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 | 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 |
|
Requisito1 |
| Subtarefa1 |
|
Chamado2 |
| ||
Release de Entrega Planejada | 12.1.10 | Réplica |
|
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 Produto com o PDV, viabilizando assim o CRUD completo do cadastro por envio de mensagem de integração.
(Obrigatório)
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 Produto (Item), 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 |
Produto | Inclusão/Alteração/Exclusão | RM \ BackOffice \ Gestão de Estoque, Compras e Faturamento \ Cadastros \ Estoque, Compras e Faturamento \ Produto | - |
- Pasta Identificação: Código do Produto, Data Cadastramento, Inativo, Nome fantasia, Tipo
- Pasta Detalhes / Descrição: Descrição
- Pasta Detalhes / Características: Peso Bruto, Peso Líquido
- Pasta Detalhe / Outros Dados: Ref.
- Pasta Preço: Preço à Prazo / Preço, Preço à Vista / Data-Base, Preço à vista / Preço
- Pasta Controle de Estoque: Controlado por lote, Unidade de Controle, Usa número de série
- Pasta Custos: Custo Médio / Valor, Custo unitário / Valor
- Pasta Informações por Filial / Editar o registro da respectiva Filial: Consignado
- Anexos / Informações do Estoque: Lote Econômico de Compras
Para integrar o cadastro de Produto os seguinte itens abaixo devem ser considerados:
- A configuração de compartilhamento de cadastros entre Empresas e Filiais para a entidade Item deve ser: Exclusivo por Empresa e Compartilhado por Filial.
- Serão enviados para o PROTHEUS somente os Produtos/Serviços de Último Nível.
- Caso a integração esteja ativa, não será permitido o cadastramento de produtos controlados por lote e série, devendo ser selecionada somente uma das opções.
- Produtos globais no BackOffice RM não serão considerados globais no sistema de destino, sendo enviada uma mensagem de inclusão para cada empresa a qual o produto faz parte.
- Caso haja ao menos uma mensagem enviada com sucesso ao SigaMNT, mesmo havendo erro nas mensagens referentes ao produto para as outras coligadas, não será apresentada mensagem de erro e a alteração/inclusão não será desfeita.
- Não serão enviadas informações de Cliente/Fornecedor do Produto.
- O campo B1_CODITE no cadastro de Produtos do PROTHEUS deve ser alterado, via apsdu, para não obrigatório e também deve-se retirar sua validação.
- O campo “Código do Produto” no PROTHEUS deve ser alterado para tamanho 30 caracteres para manter compatibilidade com o RM.
Tabelas Utilizadas
- TPRODUTO - Produtos Globais.
- TPRODUTODEF - Dados dos Produtos Globais por Coligada
- TPRDLOCINFO - Informações do Estoque
- TPRDFIL - Filiais de Um Produto
Entidades de Integração
- DataServer envolvido
- EstPrdDataBR EstPrdDataBR
- Transformação
- Id: Item
- Versão: 2.000
- Fluxo da mensagem
- Saída
- Tipo de Envio:
- Síncrono.
- Extension: 4d87df6a fa9d371c-0c528672-43d143a4-bff2-f0cf4c498875
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
- 9c63-56fbeee215b0
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
Mapeamento dos Campos
- Mensagem Item 2.000
Mensagem Padrão | Descrição | RM | |||||
Tabela | Campo | Observação | |||||
CompanyId | Código da coligada | TPRODUTO | CODCOLIGADA | Código da Coligada é obtido a partir do De-Para de Filial. | |||
BranchId | Código da filial | - | - | ||||
CompanyInternalId | InternalId da filial |
| |||||
Code | Código do Item | TPRODUTO | CODIGOPRD | Valor texto tamanho 30 | |||
InternalId | Chave primária do registro | TPRODUTO | CODCOLIGADA|IDPRD |
| |||
Name | Nome do Produto | TPRODUTO | DESCRICAO | ||||
ShorName | Nome curto | TPRODUTO | NOMEFANTASIA |
| |||
Active | Item Ativo? | TPRODUTO | INATIVO | Fixo “0”: Ativo Fixo “1”: Inativo | |||
StockGroupCode | Código Grupo Estoque |
|
| Não utilizado pela linha RM | |||
StockGroupInternalId | InternalId da chave completa de Grupo de Estoque do produto |
|
| Não utilizado pela linha RM | |||
StockGroupDescription | Descrição Grupo Estoque |
|
| Não utilizado pela linha RM | |||
UnitOfMeasureCode | Código Unidade Medida | TPRODUTODEF | CODUNDCONTROLE | Valor texto tamanho 6 | |||
UnitOfMeasureInternalId | InternalId da chave completa de Unidade Medida do produto | TPRODUTODEF | CODUNDCONTROLE | ||||
ObtainingType | Forma de Obtenção | Não utilizado pela linha RM | |||||
ComercialFamilyCode | Código Família Comercial | Não utilizado pela linha RM | |||||
ComercialFamilyInternalId | InternalId da chave completa de Família Comercial do produto | Não utilizado pela linha RM | |||||
ComercialFamilyDescription | Descrição Família Comercial | Não utilizado pela linha RM | |||||
DeployDate | Data Implantação | TPRODUTO | DTCADASTRAMENTO | Este será enviado somente na alteração do cadastro do produto, pois este campo é atualizado no Dataserver EstPrdData somente após a inclusão do registro na base (afterupdate). | |||
ReleaseDate | Data Liberação | Não utilizado pela linha RM | |||||
StandardWarehouseCode | Código Depósito Padrão | Não utilizado pela linha RM | |||||
StandardWarehouseInternalId | InternalId da chave completa de Depósito Padrão do produto | Não utilizado pela linha RM | |||||
StandardWarehouseDescription | Descrição Depósito Padrão | Não utilizado pela linha RM | |||||
MultipleLot | Lote Múltiplo | Não utilizado pela linha RM | |||||
EconomicLot | Lote Econômico | TPRDLOCINFO | LOTEECONCOMPRAS | Estas informações serão enviadas somente na alteração do cadastro de Produto, pois trata-se de outro DataServer (anexo Informações do Estoque). | |||
MinimumLot | Lote Mínimo | Não utilizado pela linha RM | |||||
QualityControl | Controla Qualidade | Não utilizado pela linha RM | |||||
ControlType | Tipo Controle | TPRDFIL | CONSIGNADO | Será considerada somente a informação da primeira filial, uma vez que ao incluir um produto são criados registros para todas as filiais ativas. São utilizados os campos em negrito. Fixo 1 – Físico Fixo 2 – Total Fixo 3 – Consignado Fixo 4 – Débito Direto Fixo 5 – Não Definido | |||
StockControlType | Tipo Controle Estoque | TPRODUTODEF | USANUMSERIE CONTROLADOPORLOTE | No cadastro de Produto \ Pasta Controle de Estoque é permitido selecionar as duas informações simultaneamente, Número de Série e Lote. Como a mensagem não comporta esta situação não será permitido selecionar as duas opções. Caso o usuário marque as duas opções será emitida uma mensagem de exceção e o registro não será salvo. Fixo 1 – Serial Fixo 2 – Número Série Fixo 3 – Lote Fixo 4 – Referência | |||
FractionalQuantity | Quantidade Fracionada | Não utilizado pela linha RM | |||||
NetWeight | Peso Líquido | TPRODUTO | PESOLIQUIDO | ||||
GrossWeight | Peso Bruto | TPRODUTO | PESOBRUTO | ||||
FamilyCode | Código Família | Não utilizado pela linha RM | |||||
FamilyInternalId | InternalId da chave completa de Família do produto | Não utilizado pela linha RM | |||||
FamilyDescription | Descrição Família | Não utilizado pela linha RM | |||||
FormulaType | Tipo Fórmula | Não utilizado pela linha RM | |||||
PerMillion | Valor Per PPM | Não utilizado pela linha RM | |||||
IsScrapStockControl | Controla Estoque Refugo | Não utilizado pela linha RM | |||||
IsScrapFiscalPrice | Refugo ao Preço Fiscal | Não utilizado pela linha RM | |||||
ScrapItemCode | Código Item Refugo | Não utilizado pela linha RM | |||||
ScrapItemInternalId | InternalId da chave completa de Item Refugo do produto | Não utilizado pela linha RM | |||||
ScrapItemQuantity | Quantidade Item Refugo | Não utilizado pela linha RM | |||||
Origin | Origem da mercadoria | TPRODUTO | REFERENCIACP | Fixo 0 – Nacional Fixo 1 - Estrangeira - Importação direta Fixo 2 - Estrangeira - Adquirida no mercado externo | |||
CostCenterCode | Código do Centro de Custo | Não utilizado pela linha RM | |||||
CostCenterInternalId | InternalId do CostCenterCode | Não utilizado pela linha RM | |||||
GroupCode | Não utilizado pela linha RM | ||||||
GroupInternalId | InternalId do GroupCode | Não utilizado pela linha RM | |||||
GroupName | Não utilizado pela linha RM | ||||||
SecondUnitOfMeasureCode | Segunda Unidade de Medida Utilizada para converter a quantidade para uma segunda unidade | Não utilizado pela linha RM | |||||
SecondUnitOfMeasureInternalId | InternalId do SecondUnitOfMeasureCode | Não utilizado pela linha RM | |||||
MultiplicationFactorValue | Fator multiplicador da conversão para a segunda unidade de medida | Não utilizado pela linha RM | |||||
ProductType | Tipo de produto | TPRODUTO | TIPO | Fixo 01 – Ativo Imobilizado Fixo 02 – Beneficiamento Fixo 03 – Embalagem Fixo 04 – Gastos Gerais Fixo 05 – Material de Consumo Fixo 06 – Mercadoria: enviado quando Tipo Produto = Produto Fixo 07 – Mão-De-Obra: enviado quando Tipo Produto = Serviço Fixo 08 – Matéria-Prima Fixo 09 – Outros Insumos Fixo 10 – Produto Acabado Fixo 11 – Produto Intermediario Fixo 12 – Produto em Processo Fixo 13 – Produto Veiculo Fixo 14 – Selo de Controle Fixo 15 – SubProduto | |||
FiscalInformation | Este campos não estão sendo enviados pelo RM pelos seguintes motivos:
| ||||||
FiscalClassificationCode | Código Classificação Fiscal | Não enviado pelo RM | |||||
FiscalClassificationInternalId | InternalId do FiscalClassificationCode | Não enviado pelo RM | |||||
FiscalClassificationDescription | Descrição Classificação Fiscal | Não enviado pelo RM | |||||
ListOfCustomerItemInformation \ CustomerItemInformation | Estas informações não serão enviadas, pois o adapter do PROTHEUS está implementado para receber a mensagem | ||||||
CustomerCode | Código do cliente |
|
| ||||
CustomerInternalId | InternalId do CustomerCode | ||||||
CustomerItemCode | Código do Item X Cliente | ||||||
CustomerItemInternalId | InternalId do CustomerItemCode | ||||||
Values \ ValuesType | |||||||
CostPrice | Preço de Custo | TPRODUTODEF | PRECO1 | ||||
SalesPrice | Preço de Venda | TPRODUTODEF | PRECO2 | ||||
AverageCostPrice | Preço Médio de Custo | TPRODUTODEF | CUSTOMEDIO | ||||
StandardCostPrice | Preço Padrão | TPRODUTODEF | CUSTOUNITARIO | ||||
BaseDate | Data Base do Calculo dos preços | TPRODUTODEF | DATABASEPRECO1 | No cadastro de Produto RM existem 5 tipos de preços e para cada preço existe uma data base de cálculo. Será considerada na mensagem somente a primeira data base do cálculo de preço . |
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> |
Não utilizado pela 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 |
(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. |
---|