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

O Inclusão de Cupom Fiscal não pode ser excluído, tem que ser Cancelado. Sendo assim o Cancelamento do Cupom Fiscal será realizado quando a tag "IsCanceled" estiver com o 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
;
• A coluna CANCELADO deve estar com valor igual a True;
• A coluna INTEGRAAPLICACAO deve receber o valor "SIGALOJA" para identificar que ele veio da integração.

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

Tabelas Utilizadas

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

Entidades de Integração

• DataServer envolvido
  • MovCupomFiscalData
• Transformação
  • Id: RetailSales
  • Versão: 1_001
• SourceCode (Evento)
  • GUID: 

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

 Image Removed

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

• • .

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: 2.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

Image Added

Mapeamento de Campos

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

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Programas

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.