API do Demander - Pedidos

Este artigo faz parte da documentação da API de Integração REST.

Documentação para consultar pedidos e atualizar status do pedido.

Pedidos pendentes de integração

Lista pedidos pendentes de integração com o ERP (emissão nos últimos 30 dias).

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

Retorno:

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

Consulta de um único Pedido

Retorna os dados de um pedido pelo 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
        }
      ]
    }
  ]
}

Atualizar Status

Altera o status de um pedido.

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

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
idPedido	int		✓	Identificador do pedido no Demander.
codStatus	int		✓	Código do status. Deve existir e estar ativo para a empresa.

Body:

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

Retorno:

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