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

• 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 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.

Entidades de Integração para Cupom Fiscal Cancelado

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

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

Mensagem Padrão

Descrição

RM

Tabela

Campo

Observação

CompanyId

Código da empresa.

TCUPOMFISCAL

CODCOLIGADA

.

BranchId

Código da filial

CompanyInternalId

InternalId

InternalId de Integração

TCUPOMFISCAL

OperatorCode