Child pages
  • DI_SIGATMS_x_Datasul_Faturamento_Fiscal
Skip to end of metadata
Go to start of metadata

INTEGRAÇÃO PROTHEUS SIGATMS X DATASUL FATURAMENTO FISCAL

Contexto de negócio (Introdução)

Integração do TMS (Protheus) com o módulo de Faturamento (Datasul) para receber os documentos (CT-e's e NFS-'e) emitidos pelo TMS.

 

Sistemas Envolvidos

Linha Microsiga Protheus

  • SIGATMS (Transportation Management System): sistema de gerenciamento de transportes que tem como objetivo principal controlar todos os processos fiscais e gerenciais envolvidos na operação de transportes, bem como, controlar os veículos, motoristas, fretes e viagens da empresa e de terceiros, entre as atividades mais importantes destacam-se controle das despesas dos veículos, viagens, fretes, emissão de CTRC (Conhecimento de Transporte Rodoviário de Cargas), nota fiscal de serviço, manifesto e outros. O SIGATMS controla todos os processos de um transportador, abrangendo as áreas: operacional, comercial, seguros, faturamento, logística e SAC. Solução totalmente integrada com a área administrativa (financeiro, fiscal e contábil).

Linha Datasul (BackOffice)

  • ERP Datasul: Sistema de BackOffice para gestão de empresas com ênfase no segmento de Manufatura. Disponibiliza módulos de gestão de controle da distribuição com foco nos requisitos comerciais, fiscais e tributários, entre eles: Pedidos de Venda, Faturamento e Embarques.

 

Integração

O módulo SIGATMS da linha Microsiga Protheus possui integração nativa com os módulos de BackOffice de mesma linha como, faturamento (SIGAFAT), fiscal (SIGAFIS), financeiro (SIGAFIN) e contábil (SIGACTB).

Existem clientes da linha Datasul que demandam a necessidade de utilização de um módulo de Gestão de Transportes como o SIGATMS, porém mantendo os módulos de BackOffice da linha Datasul.

Para que seja possível atender esta demanda e possibilitar uma nova oferta de mercado TOTVS, através desta integração será possível a utilização do módulo SIGATMS da linha Microsiga Protheus integrado aos módulos de BackOffice da linha Datasul (faturamento, fiscal, financeiro e contábil). Este documento especificamente apresenta os detalhes da integração do SIGATMS com os módulos Datasul: Faturamento e Fiscal.

  • Premissas
    • Permitir que os conhecimentos de transportes (CT-e) ou notas ficais de serviço de transporte (NFS-e/NFS) gerenciados pelo SIGATMS possam ser escrituradas no Datasul, em atendimento a legislação vigente, no que se trata os arquivos SPED Fiscal e SPED Contribuições;
    • O fluxo de integração é SIGATMS (sender) para o Datasul (receiver), não havendo integração reversa, ou seja, se implantado um documento diretamente no Datasul, o mesmo não será integrado ao SIGATMS;

Escopo

Possibilitar as integrações de CT-e's e NFS-e's com o módulo de Faturamento (Datasul) para que os mesmos sejam escriturados fiscalmente (SPED FIscal e SPED Contribuições) e contabilizados usando as rotinas Datasul.

Abaixo o mapa mental de toda a integração entre o TMS e o Datasul:

 

Pré-requisitos instalação/implantação/utilização

Datasul

Pré-requisitos necessários:

Versão Mínima12.1.16
Ferramentas necessáriasEAI2

Protheus

Pré-requisitos necessários:

Versão Mínima12.1.17
Módulo implantadoSIGATMS - Gestão de Transportes
Funcionalidades implantadasConhecimento de Transporte Eletrônico (CT-e)
Ferramentas necessárias¹Servidor WebServices Protheus iniciado
 Schedule Protheus configurado

¹Ajuste o timeout do servidor HTTP na qual o WebService Proteus estará para acima de 15 minutos (900 segundos).

  1. Acessar o ambiente Protheus / Programa inicial: APWEBWIZARD;
  2. Servidor Internet (HTTP/FTP) / HTTP;
  3. Altere o parâmetro: TimeOut de Sessions WEBEX para 900;

Instalação/Atualização

Datasul

Parâmetros de Integração

  1. Parâmetros de integração ativo: Menu -> Financeiro / Controladoria -> Universal -> Parâmetros Funções do Produto -> Função: TMS Transportador;

  2. Parâmetro de integração na Natureza de Operação: CD0606 aba Adicionais -> Natureza Transporte TMS.

 

Protheus

