Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

 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

Estoque

Segmento Executor

TOTVS Construção e Projetos

Projeto1

Integração BackOffice RM x PDV Protheus

IRM1

PCREQ-7769

Requisito1

PCREQ-7808

Subtarefa1

PDR_CP_MOV008-47

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 Unidade de Medida com o PDV Protheus, 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 Unidade de Medida (UnitOfMeasure), estando o adapter de recebimento 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. 

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

Unidades de Medida

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

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

-

 

Tabelas Utilizadas

  • TUND - Unidades

 

Entidades de Integração

  • DataServer envolvido
    • EstUndData
  • Transformação
    • Id: UnitOfMeasure
    • Versão: 2.000
  • Fluxo da mensagem
    • Saída
  • Tipo de Envio:
    • Síncrono.
  • Fórmula Visual
    • 06_PDV_UnidadeDeMedida.TotvsWF

 

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

Mapeamento dos campos

 

  • Mensagem UnitOfMeasure 2.000

  

Mensagem Padrão

Descrição

RM

Tabela

Campo

Observação
CodeCódigo Unidade. MedidaTUNDCODUND 
InternalIdInternalId da EntidadeTLOCCODCOLIGADA| CODFILIAL| CODLOC 
DescriptionDescrição Local EstoqueTLOCNOME 
ActiveLocal Estoque Ativo?TLOCINATIVO

Inativo=0: Ativo

Inativo=1: Inativo
TypeTipo do Local de Estoque  Não utilizada na linha RM
IsFinalItemLocal de Estoque é de produto acabado?  Não utilizada na linha RM

IsQualityControl

Local de Estoque é de controle de qualidade?

  Não utilizada na linha RM

IsProcess

Local de Estoque é de processo?

  Não utilizada na linha RM

IsWaste

Local de Estoque é de rejeito?

  Não utilizada na linha RM

 

 

(Opcional)

Grupo de Perguntas

 

<Informações utilizadas na linha Protheus>.

 

Nome: FINSRF2

X1_ORDEM

01

X1_PERGUNT

Emissão De

X1_TIPO

D

X1_TAMANHO

8

X1_GSC

G

X1_VAR01

MV_PAR01

X1_DEF01

Comum

X1_CNT01

'01/01/08'

X1_HELP

Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório 

 

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

 

Consulta: AMB

Descrição

Configurações de Planejamento

Tipo

Consulta Padrão

Tabela

“AMB”

Índice

“Código”

Campo

“Código”; ”Descrição”

Retorno

AMB->AMB_CODIGO

 

Restrições e Pontos de atenção:

  • Visto que a base Protheus possui carga de unidades de medida padrões, que obrigatoriamente constam na base de dados, deve-se efetuar o cadastro destas unidades no RM respeitando o mesmo código do Protheus para viabilizar a integração de registros que utilizem estas como parâmetro. A lista de unidades que existem no Protheus e devem ser cadastradas no RM com o mesmo código de descrição são:

    CódigoDescrição
    ARARROBA
    BDBALDE    
    CCCENTIMETRO CUBICO
    CMCENTIMETRO
    CTCENTO
    CXCAIXA
    DMDECIMETRO
    DZDUZIA
    FLFOLHAS
    FTPES
    GGRAMA
    GLGALAO
    GZGROZA
    HRHORA
    JGJOGO
    KGQUILOGRAMA
    KTKIT
    LLITRO
    LBLIBRA
    LTLATA
    M2METRO QUADRADO
    M3METRO CUBICO
    MLMILILITRO
    MMMILIMETRO
    MTMETRO
    OZONCA
    PPAR
    PCPECA
    PLPOLEGADAS
    TLTONELADA LIQUIDA
    UNUNIDADE
    YDJARDA
  • O Protheus irá efetuar a consistência do tamanho do campo Código da Unidade com o tamanho recebido na mensagem. 
    • Caso o usuário parametrizar o dicionário de dados do Protheus para gerar automaticamente o código da unidade, a consistência referente ao tamanho do campo código não será realizada.
    • Caso o tamanho do campo código seja maior do que o permitido no Protheus será apresentada mensagem de consistência ao integrar o registro, deixando ao usuário as opções de contorno abaixo.
      1. Efetuar manualmente o cadastramento de unidades de medida com código com tamanho válido e efetuar o relacionamento com o código do RM na base do Protheus e posteriormente efetuar a carga para que todos os parâmetros no Protheus sejam alterados conforme a base RM (mandatária).
        1. Caso o cliente não utilize as unidades de medida com código de tamanho maior que o permitido em produtos integrados, o mesmo pode somente efetuar customização nas fórmulas visuais de gatilho para não enviar estas ao Protheus. 
      2. Configurar o Protheus para gerar código da unidade automático, conforme o primeiro item deste sessão.
        1. Esta opção não gera problemas de usabilidade pois no Protheus o usuário não seleciona a unidade de medida, mas o código que aparecerá no cupom fiscal será o gerado automaticamente. 

