ER_PCREQ-8878_Cancelamento de Venda de Cupom Fiscal

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Implementação do adapter de integração via Mensagem Única TOTVS do Cancelamento de Cupom Fiscal. Este adapter irá viabilizar o recebimento da mensagem de Cancelamento do Cupom Fiscal (Venda e SAT) gerado pelo PDV PROTHEUS.

Definição da Regra de Negócio

Considera-se como escopo deste requisito a implementação do adapter de recebimento de Mensagens Únicas TOTVS para integração do cancelamento de Cupom Fiscal (Venda e SAT), estando o adapter de envio desta mesma mensagem fora do escopo do requisito.

 A análise e o desenvolvimento do adapter será efetuado considerando a integração com o PDV Protheus, mas também viabilizará a integração com outras fontes de dados desde que respeitado o layout da mensagem.

Regras de Integridade

Inclusão de Cupom Fiscal Cancelado

Este cenário ocorre quando o cliente desiste da venda ainda no caixa. Para este cenário o PDV deverá enviar ao RM a mensagem RETAILSALES com a tag "IsCanceled" com valor igual a "true". O cupom cancelado será incluído sem a informação de pagamento, ou seja, serão preenchidos somente os dados de Cupom Fiscal e Item de Cupom Fiscal.

Observação: na inclusão do Cupom Fiscal Cancelado não é gerado Movimento para o cupom.

Item de Cupom Cancelado

Este cenário ocorre quando o cliente desiste de comprar algum item no momento da venda. Para este cenário o PDV deverá enviar ao RM a mensagem RETAILSALES com a tag "IsCanceled" com valor igual a "true" para o Item de Cupom.

Observação: O movimento gerado para o Cupom irá considerar somente os itens não cancelados.

Cupom Fiscal Cancelado

O Cupom Fiscal não pode sofrer alterações além do cancelamento. Sendo assim o PDV irá enviar a mensagem RETAILSALES com a tag "IsCanceled" com valor igual a "true". Após o recebimento da mensagem pelo EAI RM será consumido o DataServer de Cupom Fiscal onde serão preenchidos os dados da classe de parâmetro de Cancelamento de Cupom e realizado a seguinte consistência:

• • O Cupom Fiscal a ser cancelado deve estar cadastrado.

Ao consumir o serviço de Cancelamento do Cupom Fiscal são executados no RM:

• • Cancelamento do Movimento a Partir do Cupom Fiscal
    • Consiste se existe movimento associado ao cupom fiscal.
    • Consiste se o movimento associado ao cupom fiscal está cancelado.
    • Preenche a classe de Cancelamento de Movimento (MovMovCancelamentoPar) com Motivo de Cancelamento igual a "Cancelamento de Cupom Fiscal" e Data Cancelamento igual a data atual do servidor.
    • Executa o serviço de Cancelamento de Movimento.
  • Cancelamento do Cupom Fiscal
    
    • Atualiza a coluna CANCELADO da tabela  TCUPOMFISCAL com o valor: 1 - Cupom Cancelado.

Cupom Fiscal SAT Cancelado

O Cupom Fiscal do tipo SAT não pode sofrer alterações além do cancelamento. Sendo assim o PDV irá enviar a mensagem RETAILSALES com a tag "IsCanceled" com valor igual a "true". 

Após o recebimento da mensagem pelo EAI RM será consumido o DataServer de Cupom Fiscal e quando o Tipo do Cupom for igual a SAT será recuperado o Identificador do Movimento referente ao Cupom SAT. O filtro a ser realizado para buscar o Identificador do Movimento referente ao Cupom SAT na tabela de Movimentos é: Código da Coligada e Chave de Acesso.

Serão preenchidos os dados da classe de parâmetro de Cancelamento de Cupom e consumido o serviço de Cancelamento do Cupom Fiscal.

Ao consumir o serviço de Cancelamento do Cupom Fiscal são executados no RM:

• • Cancelamento do Movimento
    • Consiste se existe movimento associado ao Cupom Fiscal SAT.
    • Consiste se o movimento associado ao cupom fiscal SAT está cancelado.
    • Preenche a classe de Cancelamento de Movimento (MovMovCancelamentoPar) com Motivo de Cancelamento igual a "Cancelamento de Cupom Fiscal", Data Cancelamento igual a data atual do servidor e Id do Movimento com o Identificador do Movimento SAT.
    • Executa o serviço de Cancelamento de Movimento.

Observação: Cupom Fiscal SAT está disponível a partir do release 12.1.14.

Entidades de Integração

• DataServer envolvido
  • MovCupomFiscalData
• Transformação:
  • Id: RetailSales
  • Versão: 1_001
• SourceCode (Evento)
  • GUID: 1efe6424-027b-44af-8dd3-ef18a527d6b6

Tabelas Utilizadas

• TCUPOMFISCAL – Cupom Fiscal
• TCUPOMFISCALITM - Itens de Cupom Fiscal
• TCUPOMFISCALFIN - Pagamentos do Cupom Fiscal
• TMOV - Movimentos
• TITMMOV - Itens de Movimento

Fluxo do Processo

Mapeamento de Campos

Mensagem: RetailSales 1.001 - mapeamento encontra-se disponível na especificação de Venda.