Contingência para Módulo NF-e

Última atualização em: 31 de agosto, 2016

 

Olá! Neste artigo iremos falar sobre o processo de envio de documentos em contingência, as possíveis situações que podem acontecer e como o emissor deve proceder em cada uma delas.

Primeiramente o emissor deve definir as configurações relacionadas a contingência para sua empresa. Para isso, basta acessar o Painel de Controle, módulo NF-e, Configurações para emissão, como demonstra a imagem.

 

Para o módulo NF-e estão disponíveis as formas de contingência EPEC, SVC, FS-DA e Nenhuma, onde o InvoiCy possibilita que o emissor defina qual a opção de emissão será priorizada no momento em que o ambiente normal estiver indisponível.

Para definir a ordem das opções de emissão basta clicar nas flechas que estão ao lado de cada uma das opções, até posicioná-las na forma desejada. O InvoiCy fará o envio do documento de acordo com a primeira opção de contingência que estiver configurada. Caso a primeira opção de contingência não esteja disponível será realizada uma tentativa de envio para a opção seguinte, seguindo assim para todas as opções e só encerrando o processo ao chegar na opção Nenhuma.

Opções de contingência

Bem, antes de definir qual será a primeira opção de emissão em contingência, vamos entender as diferenças entre os ambientes SVC, EPEC e FS-DA.

O ambiente da SEFAZ Virtual de Contingência (SVC) tem sua disponibilidade controlada pela SEFAZ, sendo ativado geralmente quando a SEFAZ de origem realiza alguma manutenção programada em sua estrutura. Nestas circunstâncias, a SEFAZ de origem solicitará a ativação do ambiente SVC para sua UF, que passará a receber suas NF-e por um tempo pré-definido. As NF-e autorizadas pela SVC não precisam ser reenviadas, pois a sincronização dos documentos entre a SVC e a SEFAZ de origem é realizada automaticamente.

Já o Evento Prévio de Emissão em Contingência (EPEC) está disponível a qualquer momento, sendo recebido pelo Ambiente Nacional, porém um evento de NF-e registrado neste ambiente, necessita obrigatoriamente, de seu posterior envio para a SEFAZ de origem, realizando assim a conciliação do evento junto a autorização da NF-e.

Por fim, Contingência com uso do Formulário de Segurança para impressão de Documento Auxiliar é a alternativa mais simples para a situação em que exista algum impedimento para obtenção da autorização de uso da NF-e, como por exemplo, um problema no acesso à internet ou a indisponibilidade da SEFAZ de origem do emissor. O envio das NF-e emitidas nesta situação para SEFAZ de origem será realizado quando cessarem os problemas técnicos que impediam a sua transmissão. Essa é a última opção que recomenda-se utilizar para emitir em contingência, ou seja, quando nenhuma das outras opções estiverem ativas.

Outra informação que deve ficar entendida é que a contingência é definida por UF e não por empresa, ou seja, a partir do momento que qualquer uma das empresas emitentes em determinada UF deixar de receber o retorno de um documento da SEFAZ, esta UF passará a operar em contingência e todas as demais empresas desta UF também.

A partir do momento em que a contingência for ativada, o InvoiCy passará a verificar a ordem de contingência configurada em cada empresa e fará o envio dos documentos conforme esta configuração.

 

Contingência SVC

Se a contingência SVC estiver configurada como primeira opção, o InvoiCy fará o envio do documento para o ambiente da SVC, que uma vez estando ativo, fará as validações do documento e em caso de efetivação o emissor receberá como retorno o código 100, o arquivo xml e o DANFE (conforme configurações da empresa), indicando que o documento foi autorizado. Nesse caso o processo de envio em contingência foi executado com sucesso, a venda está autorizada e o emissor não tem a necessidade de consultar o status do documento, pois conforme vimos acima, a sincronização entre os ambientes será automática.

Em caso de rejeição o emissor deverá fazer a correção e o reenvio do documento. Se o ambiente da SVC não estiver ativo, o InvoiCy fará uma nova tentativa de envio do documento para o EPEC, caso esta for a próxima opção de contingência configurada, senão o processo continuará tentando enviar para as próximas opções de contingência, e só será encerrado quando chegar na opção ‘Nenhuma’, onde o documento ficará com o status Pendente.

