...
Identificador da Mensagem: Currency
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/VNb0E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
|
| Âncora |
|---|
| Unidade de Medida |
|---|
| Unidade de Medida |
|---|
|
Cadastro de Unidades de Medida
Identificador da Mensagem: UnitOfMeasure
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/h9b0E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- Visto que a base Protheus possui carga de unidades de medida padrões, que obrigatoriamente constam na base de dados, deve-se efetuar manualmente o cadastramento da relação “DE-PARA” nas tabelas referentes no RM e Protheus para viabilizar a integração de registros que utilizem estas como parâmetro.
- As unidades de medida referentes à Hora (H), Quilometragem (KM), Unidade (UN) e Litro (L) devem possuir o mesmo código tanto no RM quanto no PROTHEUS.
- O campo Código da Unidade de Medida no PROTHEUS será gerado pelo Adapter, uma vez que este campo no RM tem tamanho de 5 caracteres, no PROTHEUS 2 caracteres e na mensagem única 6 caracteres.
|
Cadastro de Centro de Custo
Identificador da Mensagem: CostCenter
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/w9b0E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- Os campos “Centro de Custo” e “Código Reduzido do Centro de Custo” no PROTHEUS deve ser alterado para tamanho de 20 caracteres, uma vez que no RM estes campos permitem até 25 caracteres.
|
Cadastro de Projeto
Identificador da Mensagem: Project
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/ENf0E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- O código da filial do projeto será sempre obrigatório caso a integração esteja instalada. Caso ele não seja informado será exibida uma mensagem ao usuário e a mensagem não será enviada ao Protheus.
Algumas parametrizações são obrigatórias no Protheus para que a integração de projetos seja efetuada com sucesso. Para maiores detalhes acesse o link abaixo.
http://wikihelp.totvs.com.br/WikiHelp/CON3/INT.cadastrosProjetoBackOfficeRMxProtheusSigaMNT.aspx O campo “Código do Projeto” no Protheus está limitado a 10 caracteres. Caso o RM possua Código do Projeto com mais de 10 caracteres deve-se analisar o Protheus deve ser configurado como
|
...
Cadastro de Obra
Identificador da Mensagem: SubProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/Stf0E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- O campo “Código da Obra” no Protheus deve ser alterado para o tamanho de 60 caracteres, para manter compatibilidade com o RM.
|
Cadastro de Tarefa
Identificador da Mensagem: TaskProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/fNf0E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- O campo “Código da Tarefa” no Protheus deve ser alterado para o tamanho de 60 caracteres, para manter compatibilidade com o RM.
|
Cadastro de Etapa
Identificador da Mensagem: StepProject
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/udf0E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- O campo “Código da Etapa” no Protheus deve ser alterado para o tamanho de 60 caracteres, para manter compatibilidade com o RM.
|
Cadastro de Condição de Pagamento
Identificador da Mensagem: PaymentCondition
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/Sdj0E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
|
...
Cadastro de Produto/Serviço
Identificador da Mensagem: Item
Versão: 2.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/DYD6E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
Serão enviados para o PROTHEUS somente os Produtos/Serviços de Último Nível (Caso o controle de nível de máscara esteja habilitado nos parâmetros de Tabelas | Produtos no RM). - Caso a integração esteja ativa, não será permitido o cadastramento de produtos controlados por lote e série, devendo ser selecionada somente uma das opções.
Produtos globais no BackOffice RM não serão considerados globais no sistema de destino, sendo enviada uma mensagem de inclusão para cada empresa a qual o produto faz parte.
* Caso haja ao menos uma mensagem enviada com sucesso ao SigaMNT, mesmo havendo erro nas mensagens referentes ao produto para as outras coligadas, não será apresentada mensagem de erro e a alteração/inclusão não será desfeita. - Não serão enviadas informações de Cliente/Fornecedor do Produto.
- O campo B1_CODITE no cadastro de Produtos do PROTHEUS deve ser alterado, via apsdu, para não obrigatório e também deve-se retirar sua validação.
- O campo “Código do Produto” no PROTHEUS deve ser alterado para tamanho 30 caracteres para manter compatibilidade com o RM.
|
Cadastro de Cliente/Fornecedor
Identificador da Mensagem: CustomerVendor
Versão: 2.002
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/MYP6E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
Ao iniciar uma base zerada do Protheus, para incluir a tabela de Municípios no Protheus é necessário acessar o Protheus no sistema 09 - Livros Fiscais. Se não acessar o sistema Fiscal do Protheus antes de enviar o cadastro do RM irá apresentar mensagem de inconsistência informando que é valor inválido para o campo Município. Uma vez que o Cliente e Fornecedor são tratados na mesma mensagem (CustomerVendor), é responsabilidade do destinatário ao processar a mensagem garantir a consistência dos dados na origem e no destino da melhor forma possível.Ou seja, se o destino implementa uma única tabela, terá que manipular apenas um registro e se implementa mais de uma tabela, terá que manipular quantos registros forem necessários. - Para regras de negócio desta mensagem atenção ao seguinte ponto de atenção.
- Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa.
- No Protheus o código do cliente/fornecedor será composto pelo código do cliente/fornecedor e da coligada, conforme a mascara “[CODCOLIGADA]|[CODCFO]”.
|
Cadastro de Ativo Fixo
Identificador da Mensagem: Assets
Versão: 1.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/hYP6E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
Serão integrados somente ativos do tipo “Patrimônio”. Assim sendo, qualquer ativo dos tipos “Título” ou “Terceiros” será desconsiderado e não disparará o gatilho de integração. Não será integrado o histórico de valores do ativo fixo na seção “ListOfSalesAndValuesAssets” da mensagem, sendo o código de integração enviado sempre com o sufixo “1”. Estes dados do patrimônio serão enviados respeitando a seguinte regra:
* Inclusão: Serão enviados os dados informados na tela de inclusão.
* DepreciationStartDate : Valor calculado pela função PatPatrimonioService. RetornaDataInicioVigencia(CodColigada, DataAquisicao)
* OriginalValueCurrency : IPatrimonio . AQUISICAO
* CurrencyCode e CurrencyInternalId : Código da moeda padrão do sistema
* AnnualRateCurrencyDepreciation : IPatrimonio .VRTAXADEPRECIACAO
* BalanceDepreciation: Fixo 0.
* Alteração: Serão enviados os dados atuais do ativo em uma única linha, desconsiderando as movimentações anteriores não integradas.
* DepreciationStartDate : ICALCULOPATRIMONIO.DATAINICIOVIGENCIA
* OriginalValueCurrency : ICALCULOPATRIMONIO.VALORBASECORRIGIDO ou ISALDOCALCULOPATRIMONIOMOEDA. VALORBASECORRIGIDO
* CurrencyCode e CurrencyInternalId : ICALCULOPATRIMONIO.MOEDAINDICE ou ISALDOCALCULOPATRIMONIOMOEDA.MOEDAINDICE
* AnnualRateCurrencyDepreciation : ITAXADEPRECIACAO.VALOR
* BalanceDepreciation: ICALCULOPATRIMONIO. DEPRECIACAOACUMULADACORRIGIDA ou ISALDOCALCULOPATRIMONIOMOEDA. DEPRECIACAOACUMULADACORRIGIDA
* Exclusão: Serão enviados somente os dados da chave do Ativo, sendo desconsiderados todos os outros campos. A alteração e a exclusão de ativos são executadas via processo, assim sendo, caso haja algum erro na integração a operação executada não será desfeita, sendo necessário seguir o seguinte processo:
* Analisar a mensagem de erro obtida
* Corrigir a origem do problema
* Reencaminhar a mensagem de integração
* Caso o erro não seja sanado deve-se fazer os ajustes de forma manual Para integrar esta entidade, o PROTHEUS exige que sejam cadastrados valores defaults para Plano de Contas em sua base (para cada filial), com os seguintes parâmetros:
* Código: 001
* Descrição: “Default Integração”
* Classe de conta: Analítica
* Condição normal: Credora - No processo de Transferência de Controle (filial e centro de custo) é necessário cadastrar no PROTHEUS cotação de moeda para a moeda utilizada na data de transferência. Caso não exista cotação de moeda na data de transferência, podem ser apresentadas as seguintes mensagens de erro: “HELP: AF010JABAI” ou “HELP: AF060NOTXA”.
- O campo “N1_CHAPA” da tabela de Ativos do PROTHEUS deve ter seu tamanho alterado para 30 caracteres para ficar compatível com o RM.
|
Cadastro de Cargo
Identificador da Mensagem: EmployeePosition
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/04P6E
...
Identificador da Mensagem: Employee
Versão: 2.001
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/9Yv6E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- A informação de centro de custo é obtida a partir da seção do funcionário. Sendo assim, é necessário atentar ao cadastramento das seções, pois esta entidade ocupa no RM o mesmo nível hierárquico do centro de custo no Protheus.
- O cadastro de centros de custo do Labore (tabela PCCUSTO) deve trabalhar conforme o processo “Sincronização Centro de Custo Global”, que mantém o cadastro da tabela PCCUSTO espelhada com a tabela de centro de custo global (“GCCUSTO”).
- Para integrar a entidade Funcionário, o PROTHEUS exige que sejam cadastrados valores defaults para Banco/Agência/Conta. Estes registro devem ser cadastrados com o seguintes códigos abaixo:
* Banco / Agência / Conta com códigos: 001 / 00000 / 0000000000 A exclusão de funcionário é executada via processo, assim sendo, caso haja algum erro na integração a exclusão não será desfeita, sendo necessário seguir o seguinte processo:
* Analisar a mensagem de erro obtida
* Corrigir a origem do problema
* Reencaminhar a mensagem de integração
* Caso o erro não seja sanado deve-se fazer a exclusão de forma manual - Para que a exclusão seja efetuada com sucesso no Protheus é necessário executar o update “RHUPDMOD” no mesmo para normalizar a base de dados para integração.
- Serão integrados somente funcionários cujo Tipo de Recebimento for igual à Mensalista ou Semanalista.
- O rateio de funcionário por centro de custos não será integrado, pois o mesmo não é utilizado pelo sistema SigaMNT.
- Caso a chapa do funcionário no RM seja maior que 6 caracteres, este campo no PROTHEUS deve ser configurado como autoincremento.
|
Cadastro de Local de Estoque
Identificador da Mensagem: Warehouse
Versão: 1.000
Mandatário: BackOffice RM
Tipo de Envio: Síncrono
Mapeamento de Campos: http://tdn.totvs.com/x/b4z6E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- Caso o código do Local de Estoque no RM seja maior que 2 (dois) caracteres, no PROTHEUS o código do local de estoque deverá ser autoincremento.
|
Processos
Conforme descrito na seção de apresentação do escopo, o escopo da integração se restringe aos processos relacionados a Gestão de Frotas e Manutenção de Ativos que sejam pertinentes de manipulação no BackOffice, como integrações fiscais, financeiras ou controle de estoque.
...
Tipo de Fluxo: Protheus -> RM
Mensagem: Request
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/-476E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- As mensagens de solicitação de compra ou armazém enviadas ao BackOffice RM serão originadas no SigaMNT ao se cadastrar insumos como previstos, respeitando as devidas regras de negócio implementadas no SigaMNT. O fluxo das ordens de serviço, que inicia o fluxo das solicitações, é descrito no anexo Fluxo da ordem de serviço no SigaMNT.
Ciclo de vida das solicitações: - Solicitação de compra:
A solicitação de compra segue o processo padrão definido pelo TOTVS Gestão de Estoque, Compras e Fatuarmento, podendo passar pelo processo de cotação ou não, sendo que a baixa de estoque referente aos produtos comprados deve ser inserida no BackOffice via cópia por referência para o movimento de OS com o tipo de relacionamento “Cópia Simples com Relacionamento somente de movimento”. - Solicitação de armazém (estoque):
A solicitação de armazém segue o processo padrão definido pelo TOTVS Gestão de Estoque, Compras e Fatuarmento, sendo que a baixa de estoque destas solicitações devem ser efetuadas através do processo de faturamento disponibilizado em tela e com o tipo de movimento parametrizado como sendo de Baixa de Estoque para o SigaMNT.
Caso o faturamento não seja feito por tela ou não utilize o tipo de movimento parametrizado como sendo de Baixa de Estoque para o SigaMNT a Fórmula Visual NÃO será disparada, assim o SigaMNT não será informado da mesma.
|
Consulta Situação da SA/SC
Tipo de Fluxo: Protheus -> RM
Mensagem: TranceAbilityRequest
Versão: 1.001
Especificações BackOffice RM: Consulta situação Solicitação de Armazém/Solicitação de Compras
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- Disponível a partir da versão da biblioteca 12.1.15.160.
|
Cancelar Solicitação de Armazém/Compra
Tipo de Fluxo: Protheus -> RM
Mensagem: CancelRequest
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/apP6E
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- No caso de alteração de insumos, logo após este fluxo deve ser executado o de inclusão da nova solicitação no BackOffice, conforme definido no item Solicitações de Armazém/Compra.
- A partir da versão da biblioteca 12.1.15.160 existe a mensagem TRANCEABILITYREQUEST onde o Protheus consulta o STATUS da SC/SA no RM, caso a mesma esteja em um Status que não é possível excluir o RM retorna ao Protheus a informação que não pode excluir esta SC/SA e caso seja apenas a inclusão de um novo item o ERP cria um novo movimento de SC/SA sem alterar o movimento antigo.
|
Ordem de Serviço
Tipo de Fluxo: RM -> Protheus e Protheus -> RM
Mensagem: MaintenanceOrder
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/25P6E
...
- Parametrização do cronograma no TOP.
- Parametrização da integração TOP x TOTVS Gestão de Estoque, Compras e Faturamento.
Notas:
| Expandir |
|---|
| title | Clique aqui para expandir |
|---|
|
- No caso de alteração de insumos, logo após este fluxo deve ser executado o de inclusão da nova baixa no BackOffice, conforme definido no item Baixa de Estoque.
- O parâmetro “TMVApropriacao” deverá te seu valor atualizado com o código do tipo de movimento de Apropriação de Custos específico da integração.
* Quando as integrações TOP com NG e BackOffice RM com NG estiverem habilitadas, o movimento inserido pela integração “BackOffice RM x NG” não deverá apropriar custos no TOTVS Obras e Projetos, pois para não existir duplicação de informações a apropriação deverá ser gerada pela integração TOP com NG. Sendo assim o tipo de movimento de Apropriação de Custos deve ser configurado para Não Gerar Apropriação, ou seja, o parâmetro Gera Apropriação da etapa Projeto do Tipo de Movimento deve estar desmarcado.
|
Ampliação Patrimonial
Tipo de Fluxo: Protheus -> RM
Mensagem: AssetsValuation
Versão: 1.000
Mapeamento de Campos: http://tdn.totvs.com/x/pZv6E
...
- Acesse o contexto de integração.
- Executar o processo 'Configurar' na aba 'Ferramentas'.
- Selecionar o pacote de integração 'TOTVS Manutenção de Ativos x BackOffice RM" e executar o processo.
- Acessar a rotina "Integrações" (Integração | Mensagem Única | Integrações) e parametrizar o campo 'URL WebService" com o caminho do WebService do Protheus.
- Acessar o anexo "Parâmetros de Integração"
5.1 Configure o parâmetro "CodClassificPais" com o código da tabela de classificação utilizada e associada aos países referente à classificação do IBGE.
5.2 Informe os Códigos dos Tipos de Movimento criado anteriormente para cada um dos processos que será utilizado.
Observação: Este é apenas um exemplo, deve-se informar o Valor com o Código do Tipo de Movimento criado no ambiente do cliente.
...
| Âncora |
|---|
| Cadastrar De-Para |
|---|
| Cadastrar De-Para |
|---|
|
Cadastrar De-Para de Empresas e Filiais
...
Valor Chave Integração: Código do grupo de empresa do Protheus + '|' + Código completo da filial no Protheus (composto por Empresa + Filial)
...
| Âncora |
|---|
| Importação de Fórmulas Visuais |
|---|
| Importação de Fórmulas Visuais |
|---|
|
Importação de Fórmulas Visuais
...
- Acessar o processo "Executar" no Menu "Gestão -> Fórmula Visual"
- Selecionar a Fórmula Visual de carga desejada e ícone no botão "Executar"
- Após a execução é necessário acessar o arquivo de Log para verificação do status dos envios para o Protheus.
O Log estará disponível na pasta "Carga Inicial / Logs" dentro do diretório de instalação do RM (RM.Net).
...
| Âncora |
|---|
| De-para das Unidades de Medida |
|---|
| De-para das Unidades de Medida |
|---|
|
Cadastrar De-para das Unidades de Medida padrão
...
- No RM Acessar o menu Integração | Mensagem Única | De-para
- Incluir um novo Registro de acordo com os dados abaixo
Exemplo:
Observação: O valor da Chave Integração pode alterar de acordo com o código da empresa e níveis de gestão utilizados no Protheus.
- Acessar o SIGACFG no Protheus em Ambiente | Schedule | De/Para Mensagem Única
- Incluir um novo Registro de acordo com os dados abaixo
Exemplo:
Observação: Alguns dados podem alterar de acordo com o código da empresa, nível de gestão e etc.
...
| Âncora |
|---|
| Cadastrar os valores defaults para Plano de Contas |
|---|
| Cadastrar os valores defaults para Plano de Contas |
|---|
|
Cadastrar os valores defaults para Plano de Contas
...
- Acessar o Protheus no Ambiente 1 - Ativo Fixo
- Acessar Cadastros | Plano de Contas
- Incluir novo registro, conforme exemplo abaixo (É necessário fazer o processo para cada Filial do Protheus).
...
| Âncora |
|---|
| Cadastrar os valores defaults para Banco, Agência e Conta |
|---|
| Cadastrar os valores defaults para Banco, Agência e Conta |
|---|
|
Cadastrar os valores defaults para Banco, Agência e Conta
...
- Acessar o cadastro de Funcionário no RM
- Na aba Seção, Editar a Seção do Funcionário
- Dentro da Seção, na aba Dados Contábeis, verificar se possui centro de custo no Funcionário e se este centro de custo está integrado
- Para sincronizar os Centros de Custos do RH como Global, deve-se acessar o sistema Folha de Pagamento
- Aba Administração Pessoal | Centros de Custos
- Acessar Processos | Sincronização Centro de Custo Global
...
| Âncora |
|---|
| Fluxo da ordem de serviço |
|---|
| Fluxo da ordem de serviço |
|---|
|
Fluxo da ordem de serviço no SigaMNT (status e pontos de integração)
...
