Histórico da Página
ENVIAR NÚMERO NO FABRICANTE DO PRODUTO / INTEGRAÇÕES SIGAMNT
Informações Gerais
Linha de Produto: | RM | |||||||||
Segmento Executor: | Construção e Projetos | |||||||||
Módulo: | TOTVS Gestão de Estoque, Compras e Faturamento | |||||||||
Rotina: |
|
|
| |||
Chamado/Ticket: |
752823. | |||
Requisito/Story/Issue: | MATESTCNTFTOF01-358/MATESTCNTFTOF01-513 | ||
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>. |
Objetivo
Enviar
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 de Produto com informação do Número no Fabricante, 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 Manutenção de Ativos 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 |
Alteração |
[Atualizações -> Acadêmico-> Tesouraria]
-
[ACAA050 – Negociação Financeira]
[Envolvida]
[Atualizações -> Acadêmico-> Tesouraria]
-
[ACAA060 – Cadastro de Pedidos]
[Criação]
[Atualizações -> Acadêmico-> Cadastros]
-
RM \ BackOffice \ Gestão de Estoque, Compras e Faturamento \ Cadastros \ Produto | - | ||
Configurador de Integração | Alteração | RM \ Integração \ Ferramentas \ Configurar | - |
Regras de Integridade:
Para a integração desta nova mensagem única de Produto serão realizadas as seguintes ações:Para que o usuário possa consultar a informação de número do produto no fabricante, ao incluir insumos em uma Ordem de Manutenção (OS) no Manutenção de Ativos (SigaMNT), será necessário criar uma nova versão da mensagem única Item. Deve-se utilizar a mensagem única Item versão 4.002.
- Criar a mensagem única Item versão 43.002 007 (xsd) e adicionar o campo “ManufacturerNumber”“ManufacturerCode”. Este campo deve ser do tipo string.
- Neste campo será trafegada informação do campo Número no Fabricante do cadastro de Produto do RM (TPRODUTODEF.NUMNOFABRIC).
- Esta informação deverá ser gravada no campo "B1_FABRIC" da tabela de Produtos do Protheus (SB1).
- Atualizar o Configurador de Integração do RM para contemplar esta nova versão da mensagem Item para a Integração Manutenção de Ativos x BackOffice RM.
- Atualizar o cadastro de Transformação do RM para contemplar esta nova versão da mensagem Item.
- Atualizar a Fórmula Visual de Integração da mensagem Item para considerar a versão 3.007.
- Atualizar a Fórmula Visual de Sincronização de produto para considerar a versão 3.007.
Configurador de Integrações
Tendo em vista que um cliente pode utilizar dois projetos de integração ativos com o BackOffice RM, será necessário realizar a seguinte atualização no Configurador de Integrações:
- Projeto de Integração Manutenção de Ativos x BackOffice RM
- Apaga a mensagem ITEM versão 2.000 caso exista;
- Insere a versão 3.007 da mensagem ITEM caso ainda não exista para integração Manutenção de Ativos(SigaMNT) e TOTVS PDV.
- Projeto de Integração TOTVS PDV x BackOffice RM
- Apaga a mensagem ITEM versão 2.000 caso exista para a integração Manutenção de Ativos(SigaMNT).
- Apaga a mensagem ITEM versão 3.004 caso exista para a integração TOTVS PDV.
- Insere a versão 3.007 da mensagem ITEM caso ainda não exista para integração Manutenção de Ativos(SigaMNT) e TOTVS PDV.
Desta forma, a partir da versão 12.1.18 as integrações com o BackOffice RM do TOTVS PDV e Manutenção de Ativos passam a utilizar a versão 3.007 da mensagem única ITEM.
Ponto de atenção:
- Não será integrado o campo Código do Fabricante do Produto.
- No RM o Número do Fabricante possui tamanho de 100 caracteres. Caso este O campo Fabricante no Protheus possua um tamanho menor, deve-se tratar no recebimento da mensagem a restrição para este campo quando for maior do que o permitido no Protheuspossue por padrão o tamanho de 20 caracteres. Caso o Número do Fabricante no RM possuir mais do que 20 caracteres, é necessário altera o tamanho do campo B1_FABRIC no Protheus (via configurador SIGACFG) para ter o mesmo tamanho do RM.
- O envio da mensagem Item_ 43.002 007 do RM para o Protheus contemplará todos os campos enviados na mensagem Item_3.004 mais a informação da tag ManufacturerNumberManufacturerCode. Os demais campos não serão considerados neste momento.
Tabelas Utilizadas
- TPRODUTODEF – Dados dos Produtos Globais por Coligada.
- HCTRANSFORMACAO – Transformação Mensagem Única TOTVS.
- HCMAPAINTEGRACAO – Tabela de mapeamento das entidades para cada Integração.
(Opcional)
Procedimento para Utilização
<Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações;
Localização da rotina no menu;
Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
Caso seja necessário ter algum cadastro feito previamente, faça uma observação
Se necessário, utilizar prints de tela>.
Procedimento para Configuração
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
Entidades de Integração
- Transformação
- Identificador da Mensagem: Item
- Versão: 3_007
- Tipo do Server: DataServer
- DataServer: EstPrdDataBR
- Source Code(GUID):
- Fluxo da mensagem: Saída
- Tipo de Envio: Síncrono.
- Mandatário: BackOffice RM.
Procedimento para Configuração
CONFIGURAÇÃO DE INTEGRAÇÃO
- No RM, acesse Integração/Ferramentas/Configurar.
- Na janela Assistente de Configuração de Integração avance para a etapa Configuração do banco de dados e informe Usuário e Senha para conectar ao banco. Teste a conexão e avance.
- Na etapa Projetos de Integração selecione o item Manutenção de Ativos x BackOffice RM, avance e execute o assistente.
- No PROTHEUS acesse No Configurador (SIGACFG), acesse AmbientesAmbiente/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)Schedule/Adapter E.A.I . Crie o adapter ITEM conforme dados a seguir:
Itens/Pastas | Descrição |
Mensagem Única: | Sim |
Rotina: | MATA010 |
Mensagem: |
ITEM |
Envia: |
Informe o Tipo do parâmetro
Cont. Por.:
Informe o Conteúdo padrão
Descrição:
CONFIGURAÇÃO DE MENUS
2. No
Não | |
Recebe: | Sim |
Método: | Síncrono |
Operação: | 1 - Todas |
Canal Envio: | 2 - EAI |
Versão Envio: | 3.007 |
3. Número do Fabricante possuir o mesmo tamanho no RM e no PROTHEUS
- Acesse Configurador (SIGACFG),
- acesse
- Base de Dados/
Menu | Informe o Menu em que estará localizada a rotina |
Submenu | Informe o Submenu em que estará localizada a rotina |
Nome da Rotina | Informe o Título da rotina |
Programa | Informe o Fonte da rotina |
Módulo | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” |
Tipo | Informe a Função |
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>
...
- Dicionário/Base de Dados.
- Selecione Dicionários de Dados e pesquise a tabela SB1.
- Edite a tabela SB1 e pesquise pelo campo B1_FABRIC
- Edite o campo B1_FABRIC e no campo Tamanho informe o valor 100.
- Salve a alteração e atualize a base de dados com a alteração.
Procedimento para Utilização
- No Gestão de Estoque, Compras e Faturamento cadastrar um Produto e informar o Número do Fabricante.
- No Manutenção de Ativos acessar o cadastro de Produto e verificar que a informação foi gravada no campo Fabricante da pasta Outros.
Mapeamento dos Campos
- Mensagem Item 3.007
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 | |||
BranchInternalId | InternalId do Estabelecimento/Filial | - | - | Não utilizado nesta integração. |
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 | |
Detail | Detalhes do item | Não utilizado nesta integração. | ||
Active | Item Ativo? | TPRODUTO | INATIVO | Quando TPRODUTO.INATIVO igual a 0 (zero) envia na tag o valor 1 - Ativo. Quando TPRODUTO.INATIVO igual a 1 (um) envia na tag o valor 0 - Inativo. |
StockGroupCode | Código Grupo Estoque | Não utilizado nesta integração. | ||
StockGroupInternalId | InternalId da chave completa de Grupo de Estoque do produto | Não utilizado nesta integração. | ||
StockGroupDescription | Descrição Grupo Estoque | Não utilizado nesta integração. | ||
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 | ||
DeployDate | Data Implantação | TPRODUTO | DTCADASTRAMENTO | |
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 | Não utilizado pela linha RM | ||
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 ou CONTROLADOPORLOTE | São utilizados os campos em negrito. Fixo 1 – Serial Fixo 2 – Número Série (TPRODUTODEF.USANUMSERIE: Indica se utiliza número de série) Fixo 3 – Lote (TPRODUTODEF.CONTROLADOPORLOTE: Controlado por lote.) Fixo 4 – Referência Fixo 5 – Não Definido |
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 | ||
FamilyClassificationCode | Classificaçãio da Família de Materiais | 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 |
FiscalInformation | Ver FiscalInformationType | |||
ListOfCustomerItemInformation | Ver CustomerItemInformation \ CustomerItemInformationType | |||
CostCenterCode | Código do Centro de Custo | Não utilizado pela linha RM | ||
CostCenterInternalId | InternalId do CostCenterCode | Não utilizado pela linha RM | ||
ListOfComercialFamilyItem | Lista de códigos de famílias(categorias) com produto | Ver ComercialFamilyItemType | ||
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 | TPRODUTODEF | CODUNDCOMPRA | |
SecondUnitOfMeasureInternalId | InternalId do SecondUnitOfMeasureCode | TPRODUTODEF | CODUNDCOMPRA | |
MultiplicationFactorValue | Fator multiplicador da conversão para a segunda unidade de medida | Não utilizado pela linha RM | ||
Values | Ver Values \ ValuesType | |||
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 Fixo 16 – Insumo Agrícola Fixo 18 – Produtos Industriais Fixo 19 – Insumo Industriais Fixo 20 – Serviço Fixo 21 – Genérico Fixo 22 – Produzido Fixo 23 – Comprado Fixo 24 – Fantasma Fixo 25 – Beneficiado Fixo 26 – Final |
Trail | Rastro por lote ou Sublote, sem rastro | TPRODUTO | CONTROLADOPORLOTE | O valor do campo segue a lógica abaixo: Se controla estoque por Lote Marcado = Valor 'L' (Controlado por Lote) Se controla estoque por Lote Desmarcado = Valor 'N' (Não utiliza rastro) |
BinControl | Campo que identifica se o produto possui localização(Endereço/Numero de Serie) | TPRODUTO | USANUMSERIE | O valor do campo segue a lógica abaixo: Se controla estoque por Nº de Série Marcado = Valor 'true' (Controla Nº de Série) Se controla estoque por Nº de Série Desmarcado = Valor 'false' (Não controla Nº de Série) |
GovernmentCode | Código Item | Não utilizado nesta integração. | ||
ItemTypeCode | Código do Tipo de Produto | TPRODUTO | CODTB1FAT | Não utilizado nesta integração. |
ItemTypeInternalId | InternalId da chave completa do Tipo de Produto | TPRODUTO | CODCOLIGADA|CODTB1FAT | Não utilizado nesta integração. |
ListOfGenericPrices | Lista de Preços do Produto | Ver ListOfGenericPricesType | ||
ListOfBarCode | Lista de Códigos de Barra | Ver ListOfBarCodeType | ||
FiscalInformationType | Informações fiscais do Item | Ver FiscalInformation\FiscalClassificationType | ||
CustomerItemInformationType | Amarração Cliente X Item | Ver ListOfCustomerItemInformation \ CustomerItemInformation | ||
FiscalInformationType | Informações fiscais do Item | |||
FiscalInformation \ FiscalClassificationType | Este campos não estão sendo enviados pelo RM pelos seguintes motivos:
| |||
FiscalClassificationCode | Código Classificação Fiscal | TPRODUTO | NCM | |
FiscalClassificationInternalId | InternalId do FiscalClassificationCode | Não enviado pelo RM | ||
FiscalClassificationDescription | Descrição Classificação Fiscal | Não enviado pelo RM | ||
PisRetaining | Indica se retém PIS | Não enviado pelo RM | ||
PisAliquot | Alíquota de PIS | Não enviado pelo RM | ||
CofinsRetaining | Indica se retém COFINS | Não enviado pelo RM | ||
CofinsAliquot | Alíquota de COFINS | Não enviado pelo RM | ||
CsllRetaining | Indica se retém CSLL | Não enviado pelo RM | ||
CsllAliquot | Alíquota de CSLL | Não enviado pelo RM | ||
IrrfIncidence | Indica se tem incidência de IRRF | Não enviado pelo RM | ||
IssAliquot | Alíquota de ISS | Não enviado pelo RM | ||
IssServiceCode | Código de Serviço do ISS | Não enviado pelo RM | ||
MunicipalTaxCode | Código de Tributação Municipal | Não enviado pelo RM | ||
TaxSubstitutionCode | Código Especificador da Substituição Tributária (CEST) | Não enviado pelo RM | ||
ListOfCustomerItemInformation \ CustomerItemInformation | Não utilizados nesta integração | |||
CustomerCode | Código do cliente | Não utilizados nesta integração | ||
CustomerInternalId | InternalId do CustomerCode | Não utilizados nesta integração | ||
GovernmentalInformation | CNPJ/CPF e Inscrição estadual do cliente/fornecedor | Não utilizados nesta integração | ||
CustomerItemCode | Código do Item X Cliente | Não utilizados nesta integração | ||
CustomerItemInternalId | InternalId do CustomerItemCode | Não utilizados nesta integração | ||
Values \ ValuesType | ||||
CostPrice | Preço de Custo | TPRODUTODEF | PRECO1 | Os demais campos de Preço do produto são enviados na tag ListOfGenericPrices |
SalesPrice | Preço de Venda | TPRODUTODEF | PRECO2 | Os demais campos de Preço do produto são enviados na tag ListOfGenericPrices |
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 | Os demais campos de Data-Base do Preço do produto são enviados na tag ListOfGenericPrices |
PackingQuantity | Quantidade na Embalagem | Não utilizados nesta integração | ||
AccountantAccountCode | Código da Conta Contábil | Não utilizados nesta integração | ||
AllowsPurchase | Permite Comprar do Item | Não utilizados nesta integração | ||
IsStorable | Item é Estocável (true) ou Aplicação direta (false) ? | Não utilizados nesta integração | ||
LastUpdateItem | Data Última atualização do Item | Não utilizados nesta integração | ||
LastPurchaseItem | Data Última Compra do Item | Não utilizados nesta integração | ||
GenericPrices \ GenericPricesType | Preços | |||
PriceId | Identificador do preço | No RM pode ser de 1 a 5 | ||
CurrencyInternalId | Código da Moeda no Preço | TPRODUTODEF | CODMOEPRECO1 | |
BaseDatePrice | Data-base de Preço | TPRODUTODEF | DATABASEPRECO1 DATABASEPRECO2 DATABASEPRECO3 DATABASEPRECO4 DATABASEPRECO5 | |
Price | Preço | TPRODUTODEF | PRECO1 PRECO2 PRECO3 PRECO4 PRECO5 | |
BarCode \ BarCodeType | Códigos de Barra | |||
Code | Código de Barras do Produto | TPRDCODIGO | CODIGO | |
InternalId | InternalId do Código de Barras | TPRDCODIGO | CODCOLIGADA|TIPO|CODIGO | |
UnifOfMeasureInternalId | Unidade do Código do Produto | TPRDCODIGO | CODUND | |
ItemQuantity | Quantidade do Produto | TUND | FATORCONVERSAO | Tratado via extension. Busca-se o fator de conversão da unidade informada para o Códigos de barra. |
ECFTaxing | Tributação de Cupom Fiscal | |||
Code | Código da Tributação ECF | TPRODUTO | TRIBUTACAOECF | |
Type | Tipo da Tributação ECF | TTRIBUTACAOECF | TIPO | Informação buscada via extension quando existir Tributação Cupom Fiscal informada para o Produto, respeitando o seguinte de-para de valores: Fixo 1 - Tributado: enviado quando Tipo = 0 Fixo 2 - Isento: enviado quando Tipo = 1 Fixo 3 - Substituição Tributaria: enviado quando Tipo = 2 Fixo 4 - Não tributado: enviado quando Tipo = 3 Fixo 5 - Outros. |
Aliquot | Alíquota da Tributação ECF | TTRIBUTACAOECF | ALIQUOTA | Informação buscada via extension quando existir Tributação Cupom Fiscal informada para o Produto. |
ManufacturerCode | Número no Fabricante | TPRODUTODEF | NUMNOFABRIC | |
ComercialFamilyItemType | Amarração famílias(categorias) pertencentes ao produto | |||
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 |
- Somente os campos marcados em negrito são tratados no Adapter, sendo os demais não enviados na mensagem.