Acesse o fluxo da contingência SVC.

 

Contingência EPEC

Agora, se a primeira opção for a contingência EPEC, o InvoiCy fará o envio de um evento com os dados do documento para o ambiente nacional da SEFAZ, onde passará por validações básicas em sua estrutura e em caso de autorização o emissor receberá como retorno de status da comunicação o código 109, e como retorno de status do documento o código 136, sem o arquivo xml, mas com o DANFE para transporte da mercadoria. Isto significa que o documento foi emitido porém ainda não está autorizado na SEFAZ, ou seja, o emissor deverá realizar, em um segundo momento, a consulta desse documento para atualização de status e obtenção do XML completo de autorização.

Acesse o fluxo da contingência EPEC.

Vale ressaltar que no momento em que a comunicação com a SEFAZ de origem for restabelecida, o InvoiCy fará automaticamente o envio de todos os documentos emitidos em EPEC para a sua SEFAZ de origem, buscando sua autorização e consequentemente a conciliação do evento EPEC. Em caso de rejeição o emissor deverá fazer a correção e o reenvio do documento.

 

Contingência FS-DA

A opção de contingência FS-DA deve ser utilizada quando o emissor identificar a existência de qualquer fator que prejudique ou impossibilite a transmissão das NF-e e/ou obtenção da autorização de uso da SEFAZ. Se essa opção estiver configurada, a NF-e não será enviada imediatamente para a SEFAZ, apenas quando cessarem os problemas de comunicação e o serviço for reestabelecido a NF-e será reenviada para validação e autorização pela SEFAZ do seu estado. Destacando que com essa opção o DANFE deverá ser impresso em papel moeda, e quando a conexão voltar o documento deve ser consultado para obter o seu status atualizado, e em caso de rejeição deve ser corrigido e enviado novamente.

Acesse o fluxo da contingência FS-DA.

Pode acontecer ainda a situação de nenhuma das contingências configuradas estarem disponíveis, então o documento ficará como pendente no InvoiCy e não será emitido. O emissor receberá como retorno de status da comunicação o código 109, e como retorno de status do documento o código 105.

109 – SEFAZ em contingência

105 – Documento pendente

Resumo: O emissor estará temporariamente impedido de emitir e deverá realizar uma consulta antes de fazer o envio do próximo documento.

Códigos de retorno

É importante salientar que o emissor deve estar atento aos códigos de retorno do status do documento, e não apenas para o código de retorno da comunicação. Para auxiliar na identificação de ambos, o código de status da comunicação pode ser observado no cabeçalho de retorno do SOAP. Já o código do status do documento pode ser visualizado dentro do arquivo xml do documento.

Uma vez definida a utilização do EPEC, o emissor deverá tratar em sua integração o código de retorno 136, de forma que o ERP consiga interpretar o mesmo, pois quando um documento for emitido em EPEC, os códigos retornados serão 109 para o status da comunicação e 136 para o status do documento. Neste caso o emissor deverá fazer uma consulta posteriormente destes documentos buscando a atualização de seus status e não deverá realizar seu reenvio enquanto não obtiver um novo status. Isso irá evitar problemas de duplicidade de documento com diferença na chave de acesso e bloqueio de empresas para emissão de novos documentos em EPEC. Em caso de bloqueio da empresa, o artigo Desbloqueio de EPEC explica como proceder nessa situação.

109 – SEFAZ em contingência

136 – Contingência EPEC

Resumo: Para os documentos com estes status, o emissor deverá realizar consultas para a atualização de status e fazer seu reenvio somente quando receber um status diferente do atual.

Ao fazer uso da contingência FS-DA o emissor deverá tratar em sua integração o código de retorno 109, de forma que o ERP consiga interpretar o mesmo, pois quando um documento for emitido em FS-DA os códigos retornados serão 109 para o status da comunicação e 109 para o status do documento.

109 – SEFAZ em contingência

109 – Contingência FS-DA