Tabelas Utilizadas

  • TUND - Unidades

 

Entidades de Integração

  • DataServer envolvido
    • EstUndData
  • Transformação
    • Id: UnitOfMeasure
    • Versão: 2.000
  • Fluxo da mensagem
    • Saída
  • Tipo de Envio:
    • Síncrono.
  • Fórmula Visual
    • 04_PDV_UnidadeDeMedida.TotvsWF
    • 04.Sincronização de Unidade de Medida - PDV: fórmula visual para carga de dados.

Gatilhos de Integração

Foram disponibilizadas as duas fórmulas visuais de gatilho listadas no item acima, ficando a cargo do cliente ou implantador a customização das mesmas caso não tenha interesse de integrar todas as unidades de medida ao Protheus.

Exemplo de filtro de gatilho: "Somente enviar Unidades de Medida"

Expressão na Fórmula Visual de gatilho: " this.Fields["CODUND"].AsString.Length <= 2 "

Filtro na Consulta SQL da Fórmula Visual de Carga: "... AND LEN(CODUND) <=2 "

 

Fluxo do Processo

 

Image Added


Mapeamento dos campos

 

  • Mensagem UnitOfMeasure 2.000

  

Mensagem Padrão

Descrição

RM

Tabela

Campo

Observação
CodeCódigo Unidade. MedidaTUNDCODUNDSão selecionados os 6 primeiros caracteres
InternalIdChave da EntidadeTUNDCODUND 
DescriptionDescrição Unidade MedidaTUNDDESCRICAO 

 

 

(Opcional)

Estrutura de Menu

 

<Informações utilizadas na linha Datasul>.

 

Procedimentos

 

Procedimento

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Módulo

 

 

 

Programa base

 

 

 

Nome Menu

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Registro padrão

Sim

Sim

Sim

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Release de Liberação

 

 

 

 

 

 

Programas

 

Programa

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Nome Externo

 

 

 

Nome Menu/Programa

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Nome Verbalizado[1]

(Max 254 posições)

(Max 254 posições)

(Max 254 posições)

Procedimento

 

 

 

Template

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

Tipo[2]

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Categoria[3]

 

 

 

Executa via RPC

Sim/Não

Sim/Não

Sim/Não

Registro padrão

Sim

Sim

Sim

Outro Produto

Não

Não

Não

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Query on-line

Sim/Não

Sim/Não

Sim/Não

Log Exec.

Sim/Não

Sim/Não

Sim/Não

Rotina (EMS)

 

 

 

Sub-Rotina (EMS)

 

 

 

Localização dentro da Sub Rotina (EMS)

 

 

 

Compact[4]

Sim/Não

Sim/Não

Sim/Não

Home[5]

Sim/Não

Sim/Não

Sim/Não

Posição do Portlet[6]

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

Informar os papeis com os quais o programa deve ser vinculado

 

 

 

 

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

 

Código Papel

(máx 3 posições)

Descrição em Português*

 

Descrição em Inglês*

 

[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.

[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante

[3] Categorias são obrigatórias para os programas FLEX.

[4] Obrigatório quando o projeto for FLEX

[5] Obrigatório quando o projeto for FLEX

[6] Obrigatório quando o projeto for FLEX

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