Entrada | Recepção de NF (PurchaseOrder) POST

Endpoint de entrada de NF utilizado para que o ERP faça carga no WMS das notas fiscais que serão recepcionadas no armazém.

Necessário Integrar

✅ Sim — é necessário enviar as notas fiscais de entrada.

URL

POST https://api.wemov.com.br/open/v1/purchaseorder

Request Header

Authorization: Bearer {TOKEN}
Accept: application/json
User-Agent: NOME-DO-CLIENTE

Request Body

{
  "companyID": "string",
  "branchID": "string",
  "warehouseID": "string",
  "docksID": "string",
  "nf": "string",
  "codeERP": "string",
  "registrationDate": "2024-02-27T19:13:30.444Z",
  "receiptDate": "2024-02-27T19:13:30.444Z",
  "purchaseOrderItens": [
    {
      "productID": "string",
      "lotNumber": "string",
      "manufacturingDate": "2024-02-27T19:13:30.444Z",
      "expirationDate": "2024-02-27T19:13:30.444Z",
      "origin": "string",
      "quantity": 0,
      "status": 1,
      "positionCode": "string",
      "aux01": "string",
      "aux02": "string",
      "aux03": "string",
      "materialStatusID": "string",
      "unitMeasurementId": "string"
    }
  ],
  "providerID": "string",
  "receiptStatus": 1,
  "receiptType": 0,
  "status": 1,
  "ownersID": "string",
  "description": "string",
  "finishCallBack": false
}

Campos do Request — PurchaseOrder

Campo	Tipo	Obrigatório	Descrição
companyId	Guid	✅	Chave relacionada da empresa (FK)
branchId	Guid	✅	Chave relacionada da filial (FK)
warehouseId	Guid	✅	Chave relacionada do armazém (FK)
docksID	Guid	❌	Chave relacionada da doca de recebimento (FK)
nf	String	✅	Número da nota fiscal
codeERP	Guid	❌	Código chave da NF no ERP
registrationDate	DateTime	✅	Data de registro (YYYY-MM-DD HH:mm:SS)
receiptDate	DateTime	✅	Data de recepção (YYYY-MM-DD HH:mm:SS)
receiptStatus	String	✅	1 Aguardando/Pendente, 2 Recebendo, 3 Recebido
receiptType	Number	✅	0 Padrão/Recebimento, 1 Devolução
providerID	Guid	❌	Chave relacionada de Fornecedor (FK)
ownersID	Guid	❌	Proprietário dos produtos no Armazém
description	String	❌	Observações sobre a entrada
finishCallBack	Boolean	❌	Informar false
status	Number	✅	0 inativo, 1 ativo (informar sempre 1)
purchaseOrderItens	Collection	✅	Itens da nota fiscal — detalhes abaixo

Campos do Request — purchaseOrderItens

Campo	Tipo	Obrigatório	Descrição
productId	Guid	✅	Chave relacionada do produto (FK)
lotNumber	String	❌	Número do lote do produto
manufacturingDate	DateTime	❌	Data de fabricação
expirationDate	DateTime	❌	Data de validade
origin	String	❌	Código da origem do produto
quantity	Number	✅	Quantidade do produto
status	Number	✅	0 inativo, 1 ativo (informar sempre 1)
positionCode	String	❌	Posição para armazenamento
aux01	String	❌	Campo auxiliar 1
aux02	String	❌	Campo auxiliar 2
aux03	String	❌	Campo auxiliar 3
materialStatusId	Guid	❌	Chave relacionada do estado do material (FK)
unitMeasurementId	Guid	❌	Chave relacionada da unidade de medida (FK)

Response

