Integração eDocs x Softran
O eDocs possui integração com as soluções da Softran, responsáveis pela emissão de arquivo XML de NF-e, CT-e, MDF-e e NFS-e, além dos eventos de correção (CC-e) de NF-e e CT-e.
O processo de emissão dos documentos eletrônicos é o mesmo utilizado pelo Gestão Empresarial | ERP, porém a Softran possui processos específicos para atender o segmento de Transportadoras.
- Selecione a opção Arquivo XML (Softran) no campo Forma integração (Saída), na guia Filial da tela Configuração de Filial, para indicar a forma de integração utilizada pela Softran;
- Habilite o campo Ativar web service de download, na guia Integração da tela Configuração Geral, para ativar os web services BaixarPdf e BaixarXml, que permitem o download dos arquivos XML e PDF dos documentos autorizados;
- Selecione a opção Arquivo XML no campo Recebimento de documentos (XML), das telas Configuração de Empresa ou Configuração de Filial, para utilizar recebimento utilizado pela Softran;
- Marque a opção Sim no campo Receber documentos onde a filial é transportadora ou terceiro, da guia Filial da tela Configuração de Filial, para permitir o recebimento de notas fiscais em que a filial é transportadora ou terceira.
Nota
As configurações acima são específicas para a integração com a Softran, porém todas as demais configurações e parâmetros necessários para integração com o Gestão Empresarial | ERP devem ser observados.
- O ERP Softran emite o arquivo XML de NF-e, CT-e e MDF-e no padrão de SEFAZ e no padrão ABRASF 1.0 para NFS-e, com a tag <infSenior>, nos diretórios de integração da filial;
- O eDocs recebe o documento e faz o envio para a SEFAZ;
- Após receber o retorno da SEFAZ, verifica os documentos que devem ser retornados para a Softran;
- Converte os documentos em um arquivo XML no padrão de leiaute da SEFAZ;
- Armazena o arquivo XML no diretório PastaFilial/Retorno/ com o nome no padrão Softran_Chave/ID documento.xml.
O processo descrito acima, aplica-se para NF-e e MDF-e. Para CT-e e NFS-e o processo é o seguinte:
- CT-e
- Após receber o retorno da SEFAZ, verifica os documentos que devem ser retornados para a Softran;
- Caso o CT-e esteja Autorizado, busca o arquivo de autorização retornado pela SEFAZ e armazena esse arquivo na pasta de retorno;
- Caso o CT-e esteja Rejeitado ou Denegado, recompõe o arquivo de retorno da SEFAZ e armazena na pasta de retorno.
Este processo aplica-se também para os eventos de cancelamento e carta de correção de CT-e.
- NFS-e
- Após receber o retorno da Prefeitura, verifica os documentos que devem ser retornados para a Softran;
- Caso a NF-e esteja Autorizada, busca o arquivo de autorização retornado pela Prefeitura e gera o arquivo XML com as tags tipoOperacao, chave, cnpjEmissor, codigoVerificacao, dataAutorizacao, numeroRps, serie e situacao;
- Caso a NF-e esteja Cancelada, recompõe o arquivo de retorno da Prefeitura e gera o arquivo XML com as tags tipoOperacao, chave, cnpjEmissor, numeroNfse, numeroRps, serie e situacao;
- Caso ocorra crítica na integração da NFS-e, gera o arquivo XML com as tags tipoOperacao, chave, cnpjEmissor, numeroRps, serie e situacao.
Observação
Consulte aqui o leiaute de integração da softran com o eDocs.
Quando um CT-e ou NF-e é emitido em contingência, e gerado um arquivo indicando que a chave do documento foi alterada, e qual é a nova chave. A partir do momento em que a filial sair de contingência, o documento é enviado com a chave alterada.
Esses arquivos são gerados somente quando o documento está Autorizado em contingência, essa situação é diferente para cada tipo de contingência:
- Para contingência EPEC, o arquivo é gerado quando o documento estiver na situação Registrado EPEC;
- Para contingência SVC, o arquivo e gerado quando o documento estiver Autorizado/Autorizado fora do prazo;
- Para as contingências FS/FS-DA, os arquivos sempre são gerados para documentos integrados neste tipo de contingência, pois essas contingências não fazem nenhum envio para a SEFAZ.
Desta forma, em algumas situações são gerados dois arquivos.
Ao emitir um CT-e em contingência SVC que ficou com a situação Autorizado, é gerado um arquivo para contingência e outro arquivo de autorização.
Quando um documento é rejeitado em contingência, a sua chave é alterada no eDocs. Porém, como o documento ainda não foi autorizado, o ERP Softran não recebe a nova chave. Então na geração do arquivo de retorno de rejeições em contingência, é utilizada a chave antiga do documento, tanto no nome do arquivo quanto para as tags do conteúdo.
O ERP Softran envia e-mails adicionais do arquivo XML. Esses e-mails são enviado através da tag <infSenior>, conforme exemplo:
<infSenior>
<emails>
<email>exemplo1@email.com.br</email>
<email>exemplo2@email.com.br</email>
<email>exemplo3@email.com.br</email>
</emails>
</infSenior>
Essas informações são removidas do arquivo enviado para a SEFAZ e após a autorização do documentos o e-mail é enviado para os endereços que constam no arquivo XML.
O ERP Softran gera a fatura agrupada das prestações de serviço de transporte, ou seja, a transportadora presta vários serviços para um tomador e emite apenas uma fatura/cobrança, agrupando vários CT-es/NF-es. No envio da fatura por e-mail, são enviados os arquivos XML de distribuição e PDF dos Documentos Auxiliares.
O eDocs utiliza os web services BaixarPdf e BaixarXml, para que a Softran possa através deles, requisitar os arquivos PDF e XML e envia-los no processo de fatura.
Após o recebimento de CT-e ou NF-e via e-mail, o eDocs valida o documento na SEFAZ e disponibiliza o arquivo XML em um diretório, onde o ERP Softran faz a importação. Caso o download automático esteja ativo, o sistema faz o download e disponibiliza o arquivo XML no diretório para importação.
Este processo é realizado quando o campo Recebimento de documentos (XML) estiver parametrizado como Arquivo XML.
No campo Tempo em dias para permanência dos arquivos de retorno de XML recebidos, disponível na guia Avançado > Intervalos de Execução da tela Configuração Geral, é possível parametrizar o tempo de permanência de um arquivo XML de recebimento para retorno, o valor informado nesse parâmetro indica o tempo um arquivo pode permanecer no diretório até ser apagado.
Na geração de CT-e pelo ERP Softran, nos casos de transportadoras, as notas fiscais que compõe o CT-e são emitidas pelo emitente, com isso elas não estão na base de dados, e a chave e as demais informações necessárias precisam ser inseridas manualmente.
No eDocs as rotinas de recebimento de e-mail e download automático consideram os documentos em que ela não é o destinatário e sim Transportadora ou Terceiro, quando o campo Receber documentos onde a filial é transportadora ou terceiro, da guia Filial da tela Configuração de Filial, estiver parametrizado como Sim.
Essas NF-es são identificadas na tela de recebimento de NF-e como Transportador ou Terceiro e o arquivo XML é disponibilizado em um diretório para o ERP Softran faça a importação do arquivo.
Observação
Este padrão de integração (via arquivos no padrão da SEFAZ) pode ser utilizado por qualquer ERP, ou seja, não é exclusivo para integração com a Softran.