Resumo: Para os documentos com esses status o emissor deverá realizar consultas para a atualização de status do documento quando a conexão voltar. Se o documento rejeitar deve corrigi-lo e envia-lo novamente. Para efetuar a impressão do DANFE deve fazer uso de papel moeda.

Outro código que precisa ser tratado na integração é o 108, que será retornado para o documento que identificar a indisponibilidade da SEFAZ de uma UF. Isso irá ocorrer quando o InvoiCy receber um documento e não conseguir enviá-lo à SEFAZ ou não obtiver o seu retorno junto a SEFAZ, detectando neste momento a necessidade de entrar em modo de contingência. O documento que identificar a contingência ficará com o status “Necessita interação” no InvoiCy e o emissor receberá como retorno do InvoiCy o código 108, tanto para o status do documento, como para o status da comunicação.

108 – Entrada da SEFAZ em contingência: [erro_encontrado]

108 – Entrada da SEFAZ em contingência: [erro_encontrado]

Resumo: Quando o emissor receber o retorno 108, seu sistema deverá estar preparado para emitir uma cópia do documento anterior, avançando sua numeração e referenciando o documento emitido anteriormente. Recomendamos a leitura do artigo Referenciando documento emitido anteriormente” para compreender o funcionamento desse processo.

Uma informação importante quanto ao código 108 é que um único documento por UF irá receber este retorno ao identificar alguma falha de comunicação com a SEFAZ, pois a partir disso todos os demais documentos das empresas que emitam nesta mesma UF passarão a emitir automaticamente em modo de contingência. Outro detalhe é que este retorno independe do tipo de contingência utilizada pela empresa que enviou o documento e detectou a falha de comunicação.

 

Por que avançar numeração e referenciar o documento anterior?

Esta regra foi implementada para evitar problemas com o documento que identificar a contingência, uma vez que neste momento não é possível saber se o documento chegou até a SEFAZ ou não. Realizando este tratamento o emissor consegue garantir que um documento que pode estar efetivado na SEFAZ não seja enviado também para a SVC, EPEC ou FS-DA, por exemplo. Supondo que o documento esteja efetivado na SEFAZ e seja feito simplesmente o seu reenvio pelo sistema, como o InvoiCy já estará operando em modo de contingência ele fará o envio para uma das opções (SVC, EPEC ou FS-DA), podendo gerar os seguintes problemas:

– Se o documento for enviado e efetivado na SVC, irá ocorrer falha na sincronização entre os ambientes, devido a duplicidade de documento com diferença nas chaves de acesso;

– Se for enviado para EPEC, o problema irá ocorrer no momento da conciliação do documento, pois o documento teve um EPEC com horário posterior a sua autorização.

– Se o documento for enviado para FS-DA, irá ocorrer uma rejeição devido a duplicidade de documento com diferença nas chaves de acesso.

Uma vez referenciado o documento, o IncoiCy se encarrega de realizar as ações necessárias sobre ele, realizando seu cancelamento ou inutilização, conforme for a situação em que o mesmo se encontra junto a SEFAZ.

 

Restabelecimento de comunicação

Após cessarem os problemas de comunicação com a SEFAZ da UF o InvoiCy voltará ao modo de comunicação normal e passará a verificar quais documentos precisam receber algum encaminhamento.

Para o documento que identificou a contingência e foi referenciado no segundo documento, o InvoiCy fará automaticamente a sua consulta junto a SEFAZ. Se estiver efetivado será providenciado seu cancelamento, caso contrário, a sua inutilização.

Já para os documentos emitidos em EPEC, o InvoiCy irá realizar seu envio para conciliação, podendo ser efetivado ou rejeitado. Estes são os casos de retorno 136, onde o emissor deverá fazer a consulta dos documentos para atualização de seus status e reenvio, quando necessário.

Para facilitar o entendimento do emissor, foi elaborado um fluxo abrangendo todas as situações de emissão em contingência, bem como o retorno de cada situação.

Durante o processo de envio, ainda podem acontecer situações como o Aplicativo Comercial ou ERP não possuir conexão com a internet, ou a conexão com o InvoiCy ser perdida durante o processo de emissão e não dar nenhum retorno do documento.

