Histórico da Página
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 | Protheus | Módulo | SIGATMS |
Segmento Executor | Distribuição e Logística | ||
Projeto1 | LOGTMS01-608 | IRM1 |
|
Requisito1 |
| Subtarefa1 |
|
Chamado2 |
| ||
País | ( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||
Outros |
|
Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).
Objetivo
Integrar as informações dos cadastros de PRODUTOS, FORNECEDORES, CLIENTES, TRANSPORTADORAS e LOCAIS DE ENTREGAS, gerados pelo módulo SIGATMS (Transportation Management System) da linha Microsiga Protheus com o Datasul.
O Protheus usará como ferramenta de Integração o EAI (Enterprise Application Integrator), o EAI por sua vez, terá a responsabilidade de trafegar mensagens de XML entre o Protheus e o Datasul, além de fazer o controle de filas das mensagens a serem integradas.
Definição da Regra de Negócio
Para que se cumpra o objetivo deste requisito, deverá criar deverão ser criadas verificações para os processos de inclusão, alteração e exclusão dos itens relacionados, mantendo assim, tanto o SIGATMS quanto o DATASUL com as mesmas informações. Um tratamento importante será na exclusão do item cadastrado, onde o sistema deverá verificar se o mesmo esta atrelado a algum processo e/ou documento, evitando assim que o sistema perca a integridade de dados.
Abaixo Mapa Mental do processo.
informações idênticas, sempre assegurando a integridade dos dados.
O parâmetro MV_TMSERP deverá estar setado como "1", onde significa que o sistema integrará com outra marca, neste caso, o DATASUL, solicitando a inclusão, alteração e exclusão de registros e solicitando retorno em forma síncrona.
O Adapter EAI deve estar cadastrado, indicando o(s) cadastro(s) que integrará com a outra marca.
O sistema deverá tratar os cadastros com uma numeração única para os registros integrados, onde terá um código informado pelo DATASUL para ser atualizado também no registro de origem, permitindo assim, que pelo mesmo código possa ser consultado o registro tanto na origem como no destino.
Exemplo:
- Ao incluir, alterar ou excluir um registro, o sistema deverá verificar o parâmetro MV_TMSERP e se existe o Adapter EAI cadastrado para o determinado cadastro, verificando as seguintes situações:
- INCLUIR: Verificar se o registro já existe no destino, caso SIM, atualizar as informações de acordo com a origem, caso NÃO, incluir no destino e atualizar a origem com o código de numeração única disponibilizado pelo destino..
- ALTERAR: Verificar se registro já existe no destino, caso SIM, atualizar as informações de acordo com a origem, caso NÃO, incluir no destino e atualizar a origem com o código de numeração única disponibilizado pelo destino.
- EXCLUIR: Verificar se existe algum processo e/ou cadastro em que o registro esteja atrelado, tanto na origem, como no destino, caso SIM, notificar através de mensagem e não permitir a exclusão, caso NÃO, excluir na origem e no destino.
Abaixo fluxo básico do processo de atualização da numeração única.
.
Seguem as rotinas que devem ser alteradas
FONTE | TIPO OPERAÇÃO | TIPO | ACESSO MENU | DESCRIÇÃO | |||
---|---|---|---|---|---|---|---|
MATA010 | Alteração | Cadastro | |||||
FONTES | TIPO DE FONTE | TIPO DE OPERAÇÃO | OPÇÃO DE MENU | ||||
MATA010 - PRODUTOS | Cadastro | Alteração | Atualizações / Cadastros / Produtos | Cadastro de Produtos / Itens | |||
MATI010 | Alteração | Integração EAI | Alteração | Responsável por montar a mensagem de EAI | |||
MATA020 | Alteração | Cadastro | MATA020 - FORNECEDORES | Cadastro | Alteração | Atualizações / Cadastros / Fornecedores | Cadastro de Fornecedores |
MATI020 | Alteração | Integração EAI | Alteração | Responsável por montar a mensagem de EAI | |||
MATA030 | Alteração | Cadastro | MATA030 - CLIENTES | Cadastro | Alteração | Atualizações / Cadastros / Clientes | Cadastro de Clientes |
MATI030 | Alteração | Integração EAI | Alteração | Responsável por montar a mensagem de EAI | |||
MATA050 | AlteraçãoMATA050 - TRANSPORTADORAS | Cadastro | Alteração | Atualizações / Cadastros / Transportadoras | Cadastro de transportadoras | ||
MATI050 | Alteração | Integração EAI | Alteração | Responsável por montar a mensagem de EAI | |||
TMSA450 | InclusãoTMSA450 - LOCAIS DE ENTREGAS | Cadastro | Criação | Atualizações / SAC / Endereços de Solicitantes e ClientesS.A.C. / End.solic./cliente | Cadastro de locais de entregas | ||
TMSI450 | InclusãoTMSI450 | Integração EAI | Criação |
Exemplo de Aplicação:
Responsável por montar a mensagem de EAI |
Tabelas Utilizadas
- SE2 SB1 – Cadastro de Contas a PagarProdutos
- FI9 – Controle de Emissão de DARF>.
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
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*/
Índice | Chave |
01 | <FI9_FILIAL+FI9_IDDARF+FI9_STATUS> |
02 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF> |
03 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO> |
Campo | <AAA_PERESP> |
Tipo | <N> |
Tamanho | <6> |
Valor Inicial | <Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. |
Mandatório | Sim ( ) Não ( ) |
Descrição | <Referência Mínima para Cálculo> |
Título | <Ref.Calc.> |
Picture | <@E999.99> |
Help de Campo | <Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação> |
(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 |
- SA7 – Cadastro de Produtos X Clientes
- SA1 - Cadastro de Clientes
- SA2 - Cadastro de Fornecedores
- DUY - Cadastro de Regiões
- SYA - Cadastro de Países
- SA4 - Cadastro de Transportadoras
- CC2 - Cadastro de Municípios
- SX5 - Cadastro de Estados - Tabela 12
- CCH - Cadastro de País
- DUL - Cadastro de Endereço de Solicitantes e Clientes
- DUE - Cadastro de Solicitantes
Campo obrigatório para integração do cadastro de produtos:
TÍTULO | TAG / CAMPO TABELA | DESCRIÇÃO |
---|---|---|
Código da família | FamilyCode → B1_FPCODE | Código da família do produto |
Fluxo das operações INCLUSÃO, ALTERAÇÃO e EXCLUSÃO.
Informações de Campos e TAGs
Cadastro de PRODUTOS
CAMPO DATASUL | CAMPO PROTHEUS | TIPO |
Entity | Item | Variável |
Event | cEvent | Variável |
key | B1_COD | Campo Base |
CompanyId | EmpAnt | Variável |
BranchId | B1_FILIAL | Campo Base |
CompanyInternalId | EmpAnt + | + FilAnt | Variável |
Code | B1_COD | Campo Base |
InternalId | EmpAnt + B1_COD | Variável + Campo Base |
Name | B1_DESC | Campo Base |
ShortName | B1_DESC | Campo Base |
Active | ProdActiv | Variável |
StockGroupCode | B1_GRUPO | Campo Base |
StockGroupInternalId | B1_GRUPO | Campo Base |
StockGroupDescription | B1_GRUPO | Campo Base |
UnitOfMeasureCode | B1_UM | Campo Base |
UnitOfMeasureInternalId | EmpAnt + | + B1_UM | Variável + Campo Base |
StandardWarehouseCode | B1_LOCPAD | Campo Base |
StandardWarehouseInternalId | B1_LOCPAD | Campo Base |
StandardWarehouseDescription | B1_LOCPAD | Campo Base |
EconomicLot | B1_LE | Campo Base |
MinimumLot | B1_LM | Campo Base |
NetWeight | B1_PESO | Campo Base |
GrossWeight | B1_PESBRU | Campo Base |
Origin | B1_ORIGEM | Campo Base |
FamilyCode | B1_FPCOD | Campo Base |
FamilyInternalId | EmpAnt + | + SYC + | + B1_FPCOD | Variável + Campo Base |
FamilyDescription | B1_FPCOD | Campo Base |
ProductType | B1_TIPO | Campo Base |
Trail | B1_RASTRO | Campo Base |
SecondUnitOfMeasureCode | B1_SEGUM | Campo Base |
SecondUnitOfMeasureInternalId | B1_SEGUM | Campo Base |
MultiplicationFactorValue | B1_CONV | Campo Base |
CostPrice | PrecoCusto | Variável |
SalesPrice | B1_PRV1 | Campo Base |
AverageCostPrice | B2_CM1 | Campo Base |
StandardCostPrice | BZ_CUSTD | Campo Base |
CustomerCode | A7_CLIENTE | Campo Base |
CustomerInternalId | A7_CLIENTE + A1_LOJA | Campo Base |
GovernmentalInformation (INSCRICAO ESTADUAL) | A1_INSCR | Campo Base |
GovernmentalInformation (INSCRICAO MUNICIPAL) | A1_INSCRM | Campo Base |
GovernmentalInformation (CPF ou CNPJ) | A1_CGC | Campo Base |
GovernmentalInformation (SUFRAMA) | A1_SUFRAMA | Campo Base |
CustomerItemCode | A7_CODCLI | Campo Base |
CustomerItemInternalId | A7_CODCLI | Campo Base |
Cadastro de TRANSPORTADORAS
CAMPO DATASUL | CAMPO PROTHEUS | TIPO |
---|---|---|
Entity | Carrier | Variável |
Event | cEvent | Variável |
key | A4_COD | Campo Base |
CompanyId | EmpAnt | Variável |
Code | A4_COD | Campo Base |
ShortName | A4_NREDUZ | Campo Base |
Name | A4_NOME | Campo Base |
InternalId | A4_COD | Campo Base |
GovernmentalInformation (INSCRICAO ESTADUAL) | A4_INSEST | Campo Base |
GovernmentalInformation (SUFRAMA) | A4_SUFRAMA | Campo Base |
GovernmentalInformation (CPF ou CNPJ) | A4_CGC | Campo Base |
Address | A4_END (L) | Campo Base |
Number | A4_END (N) | Campo Base |
Complement | A4_COMPLEM | Campo Base |
Code (City) | A4_COD_MUN | Campo Base |
Description | A4_EST | Campo Base |
District | A4_BAIRRO | Campo Base |
Code (State) | A4_EST | Campo Base |
Code (Country) | cCountryCode | Variável |
Description | cCountryDsc | Variável |
ZIPCode | A4_CEP | Campo Base |
PhoneNumber | cTel | Variável |
HomePage | A4_HPAGE | Campo Base |
A4_EMAIL | Campo Base |
Cadastro de FORNECEDORES
CAMPO DATASUL | CAMPO PROTHEUS | TIPO |
---|---|---|
Entity | CustomerVendor | Variável |
Event | cEvent | Variável |
key | A2_COD + A2_LOJA | Campo Base |
CompanyId | EmpAnt | Variável |
BranchId | xFilial | Variável |
BranchInternalId | cEmpAnt + | + cFilAnt | Variável |
CompanyInternalId | cEmpAnt + | + cFilAnt | Variável |
Code | A2_COD | Campo Base |
StoreId | A2_LOJA | Campo Base |
InternalId | A2_COD + A2_LOJA | Campo Base |
ShortName | A2_NREDUZ | Campo Base |
Name | A2_NOME | Campo Base |
Type | Vendor | Fixo |
EntityType | Person (CPF) ou Company (CNPJ) | Campo Base |
RegisterSituation | Inactive ou Active | Campo Base |
GovernmentalInformation (INSCRICAO ESTADUAL) | A2_INSCR | Campo Base |
GovernmentalInformation (INSCRICAO MUNICIPAL) | A2_INSCRM | Campo Base |
GovernmentalInformation (CPF ou CNPJ) | A2_CGC | Campo Base |
Address | A2_END (L) | Campo Base |
Number | A2_END (N) | Campo Base |
Complement | A2_COMPLEM | Campo Base |
District | A2_BAIRRO | Campo Base |
CityCode | A2_COD_MUN | Campo Base |
CityDescription | A2_MUN | Campo Base |
StateCode | A2_EST | Campo Base |
StateInternalId | A2_EST | Campo Base |
StateDescription | X5DESCRI | Variável |
CountryCode | A2_PAIS | Campo Base |
CountryInternalId | A2_PAIS | Campo Base |
ZIPCode | A2_CEP | Campo Base |
POBox | A2_CX_POST | Campo Base |
A2_EMAIL | Campo Base | |
PhoneNumber | A2_TEL | Campo Base |
FaxNumber | A2_FAX | Campo Base |
HomePage | A2_HPAGE | Campo Base |
Contact (Name) | A2_CONTATO | Campo Base |
BankCode | A2_BANCO | Campo Base |
BankInternalId | A2_BANCO + A2_AGENCIA + A2_NUMCON | Campo Base |
BankName | cBcoName | Variável |
BranchCode | A2_AGENCIA | Campo Base |
BranchKey | A2_DVAGE | Campo Base |
CheckingAccountNumber | A2_NUMCON ou A2_DVCTA | Campo Base |
CheckingAccountType | A2_TIPCTA | Campo Base |
MainAccount | 1 | Fixo |
CurrencyAccount | 01 | Fixo |
Cadastro de CLIENTES
CAMPO DATASUL | CAMPO PROTHEUS | TIPO |
Entity | CustomerVendor | Variável |
Event | cEvent | Variável |
key | A1_COD + A1_LOJA | Campo Base |
CompanyId | EmpAnt | Variável |
BranchId | xFilial | Variável |
BranchInternalId | cEmpAnt + | + cFilAnt | Variável |
CompanyInternalId | cEmpAnt + | + cFilAnt | Variável |
Code | A1_COD | Campo Base |
StoreId | A1_LOJA | Campo Base |
InternalId | A1_COD + A1_LOJA | Campo Base |
ShortName | A1_NREDUZ | Campo Base |
Name | A1_NOME | Campo Base |
Type | Customer | Fixo |
EntityType | Person (CPF) ou Company (CNPJ) | Campo Base |
RegisterDate | A1_DTNASC | Campo Base |
RegisterSituation | Inactive ou Active | Campo Base |
GovernmentalInformation (INSCRICAO ESTADUAL) | A1_INSCR | Campo Base |
GovernmentalInformation (INSCRICAO MUNICIPAL) | A1_INSCRM | Campo Base |
GovernmentalInformation (CPF ou CNPJ) | A1_CGC | Campo Base |
Address | A1_END (L) | Campo Base |
Number | A1_END (N) | Campo Base |
Complement | A1_COMPLEM | Campo Base |
District | A1_BAIRRO | Campo Base |
CityCode | A1_COD_MUN | Campo Base |
CityDescription | A1_MUN | Campo Base |
StateCode | A1_EST | Campo Base |
StateInternalId | A1_EST | Campo Base |
StateDescription | X5DESCRI | Variável |
CountryCode | A1_PAIS | Campo Base |
CountryInternalId | A1_PAIS | Campo Base |
ZIPCode | A1_CEP | Campo Base |
POBox | A1_CX_POST | Campo Base |
ShippingAddress (Address) | A1_ENDENT (L) | Campo Base |
ShippingAddress (Number) | A1_ENDENT (N) | Campo Base |
ShippingAddress (Complement) | A1_ENDENT (C) | Campo Base |
ShippingAddress (CityCode) | cCodMunE | Variável |
ShippingAddress (CityDescription) | A1_MUNE | Campo Base |
ShippingAddress (District) | A1_BAIRROE | Campo Base |
ShippingAddress (StateCode) | A1_ESTE | Campo Base |
ShippingAddress (ZipCode) | A1_CEPE | Campo Base |
PhoneNumber | A1_TEL | Campo Base |
FaxNumber | A1_FAX | Campo Base |
HomePage | A1_HPAGE | Campo Base |
A1_EMAIL | Campo Base | |
ContactInformationName | A1_CONTATO | Campo Base |
BillingInformation (Address) | A1_ENDCOB (L) | Campo Base |
BillingInformation (Number) | A1_ENDCOB (N) | Campo Base |
BillingInformation (Complement) | A1_ENDCOB (C) | Campo Base |
BillingInformation (CityDescription) | A1_MUNC | Campo Base |
BillingInformation (District) | A1_BAIRROC | Campo Base |
BillingInformation (StateCode) | A1_ESTC | Campo Base |
BillingInformation (ZipCode) | A1_CEPC | Campo Base |
VendorInformation (Code) | A1_VEND | Campo Base |
CreditLimit | A1_LC | Campo Base |
Cadastro de LOCAIS DE ENTREGAS
CAMPO DATASUL | CAMPO PROTHEUS | TIPO |
Entity | CUSTOMERSHIPPINGADDRESS | Campo Base |
Event | cEvent | Variável + Campo Base |
key (InternalId) | xFilial + | + DUL_SEQEND | Variável + Campo Base |
CompanyId | cEmpAnt | Variável |
BranchId | cFilAnt | Variável |
CompanyInternalId | cEmpAnt | Variável |
BranchInternalId | cEmpAnt + | + cFilAnt | Variável |
CustomerCode | DUL_CODCLI | Campo Base |
InternalId | cInternalId | Variável |
GovernmentalInformation (INSCRICAO ESTADUAL) | DUL_INSCR | Campo Base |
GovernmentalInformation (INSCRICAO MUNICIPAL) | "" | Branco |
GovernmentalInformation (CPF ou CNPJ) | DUL_CGC | Campo Base |
Code | DUL_SEQEND | Campo Base |
ExternalId | "" | Branco |
ShippingAddress (Address) | DUL_END (L) | Campo Base |
ShippingAddress (Number) | DUL_END (N) | Campo Base |
ShippingAddress (Complement) | "" | Branco |
ShippingAddress (District) | DUL_BAIRRO | Campo Base |
ShippingAddress (ZipCode) | DUL_CEP | Campo Base |
ShippingAddress (Region) | DUY_DESCRI | Campo Base |
ShippingAddress (POBox) | "" | Branco |
ShippingAddress (CityCode) | DUL_CODMUN | Campo Base |
ShippingAddress (CityInternalID) | cFilAnt + DUL_CODMUN | Variável + Campo Base |
ShippingAddress (CityDescription) | DUL_MUN | Campo Base |
ShippingAddress (StateCode) | DUL_CODMUN | Campo Base |
ShippingAddress (StateInternalID) | cFilAnt + DUL_EST | Variável + Campo Base |
ShippingAddress (StateDescription) | X5_DESCRI | Campo Base |
ShippingAddress (CountryCode) | A1_PAIS | Campo Base |
ShippingAddress (CountryInternalID) | cFilAnt + A1_PAIS | Variável + Campo Base |
ShippingAddress (CountryDescription) | YA_DESCR | Campo Base |
(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
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|