Permissões de Usuário:

3122 – API Pedidos de Compra (Consultar)

3374 – API Pedidos de Compra (Incluir)

3626 – API Pedidos de Compra EDI (Consultar)

Agora no Bluesoft ERP, as APIs de pedidos de compra passam a oferecer suporte ampliado aos pedidos CD – Cross Docking com distribuição programada.

Nas consultas GET /api/compras/pedidos-de-compra e GET /api/compras/pedidos-de-compra/edi, o integrador poderá solicitar a expansão das lojas e dos itens da distribuição programada. As respostas também passam a identificar esse modelo por meio do campo distribuicaoProgramada e permitem filtrar pedidos abertos ou fechados.

Na consulta EDI, cada loja destinatária é apresentada separadamente, sem incluir o CD como destinatário. Para pedidos abertos, quando o filtro de envio não for informado, a consulta considera pedidos ainda não enviados ao EDI.

Também será possível alterar as quantidades das lojas de um pedido programado aberto por meio do endpoint PATCH /api/compras/pedidos-de-compra/{numeroDoPedido}. O ERP recalculará automaticamente a quantidade do CD, considerando as lojas não informadas na requisição, os fatores de estoque e a configuração logística aplicável.

Com essa melhoria, as integrações poderão consultar os identificadores dos itens, atualizar as quantidades distribuídas e conferir o resultado pelo mesmo fluxo de API, mantendo o comportamento anterior quando os novos parâmetros não forem utilizados.

Exemplo consultar pedidos de compra

GET /api/compras/pedidos-de-compra?numeroDoPedido=12345&statusPedido=FECHADO&retornaPedidosComDistribuicaoProgramada=true&incluirItensComQuantidadeZero=true

Resposta — sucesso

HTTP/1.1 200 OK
{
  "data": [
    {
      "numeroPedido": 12345,
      "statusPedido": "FECHADO",
      "distribuicaoProgramada": true,
      "entregaPendente": true,
      "itens": [
        {
          "itemPedidoKey": 1001,
          "produtoKey": 2001,
          "lojaKey": 10,
          "quantidadePedida": 5,
          "quantidadePendente": 2,
          "fatorEstoque": 1
        },
        {
          "itemPedidoKey": 1002,
          "produtoKey": 2001,
          "lojaKey": 11,
          "quantidadePedida": 0,
          "quantidadePendente": 0,
          "fatorEstoque": 1
        }
      ]
    }
  ]
}

Exemplo consultar pedidos de compra para EDI

GET /api/compras/pedidos-de-compra/edi?numeroDoPedido=12345&statusPedido=ABERTO&pedidoEnviadoEdi=NAO&retornaPedidosComDistribuicaoProgramada=true

Resposta — sucesso

HTTP/1.1 200 OK
{
  "data": [
    {
      "numeroPedido": 12345,
      "statusPedido": "ABERTO",
      "distribuicaoProgramada": true,
      "entrega": 1,
      "lojaKey": 10,
      "eanLocalEntrega": "0000000000000",
      "itens": [
        {
          "itemPedidoKey": 1001,
          "produtoKey": 2001,
          "quantidadeSolicitada": 5,
          "fatorEstoque": 1,
          "custoBrutoEmbalagem": 20.50
        }
      ],
      "prazos": [
        {
          "quantidadeDias": 30,
          "porcentagemFatura": 100
        }
      ]
    }
  ]
}

Exemplo alterar quantidades de itens do pedido

PATCH /api/compras/pedidos-de-compra/{{numPedido}}
{
  "itens": [
    {
      "itemPedidoKey": 1001,
      "quantidadePedida": 8
    },
    {
      "itemPedidoKey": 1002,
      "quantidadePedida": 4
    }
  ]
}

Resposta — sucesso

HTTP/1.1 200 OK

Resposta — pedido fechado

HTTP/1.1 400 Bad Request
{
  "type": "about:blank",
  "title": "O Pedido {{numPedido}} informado está com status FECHADO",
  "status": 400,
  "message": "O Pedido {{numPedido}} informado está com status FECHADO"
}

Para conhecer mais sobre como é a utilização dessa ferramenta, confira as documentações abaixo:

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r376.01.