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.
