HomeGuidesAPI Reference
Log In
Guides

Pedidos de entrada

Os pedidos de entrada trazem mercadorias que serão adicionadas ao seu estoque. Podem ser Pedidos de Entrada regulares (Operação 2) ou Pedidos de Entrada de Sobra (Operação 7).

Os pedidos são criados por meio do nosso endpoint de Pedidos. A requisição deve ser parecida com esta:

[
  {
    "relatedOrderCode": "4657812",
    "relationalLogisticOperationId": "171",
    "subOperation": "FOOD",
    "relationalEntityId": "5413",
    "operation": 2,
    "typing": "2022-03-28T19:46:59.376Z",
    "whoTyped": "John Doe",
    "orderItems": [
      {
        "relatedProductId": "5487",
        "quantity": 10,
        "itemNumber": 1
      }
    ]
  }
]

Estes são os campos obrigatórios para criar um pedido; você pode ver todos os campos abaixo.

🚧

A API exige obrigatoriamente relatedOrderCode, relationalEntityId, ao menos um item em orderItems e, para cada item, relatedProductId e quantity (maior que zero). Os demais campos marcados como "Sim" abaixo são exigidos por regras de negócio no WMS.

Todos os campos

NomeDescriçãoObrigatórioValor padrão
relatedOrderCodeId do documento no sistema de origem.Sim
relationalLogisticOperationIdId da operação logística no sistema de origem.Sim
operationOperação do pedido: 2 = Entrada regular, 7 = Entrada de Sobra.Sim
subOperationSuboperação do pedido, pode ser qualquer valor, ex.: Compra, Transferência.Sim
reasonSubOperationMotivo da suboperação, pode ser qualquer valor.Não
relationalEntityIdId do fornecedor no sistema de origem; para Pedidos de Sobra é o Id da operação logística.Sim
typingData de criação no sistema de origem.Sim
whoTypedQuem criou o pedido, pode ser qualquer valor.Sim
orderOriginOrigem do pedido, pode ser qualquer valor.NãoConfigurável no WMS
relationalCarrierCodeId da transportadora no sistema de origem.Não
orderObservationObservações do pedido, pode ser qualquer valor.Não
relationalTitleCodeId da nota fiscal no sistema de origem.Não
invoiceNumberNúmero da nota fiscal (somente Brasil).Não
invoiceSeriesSérie da nota fiscal (somente Brasil).Não
orderItemsItens do pedido, veja aqui.Sim

Itens do pedido

NomeDescriçãoObrigatórioValor padrão
relatedProductIdId do produto no sistema de origem.Sim
quantityQuantidade do produto.Sim
itemNumberNúmero do item no documento de entrada.Sim
itemNoteObservações do item dentro do documento de entrada.Não
minimumValidityValidade mínima em dias.Não
variableQuantityQuantidade variável.Não
standardMeasureMedida padrão.Não
itemInventoryNoteObservações do item a conferir durante a entrada.Não
orderItemVolumeLotsLote esperado durante a entrada, veja aqui.Não

Volumes de lote

NomeDescriçãoObrigatórioPadrão
originLotLote de origem.Sim
quantityQuantidade do lote.Sim
validityOriginData de validade do lote.Sim
manufacturingDateData de fabricação.Não
itemLotNoteObservações do lote, pode ser qualquer valor.Não
relatedOriginClassificationId da classificação do lote no sistema de origem.Não
variableQuantityQuantidade variável do produto.Não

Para mais informações sobre as propriedades necessárias, consulte a nossa Referência da API aqui.


Did this page help you?