Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 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 somcnte 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.
  • O Conforme uso normal do FrontLoja, o usuário deverá acessar o cadastro de Estação no PDV-Protheus e incluir algumas informações como: Impressora/Modelo, Porta de comunicação, PinPad. Iremos analisar a possibilidade de acrescentar estes campos no RM para que possa ser cadastrado no RM e não precisar acessar o Protheus para atualizar estas informações no cadastro.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).

 Image Added

Campo

DESCRICAO

Tipo

varchar

Tamanho

60

Descrição

Descrição do Ponto de Venda

Título

Descrição

Picture

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

Dicionário de Dados

 

Tabela: TPONTOVENDA - Ponto de Venda  

 

Índice

Chave

Primary Key

CODCOLIGADA + PONTOVENDA

Campo

CODCOLIGADA

Tipo

DCODCOLIGADA

Tamanho

2

Descrição

Código da Coligada

Título

Coligada

Picture

 

Help de Campo

Código da Coligada

Campo

PONTOVENDA

Tipo

varchar

Tamanho

10

Descrição

Código do Ponto de Venda

Título

Ponto de Venda

Picture

 

Help de Campo

Ponto de Venda

Campo

CODFILIAL

Tipo

smallint

Tamanho

2

Descrição

Código da Filial Default

Título

Filial Default

Picture

 

Help de Campo

Código da Filial Default

Campo

SERIE

Tipo

varchar

Tamanho

5

Descrição

Série

Título

Série Default

Picture

 

Help de Campo

Série Default

 

Help de Campo

Descrição do Ponto de Venda

Campo

GRUPO

Tipo

varchar

Tamanho

10

Descrição

Série

Título

Grupamento

Picture

 

Help de Campo

Grupamento

Campo

CODTMV

Tipo

varchar

Tamanho

10

Descrição

Tipo de Movimento Vendas

Título

Tipo de Movimento Vendas

Picture

 

Help de Campo

Tipo de Movimento Vendas

Campo

CODTMVRECEB

Tipo

varchar

Tamanho

10

Descrição

Código do tipo de movimento

Título

Código do tipo de movimento

Picture

 

Help de Campo

Código do tipo de movimento

Campo

CODTMVDEVOLUCAO

Tipo

varchar

Tamanho

10

Descrição

Tipo de Movimento Devolução

Título

Tipo de Movimento Devolução

Picture

 

Help de Campo

Tipo de Movimento Devolução

Campo

CODTMVPEDIDO

Tipo

varchar

Tamanho

10

Descrição

Tipo de Movimento Pedido

Título

Tipo de Movimento Pedido

Picture

 

Help de Campo

Tipo de Movimento Pedido

Campo

CODTMVTRANSF

Tipo

varchar

Tamanho

10

Descrição

Tipo de Movimento Transferência

Título

Tipo de Movimento Transferência

Picture

 

Help de Campo

Tipo de Movimento Transferência

Campo

CODLOC

Tipo

varchar

Tamanho

15

Descrição

Local de Estoque

Título

Local de Estoque

Picture

 

Help de Campo

Local de Estoque Default

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