Atualizar fornecedoresUpdate vendors

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported.

Atualizar as propriedades de um objeto fornecedor para o Dynamics 365 Business central.Update the properties of a vendor object for Dynamics 365 Business Central.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Financials.ReadWrite.AllFinancials.ReadWrite.All
Delegado (conta pessoal da MicrosoftDelegated (personal Microsoft account Sem suporte.Not supported.
AplicativoApplication Financials.ReadWrite.AllFinancials.ReadWrite.All

Solicitação HTTPHTTP request

PATCH /financials/companies/{id}/vendors/{id}

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the OData Query Parameters to help customize the response.

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json
If-MatchIf-Match Obrigatório.Required. Quando esse cabeçalho de solicitação for incluído e a eTag fornecida não corresponder à marca atual nos fornecedores, os fornecedores não serão atualizados.When this request header is included and the eTag provided does not match the current tag on the vendors, the vendors will not be updated.

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para obter melhor desempenho, não inclua valores existentes que não foram alterados.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

RespostaResponse

Se bem-sucedido, este método retorna um 200 OK código de resposta e um objeto fornecedores atualizados no corpo da resposta.If successful, this method returns a 200 OK response code and an updated vendors object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/financials/companies/{id}/vendors/{id}
Content-type: application/json

{
  "displayName": "Wide World Importers Inc.",
  "blocked": "Payment"
}

RespostaResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

Observação: o objeto de resposta mostrado aqui pode ser encurtado com fins de legibilidade.Note: The response object shown here might be shortened for readability. Todas as propriedades serão retornadas de uma chamada real.All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "id-value",
  "number": "40000",
  "displayName": "Wide World Importers Inc.",
  "address": {
    "street": "51 Radcroft Road",
    "city": "Atlanta",
    "state": "GA",
    "countryLetterCode": "US",
    "postalCode": "31772"
  },
  "phoneNumber": "",
  "email": "toby.rhode@cronuscorp.net",
  "website": "",
  "taxRegistrationNumber": "",
  "currencyCode": "USD",
  "irs1099Code": "",
  "taxLiable": true,
  "blocked": "Payment",
  "balance": 0,
  "lastModifiedDateTime": "2017-03-07T00:35:29.667Z"
}