Demander API - Orders

This article is part of the REST Integration API documentation.

Documentation to consult orders and update order status.

Pending integration requests

Lists orders pending ERP integration.

Caution

Issue-date limit (30 days)

Only orders with an issue date in the last 30 days are returned. Older orders do not appear here, even if they are still pending ERP integration.

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

Return:

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

Consultation of a single Order

Returns the data of an order via idPedido.

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

Caution

Parameters

• idPedido — mandatory

Return:

{
  "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
        }
      ]
    }
  ]
}

Update Status

Changes the status of an order.

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

Property	Type	Size	Mandatory	Description
idPedido	int		✓	Order identifier in Demander.
codStatus	int		✓	Status code. It must exist and be active for the company.

Body:

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

Return:

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