Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • 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

 

  1. No RM, acesse Integração/Ferramentas/Configurar
    1. 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.
    2. Na etapa Projetos de Integração selecione o item Manutenção de Ativos x BackOffice RM, avance e execute o assistente.

  2. 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

 

DetailDetalhes 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

StockControlTypeTipo Controle EstoqueTPRODUTODEFUSANUMSERIE 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

TrailSe controla estoque por LoteTPRODUTOCONTROLADOPORLOTE

O valor do campo segue a lógica abaixo:

Marcado = Valor 'L' (Controlado por Lote)

Desmarcado = Valor 'N' (Não utiliza rastro)

BinControl

Se controla estoque por Nº de Série

TPRODUTO

USANUMSERIE

O valor do campo segue a lógica abaixo:

Marcado = Valor 'true' (Controla Nº de Série)

Desmarcado = Valor 'false' (Não controla Nº de Série)

     

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

FamilyClassificationCodeClassificaçã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

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

TPRODUTODEFCODUNDCOMPRA

 

SecondUnitOfMeasureInternalId

InternalId do SecondUnitOfMeasureCode 

TPRODUTODEFCODUNDCOMPRA

 

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

TrailRastro por lote ou Sublote, sem rastro  Não utilizado nesta integração.
GovernmentCodeCódigo Item  Não utilizado nesta integração.
BinControlCampo que identifica se o produto possui localização(Endereço/Numero de Serie)   
ItemTypeCodeCódigo do Tipo de ProdutoTPRODUTOCODTB1FATNão utilizado nesta integração.
ItemTypeInternalIdInternalId da chave completa do Tipo de ProdutoTPRODUTOCODCOLIGADA|CODTB1FATNão utilizado nesta integração.
ListOfGenericPricesLista de Preços do Produto  Ver ListOfGenericPricesType
ListOfBarCodeLista de Códigos de Barra  Ver ListOfBarCodeType
FiscalInformationTypeInformações fiscais do Item  Ver FiscalInformation\FiscalClassificationType
CustomerItemInformationTypeAmarração Cliente X Item  Ver ListOfCustomerItemInformation \ CustomerItemInformation

FiscalInformation \ FiscalClassificationType

Este campos não estão sendo enviados pelo RM pelos seguintes motivos:

    • BranchId - Filial: na inclusão de um novo Produto no RM é gerado na tabela TPRDFIL um registro para cada Filial ativa. Desta forma seria necessário a utilização de uma outra mensagem.

    • FiscalInformation: no RM temos Dados Fiscais do Produto e Dados Fiscais por UF. Nestes dois cadastros não temos o campo Descrição.

FiscalClassificationCode

Código Classificação Fiscal 

TPRODUTONCM

 

FiscalClassificationInternalId

InternalId do FiscalClassificationCode

  

Não enviado pelo RM

FiscalClassificationDescription

Descrição Classificação Fiscal

  

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

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

PackingQuantityQuantidade na Embalagem  Não utilizados nesta integração
AccountantAccountCodeCódigo da Conta Contábil  Não utilizados nesta integração
AllowsPurchasePermite Comprar do Item  Não utilizados nesta integração
IsStorableItem é Estocável (true) ou Aplicação direta (false) ?  Não utilizados nesta integração
LastUpdateItemData Última atualização do Item  Não utilizados nesta integração
LastPurchaseItemData Última Compra do Item  Não utilizados nesta integração
GenericPrices \ GenericPricesTypePreços   
PriceIdIdentificador do preço 

 

No RM pode ser de 1 a 5
CurrencyInternalIdCódigo da Moeda no PreçoTPRODUTODEF

CODMOEPRECO1
CODMOEPRECO2
CODMOEPRECO3
CODMOEPRECO4
CODMOEPRECO5

 
BaseDatePriceData-base de PreçoTPRODUTODEFDATABASEPRECO1
DATABASEPRECO2
DATABASEPRECO3
DATABASEPRECO4
DATABASEPRECO5
 
PricePreçoTPRODUTODEFPRECO1
PRECO2
PRECO3
PRECO4
PRECO5
 
BarCode \ BarCodeTypeCódigos de Barra   
CodeCódigo de Barras do ProdutoTPRDCODIGOCODIGO 
InternalIdInternalId do Código de BarrasTPRDCODIGOCODCOLIGADA|TIPO|CODIGO 
UnifOfMeasureInternalIdUnidade do Código do ProdutoTPRDCODIGOCODUND 
ItemQuantityQuantidade do ProdutoTUNDFATORCONVERSAOTratado via extension. Busca-se o fator de conversão da unidade informada para o Códigos de barra.
ECFTaxingTributação de Cupom Fiscal   
CodeCódigo da Tributação ECFTPRODUTOTRIBUTACAOECF 
TypeTipo da Tributação ECFTTRIBUTACAOECFTIPO

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.

AliquotAlíquota da Tributação ECFTTRIBUTACAOECFALIQUOTAInformação buscada via extension quando existir Tributação Cupom Fiscal informada para o Produto.

 

  • Somente os campos marcados em negrito são tratados no Adapter, sendo os demais não enviados na mensagem.