fev
23
2015

Testes de entrada em contingência – Integração via Web Service

23 de fevereiro de 2015

Índice

-

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

 

No módulo NFC-e da Plataforma InvoiCy é disponibilizada uma opção para que o usuário simule o ambiente de contingência para testar a sua aplicação. Esta opção deverá ser configurada por empresa, e é importante destacar que a mesma estará disponível apenas para o ambiente de homologação.

Para configurar os parâmetros e simular a entrada da contingência basta acessar o Painel de controle – Módulo NFC-e – Configurações para emissão, como demonstra a imagem a seguir.

Na tela do módulo NFC-e estará disponível o campo “Simular contingência”, representado na imagem abaixo, onde o usuário poderá configurar a simulação do ambiente de contingência, com as opções “Simular timeout SEFAZ” que retorna o código 108, “Simular SEFAZ fora do ar” que retorna o código 109 e “Emissão normal” que retorna o código 100 após o documento ser autorizado na SEFAZ.

Ao ativar a simulação da contingência os documentos emitidos nesse tempo não serão enviados para a SEFAZ, somente após a empresa voltar para a opção “Emissão normal”.

Através desta opção é possível que o usuário simule várias situações que podem acontecer durante a emissão em contingência, que pode ser por EPEC ou contingência Offline.

Antes de optar pela opção EPEC, em primeiro lugar o emissor deverá tratar na integração o código de retorno 136, de forma que seu ERP consiga interpretar o mesmo, pois quando uma NFC-e for emitida em EPEC será retornado o código 109 no status da comunicação e o código 136 no status do documento, sem o arquivo xml, mas com o DANFENFC em base 64 (para mais informações sobre base64 acesse o artigo). Nesse caso, o documento foi emitido porém ainda não está autorizado na SEFAZ, então o emissor deverá consultar o documento posteriormente para ter o xml completo autorizado.

Da mesma forma, ao receber um retorno de código 136 o emissor não deve reenviar o documento, somente consultar o seu status. Tratando o código 136 na integração poderá evitar problemas maiores, como sua empresa ser bloqueada para emissão de documentos em EPEC. Mas em caso de bloqueio da empresa, o artigo Desbloqueio de EPEC explica como proceder nessa situação.

A seguir iremos explicar essas possíveis situações e como o usuário deve proceder em cada uma delas.

Para exemplificar usaremos os termos Emissor 1, Emissor 2, Plataforma InvoiCy e Aplicação parceiro, de forma a facilitar a compreensão por parte do usuário.

Caso 1:

Se o Emissor 1 estiver emitindo em modo Normal com tpEmis 1, porém a opção selecionada for “Simular timeout SEFAZ” a Plataforma InvoiCy irá entrar em modo contingência, este documento enviado irá detectar a entrada em contingência e ficará com status “Necessita interação”, retornando para o Emissor 1 o código 108.

O correto a fazer neste caso de retorno 108, é emitir uma cópia do documento anterior e avançar a numeração. Esta cópia terá um avanço na numeração e deverá referenciar o documento emitido anteriormente. Recomendamos a leitura do artigo Referenciando documento emitido anteriormente para compreender o funcionamento desse processo.

O InvoiCy está preparado para que mesmo na opção “Simular timeout SEFAZ”, se receber um xml com tpEmis 9, retornar o código 109. Após o envio desse novo documento com tpEmis 9 o InvoiCy deverá cancelar ou inutilizar o documento anterior que está referenciado. Este processo não roda automaticamente no servidor de testes.

Ao alterar a opção no InvoiCy  para “Simular SEFAZ fora do ar” os próximos documentos enviados irão retornar para o Emissor 1 o código 109 como status da comunicação e do documento,  se forem emitidos em contingência Offline. Porém, se forem emitidos em EPEC o retorno do status de comunicação será 109, e o retorno do status do documento será 136.

Ainda pode acontecer a situação de nenhuma contingência configurada estar disponível, 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. Isso indica que não poderá mais emitir temporariamente, e deverá então realizar uma consulta antes de fazer o envio da próxima NFC-e.

É importante salientar que o emissor deve sempre estar atento para o código 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.

Caso 2:

Pode acontecer uma situação onde o InvoiCy está configurado para emissão em contingência e um Emissor 2 do mesmo estado do Emissor 1, que desconhece que o InvoiCy está em modo contingência, envia um documento com tpEmis 1. Neste caso, o Emissor 2 irá receber como retorno o código 108 e seguirá o fluxo da mesma forma que o Emissor 1 quando também recebeu o retorno 108.

Caso 3:

Também pode acontecer uma situação onde o Emissor 1 recebeu o retorno 108 no primeiro documento, indicando que este documento identificou a entrada em contingência. Se durante este processo de referenciar o documento anterior e enviar novamente o novo documento, o InvoiCy saiu do modo contingência por ter conseguido autorizar outro documento do Emissor 2, ao receber este documento do Emissor 1 com tpEmis 9 ou 4, e ao enviar para a SEFAZ detectar novamente a contingência, o Emissor 1 irá receber o retorno 109 e o documento ficará armazenado no InvoiCy com status Contingência Offline, ou EPEC autorizado.

Para cancelar a simulação do ambiente de contingência a empresa deve selecionar a opção “Emissão normal”.  Após a empresa sair do modo contingência no InvoiCy, então os documentos serão enviados para a SEFAZ e terão seu devido retorno.

É importante destacar ainda que sempre que o Emissor receber como retorno o código 108 deverá avançar a numeração e enviar um novo documento referenciando o anterior.

Não é aconselhável que o Emissor simule situações para receber o código 109 quando estiver enviando com tpEmis 1, pois no processo do ambiente de produção este retorno não irá ocorrer, nesse caso sempre irá retornar primeiro o código 108.

O InvoiCy só irá retornar o código 109 quando estiver em contingência e receber um documento com tpEmis 9, ou se está em modo normal e receber um documento com tpEmis 9 e este identificar a contingência na SEFAZ.

Para facilitar o entendimento do emissor, elaboramos um fluxo abrangendo todas essas situações de emissão em contingência comentadas no artigo, 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.

https://mostbetsitez.com, https://mostbetaz2.com, https://1xbet-az24.com, https://vulkanvegas-bonus.com, https://mostbetcasinoz.com, https://mostbet-azerbaycanda.com, https://mostbet-az24.com, https://vulkan-vegas-spielen.com, https://1winaz888.com, https://vulkan-vegas-24.com, https://1xbetaz3.com, https://1xbet-azerbaycanda.com, https://1xbetsitez.com, https://mostbet-royxatga-olish24.com, https://mostbet-azerbaycan-24.com, https://mostbet-uzbekistons.com, https://mostbet-azer.xyz, https://pinup-bet-aze.com, https://1xbet-azerbaycanda24.com, https://1xbet-az-casino2.com, https://1xbetaz777.com, https://mostbet-qeydiyyat24.com, https://mostbetuztop.com, https://1win-az-777.com, https://pinup-azerbaycanda24.com, https://1xbet-az-casino.com, https://mostbet-az.xyz, https://vulkanvegaskasino.com, https://mostbet-azerbaycanda24.com, https://pinup-qeydiyyat24.com, https://1win-qeydiyyat24.com, https://vulkan-vegas-888.com, https://mostbetuzbekiston.com, https://1xbetkz2.com, https://mostbet-ozbekistonda.com, https://mostbet-kirish777.com, https://mostbetsportuz.com, https://mostbettopz.com, https://vulkan-vegas-erfahrung.com, https://1xbetaz888.com, https://mostbet-oynash24.com, https://mostbetaz777.com, https://kingdom-con.com, https://1win-azerbaycanda24.com, https://mostbet-uz-24.com, https://vulkan-vegas-kasino.com, https://1x-bet-top.com, https://most-bet-top.com, https://mostbet-azerbaijan2.com, https://1winaz777.com, https://1xbetaz2.com, https://vulkan-vegas-casino2.com, https://vulkanvegasde2.com, https://vulkan-vegas-bonus.com, https://1xbetcasinoz.com, https://pinup-azerbaijan2.com, https://mostbetuzonline.com, https://1win-azerbaijan2.com, https://pinup-az24.com, https://1win-az24.com, https://1xbet-azerbaijan2.com, https://pinup-bet-aze1.com, https://1win-azerbaijan24.com, https://mostbet-az-24.com, https://mostbet-azerbaijan.xyz