Parâmetros de Integração

  1. Acessar o ambiente Protheus / Programa inicial: SIGACFG;
  2. Ambiente / Cadastros / Parâmetros;
  3. Busque e altere os parâmetros:

    ParâmetroDescriçãoValor
    MV_TMSERPERP que está integrado ao SIGATMS. 0 - Protheus, 1 - Datasul.1
    MV_TMSMFATModo de Faturamento do TMS. 1- Faturamento a partir do SE1; 2- Faturamento a partir do DT6          2
    MV_TMSOPECCódigo da natureza de operação do Datasul que será utilizado em CT-e Cortesia.<COD NATUREZA DTS>
    MV_TMSOPENCódigo da natureza de operação do Datasul que será utilizado em CT-e Normal.<COD NATUREZA DTS>
    MV_TMSOPNFCódigo da natureza de operação do Datasul que será utilizado em Nota Fiscal.<COD NATUREZA DTS>
    MV_ESPECIERelação entre a série e o tipo de documento fiscal. Exemplo: 1=CTE;UNI=NF (Indica que a série "1" será de documento do tipo CTE e a série "UNI" será de nota fiscal<SÉRIE=CTE/NF;>

Configurações EAI

  1. Cadastre um agendamento no Schedule para a rotina FWEAI de forma que fique sempre ativo (Este serviço é necessário para processamento das mensagens);

  2. Configure a rota para o ambiente Datasul que será integrado, através da alteração dos parâmetros ou do cadastro de rotas:

    (Lib inferior a label 20170208)

    ParâmetroDescriçãoValor
    MV_EAIWSNome do Client WS do EAI para envio a outro EAI.WSEAIDATASUL
    MV_EAIURL2Nome do canal configurado no EAI para envio a outro EAI. http://<HOST>:<PORTA>/eai2-ws/EAIService * Ambiente Datasul
    MV_EAIMETHMétodo de envio do EAI para envio a outro EAIreceiveMessage
    MV_EAIXSDDiretórios dos XSD usados na validação<DIRETÓRIO XSD>
    MV_EAIUSERUsuário para autenticação<USUÁRIO>
    MV_EAIPASSSenha para autenticação<SENHA>

     

    (Lib igual ou superior label 20170208)
    Através do cadastro de rotas:

    1. Acessar o ambiente Protheus / Programa inicial: SIGACFG;
    2. Ambiente / Schedule / Cadastro Rotas Eai;

      ProdutoAplicaçãoURLClient WSMétodoUsuárioSenha
      DATASUL<Aplicação Datasul>http://<HOST>:<PORTA>/eai2-ws/EAIService * Ambiente DatasulWSEAIDATASULreceiveMessage<USUÁRIO><SENHA>
       
  3. Realize o cadastro de De/Para de Empresas Mensagem Única:
    1. Acessar o ambiente Protheus / Programa inicial: SIGACFG;
    2. Ambiente / Schedule / Emp.filial Mensagem Única

      ReferênciaCompanyBranchEmp.ProtheusFil.Protheus
      DATASUL<EMPRESA DATASUL> <EMPRESA PROTHEUS><FILIAL PRINCIPAL>
      Cadastre o De/Para para todas as empresas que possuírem integração
  4. Devem ser realizados os seguintes cadastros de adapters EAI:
    1. Acessar o ambiente Protheus / Programa inicial: SIGACFG;
    2. Ambiente / Schedule / Adapter E.a.i;
    3. Cadastre os seguintes registros:

      Mensagem única?RotinaMensagemDescriçãoEnvia?Recebe?MétodoOperaçãoCanal EnvioXSDVersão Envio
      1 - SimTMSAE76ELECTRONICTRANSPORTDOCUMENTCTE PARA FATURAMENTO DATASUL1 - Sim1 - Sim2 - Assíncrono1 - Todas2 - EAI 1.000

      Observação (Lib igual ou superior label 20170208)

      Vincule a rota criada do produto Datasul e indique o campo Envia como Sim para todos os adapters que enviam mensagem (Envia? 1 - Sim).

Informações necessárias em Cadastros

Cadastro no menuInformações necessáriasObservação
Atualizações / Cadastros / ClientesNome, endereço, estado, CEP, Cd. Município, País, CNPJ/CPF, Insc. Estadual, Reg. ClienteEstas informações são necessárias para o correto funcionamento da integração do CTe e NFST com o Faturamento/Fiscal Datasul. A relação entre os clientes cadastrados no Protheus e os clientes cadastrados no Datasul é dada através do CNPJ + Inscrição estadual.
Atualizações / Cadastros / ProdutosCódigoO código dos produtos de cálculos do SIGATMS devem ser correspondentes aos códigos de itens cadastrados no Datasul.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

 

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.

 

Transações/Entidades/Mensagens únicas

 

Método

ID

Descrição

Origem

Destino

XSD (versões podem variar)

Processos

02

Envio CTE/NFST para o Datasul

Protheus

Datasul

ElectronicTransportDocument_1_000.xsd

Fluxo das Informações

Os documentos integrados são gerados, calculados, impressos e controlados pelo TMS, ou seja, no Datasul apenas é feito uma cópia para escrituração fiscal, contabilização e integração com Contas a Receber, utilizando as rotinas padrões. Serão integrados pelo TMS somente após autorizados pelo SEFAZ (CT-e) ou conversão pela Prefeitura (NFS-e), portanto as informações recebidas no XML, não poderão ser alteradas no ERP (módulo de faturamento). A exceção serão as notas fiscais de serviço cujo o município não possua emissão eletrônica, em que a validação do documento para interação será realizada pelo TMS.

 

Processos

  1.  Autorização CTe / NFST

    Tipo de Fluxo: Protheus -> Datasul
    Mensagem: ElectronicTransportDocument_1_000
    Versão: 1.000
    Modo: Assíncrono

    O processo de autorização do CTe pelo SEFAZ ou NFST pela prefeitura dentro do módulo SIGATMS irá disparar a integração com o módulo de Faturamento Datasul que por sua vez integrará com o módulo Fiscal automaticamente e com o módulo Financeiro manualmente se executado o programa Atualização do Contas a Receber (FT0603). Assim também o Cancelamento do CTe e NFST e a Inutilização do CTe.
    O processo de autorização, cancelamento e inutilização se mantém o mesmo já existente no módulo SIGATMS, porém, quando houver integração com o ERP Datasul (ativação através do parâmetro MV_TMSERP), também será realizado esta integração com o backoffice.

     

    Este processo ocorre somente após:
    CTe: do retorno do SEFAZ autorizando o mesmo;
    NFST: do retorno da prefeitura autorizando a mesma (caso a integração com a prefeitura ocorra de forma eletrônica) ou alterando o registro fiscal no módulo de Livros Fiscais do Protheus indicando o status SEFA e Nr Eletrônico que indique autorização ou cancelamento;

Notas:

Integração no modo assíncrono: ao ser disparada, a mensagem será enviada ao EAI Protheus para que seja processada pela agenda do programa FWEAI no Schedule. Ao processar a mensagem, será enviada ao EAI Datasul que por sua vez irá processar a mensagem conforme agenda do programa Registrar Fila do EAI2 no RPW (BTB948AA).

É estritamente necessário que o Schedule Protheus e RPW Datasul estejam corretamente configurados para o processamento no modo assíncrono.

Integração no modo síncrono: ao ser disparada, a mensagem será enviada pelo EAI Protheus diretamente ao EAI Datasul, que irá processar e retornar a resposta. O processo que disparou a mensagem fica aguardando até o retorno da resposta do ambiente destino para dar continuidade em sua execução.

 

Limitações / Restrições Gerais

  • No Datasul é feita várias validações na integração dos documentos, exemplo: Cliente não Cadastrado ou Série não cadastrada, por tanto os cadastros devem estar devidamente configurados.
  • Documentos implantados pela integração deverão ser cancelados pelo TMS, no Datasul os programas de cancelamento e alteração serão bloqueados para documentos integrados.

 

Como fazer

  1. Autorização CTe / NFST

    1. CT-e - Inclusão
      1. Acesse o ambiente Protheus, módulo SIGATMS, Atualizações / Recebimento / Entrada Documento de Clientes;
      2. Inclua um novo documento com um lote Eletrônico para geração do conhecimento de transporte eletrônico;
      3. Calcule o documento em Outras Ações / Cálculo Frete / Calcular;
      4. Acesse o Monitor CT-e, selecione o documento e clique em Transmitir;
      5. É necessário que o retorno da SEFAZ esteja como 100 - Autorizado o uso do CT-e, para que seja disparada a integração, por isso, enquanto estiver em processamento é necessário consultar o Status até que o retorno seja atualizado;
      6. Após ser autorizado, a mensagem de integração pode ser consultada em Miscelânea / Monitor EAI (Código da função: ELECTRONICTRANSPORTDOCUMENT);
      7. Também serão criados registros na tabela DJQ e DJR ao ser acionada a integração. Através da rotina Atualizações / Recebimento / Reenvio DTS, poderá ser consultado os registros enviados ao EAI e caso ocorra algum erro retornado pela resposta Datasul, após corrigi-los, a mensagem pode ser reenviada através deste monitor;

    2. CT-e - Cancelamento
      1. Acesse o ambiente Protheus, módulo SIGATMS, Atualizações / Recebimento / Entrada Documento de Clientes;
      2. Selecione o documento desejado para ser cancelado e vá em Outras Ações / Cálculo Frete / Estornar;
      3. Marque o documento que deve ser estornado e clique em Confirmar;
      4. Será apresentado um Help indicando que o cancelamento deve ser autorizado pelo SEFAZ;
      5. Para transmitir os documentos cancelados é necessário acessar o Monitor CT-e em Outras Ações / Cálculo Frete / CT-e;
      6. Não selecione nenhum documento e clique em Transmitir, será apresentado uma questão indicando se devem ser transmitidos os documentos cancelados, clique em sim;
      7. Quando houver a autorização de cancelamento pelo SEFAZ, será disparado a integração com o Datasul;
      8. Caso ocorra algum erro durante o cancelamento, após corrigi-los, a mensagem de integração poderá ser reenviada pela rotina Atualizações / Recebimento / Reenvio DTS;

    3. CT-e - Inutilização
      1. No Protheus, caso na transmissão do documento ao SEFAZ ocorra algum erro no retorno (Exemplo: 002 - Não foi possível assinar o CT-e...) e seja realizado o estorno deste documento, automaticamente é transmitido ao SEFAZ a solicitação de inutilização;
      2. Quando o SEFAZ autoriza a inutilização é chamado a integração com o Faturamento e Fiscal Datasul;

    4. NFST - Inclusão
      1. Acesse o ambiente Protheus, módulo SIGATMS, Atualizações / Recebimento / Entrada Documento de Clientes;
      2. Inclua um novo documento com um lote Normal para geração da NFST;
      3. Calcule o documento em Outras Ações / Cálculo Frete / Calcular;
      4. Para efetuar o processo de autorização desta NFST, é necessário acessar o módulo Livros Fiscais (09);
      5. Miscelânea / Acertos / Acertos Fiscais;
      6. Posicione no registro fiscal relacionado a NFST e clique em Alterar;
      7. Será apresentado uma mensagem de aviso de alteração, clique em Sim;
      8. Informe o Nr. Eletr. e o Retorno SEFA como 100 (Autorizado), após clique em Salvar;
      9. Neste momento é disparado a integração com o Faturamento Datasul que irá atualizar o módulo de Fiscal;

    5. NFST - Cancelamento
      1. Acesse o ambiente Protheus, módulo SIGATMS, Atualizações / Recebimento / Entrada Documento de Clientes;
      2. Selecione o documento desejado para ser cancelado e vá em Outras Ações / Cálculo Frete / Estornar;
      3. Marque o documento que deve ser estornado e clique em Confirmar;
      4. Acesse o módulo Livros Fiscais (09), Miscelânea / Acertos / Acertos Fiscais;
      5. Posicione no registro fiscal relacionado a NFST e clique em Alterar;
      6. Será apresentado uma mensagem de aviso de alteração, clique em Sim;
      7. Informe o Retorno SEFA como 101 (Cancelado), após clique em Salvar;
      8. Neste momento é disparado a integração com o backoffice Datasul;

 

Situações comuns

Problemas de integração (Protheus):

Situação

Possíveis Causas

Solução

Ao realizar a autorização do CT-e no SIGATMS, não disparou a mensagem de integração para o Faturamento Datasul (ELECTRONICTRANSPORTDOCUMENT).

  1. Adapter não está cadastrado corretamente;
  2. Série informada para o CT-e não está parametrizada corretamente no parâmetro MV_ESPECIE;
  1. O adapter para a transação ELECTRONICTRANSPORTDOCUMENT deve estar conforme orientação deste documento no tópico de configuração;
  2. Relacione a série utilizada com os tipos de documento: CTE e NF no parâmetro MV_ESPECIE;
NFSE Chave Registro: 9999999999999|999|9999999 Relacionamento Série X Estabelecimento não cadastrado.
  1. A série enviada pelo SIGATMS na integração com o Faturamento Datasul não está cadastrada no Datasul;
  2. Não há a relação no Datasul da série enviada pelo SIGATMS com o estabelecimento;
  1. É necessário que o SIGATMS e o Datasul trabalhem com os mesmos códigos de séries;
  2. É necessário relacionar a série com o estabelecimento no programa FT0114;

 

Erros de integração:

CódigoErroRota de integraçãoSituação
EAI005Adapter com.totvs.datasul.logistics.dis.ElectronicTransportDocumentAdapter gerou uma exceção...DATASUL -> PROTHEUSVerifique o log de processamento da mensagem no Datasul (logs: RPW e Appserver), pois foi gerado um erro Progress que gerou a exceção.
56Unidade da Federação: SP inexistente.DATASUL -> PROTHEUSÉ provável que o código IBGE do País da Unidade de Federação não tenha sido informado no cadastro do cliente (Protheus) em um dos clientes relacionados ao conhecimento (remetente, destinatário, devedor, consignatário).
8Não foi enviada a data do cancelamentoDATASUL -> PROTHEUS

Durante o processo de cancelamento de uma NFST, foi realizado a alteração do status SEFA do registro fiscal Protheus antes de realizar o estorno do cálculo do conhecimento e por isso a data não foi enviada na mensagem de integração.

Realize o estorno do cálculo do conhecimento e após reenvie a mensagem de cancelamento através da rotina de Atualizações / Recebimento / Reenvio DTS.