Na primeira situação o documento não será enviado para o InvoiCy, sendo responsabilidade do emissor ajustar a sua infraestrutura para permitir a comunicação com o InvoiCy. Já na segunda situação, o emissor deverá consultar o status do documento para verificar se o mesmo já não foi emitido, ou se será necessário enviá-lo novamente.

Desbloqueio de EPEC

Última atualização em: 11 de fevereiro, 2015

 

O que é o EPEC?

A SEFAZ disponibilizou uma nova forma de emissão em contingência, o EPEC ou Evento Prévio de Emissão em Contingência, que permite a empresa emitir uma solicitação de registro de evento de CT-e ou NF-e anterior à emissão do documento em si com um layout mínimo de informações. Esse evento deve ser enviado para o Ambiente Nacional (AN), utilizando-se o Web Service de Eventos genérico, criado para este fim.

A emissão do evento tem como objetivo permitir que a empresa continue sua operação, uma vez que autorizado o EPEC, esta poderá imprimir o DACTE/DANFE e realizar a prestação do serviço.

Conforme disponível na NT2012/004, a emissão do EPEC poderá ser adotada por qualquer emissor que esteja impossibilitado de transmissão e/ou recepção das autorizações de uso de seus CT-e ou NF-e.

Após realizada a autorização do Evento EPEC, da mesma maneira que para os demais eventos, o EPEC também será distribuído para as UF envolvidas na operação, inclusive para a própria UF do emitente.

Eventos do tipo EPEC devem ser reenviados no período máximo de sete dias (168 horas) para obterem sua efetivação, utilizando ainda o “tpEmis” = 4. Esse reenvio deve ser realizado para que as emissões feitas em EPEC não entrem em lista de pendências na SEFAZ.

Destacando que esse modelo de contingência deverá ser utilizado somente em casos de dificuldade técnica, sendo que o uso de forma contínua poderá ser bloqueado por regra de validação ou medida restritiva.

Após cessarem os problemas o InvoiCy fará a conciliação automática dos Documentos que foram emitidos em EPEC, e durante esse processo se algum documento rejeitar e não for corrigido e reenviado em até sete dias este ficará pendente de conciliação.

Decorrido o prazo para reenvio o ambiente de contingência EPEC será bloqueado para este emitente, e para liberar o uso do Ambiente de Contingência EPEC a empresa deverá corrigir o documento rejeitado e envia-lo novamente.

Durante o processo de testes de integração pode ocorrer algum erro na emissão, e autorizar o EPEC e o documento que o originou. Neste caso, a empresa também ficará bloqueada para emitir em ambiente de contingência EPEC. Para continuar emitindo deve desbloquear a empresa seguindo as seguintes instruções:

1) Fazer um termo no livro de ocorrências. Fotocopiar a capa do livro e o Termo de Ocorrência lavrado pela empresa e protocolizar. Deve-se obedecer, no que couber o Regulamento do ICMS do estado do emissor.

2) Fazer requerimento solicitando a regularização do caso, explicando o ocorrido.

3) Junto com o requerimento anexar cópia de Termo no Livro de Ocorrências e Documentos Fiscais relatando o fato. Pode ser realizado pelo contador do contribuinte.

4) Protocolar em Agência da Receita do Estado do emissor. Pode ser realizado pelo contribuinte.

Importante ressaltar que se o contribuinte não protocolar este requerimento, permanecerá bloqueado para a emissão de novos EPEC em casos de entrada em contingência.

Para visualizar um modelo do requerimento que deve ser enviado, clique aqui.

Quando o documento for emitido em EPEC, será retornado o código 136 no status do documento, assim como, será gerado duas vias do DACTE/DANFE conforme a legislação. Neste caso não será retornado o XML do documento, pois este será enviado automaticamente pelo InvoiCy à SEFAZ quando a mesma voltar a operar. Para obter o XML do documento, posteriormente poderá ser feita uma consulta.

Release Notes – Versão 1.8.0.0

Versão 1.12.0.0 Módulo NFS-e – 25/03/2015

Liberação Padrão Equiplano