{
  "code": 200,
  "message": "string",
  "data": {
    "id": "string",
    "companyID": "string",
    "branchID": "string",
    "warehouseID": "string",
    "docksID": "string",
    "nf": "string",
    "codeERP": "string",
    "registrationDate": "2024-02-27T19:13:30.475Z",
    "receiptDate": "2024-02-27T19:13:30.475Z",
    "startDate": "2025-04-16T14:33:05.690Z",
    "endDate": "2025-04-16T14:33:05.690Z",
    "purchaseOrderItens": [
      {
        "id": "string",
        "purchaseOrderID": "string",
        "productID": "string",
        "lotNumber": "string",
        "manufacturingDate": "2024-02-27T19:13:30.475Z",
        "expirationDate": "2024-02-27T19:13:30.475Z",
        "quantity": 0,
        "received": 0,
        "unitaryValue": 0,
        "saleValue": 0,
        "status": 1,
        "positionCode": "string",
        "aux01": "string",
        "aux02": "string",
        "aux03": "string",
        "materialStatusID": "string",
        "receivingEan": "string",
        "origin": "string",
        "unitMeasurementId": "string",
        "unitMeasurementName": "string",
        "lotDetails": [
          {
            "lotNumber": "string",
            "quantity": 0,
            "status": 0,
            "seriesNumbers": ["string"],
            "weightVariable": 0.0,
            "unitMeasurementId": "string",
            "unitMeasurementName": "string"
          }
        ]
      }
    ],
    "providerID": "string",
    "receiptStatus": 1,
    "receiptType": 0,
    "status": 0,
    "ownersID": "string",
    "description": "string",
    "finishCallBack": true,
    "document": "string"
  },
  "error": "string"
}

Campos do Response — PurchaseOrder

Campo	Tipo	Descrição
id	Guid	Chave de identificação da entrada de NF (PK)
companyId	Guid	Chave relacionada da empresa (FK)
branchId	Guid	Chave relacionada da filial (FK)
warehouseId	Guid	Chave relacionada do armazém (FK)
docksID	Guid	Chave relacionada da doca de recebimento (FK)
nf	String	Número da nota fiscal
codeERP	Guid	Código chave da NF no ERP
registrationDate	DateTime	Data de registro (YYYY-MM-DD HH:mm:SS)
receiptDate	DateTime	Data de recepção (YYYY-MM-DD HH:mm:SS)
startDate	DateTime	Data de início (YYYY-MM-DD HH:mm:SS)
endDate	DateTime	Data de finalização (YYYY-MM-DD HH:mm:SS)
providerID	String	Chave relacionada de Fornecedor (FK)
receiptStatus	String	1 Aguardando, 2 Recebendo, 3 Recebido
receiptType	Number	0 Padrão/Recebimento, 1 Devolução
ownersID	Guid	Proprietário dos produtos no Armazém
finishCallBack	Boolean	Informar false
document	String	Campo auxiliar
status	Number	0 inativo, 1 ativo

Campos do Response — purchaseOrderItens

Campo	Tipo	Descrição
id	Guid	Chave de identificação dos itens da entrada (PK)
purchaseOrderID	Guid	Chave relacionada da entrada de NF (FK)
productId	Guid	Chave relacionada do produto (FK)
lotNumber	String	Número do lote do produto
manufacturingDate	DateTime	Data de fabricação
expirationDate	DateTime	Data de validade
origin	String	Código da origem do produto
quantity	Number	Quantidade do produto
received	Number	Quantidade recebida
unitaryValue	Decimal	Valor unitário do produto
saleValue	Decimal	Valor de venda do produto
status	Number	0 inativo, 1 ativo
positionCode	String	Posição para armazenamento
aux01	String	Campo auxiliar 1
aux02	String	Campo auxiliar 2
aux03	String	Campo auxiliar 3
materialStatusId	Guid	Chave relacionada do estado do material (FK)
receivingEan	String	EAN do produto informado no recebimento
unitMeasurementId	Guid	Chave relacionada da unidade de medida (FK)
unitMeasurementName	String	Nome da unidade de medida
lotDetails	Array	Detalhes dos lotes recebidos — detalhes abaixo

Campos do Response — lotDetails

Campo	Tipo	Descrição
lotNumber	String	Número do lote
quantity	Number	Quantidade recebida no lote
status	Number	Status do lote
seriesNumbers	Array	Lista de números de série
weightVariable	Number	Peso variável
unitMeasurementId	Guid	Chave relacionada da unidade de medida (FK)
unitMeasurementName	String	Nome da unidade de medida