Histórico da Página

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.

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

Cupom Fiscal Cancelado

O Cupom Fiscal não pode sofrer alterações além do cancelamento. Sendo assim o PDV irá enviar a mensagem RETAILSALESCANCELLATIONRETAILSALES com a tag "IsCanceled" com valor igual a "true". Após o recebimento da mensagem pelo EAI RM será consumido o serviço DataServer de Cancelamento do Cupom Fiscal onde serão realizadas as seguintes consistênciaspreenchidos 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çãoEntidades de Integração para Cupom Fiscal Cancelado

• DataServer envolvido
  • MovCupomFiscalData
• Transformação:
  • RetailSalesCancellationId: RetailSales
  • Versão: 1_0002.009
• 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 12.001 009 - mapeamento encontra-se disponível na especificação de Venda.

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

Mensagem Padrão

Descrição

RM

Tabela

Campo

Observação

CompanyId

Código da empresa.

TCUPOMFISCAL

CODCOLIGADA

de

BranchId

Código da filial

CompanyInternalId

InternalId da chave completa de empresa do produto

InternalId

InternalId de Integração

TCUPOMFISCAL

Venda

OperatorCode

.