A partir de agora, o InvoiCy – Módulo NFS-e passa a integrar com o padrão EQUIPLANO, abrangendo atualmente o município de Toledo/PR. Para consultar a lista completa de municípios integrados, acesso o mapa.

Versão 1.8.0.0 – 05/02/2015

Licenciamento

A partir de agora, quando o usuário parceiro cadastrar empresas emitentes em ambiente de produção já deverá fazer a solicitação da licença para os módulos que possui contrato, sendo obrigatório o preenchimento dessa etapa para prosseguir com o cadastro da empresa.

Web Service para buscar Notas de entrada na SEFAZ

Atualmente a Plataforma InvoiCy já está preparada para receber por Web Service arquivos de manifestação de destinatário, e a partir desta versão também disponibiliza a funcionalidade de consulta das notas emitidas contra o CNPJ da empresa que está manifestando.

Download do XML da NF-e emitida contra o CNPJ

Após realizar a ciência da operação também será possível baixar o arquivo XML completo, sendo que o cliente poderá solicitar o download de até dez documentos por vez.

Configuração dos textos de E-mail

Agora o usuário pode configurar suas mensagens de e-mail em formato HTML, com a possibilidade de inserir links de imagens, mudar a fonte, tamanho e cor do texto.

É possível também inserir variáveis junto ao texto padrão dos e-mails, como número do documento, série, chave de acesso, nome do destinatário, link para download do XML e do PDF, facilitando assim para montar a mensagem desejada.

Alterações no DANFE

Para os clientes que possuem uma folha customizada para impressão do DANFE é possível configurar se o canhoto do DANFE será impresso no cabeçalho ou no rodapé.

Nesta versão também foi liberada uma opção para definir se a logomarca do DANFE terá moldura ou não.

Detalhamento das versões

Para conhecer todas as modificações realizadas nessa versão, clique aqui.

Verifique se sua empresa está apta para entrar em produção

Última atualização em: 07 de janeiro, 2015

Antes de realizar o checklist abaixo, é importante o Parceiro realizar a leitura da documentação no Portal, através do link https://desenvolvedores.migrate.com.br/modulo-nf-e/.

Abaixo segue os testes mínimos necessários para o Parceiro ser considerado apto para iniciar o processo em Produção no módulo NF-e.

Para emissão normal seguir os passos abaixo:

– Autorizar um documento:
https://desenvolvedores.migrate.com.br/2013/10/22/envio-de-nf-e-nfc-e/

– Inutilizar um documento:
https://desenvolvedores.migrate.com.br/2014/03/07/inutilizando-uma-nf-e-ou-nfc-e

– Realizar a consulta de um documento:
https://desenvolvedores.migrate.com.br/2014/03/07/consultando-um-documento-nf-e-ou-nfc-e/

– Cancelar um documento:
https://desenvolvedores.migrate.com.br/2014/03/07/cancelando-uma-nf-e-ou-nfc-e

– Emitir uma Carta de Correção:
https://desenvolvedores.migrate.com.br/2014/03/07/carta-de-correcao-eletronica-cc-e-2

Para emissão em contingência seguir os passos abaixo:

– Emitir um documento em contingência SVC:
https://desenvolvedores.migrate.com.br/2014/03/07/emissao-em-contingencia

– Emitir um documento em contingência EPEC:
https://desenvolvedores.migrate.com.br/2014/03/07/emissao-em-contingencia

Algumas particularidades deste módulo:

– A empresa deve verificar o fluxo atual de seus clientes, e realizar testes de emissão de acordo com o fluxo de cada um de seus clientes.

Exemplos:

– Se determinado cliente é do simples nacional, deverá testar emissão de notas com CST do Simples Nacional.
– Se cliente é do Regime Normal, deverá testar emissão de notas com CST do Regime Normal.
– Se cliente usa informação de transportador, deve testar a emissão informando o grupo do transportador.
– Se cliente vende medicamentos, deve testar emissão de documentos com tipo de produto = medicamento.
OBS: Essas são regras de negócio que só o parceiro terá conhecimento, e será de sua inteira responsabilidade testá-las e aprová-las em seu ERP.

Release Notes – Versão 1.6.1.0

 

