Pedido de Compra/Venda
O Pedido compra, venda, pagamento entre outras será integrado com o sistema Backoffice RM gerando um movimento através de comunicação de mensagem única para o módulo faturamento nas tabelas TMOV, TMOVCOMPL, TITMMOV, TMOVPAGTO, TPAGTO, entre outras. Abaixo os campos que são integrados por padrão.
Contexto de negócio (Introdução)
Adapter responsável pela integração de Pedidos de Compra/Venda.
| Modulo RM | Identificador | Versão | Forma de Envio | Tipo do Adapter |
|---|---|---|---|---|
| Gestão Estoque / Suprimentos | ORDER | 3.002 | Síncrona | Recebimento |
| ORDER | 4.010 | Síncrona | Recebimento |
Mapeamento de Campos
ORDER (RECEBIMENTO)
Regras de Integridade:
- A partir da versão 3.002 o centro de custo do movimento será determinado pelo centro de custo do primeiro item do movimento uma vez que este campo não está disponível entre os campos de movimento da mensagem.
O movimento a ser criado no RM pode estar definido nos Parâmetros de Integração (RM módulo Integração - menu EAI 2.0 \ Parâmetros Adapter) e/ou nos Parâmetros de Integração EAI (Parâmetros Gestão de Estoque, Compras e Faturamento \ 04.03- Integrações \ 04.03.06 - Integrações EAI). O adapter vai decidir qual movimento será gerado com base no valor recebido da tag OrderTypeCode.
Abaixo as configurações do parâmetros de integração:
- Para usar o recurso de Desconto no Movimento é obrigatório configurar os tipos de movimentos para usar desconto por valor. Etapa Mov Valores Financeiros 1/4 dos parâmetros de tipo de movimento
- Para usar o recurso de Desconto no Item de Movimento é obrigatório configurar os tipos de movimentos para usar desconto por valor no item. Etapa Item Valores Financeiros 1/2 dos parâmetros de tipo de movimento
ORDER 3.002
Regras de Integridade:
| Mensagem Única | RM | Observação | ||
|---|---|---|---|---|
| Elemento | Descrição | Tabela | Coluna | |
| BusinessContent | ||||
| CompanyId | Coligada | TMOV | CODCOLIGADA | O campo é preenchido com valor de referencia do De-Para. |
| CompanyInternalId | InternalId da empresa | TMOV | CODCOLIGADA|CODFILIAL | |
| BranchId | Filial | TMOV | CODFILIAL | O campo é preenchido com valor de referencia do De-Para. |
| OrderTypeCode | Tipo do Pedido | TMOV | CODTMV | Os valores passados na mensagem serão: 001 = Pedido de compras, vendas 002 - Solicitação Remessa 003 - Solicitação Fatura locação 004 - Solicitação NFS-e 005 - Solicitação NF-e |
| InternalId | InternalId do Pedido | TMOV | CODCOLIGADA|IDMOV | |
| RegisterDate | Data de Emissão | TMOV | DATAEMISSAO | |
| OrderId | Número do Pedido | TMOV | IDINTEGRACAO | Este campo só é visível apenas na visão de movimentos. |
| RegisterHour | Horário Emissão | TMOV | HORARIOEMISSAO | |
| VendorGovInfo | Informação Governo de Fornecedor | TMOV | CGCCFO | Não utilizado. |
| CustomerCode | Código do Cli/For | TMOV | CODCFO | Não utilizado. |
| CustomerInternalId | InternalId do Cli/For | TMOV | CODCOLCFO|CODCFO | |
| PaymentTermCode | Condição de Pagamento | TMOV | CODCPG | O campo é preenchido com valor de referencia do De-Para. |
| PaymentConditionInternalId | InternalId da condição de pagamento | TMOV | CODCOLIGADA|CODCPG | |
| TMOV | CODRPR | Não há tag na mensagem específica para informar o representante então tal campo é preenchido com o representante default do Cli/For informado na mensagem ou então pelo representante default de acordo com o tipo de movimento. | ||
| SalesOrderItens.Item | ||||
| CompanyId | Coligada | TITMMOV | CODCOLIGADA | O campo é preenchido com valor de referencia do De-Para. |
| BranchId | Filial | TITMMOV | CODFILIAL | O campo é preenchido com valor de referencia do De-Para. |
| OrderItem | Id do Item | TITMMOV | NSEQITMMOV | |
| InternalId | InternalID Item do Pedido | TITMMOV | CODCOLIGADA|IDMOV|NSEQITMMOV | |
| ItemInternalId | InternalId do Produto | TITMMOV | CODCOLIGADA|IDPRD | O campo é preenchido com valor de referencia do De-Para. |
| Itemunitofmeasure | Unidade de Medida do Item | TITMMOV | CODUND | Não utilizado. |
| UnitOfMeasureInternalId | InternalId da Unidade de Medida | TITMMOV | CODUND | |
| Quantity | Quantidade | TITMMOV | QUANTIDADE | |
| UnityPrice | Preço unitário | TITMMOV | PRECOUNITARIO | |
| TotalPrice | Valor Total | TITMMOV | VALORBRUTOITEM | |
| valnetlineitem | TITMMOV | VALORTOTALITEM | ||
| CostCenterCode | Centro de Custo | TITMMOV | CODCCUSTO | Não utilizado. |
| CostCenterInternalId | InternalID do Centro de Custo | TITMMOV | CODCOLIGADA|CODCCUSTO | |
| Event | Operação a ser executada no registro | Valor default: “upsert”. Enviar “delete” quando for exclusão | ||
| PAYMENTPLAN.TERM | ||||
| InternalId | Chave da parcela | TPAGTO/TMOVPAGTO | CODCOLIGADA|IDSEQPAGTO | Chave única da parcela no RM. |
| conditionpay | Condição de Pagamento | Não utilizado. | ||
| datereference | Data de emissão | TPAGTO/TMOVPAGTO | DATAEMISSAO | |
| timereference | Referência de tempo | Não utilizado. | ||
| typeperiod | Tipo de período | Não utilizado. | ||
| periodnum | Numero de períodos | Não utilizado. | ||
| termduedate | Data de vencimento | TPAGTO/TMOVPAGTO | DATAVENCIMENTO | |
| termamount | Valor total | TPAGTO/TMOVPAGTO | VALOR | |
| termpaymentpercentage | Percentual ao valor da nota | Não utilizado. | ||
| OTHER.ADDFIELD | A informação de campo complementar só vai ser gravada se o campo existir na base e o campo for visível no movimento | |||
| field | Nome da coluna personalizada | TMOVCOMPL | ||
| value | Valor da coluna personalizada | TMOVCOMPL | ||
ORDER 4.010
Regras de Integridade:
| Mensagem Única | RM | Observação | ||
|---|---|---|---|---|
| Elemento | Descrição | Tabela | Coluna | |
| BusinessContent | ||||
| CompanyId | Coligada | TMOV | CODCOLIGADA | O campo é preenchido com valor de referencia do De-Para. |
| CompanyInternalId | InternalId da empresa | TMOV | CODCOLIGADA|CODFILIAL | |
| PaymentMethodCode | Código da Forma/Meio de pagamento | Não utilizado, mantido na msg por padronização | ||
| SellerInternalId | Código do vendedor | TMOV | CODVEN2 | O campo Vendedor2 necessita ser parametrizado no movimento para ser utilizado. |
| PaymentMethodInternalId | InternalId da Forma/Meio de pagamento | A tabela de movimentos em si do TOTVS RM não possui esta informação mas sim na tabela de pagamentos do movimentos (parcelas) então o valor aqui informado será utilizado em tais parcelas caso na estrutura de pagamentos/parcelas (PAYMANTPLAN/TERM) exista alguma em que tal informação não seja informado. | ||
| Discounts | Descontos | TMOV | VALORDESC | O type deste campo pode receber de 0 a 4 descontos, o RM envia e recebe apenas um desconto. Tanto no envio quando no recebimento o RM irá considerado apenas o primeiro registro da lista. Disponível a partir da versão Order 4.010 Tipo de movimento deve ser configurado para usar desconto por valor. Etapa Mov Valores Financeiros 1/4 dos parâmetros de tipo de movimento |
| Observation | Observações do Pedido | TMOV | HISTORICOCURTO | Campo considerado a partir das versões: 4.003 (envio) / 4.010 (recebimento). Tipo de movimento utilizado deve ser configurado para Editar Histórico Curto - Etapa Mov-Campos Livres 2/2 dos parâmetros de tipo de movimento. |
| BranchId | Filial | TMOV | CODFILIAL | O campo é preenchido com valor de referencia do De-Para. |
| OrderTypeCode | Tipo do Pedido | TMOV | CODTMV | Os valores passados na mensagem serão: 001 = Pedido de compras, vendas 002 - Solicitação Remessa 003 - Solicitação Fatura locação 004 - Solicitação NFS-e 005 - Solicitação NF-e |
| InternalId | InternalId do Pedido | TMOV | CODCOLIGADA|IDMOV | |
| RegisterDate | Data de Emissão | TMOV | DATAEMISSAO | |
| OrderId | Número do Pedido | TMOV | IDINTEGRACAO | Este campo só é visível apenas na visão de movimentos. |
| RegisterHour | Horário Emissão | TMOV | HORARIOEMISSAO | |
| VendorGovInfo | Informação Governo de Fornecedor | TMOV | CGCCFO | Não utilizado. |
| CustomerCode | Código do Cli/For | TMOV | CODCFO | Não utilizado. |
| CustomerInternalId | InternalId do Cli/For | TMOV | CODCOLCFO|CODCFO | |
| PaymentTermCode | Condição de Pagamento | TMOV | CODCPG | O campo é preenchido com valor de referencia do De-Para. |
| PaymentConditionInternalId | InternalId da condição de pagamento | TMOV | CODCOLIGADA|CODCPG | |
| TMOV | CODRPR | Não há tag na mensagem específica para informar o representante então tal campo é preenchido com o representante default do Cli/For informado na mensagem ou então pelo representante default de acordo com o tipo de movimento. | ||
| SalesOrderItens.Item | ||||
| CompanyId | Coligada | TITMMOV | CODCOLIGADA | O campo é preenchido com valor de referencia do De-Para. |
| BranchId | Filial | TITMMOV | CODFILIAL | O campo é preenchido com valor de referencia do De-Para. |
| OrderItem | Id do Item | TITMMOV | NSEQITMMOV | |
| InternalId | InternalID Item do Pedido | TITMMOV | CODCOLIGADA|IDMOV|NSEQITMMOV | |
| ItemInternalId | InternalId do Produto | TITMMOV | CODCOLIGADA|IDPRD | O campo é preenchido com valor de referencia do De-Para. |
| Itemunitofmeasure | Unidade de Medida do Item | TITMMOV | CODUND | Não utilizado. |
| UnitOfMeasureInternalId | InternalId da Unidade de Medida | TITMMOV | CODUND | |
| Quantity | Quantidade | TITMMOV | QUANTIDADE | |
| UnityPrice | Preço unitário | TITMMOV | PRECOUNITARIO | |
| TotalPrice | Valor Total | TITMMOV | VALORBRUTOITEM | |
| valnetlineitem | TITMMOV | VALORTOTALITEM | ||
| CostCenterCode | Centro de Custo | TITMMOV | CODCCUSTO | Não utilizado. |
| CostCenterInternalId | InternalID do Centro de Custo | TITMMOV | CODCOLIGADA|CODCCUSTO | |
| ItemDiscounts | Descontos do Item | TITMMOV | VALORDESC | O type deste campo pode receber de 0 a 4 descontos, o RM envia e recebe apenas um desconto. Tanto no envio quando no recebimento o RM irá considerado apenas o primeiro registro da lista. Disponível a partir da versão Order 4.010 Tipo de movimento deve ser configurado para usar desconto por valor no item. Etapa Item Valores Financeiros 1/2 dos parâmetros de tipo de movimento |
| Observation | Observações do item do pedido | TITMMOV | HISTORICOCURTO | Tipo de movimento utilizado deve ser configurado para Editar Histórico Curto - Etapa Item-Campos Livres 1/2 dos parâmetros de tipo de movimento. |
| Event | Operação a ser executada no registro | Valor default: “upsert”. Enviar “delete” quando for exclusão | ||
| PAYMENTPLAN.TERM | ||||
| InternalId | Chave da parcela | TPAGTO/TMOVPAGTO | CODCOLIGADA|IDSEQPAGTO | Chave única da parcela no RM. |
| conditionpay | Condição de Pagamento | Não utilizado. | ||
| datereference | Data de emissão | TPAGTO/TMOVPAGTO | DATAEMISSAO | |
| timereference | Referência de tempo | Não utilizado. | ||
| typeperiod | Tipo de período | Não utilizado. | ||
| periodnum | Numero de períodos | Não utilizado. | ||
| termduedate | Data de vencimento | TPAGTO/TMOVPAGTO | DATAVENCIMENTO | |
| termamount | Valor total | TPAGTO/TMOVPAGTO | VALOR | |
| termpaymentpercentage | Percentual ao valor da nota | Não utilizado. | ||
| PaymentMethodCode | Código da Forma/Meio de pagamento | Não utilizado, mantido na msg por padronização | ||
| PaymentMethodInternalId | InternalId da Forma/Meio de pagamento | TMOVPAGTO/TPAGTO | CODCOLIGADA|IDFORMAPAGTO | O campo é preenchido com valor de referencia do De-Para. Para as parcelas onde tal valor não seja informado então o mesmo será preenchido conforme a tag equivalente que se encontra na estrutura principal da mensagem |
| OTHER.ADDFIELD | A informação de campo complementar só vai ser gravada se o campo existir na base e o campo for visível no movimento | |||
| field | Nome da coluna personalizada | TMOVCOMPL | ||
| value | Valor da coluna personalizada | TMOVCOMPL | ||
Atenção
Verificar se Origem e Destino possui tratamento para as informações que são trafegadas, pois podem existir campos (tags) que são preenchidos e enviados para o sistema destino e estes valores serão gravados no destino somente se possuir tratamento no recebimento da mensagem.
Exemplo: a tag Observation é tratada no recebimento PROTHEUS apenas no Pedido de Compra. O Pedido de Venda Protheus (MATA410) não possui tratamento para a tag Observation. Caso cliente necessite do tratamento deste dado por parte do Protheus deverá solicitar via Central Colaborativa Faturamento Protheus a melhoria.
ORDER (ENVIO)
Regras de Integridade:
A tag TypeOperation será enviada somente quando a mensagem for Pedido de Venda (OrderPurpose com valor 2).
Ao realizar a configuração dos pacotes de integração TOTVS Gestão de Imóveis x BackOffice Protheus e TOTVS Educacional x BackOffice Protheus, caso os parâmetros de TES (TESTIN e TESEDU) não existam na base de dados, eles serão criados para as coligadas integradas. Os valores definidos nestes parâmetros de adapter é que serão considerados no envio da tag TypeOperation,
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas