Manuais:UniNFe/Integracao do ERP com o UniNFe
Integrando softwares ERP com o UniNFe
A integração dos softwares ERP com o UniNFe é bem simples, bastando para isso gerar os arquivos XML que devem ser enviados para os serviços dos documentos fiscais eletrônicos (WebServices) na pasta de envio que foi previamente informada na tela de configuração do UniNFe, que o aplicativo automaticamente valida, assina os arquivos e os envia a SEFAZ.
O conteúdo de resposta obtido dos serviços (Webservices) serão gravados na pasta de retorno, também informada na tela de configuração do UniNFe.
Para todo arquivo XML enviado, o ERP deve aguardar um ou mais retornos.
Arquivos de envio
Independente do serviço solicitado, a forma de envio será sempre a mesma.
O software ERP deve gerar os arquivos XML na “pasta de envio” informada na tela de configurações para que o UniNFe saiba que algo deve ser processado.
Os nomes dos arquivos de envio devem seguir um padrão o quais demonstraremos na integração de cada serviço.
Sempre que o ERP gerar um arquivo de envio, deve ficar aguardando o arquivo de retorno correspondente para conseguir pegar a resposta dada pelo Webservice.
Os arquivos XML devem possuir o formato determinado no manual de integração criado pelos Órgãos Responsáveis pelos DFe´s.
Arquivos de retorno
Independente do serviço solicitado, a forma de retorno será sempre a mesma, o que muda, é o formato dos arquivos retornados, pois cada um tem um formato específico, de acordo com o padrão estabelecido pela SEFAZ.
Todos os arquivos retornados serão gravados na “pasta de retorno” informada na tela de configurações.
Pode-se obter como retorno do UniNFe duas extensões de arquivos:
- .XML = Se tudo ocorrer bem na conexão, o UniNFe vai gravar um arquivo XML com o conteúdo retornado pelo Webservice com a resposta do serviço.
- .ERR = Se por algum motivo o UniNFe não conseguir enviar o arquivo, seja por problemas de validação, conexão, assinatura do arquivo, etc, será gerado um arquivo no formato TXT com o erro ocorrido.
