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
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 | 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:
- 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.
Entidades de Integração
- Transformação
- Identificador da Mensagem: Item
- Versão: 43_002007
- Tipo do Server: DataServer
- DataServer: EstPrdDataBR
- Source Code(GUID):
- Fluxo da mensagem: Saída
- Tipo de Envio: Síncrono.
- Mandatário: BackOffice RM.
- Mapeamento de Campos: http://tdn.totvs.com/x/DYD6E
(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 paraConfiguraçã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 Configurador (SIGACFG), acesse Ambiente/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: | Não |
Recebe: | Sim |
Método: | Síncrono |
Operação: | 1 - Todas |
Canal Envio: | 2 - EAI |
Versão Envio: |
3. |
CONFIGURAÇÃO DE MENUS
2. No
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.