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 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, 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".

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.

Entidades de Integração para Cupom Fiscal Cancelado e Item de Cupom Cancelado

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

Cupom Fiscal Cancelado

O Cupom Fiscal não pode sofrer alterações além do cancelamento. Sendo assim o PDV irá enviar a mensagem RETAILSALESCANCELLATION. Após o recebimento da mensagem pelo EAI RM será consumido o serviço de Cancelamento do Cupom Fiscal onde serão realizadas as seguintes consistências:

• • O Cupom Fiscal a ser cancelado deve estar cadastrado;
  • A coluna INTEGRAAPLICACAO deve receber o valor "SIGALOJA" para identificar que ele veio da integração.

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 Movimento Relacionado ao Cupom Fiscal
    • Este cancelamento será executado somente se já existir uma Pré-Venda integrada ao Cupom Fiscal (Id. Pedido > 0).
    • Preenche a classe de Cancelamento de Movimento (MovMovCancelamentoPar) com Motivo de Cancelamento igual a "Cancelamento de Pré-Venda integrada a Cupom Fiscal" e Data Cancelamento igual a data atual do servidor.
  • Cancelamento do Cupom Fiscal
    • Atualiza a coluna CANCELADO da tabela  TCUPOMFISCAL com o valor: 1 - Cupom Cancelado.

Entidades de Integração para Cupom Fiscal Cancelado

• DataServer envolvido
  • MovCupomFiscalData
• Transformação:
  • RetailSalesCancellation
  • Versão: 1_000
• SourceCode (Evento)
  • GUID: 

Tabelas Utilizadas

• TCUPOMFISCAL – Cupom Fiscal
• TCUPOMFISCALITM - Itens de Cupom Fiscal
• TCUPOMFISCALFIN - Pagamentos do Cupom Fiscal

Fluxo do Processo

Mapeamento de Campos

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

Mensagem: RetailSalesCancellation 1.000 - Mensagem para Integração de Cancelamentos de Vendas

• Somente os campos marcados em negrito são tratados no Adapter.