Emissão da NF-e em Contingência 

A partir da versão 1.6.1.0 está disponível no InvoiCy a emissão de NF-e em Contingência EPEC, ou Evento Prévio de Emissão em Contingência, permitindo que as empresas mesmo antes da emissão da NF-e solicitem um registro do EPEC, que possui um layout reduzido de informações. O EPEC deve ser enviado para o Ambiente Nacional (AN), utilizando-se o Web Service de Eventos genérico, criado para este fim.

Conforme disponível na NT2014/001, a emissão do EPEC poderá ser adotada por qualquer emissor que esteja impossibilitado de transmissão e/ou recepção das autorizações de uso de suas NF-e.

Após realizada a autorização deste evento, da mesma maneira que para os demais eventos, o EPEC também será distribuído para as UF envolvidas na operação, inclusive para a própria UF do emitente.

Saiba como configurar o InvoiCy para a emissão em contingência EPEC acessando o artigo Emissão em Contingência.

Integrando com o InvoiCy

 

Olá! Neste artigo vamos lhe auxiliar a realizar a integração de seu ERP com o InvoiCy. Pronto para iniciar? Vamos lá!

A integração com o InvoiCy deve ser realizada através do Web Service de recepção de documentos. Este Web Service é único, e deve ser utilizado para qualquer integração com o InvoiCy, independente do tipo de documento a ser enviado. Para realizar a integração, realize os seguintes passos:

1. Visualize a estrutura WSDL do Web Service
Para visualizar a estrutura WSDL (Web Services Description Language) do Web Service, basta acessar o endereço https://app.invoicy.com.br/arecepcao.aspx?wsdl através do seu navegador de internet. Assim é possível visualizar a estrutura do WSDL, e consequentemente a estrutura do pacote SOAP que precisa ser transmitido, conforme demonstra a imagem abaixo:

Integração com o InvoiCy

Visualize a estrutura WSDL do Web Service para poder alimentar a estrutura de integração

2. Realize o consumo do Web Service
Para enviar um documento, você deverá informar os seguintes parâmetros:

  • EmpPK: Chave de Parceiro disponibilizada pela Migrate para cada cliente.
    Exemplo: YPxRwGxIbpWZtwhuC0m+Wg== 

    A chave de parceiro é gerada por nosso Sistema de Gestão no momento que a sua empresa é cadastrada como nosso parceiro. A mesma será enviada por e-mail e utilizada para controlar as empresas de clientes finais que utilizarão licenças adquiridas pela sua empresa.

  • EmpCK: Código HASH gerado em formato MD5 de acordo com dados enviados.
    Exemplo: 213f3b55d679e790258fd811cc86d309 

    Utilizado para validar a comunicação e garantir a segurança na comunicação. Consulte o artigo “Como gerar o código HASH?” para mais informações.

  • EmpCO: Identificador do PDV, para o módulo NF-e não é obrigatório o seu preenchimento.
  • Texto: Uso interno do InvoiCy. Não é necessário o preenchimento.
  • Documento: Conteúdo do documento Fiscal a ser enviado para o InvoiCy.
  • Parametros: Parâmetros com algumas configurações do documento. Necessário quando ocorre emissão em contingência.

Dentro da TAG <inv:Documento>, você deverá informar o conteúdo XML do documento, contendo a estrutura de campos do layout 2.0 (apenas para NF-e) ou 3.10 (para NF-e ou NFC-e), ou o layout de qualquer outro tipo de documento que você deseje enviar, como MDF-e. Os campos do documento devem ser convertidos para formato texto, conforme exemplo abaixo:

Obs: Caso deseje enviar mais de um documento, deve-se repetir a TAG <inv:DadosItem>, contendo o conteúdo dos documentos a serem enviados.

Integração com o InvoiCy

Realizar o consumo do Web Service.

 

Agora que você já está familiarizado com o que é necessário para comunicar-se com o InvoiCy, podemos prosseguir ao próximo passo.

 

Seu próximo passo é: Enviando uma NF-e

Artigos Relacionados:

Integrando com o módulo NF-e

Última atualização em: 26 de março, 2015

 

