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 recebimento 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 recebimento envio de Mensagens Únicas TOTVS para integração do cadastro de Estação (Ponto de Venda), estando o adapter de envio recebimento desta mesma mensagem fora do escopo do requisito, ou seja , os pontos de vendas (Estação-PDV) serão cadastrado somente no PDV ProtheusBackOffice RM.

A análise e o desenvolvimento do adapter será efetuado considerando a integração com o BackOffice RMPDV 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

[Atualizações -> Acadêmico-> Tesouraria]

-

 

  • Criar o parâmetro  de integração "CODTMVVENDA" para que seja informado o  Código de Tipo de Movimento Vendas. Neste campo poderá ser informado somente movimentos de venda, ou seja, códigos "2.2.X".
  • Criar o parâmetro de integração "CODTMVPED" para que seja informando Código Tipo de Movimento Pedido. Neste campo poderá ser informando somente movimentos cujo o código comece com "1.2.X".
  • RM \ BackOffice \ Gestão de Estoque, Compras e Faturamento \ Cadastros \
    Estoque, Compras e Faturamento \ Mais \ Tabelas Auxiliares \ Ponto de Venda

    -

    Criar o parâmetro de integração "CODTMVTRANSF" para que seja informa o código Tipo de Movimento Transferência. Este parâmetro deve aceitar somente movimentos cujo código inicia-se com "2.2.X".

     

    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

     

    Permissões do cadastro

     

    As permissões de inclusão, alteração ou exclusão ao cadastro devem ser removidas, permitindo somente visualização, visto que o cadastro é mantido pelo Protheus.

    Mapeamento dos campos

    • Mensagem XX

     

     

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

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

    Image Added

    <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

    Campo

    DESCRICAO

    Tipo

    varchar

    Tamanho

    60

    Descrição

    Descrição do Ponto de Venda

    Título

    Descrição

    Picture

     

    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.