Boas práticas para explosão de lote em integrações via API

Durante integrações de pedidos de venda via API, podem surgir dúvidas ou inconsistências relacionadas à explosão de lote, especialmente quando o comportamento difere entre pedidos lançados manualmente e pedidos integrados.

Essas inconsistências geralmente estão associadas à forma como a integração gerencia a inclusão e a posterior alteração dos itens do pedido, em conjunto com a configuração da TOP (Tipo de Operação) utilizada.

Procedimento:

Quando utilizar TOP com Validar Estoque p/ Reservar = Ligado

Fluxo obrigatório:

Inclua o pedido via CACSP.incluirNota

• A explosão de lote ocorre automaticamente na inclusão.

• Não é necessário enviar requisição de alteração do item, para que ocorra a explosão do lote.

OBSERVAÇÃO:

• O sistema pode desmembrar o item em múltiplas linhas, de acordo com o estoque disponível para cada local.

• Caso seja necessário enviar uma alteração via CACSP.incluirAlterarItemNota, é fundamental mapear previamente o pedido, verificando se houve alterações na estrutura, como explosão de lote e sequenciamento dos itens.
   

Quando utilizar TOP com Validar Estoque p/ Reservar = Desligado

Fluxo obrigatório:

Inclua o pedido via CACSP.incluirNota

Confirme o pedido via CACSP.confirmarNota

Altere o item via CACSP.incluirAlterarItemNota.

• Nesse momento ocorre a explosão de lote.

ATENÇÃO:

• A explosão de lote não acontece sem a execução das chamadas CACSP.confirmarNota e CACSP.incluirAlterarItemNota.

• Todo o fluxo deve ser seguido integralmente pela integração para garantir o comportamento correto do sistema.
   

INFORMAÇÕES ADICIONAIS:

• Valide previamente a configuração da TOP utilizada na integração.

• Evite chamadas desnecessárias de alteração quando a TOP já realiza a reserva estoque.

• Mapeie corretament os itens e suas sequências após a explosão de lote.

• Realize testes em homologação sempre que houver alterações na TOP ou no fluxo da integração.