Olá! Neste artigo vamos lhe auxiliar a realizar a integração de seu ERP com o módulo NF-e do InvoiCy. Pronto para iniciar? Vamos lá!

A integração de seu ERP com o módulo NF-e deve ser realizada através de Web Service disponibilizado pelo InvoiCy. Trata-se do WS arecepcao.aspx. Este Web Service é único, e deve ser utilizado para qualquer integração com o InvoiCy, independente do tipo de documento a ser enviado. Abaixo, detalhamos o processo de integração com o módulo NF-e.

Para realizar a integração, realize os seguintes passos:

1.      Visualize a estrutura WSDL do Web Service
Para visualizar a estrutura WSDL do Web Service, basta copiar e colar o link do Web Service em seu navegador de internet, por exemplo https://homolog.invoicy.com.br/arecepcao.aspx?wsdl. Assim podemos visualizar toda a estrutura do WSDL, conforme demonstra a imagem abaixo:

2.      Realize o consumo do Web Service
Você deverá realizar o consumo do Web Service para realizar a integração. Ao realizar a consumo do WS, você deverá informar os seguintes parâmetros:

  • EmpPK: Chave de Parceiro disponibilizada pela Migrate para cada cliente.
    Exemplo: PYcEsFuKroDBojfiFEl+Ms==

A chave de parceiro é gerada por nosso Sistema de Gestão no momento que a sua empresa é cadastrada como nosso parceiro. A mesma será enviada por e-mail e utilizada para controlar as empresas de clientes finais que utilizarão licenças adquiridas pela sua empresa.

  • EmpCK: Código HASH gerado em formato MD5 de acordo com dados enviados.
    Exemplo: 213f3b55d679e790258fd811cc86d309

Utilizado para validar a comunicação e propor segurança à comunicação. Consulte o artigo “Como gerar o código Hash MD5?” para mais informações.

  • EmpCO: Identificador do PDV.
  • Texto: Uso interno do InvoiCy. Não é necessário o preenchimento.
  • Documento: Conteúdo do documento Fiscal a ser enviado para o InvoiCy.
  • Parâmetros: Neste campo podem ser informados alguns parâmetros, como por exemplo, quais dados deseja que retorne na consulta de documentos. Seu preenchimento não é obrigatório.

Dentro da TAG <inv:Documento>, você deverá informar o conteúdo XML da NF-e, contendo a estrutura de campos do layout 3.10 da NF-e. Os campos da NF-e devem ser convertidos para texto.

Obs: Caso deseje enviar mais de um documento, deve-se repetir a TAG <inv:DadosItem>, contendo o conteúdo dos documentos a serem enviados.

Para facilitar seu entendimento, disponibilizamos para você o download de um exemplo completo de consumo do WS de recepção.

Clique aqui, e realize o download do documento.

Para obter o Layout atualizado da NF-e consulte o artigo “Layout 3.10”. Nele você encontra a estrutura completa do arquivo XML da NF-e para gerar o documento a ser enviado ao InvoiCy.

3.      Realize a leitura do retorno do envio da NF-e
Após o envio da NF-e, precisamos realizar a leitura do retorno do processamento do documento. O retorno recebido segue a seguinte estrutura SOAP:

A estrutura SOAP acima demonstra o retorno do envio de apenas um único documento.

Note que na TAG <Documento> é retornado o conteúdo XML do retorno, codificado em “CDATA”. Este conteúdo pode ser lido pelo ERP para atualização do Status do documento.

Abaixo demonstramos a estrutura do XML de retorno:

Todo o conteúdo acima estará codificado em “CDATA” e retornará dentro da TAG <Documento> do SOAP de retorno.

Para facilitar seu entendimento, anexamos um documento completo a este artigo.

Clique aqui, e realize o download do arquivo SOAP de retorno.

Existe ainda uma tabela de códigos e descrições dos retornos da SEFAZ, que você pode consultar no artigo “Códigos de Retorno da SEFAZ”.

Agora que você já realizou sua integração, podemos dar prosseguimento ao próximo passo.

Seu próximo passo é: Enviando uma NF-e ou NFC-e

Artigos Relacionados: