Adapters da Integração Estoque

Rotina

Mensagem

Descrição


ProtheusRMCanal

Operação

Versão

Alias do Protheus

Envia

Recebe

EnviaRecebe
MATA010ITEMProdutoSimNãoNãoSimEAITodas4.005SB1
MATA035STOCKGROUPGrupo de ProdutoSimNãoNãoSimEAITodas1.000SBM
QIEA030UNITOFMEASUREUnidade de medidaSimNãoNãoSimEAITodas2.000SAH
AGRA045WAREHOUSELocal de EstoqueSimNãoNãoSimEAITodas1.000NNR
MATA360PAYMENTCONDITIONCondição de PagamentoSimNãoNãoSimEAITodas2.000SE4

A mensagem UNITOFMEASURE é responsável por receber os dados de unidade de medida entre a integração BackOffice Protheus com o TOTVS Educacional.

Os cadastros de unidade de medida devem ser realizados no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de unidade de medida do lado do RM.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Cadastro de Unidade de Medida - Protheus

Módulo "SIGAEST"

Atualizações | Cadastros | Unidade de Medida

Unidade de Medida no Protheus

Cadastro de Unidade de Medida - RM

Acesse o módulo BackOffice | Gestão de Estoque, Compras e Faturamento 


Unidade de Medida no RM


Todas as movimentações da mensagem Unitofmeasure resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

TUND

CODUND

UN

T1|UN

UNITOFMEASURE

84043D1C-707C-4F5A-A961-48CDCBBE0111

A restrição da mensagem está relacionada ao tipo de compartilhamento das tabelas SAH no Protheus, para mais informações clique aqui. 

A recomendação na integração EAI 2.0 é utilizar o modo de compartilhamento da Filial, Unidade e Empresa parametrizado no modo “Compartilhado” no Protheus, pois no RM o cadastro de Unidade de Medida não possui vínculo com a Coligada/Filial.

A mensagem STOCKGROUP é responsável por receber os dados do grupo de produto entre a integração BackOffice Protheus com o TOTVS Educacional.

Os cadastros de grupo de produto devem ser realizados no BackOffice Protheus, serão desabilitadas quaisquer alterações a serem feitas no cadastro de grupo de produto do lado do RM.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Cadastro de Grupo de Produto - Protheus

Módulo "SIGAEST"

Atualizações | Cadastros | Grupos


Grupo de Produto no Protheus

Caminho para acesso a tabela de classificação, no sistema:

BackOffice / Gestão de Estoque, Compras e Faturamento / Cadastros / Tabelas de Classificação.


Grupo de produto no RM                         

As informações de grupo de produtos utilizam sempre a Tabela de Classificação 2 com o nome de Grupo de Produtos. 

Os parâmetros de tabelas de classificação podem ser acessados, no caminho: 

BackOffice / Gestão de Estoque, Compras e Faturamento / Ambiente / Parâmetros / Gestão de Estoque, Compras e Faturamento         

04.01 – Parâmetros Gerais / 04.01.04 – Tabelas / 04.01.04.01 – Classificação                                                   

Marque as opções Usar em Produto, Usar em Item de Movimento e Usar em Movimento.               


Todas as movimentações da mensagem StockGroup resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

TTB2

CODCOLIGADA|CODTB2FAT

1|0015

T1||0015

STOCKGROUP

004505C8-2789-457E-BBCA-20FDB97BA6ED

As restrições da mensagem está relacionada ao tipo de compartilhamento das tabelas SBM no Protheus, para mais informações clique aqui. 

Quando no RM está cadastrado a coligada em Integração / EAI 2.0 / Aplicativos como:

  • Unidade de Negócio: não é permitido no Protheus o modo de compartilhamento "compartilhado" de Filial e Unidade de Negócio
  • Empresa: não é permitido no Protheus o modo de compartilhamento "compartilhado" somente de Filial
  • Grupo de Empresa: não é permitido no Protheus o "compartilhamento" compartilhado somente de Filial ou Filial e Unidade de Negócio
  • Nas coligada acima: não é permitido que a Filial, Unidade de Negocio e Empresa esteja cadastrado no modo de compartilhamento "exclusivo" no Protheus.

A mensagem ITEM é responsável por receber e enviar os dados do produto entre a integração BackOffice Protheus com o TOTVS Educacional.

Os cadastros de produto devem ser realizados no BackOffice Protheus, as alterações a serem feitas no cadastro de grupo de produto do lado do RM.

Para realizar o cadastro de item primeiramente deve ser realizado o cadastro de Unidade de Medida e Grupo de Produto (caso utilize) no SIGAEST.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Cadastro de Grupo de Produto - Protheus

Módulo "SIGAEST"


Atualizações | Cadastros | Produto


Produto no Protheus

Informações importantes sobre o cadastro de produtos:

O cadastro de produto é utilizado somente para vínculo com o serviço do Educacional e envio posterior junto com o lançamento a receber para o Backoffice Protheus, por isso são utilizados os campos código e descrição do produto.

As definições Máscara e Opções para a Máscara de produto devem ser alteradas para QQQQQQQQQQQQQ e Não controla níveis de máscara respectivamente, para que o RM aceite os produtos enviados pelo Protheus na integração.

Acesse: BackOffice / Gestão de Estoque, Compras e Faturamento / Ambiente / Parâmetros / Gestão de Estoque, Compras e Faturamento

04.01 – Parâmetros Gerais / 04.01.04 – Tabelas / 04.01.04.01 – Definições Gerais

Caso possua no Protheus informações de unidade de medida e grupo de produtos, são enviados antes pela integração por meio das mensagens: UnitOfMeasure e StockGroup, 

Caminho para o cadastro de produtos no TOTVS Gestão de Estoque, Compras e Faturamento:

Acesse: BackOffice / Gestão de Estoque, Compras e Faturamento / Cadastros / Produto

Produto no RM


Caminho para a parametrização do produto para a integração com o Protheus:

Acesse: Educacional / Educacional / Financeiro/Contábil / Serviços 

Anexo: Dados financeiros - Integração Protheus


No cenário em que o Protheus possua compartilhamento por Empresa e por Filial para o produto, o TOTVS Gestão de Estoque, Compras e Faturamento deve ser parametrizado para utilizar um cadastro de produto global. Dessa maneira, todos os produtos são cadastrados na coligada 0 assumindo o comportamento de compartilhados para todas as coligadas.
Vale ressaltar que quando o produto não é global no RM, os seus dados são replicados para cada coligada configurada para a integração com o Protheus.

Caminho para acesso ao parâmetro para permitir o cadastro global:                                              

Acesse BackOffice / Gestão de Estoque, Compras e Faturamento / Ambiente / Parâmetros / Gestão de Estoque, Compras e Faturamento                                                        04.01 – Parâmetros Gerais / 04.01.04 – Tabelas / 04.01.04.07 – Produtos / 04.01.04.07.07 –Produto Global / Usa Produto Global

Importante: Essa configuração é realizada somente caso o Protheus tenha um compartilhamento por Empresa.

Todas as movimentações da mensagem Item resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

TPRODUTO

CODCOLPRD|IDPRD

1|7

T1||001

ITEM

314D6308-1488-462D-805F-64A196BE1848


Quando o RM estiver configurado para produto global, o cadastrado do “De/Para” do produto no RM irá considerar a coligada 0 para a montagem do “de/para”.

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

TPRODUTO

CODCOLPRD|IDPRD

0|19

T1||001

ITEM

0B0EFCE7-20CE-437F-BCE9-632899568D18

As restrições da mensagem está relacionada ao tipo de compartilhamento das tabelas SBM no Protheus, para mais informações clique aqui. 

Quando no RM está cadastrado a coligada em Integração / EAI 2.0 / Aplicativos como:

  • Unidade de Negócio: não é permitido no Protheus o modo de compartilhamento "compartilhado" de Filial e Unidade de Negócio
  • Empresa: não é permitido no Protheus o modo de compartilhamento "compartilhado" somente de Filial
  • Grupo de Empresa: não é permitido no Protheus o "compartilhamento" compartilhado somente de Filial ou Filial e Unidade de Negócio
  • Nas coligada acima: não é permitido que a Filial, Unidade de Negocio e Empresa esteja cadastrado no modo de compartilhamento "exclusivo" no Protheus.

Contempla a rotina Geração de NFS (FINA720) para ser utilizada na integração com o RM Classis e atender a necessidade de emissão de nota fiscal eletrônica de serviço educacional. A geração é realizada no ambiente do Protheus.

Abaixo os passos realizados para geração da NFS.

Gerar lançamento de uma parcela.

Verifique os lançamentos / Boletos da parcela

Logar no módulo SIGAFIN

Atualizações / Contas a Receber / Geração de Nf

Clicar em + Gerar NF

Informar os Parametros da tela que se abre

 - Data inicial e data final de emissão;

 - Data inicial e data final de vencimento;

 - Intervalo de prefixo;

 - Intervalo de RA

 - Tipo de titulos ( Baixados ou Abertos)

Selecionar a Serie

Selecionar os títulos para geração

Gerar NF

A Nota Fiscal poderá ser visualizada ao clicar duas vezes sobre o registro gerado.

Esse adapter foi homologado nas versões 12.1.27 a partir do patch 12.1.27.349, 12.1.31 a partir do patch 12.1.31.  e versões superiores a versão 12.1.31. Nas versões 12.1.2.8, 12.1.29, 12.1.30 o mesmo não foi homologado pelo TOTVS Educacional.


A mensagem WAREHOUSE é responsável por receber os dados do local de estoque entre a integração BackOffice Protheus com o TOTVS Educacional.

Os cadastros do local de estoque devem ser realizados no BackOffice Protheus, assim a integração irá enviar os dados cadastrados para o RM.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Na versão 12.1.27 o adapter WareHouse deve ser cadastrado no Aplicativo de forma manual no anexo Rotas. E nas versões superiores pode utilizar também o configurador presente no menu EAI 2.0



Como pré-requisito é necessário a execução do processo "Configurador Tipo de Movimento - EAI 2.0", a documentação do processo está presente na aba Order.

Cadastro de Local de Estoque - Protheus

Módulo "SIGAFAT"

Atualizações | Cadastros 

Locais de Estoque no Protheus

Na utilização do local de estoque no RM para a integração TOTVS Educacional com o BackOffice Protheus é recomendo a utilização da máscara QQQQQQQ para o código do local de estoque. Essa máscara é configurada na parametrização do Gestão de Estoque, Compras e Faturamento no menu BackOffice / Gestão de Estoque, Compras e Faturamento / Ambiente / Configuração / Parâmetros / Gestão de Estoque, Compras e Faturamento / Parâmetros Gerais / Tabelas / Local de Estoque / Campo Máscara.

A alteração da formatação da máscara do local de estoque deve ser realizada preferencialmente com nem um local de estoque cadastrado no sistema.

Caminho para acesso a tabela de classificação, no sistema:

BackOffice / Gestão de Estoque, Compras e Faturamento / Cadastros / Estoque, Compras e Faturamento.

Local de Estoque no RM


Todas as movimentações da mensagem WareHouse resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

TLOC

CODCOLIGADA|CODFILIAL|CODLOC

1|1|000002

T1|D MG 01|02

WAREHOUSE

3006A836-8167-45B0-B57A-A04BF8F0F903

As restrições da mensagem está relacionada ao tipo de compartilhamento das tabelas NNR no Protheus, para mais informações clique aqui. 

A recomendação é a utilização de compartilhamento no local de estoque exclusiva por filial.

Quando no RM está cadastrado a coligada em Integração / EAI 2.0 / Aplicativos como:

  • Unidade de Negócio: não é permitido no Protheus o modo de compartilhamento "compartilhado" por Filial e Unidade de Negócio, e exclusivo por Empresa
  • Empresa: não é permitido no Protheus o modo de compartilhamento "compartilhado" por Filial, e exclusivo por Unidade de Negócio e por Empresa
  • Grupo de Empresa: não é permitido no Protheus o "compartilhamento" compartilhado por Filial e exclusivo por Unidade de Negócio e Empresa, ou compartilhado por Filial e Unidade de Negócio e exclusivo por Empresa.


Esse adapter foi homologado nas versões 12.1.27 a partir do patch 12.1.27.349, 12.1.31 a partir do patch 12.1.31.  e versões superiores a versão 12.1.31. Nas versões 12.1.2.8, 12.1.29, 12.1.30 o mesmo não foi homologado pelo TOTVS Educacional.


A mensagem PAYMENTCONDITION é responsável por receber os dados da condição de pagamento entre a integração BackOffice Protheus com o TOTVS Educacional.

Os cadastros da condição de pagamento devem ser realizados no BackOffice Protheus, assim a integração irá enviar os dados cadastrados para o RM.

Nas abas abaixo são descritas as configurações necessárias para a utilização da mensagem com as suas particularidades.

Na versão 12.1.27 o adapter PaymentCondition deve ser cadastrado no Aplicativo de forma manual no anexo Rotas. E nas versões superiores pode utilizar também o configurador presente no menu EAI 2.0


Cadastro de Local de Estoque - Protheus

Módulo "SIGAFAT"

Atualizações | Cadastros 

Condições de Pagamento no Protheus

Caminho para acesso a tabela de classificação, no sistema:

BackOffice / Gestão de Estoque, Compras e Faturamento / Cadastros / Estoque, Compras e Faturamento / Mais... / Tabelas Auxiliares 

Condição de Pagamento no RM

Todas as movimentações da mensagem PaymentCondition resultam em um registro na tabela De-Para para relacionamento entre os códigos dos sistemas que estão trocando informações.

Exemplo:

Aplicativo

Tabela RM

Campos RM

Valor RM

Valores Externos

Transação

Identificador Global
TOTVS Educacional x BackOffice Protheus

TCPG

CODCOLIGADA|CODCPG

1|2

T1|D|2

WAREHOUSE

3006A836-8167-45B0-B57A-A04BF8F0F903

As restrições da mensagem está relacionada ao tipo de compartilhamento das tabelas SE4 no Protheus, para mais informações clique aqui. 

A recomendação é a utilização de compartilhamento na condição de pagamento e exclusiva por empresa e compartilhada por filial.

Quando no RM está cadastrado a coligada em Integração / EAI 2.0 / Aplicativos como:

  • Unidade de Negócio: não é permitido no Protheus o modo de compartilhamento exclusiva por Filial e Unidade de Negócio e Empresa
  • Empresa: não é permitido no Protheus o modo de compartilhamento exclusiva por Filial e Unidade de Negócio e Empresa, ou exclusiva por Filial e Unidade de Negócio e compartilhado por Empresa
  • Grupo de Empresa: não é permitido no Protheus o "compartilhamento" exclusiva por Filial e Unidade de Negócio e Empresa, ou exclusiva por Filial e Unidade de Negócio e compartilhado por Empresa.

O processo está disponível somente na versão 12.1.27 a partir do patch 12.1.27.349. Nas versões 12.1.31 ou superiores utilizar o configurador do EAI 2.0.

Recomendamos que esse processo seja executado somente na implantação. Para executar o processo o usuário deverá ter permissão de supervisor.

O processo gera outros tipos de movimentos para atender os demais módulos da linha RM na integração do EAI 2.0 com o Protheus.

Se algum dos tipos de movimentos esteja em uso, por favor realizar a cópia do tipo de movimento em questão antes da execução do processo.

O processo de “Configurador Tipo de Movimento - EAI 2.0” tem objetivo de criar e/ou configurar o tipo de movimento para a integração do TOTVS Educacional com o BackOffice Protheus.

Esse processo irá criar e realizar as configurações básica do tipo de movimento “2.1.80 – PEDIDO VENDA EDUCACIONAL” para a geração do movimento por competência pelo contrato.

Esse tipo de movimento será configurado para integrar o adapter Order para os pedidos de vendas.




O processo pode ser encontrado através da opção Executar dentro do sistema. Por favor, recriar o broker


Listagem dos Tipos de Movimentos criados pelo processo

CódigoDescrição
1.1.01SOLICITAÇÃO AO ARMAZÉM  - MOVIMENTO PADRÃO
1.1.02SOLICITAÇÃO DE COMPRA HISTÓRICO - MOVIMENTO PADRÃO
1.1.03SOLICITAÇÃO DE COMPRA  - MOVIMENTO PADRÃO
1.1.04PEDIDO DE COMPRA - MOVIMENTO PADRÃO
1.1.05PROVISAO DE PAGAMENTO - MOVIMENTO PADRÃO
1.1.06PEDIDO-ELIMINCAÇÃO DE RESIDUOS
1.1.09PEDIDO DE COMPRA
1.1.15PROVISAO DE PAGAMENTO - MOVIMENTO PADRÃO
1.1.70SOLICITAÇÃO AO ARMAZÉM - BRINDE
1.1.71SOLICITAÇÃO DE COMPRA - BRINDE
1.1.72SOLICITUD AL ALMACÉN - ATENCIÓN
1.1.73SOLICITUD DE COMPRA - ATENCIÓN
1.2.02TITULO A PAGAR - MOVIMENTO PADRÃO
1.2.04NOTA FISCAL - MOVIMENTO PADRÃO
1.2.05ADIANTAMENTO DE CONTRATO A PAGAR - MOVIMENTO PADRÃO
1.2.06RETENÇÃO DE CONTRATO A PAGAR - MOVIMENTO PADRÃO
1.2.10ADIANTAMENTO DE CONTRATO A PAGAR - MOVIMENTO PEDIDO
1.2.11ADIANTAMENTO E RETENÇÃO DE CONTRATO A PAGAR - PEDIDO
2.1.01PEDIDO DE VENDA - MOVIMENTO PADRÃO
2.1.02PROVISAO DE RECEBIMENTO - MOVIMENTO PADRÃO
2.1.12PROVISAO DE RECEBIMENTO - MOVIMENTO PADRÃO
2.1.70ORDEN DE VENTA - SIN FINANCIERO
2.1.71ORDEN DE VENTA - CON FINANCIERO
2.1.80PEDIDO DE VENDA DO EDUCACIONAL
2.2.01BAIXA DE ESTOQUE - MOVIMENTO PADRÃO
2.2.03TITULO A RECEBER - MOVIMENTO PADRÃO
2.2.04NOTA FISCAL - VENDA
2.2.05ADIANTAMENTO A RECEBER - MOVIMENTO PADRÃO
2.2.06RETENÇÃO A RECEBER - MOVIMENTO PADRÃO
2.2.10ADIANTAMENTO A RECEBER - MOVIMENTO PEDIDO
2.2.11ADIANTAMENTO E RETENÇÃO A RECEBER - PEDIDO
4.1.04ATUALIZACAO DE CUSTO - MOVIMENTO PADRÃO