API de Demander - Órdenes

Este artículo es parte de la documentación API de integración REST.

Documentación para consultar pedidos y actualizar el estado del pedido.

Solicitudes de integración pendientes

Listado de solicitudes de integración pendientes con el ERP (emitidas en los últimos 30 días).

Rota: {host}/public/v1/pedidos/pendentes-de-integracao
Método: GET

Retorno:

{
  "pedidos": [
    {
      "idPedido": 12345,
      "codigo": 2233
    },
    {
      "idPedido": 165554,
      "codigo": 2365
    }
  ]
}

Consulta de un solo Pedido

Devuelve los datos de un pedido mediante idPedido.

Rota: {host}/public/v1/pedidos?idPedido={idPedido}
Método: GET

Retorno:

{
  "cabecalho": {
    "idPedido": 121212,
    "codigo": 12345,
    "codFilial": "SP01",
    "codTipoPedido": 1,
    "numOrdemCompra": "OC-2025-0001",
    "dataEmissao": "2025-08-26T13:45:00",
    "previsaoEntrega": "2025-08-30T18:00:00",
    "codListaPreco": "LP01",
    "codVendedor": 456,
    "codFormaPagamento": "CREDITO",
    "codCondicaoPagamento": "30DD",
    "codTransportadora": "TRANS001",
    "cliente": {
      "idCliente": 121212,
      "codCliente": 64068,
      "cpfCNPJCliente": "12.345.678/0001-99"
    }
  },
  "desconto": {
    "valorDescontoDestacado": 12.5,
    "percDescontoDestacado": 5.0
  },
  "valores": {
    "valorProdutosSemDescAcres": 1000.0,
    "valorProdutosComDescAcres": 950.0,
    "valorFrete": 50.0,
    "valorIPI": 25.0,
    "valorICMS_ST": 30.0,
    "valorDespesasAcessorias": 10.0,
    "valorTotalPedido": 1000.0
  },
  "observacoes": {
    "observacao": "Pedido emitido em campanha promocional.",
    "observacaoCliente": "Favor entregar no período da tarde."
  },
  "camposAuxiliares": [
    {
      "identificador": "IncluirBrinde",
      "valor": 1
    },
    {
      "identificador": "AssinaturaCliente",
      "valor": "https://exemplo.s3.amazonaws.com/assinatura.jpg"
    }
  ],
  "itens": [
    {
      "codProduto": "PROD001",
      "qtde": 10,
      "valorUnitarioSemDesconto": 100.0,
      "valorTotalProdutosComDesconto": 950.0,
      "valorTotalIPI": 25.0,
      "valorTotal_ICMS_ST": 30.0,
      "valorTotalComImpostos": 1005.0,
      "valorFlexMovimentado": -50.0,
      "camposAuxiliares": [
        {
          "identificador": "QtdeBonificacao",
          "valor": 3
        }
      ]
    }
  ]
}

Estado de actualización

Cambia el estado de un pedido.

Rota: {host}/public/v1/pedidos/atualizar-status
Método: POST
Body: json

Propiedad	Tipo	Tamaño	Obligatorio	Descripción
idPedido	entero		✓	Identificador de pedido en Demander.
codStatus	entero		✓	Código de estado. Debe existir y estar activo para la empresa.

Cuerpo:

{
  "idPedido": 123,
  "codStatus": 2
}

Retorno:

{
  "mensagem": "Status do pedido de ID (123) atualizado com sucesso."
}