Como Integrar com o InvoiCy Conector – versão 5.0

Última atualização em: 16 de abril, 2021

Olá! Neste artigo iremos exemplificar o processo de integração com o InvoiCy utilizando o aplicativo InvoiCy Conector. Mostraremos um exemplo prático de envio de um documento fazendo uso desse aplicativo. Vamos lá!

A partir deste momento assumimos que você já leu o artigo “Como funciona o InvoiCy Conector” e “Cadastro de empresas via interface web”. Caso ainda não tenha lido tais artigos por favor volte um passo, antes de iniciar a leitura deste documento.

1. Inicialmente, configure o InvoiCy Conector de acordo com a sua preferência de diretórios. Exemplo:

2. Após o aplicativo devidamente configurado e as informações salvas, vamos agora gerar um documento de integração que posteriormente será salvo no diretório de Entrada para ser enviado ao InvoiCy. Neste artigo, estaremos gerando um documento NF-e como exemplo, porém você poderá gerar o documento de sua preferência.

Clique aqui para ver um exemplo de documento XML de uma NF-e.

3. Os arquivos XML de cada documento devem ser gerados a partir dos layouts abaixo:

NF-e / NFC-e layout 4.00: download

CT-e layout 3.0: download

CT-e Eventos: download

NFS-e: download

NFS-e Cancelamento: download

NFS-e Consulta: download

MDF-e 3.0: download

Eventos MDF-e: download

Consulta de Status de Documentos: download

4. Depois de gerado o documento o mesmo deverá ser salvo dentro do diretório de “Envio” configurado no InvoiCy Conector. No momento que o arquivo for salvo no diretório o aplicativo fará a sua leitura e processamento, enviando o mesmo para o InvoiCy, que por sua vez fará o envio para a SEFAZ e devolverá um retorno no diretório de Retorno configurado no InvoiCy Conector.

Clique aqui para obter um exemplo de retorno do Conector InvoiCy.

O arquivo de retorno conterá a seguinte estrutura em sua nomenclatura:

CNPJ: 14 posições (ex: 88128984000224)

Numero: 9 posições (ex: 000000123)

Serie: 5 posições (ex: 00451)

Evento: 6 posições (ex: 110111)

Sequencial do evento: 2 posições (ex: 01)

Ex: 881289840002240000001230045100000000-ret.xml (Exemplo de retorno do envio de uma nota)

Ex: 881289840002240000001230045111011101-ret.xml (Exemplo de retorno do envio de um evento de cancelamento)

5. Após o envio do documento pelo aplicativo, serão salvos no diretório Arquivos, configurado no InvoiCy Conector, os arquivos XML e PDF do documento enviado, caso o mesmo for efetivado. O arquivo XML é o arquivo protocolado pela SEFAZ. Já o PDF será o DANFE para o caso de NF-e/NFC-e, DACTE para o caso de CT-e, DAMDFE para o caso de MDF-e e Espelho de RPS para o caso de NFS-e.

Estes são os processos básicos de envio e retorno de documentos através do InvoiCy Conector. Em nosso próximo artigo estaremos disponibilizando exemplos de envio e retorno para cada documento que pode ser emitido através do InvoiCy.