01. DADOS GERAIS

Produto:

TOTVS Varejo Supermercados

Linha de Produto:

Supermercados - Linha Consinco

Segmento:

Varejo

Tipo de Documento:

Inovação

Módulo:Integrações Canais de Vendas
Caminho: API de Pedido de Vendas > POST Pedido Venda
Função:Importação de pedidos
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DSUPXOMNI-4122

02. SITUAÇÃO/REQUISITO

Atualmente a integração de pedidos pela API Pedido de Venda não permite o envio de múltiplos pedidos com o mesmo idPedidoCanalVenda.

Sendo assim, após a integração de um determinado pedido pela API Pedido de Venda e o processamento do mesmo pelo Processamento de Pedidos (Scheduler), caso outro pedido seja enviado com o mesmo idPedidoCanalVenda é gerado uma Críticas de Importação na API indicando que o pedido já está integrado no sistema.

Entretanto existem casos onde após uma separação do pedido feita por um terceiro, existe a necessidade de uma atualização desse pedido com as informações atualizadas, como a adição de um produto ou a atualização de sua quantidade.

Visando cumprir esse e demais cenários similares, foi implementado um novo parâmetro na requisição chamado de substituirPedidoExistente para que haja a possibilidade de realizar a substituição de um pedido existente já importado previamente.

03. PRÉ-REQUISITOS

O usuário precisa estar autenticado na API.

Um pedido com o mesmo idPedidoCanalVenda precisa já ter sido importado previamente dentro do sistema.

A situação do pedido no Pedido de Venda/Transferência - Vendas deve estar como Liberado.

O novo pedido deve ser enviado com a propriedade substituirPedidoExistente com o valor S.


Alterações ou parametrizações incorretas podem comprometer o desempenho e causar falhas no sistema. Sempre que necessário, consulte um especialista ou a equipe responsável para garantir a configuração correta.


04. SOLUÇÃO

Foi implementado uma nova propriedade na requisição de POST - Pedido de Venda chamada substituirPedidoExistente.

Caso seja enviado um pedido onde essa propriedade esteja como S e já tenha um pedido com o mesmo idPedidoCanalVenda e com a situação Liberado, o mesmo será Cancelado e um novo pedido será importado utilizando os dados recebidos.

Caso seja enviado um pedido onde essa propriedade esteja como S porém nenhum pedido tenha sido importado previamente com o mesmo idPedidoCanalVenda, um novo pedido será importado utilizando os dados recebidos.

Caso seja enviado um pedido onde essa propriedade esteja como S e já tenha um pedido com o mesmo idPedidoCanalVenda porém com a situação diferente de Liberado, será gerado uma crítica na tela de Críticas de Importação indicando que o não foi possível cancelar o pedido.

Caso seja enviado um pedido onde essa propriedade esteja como e já tenha um pedido com o mesmo idPedidoCanalVenda, independente da situação do pedido, será gerado uma crítica na tela de Críticas de Importação indicando que o pedido já foi importado.

05. REQUISITOS DE VERSÃO

Se estiver na versão 25.07, atualize para o service pack 25.07.026 ou superior.

Se estiver na versão 26.01, atualize para o service pack 26.01.002 ou superior.

06. DOCUMENTOS RELACIONADOS

DOCUMENTO(S) DE REFERÊNCIA