Criar itensCreate items

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.

Criar um item no Dynamics 365 Business central para uso em faturas, citações, etc.Create an item in Dynamics 365 Business Central for use on invoices, quotes, etc.

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

POST /financials/companies/{id}/items

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

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON de um objeto Items .In the request body, supply a JSON representation of an items object.

RespostaResponse

Se bem-sucedido, este método retorna 201 Created o código de resposta e um objeto Items no corpo da resposta.If successful, this method returns 201 Created response code and an items object in the response body.

ExemploExample

SolicitaçãoRequest

Veja a seguir um exemplo de uma solicitação.Here is an example of a request.

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

{
  "number": "1896-S",
  "displayName": "ATHENS Desk",
  "type": "Inventory",
  "blocked": false,
  "baseUnitOfMeasureId": "65bdbd3a-39f1-49f4-bf24-598cbac36230",
  "gtin": "",
  "itemCategoryId": "5b0b9c1c-312d-4809-96b2-056690a11057",
  "inventory": 0,
  "unitPrice": 1000.8,
  "priceIncludesTax": false,
  "unitCost": 780.7,
  "taxGroupCode": "FURNITURE"
} 

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 201 Created
Content-type: application/json

{
  "id": "id-value",
  "number": "1896-S",
  "displayName": "ATHENS Desk",
  "lastModifiedDateTime": "2015-11-09T02:14:32Z"
}