Demander API - Orders

This article is part of the REST Integration API documentation.

Documentation to consult orders and update order status.

Pending integration requests

List pending integration requests with the ERP (issued in the last 30 days).

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

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."
}