Histórico da Página
...
- 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 campo 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 Protheus.
- O envio da mensagem Item_ 4.002 do RM para o Protheus contemplará todos os campos enviados na mensagem Item_3.004 mais a informação da tag ManufacturerNumber. 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: 4_002
- 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 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 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: | 4.002 |
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:
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>.
Mapeamento dos Campos
- Mensagem Item 4.002
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 | |||||||||||||
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 |
| |||||||||||
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 familiasfamí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 | 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. | |||||||||||
| ManufacturerNumber | 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.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas