Skip to end of metadata
Go to start of metadata

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais 

Especificação

Produto

TOTVS Gestão de Estoque, Compras e Faturamento

Módulo

Faturamento

Segmento Executor

TOTVS Construção e Projetos

Projeto1

Integração BackOffice RM x PDV Protheus

IRM1

PCREQ-7769

Requisito1

PCREQ-7799

Subtarefa1

PDR_CP_MOV008-26

Chamado2

 

Release de Entrega Planejada

12.1.10

Réplica

Não

País

( X ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

   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 cadastro de Estação PDV, viabilizando assim o CRUD completo do cadastro por envio de mensagem de integração.

 

Definição da Regra de Negócio

 

Considera-se como escopo deste requisito a implementação do adapter de envio de Mensagens Únicas TOTVS para integração do cadastro de Estação (Ponto de Venda), estando o adapter de recebimento desta mesma mensagem fora do escopo do requisito, ou seja , os pontos de vendas (Estação-PDV) serão cadastrado somente no BackOffice RM.

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.

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

Ponto de Venda

Inclusão/Alteração/Exclusão

RM \ BackOffice \ Gestão de Estoque, Compras e Faturamento \ Cadastros \
Estoque, Compras e Faturamento \ Mais \ Tabelas Auxiliares \ Ponto de Venda

-

 

Tabelas Utilizadas

  • TGRPPONTOVENDA – Grupamento de Pontos de Venda
  • TPONTOVENDA – Ponto de Venda

 

Entidades de Integração 

  • DataServer envolvido
    • MovGrpPontoVendaData
  • Transformação
    • Id: LISTOFSTATIONSALEPOINT
    • Versão: 1.000
  • SourceCode (Evento)
    • GUID: f1b94c0a-3982-455a-a9d3-d4c26bc775b2
    • Nome: StationSalesPoint_1.000
  • Fórmula Visual
    • 03_PDV_PontoVenda.TotvsWF

Regras de Integridade 

  • O cadastro deve ser feito no BackOffice RM e sincronizado para o PROTHEUS via Integração TOTVS Mensagem Única.
  • O código do ponto de venda no RM (TPONTOVENDA.PONTOVENDA) deve ser igual ao código do ECF no Protheus (SLG.LG_PDV). É obrigatório incluir um código do ponto de venda no RM com o valor 001.
  • No RM os cadastros de Pontos de Venda (PDV) são consolidados pelo cadastro de Grupo de Venda, sendo enviado ao Protheus na Mensagem Única a lista com todos os Pontos de Venda do grupo.
    • O tratamento de evento será efetuado através do campo "Event" interno ao item da mensagem, visto que em uma mesma mensagem de evento 'Upsert' podem existir itens com eventos 'Delete'. Ex.: Foi incluído um PDV e outro foi excluído.
  • Serão enviados para o PROTHEUS somente os registros que são do Tipo 'Impressora Fiscal' (TPONTOVENDA.TIPO=1).
    • Esta validação é efetuada na Fórmula Visual e no XSLT de saída.
  • Caso o campo TIPO seja alterado de 'Impressora Fiscal' para qualquer outro será enviada a exclusão do respectivo Ponto de Venda ao Protheus.
  • Caso o Código do Ponto de Venda seja alterado será enviada ao Protheus a exclusão do registro referente ao código anterior e a inclusão de novo Ponto de Venda com o novo código.
  • CRO - Default
    • O Contador de Reinicio de Operação é trafegado na mensagem única, pois será utilizado na integração de inclusão do Cupom Fiscal. Para obter maiores informações sobre o a integração de Cupom Fiscal clique aqui.

 

Compartilhamento de registros por Coligada e Filial

Visto que o registo no BackOffice RM não considera a Filial como parte da Chave e existe a restrição na Mensagem Única TOTVS para envio do 'CompanyInternalId' completo (Coligada + Filial), é necessário que o sistema destinatário possua este cadastro exclusivo por Coligada e compartilhado por Filial.

Em resumo, o sistema de destino não deve considerar a informação de Filial enviada, pois caso no BackOffice RM este campo esteja nulo será enviada a Filial do contexto de integração, que e a primeira filial da empresa disponível na tabela De-Para.

Em relação ao Protheus deve seguir o seguinte compartilhamento:

      • Empresa:  Exclusivo
      • Unidade:   Deve ser equivalente à entidade relacionada no De-Para de integração (Empresa ou filial)
      • Filial:        Compartilhado

Restrições e Ponto de Atenção

  • Os campos enviados do RM para o PROTHEUS não poderão ser alterados no PDV.
  • Conforme uso normal do FrontLoja, o usuário deverá acessar o cadastro de Estação no mesmo para efetuar as configurações referentes aos devices agregados, como Impressora Fisca, PinPad, Leitor de Código de Barras e demais. 


Mapeamento dos campos

  • Mensagem LisOfStationSalePoint 1.000 

Mensagem Padrão

Descrição

RM

Tabela

Campo

Observação

CompanyId

Código da empresa.

TPONTOVENDA

CODCOLIGADA

Código da Coligada é obtido a partir do De-Para de Filial.

BranchId

Código da filial

TPONTOVENDA

CODFILIAL

CompanyInternalId

InternalId da chave completa de empresa do produto

TPONTOVENDA

CODCOLIGADA|CODFILIAL

Code

Código Ponto de Venda

TPONTOVENDA

PONTOVENDA

 

InternalId

InternalId de Integração

TPONTOVENDA

CODCOLIGADA|PONTOVENDA

 

Series

Série

TPONTOVENDA

SERIE

 
SeriesInternalIdId de integração da SérieTPONTOVENDACODCOLIGADA|SERIE 

Description

Descrição

TPONTOVENDA

DESCRICAO

 

WarehouseInternalIdId de integração do Local de Estoque(Armazem)TPONTOVENDACODLOC 
WarehouseCodeCódigo do Local de EstoqueTPONTOVENDACODCOLIGADA|CODFILIAL|CODLOC 

Active

Estação Ativa?

TPONTOVENDA

INATIVO

TPONTOVENDA.INATIVO = 0: Ativo

TPONTOVENDA.INATIVO = 1: Inativo

EventEvento do item (Ponto de Venda) EVENTCampo adicionado no tratamento da Fórmula Visual para controle de evento por Ponto de Venda do Grupo.
CROContador Reinício de OperaçãoTPONTOVENDACRO 
  • Somente os campos marcados em negrito são tratados no Adapter, sendo os demais não enviados na mensagem.

 

Fluxo do Processo

A integração de Pontos de Venda é efetuada em duas etapas, iniciada no BackOffice RM onde todos os dados de integração fiscal devem ser efetuadas e finalizada com a completa configuração dos equipamentos agregados ao FrontLoja (Pinpad, leitores, impressora fiscal, etc).


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

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.