Envio de Movimentações via API

O sistema Valesoft permite o envio das movimentações de locais ocorridas com os EPCs para uma API externa de outro sistema.

Dessa forma é realizado internamente o envio de um POST HTTP para uma URL pré-configurada nas configurações de integração.

Para isso é necessário configurar o token de acesso e a url da API para integração.

A integração Http Json pode chamar APIs sem autenticação ou com autenticação por meio de token passado no header Authorization, como por exemplo, Basic dXNlcm5hbWU6cGFzc3dvcmQ= ou Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

  {
    "movement": [{
      "originPlace": "12345",
      "destinationPlace": "654321",
      "documentId": "3e3a8c72-57b8-4c4a-8d9b-230fe6982a3d",
      "documentReference": "Padrão",
      "documentType": "SHIPPING",
      "productReference":  "SKU123",
      "batch": "",
      "epc": "AB0123456789012345678902",
      "fraction": 100.23,
      "previousPlaceReference": null,
      "previousPlaceName": null,
      "date": "2024-05-28 14:59:14.000",
      "custom": {
            "campoCustomDoEpc2": 456
      },
    },
    {
      "originPlace": "456789",
      "destinationPlace": "987654",
      "documentId": "3e3a8c72-57b8-4c4a-8d9b-230fe6982a3d",
      "documentReference": "Padrão",
      "documentType": "SHIPPING",
      "productReference":  "SKU456",
      "batch": "123456",
      "epc": "AB0123456789012345678901",
      "fraction": 20.0,
      "previousPlaceReference": null,
      "previousPlaceName": null,
      "date": "2024-05-28 14:59:14.000",
      "custom": {
            "campoCustomDoEpc1": true,
            "campoCustomDoEpc2": 123
      },
    }]
  }

Campos do corpo da requisição:

• movement - Lista de movimentações.

• originPlace - Código do Local de origem do EPC.

• destinationPlace - Código do Local de destino do EPC.

• documentId - Id do documento do EPC.

• documentReference - Referência do documento do EPC.

• documentType - Tipo do documento do EPC. Tipos existentes:

  • PROCESSING - Ordem de Beneficiamento
  • MANUFACTURE - Ordem de produção
  • ENTRY - Nota de Entrada
  • OUTGOING - Nota de Saída
  • SALES - Pedido de venda
  • SHIPPING - Remessa
  • RAW_REQUEST - Requisição de material

• productReference - Código do Produto do EPC movimentado.

• batch - Lote da etiqueta movimentada.

• epc - EPC da etiqueta movimentada.

• fraction - Quantidade fracionada movimentada.

• date - Data e Hora da movimentada.

• custom - Campos personalizados no EPC

• previousPlaceReference - Referência do local anterior do EPC

• previousPlaceName - Nome do local anterior do EPC

Resposta esperada em caso de sucesso

Retornar uma resposta padrão HTTP com status 200

Resposta esperada em caso de erro

Retornar uma resposta padrão HTTP com o respectivo status de erro

{
    "errorMessage": "Mensagem de erro"
}

Disponível a partir da versão 1.29.81