Sudrel API
Panel Crear clave de API

Documentación › Emisión de NF-e

Guías

Contingencia de la NF-e

Cuando la SEFAZ de una UF cae: esperar, SVC o EPEC, sin crear nunca una nota duplicada.

Cuando la SEFAZ de la UF de la empresa cae, la nota puede esperar o salir en contingencia. La regla que vale siempre: solo va a contingencia la nota que con certeza nunca llegó a la SEFAZ. La nota que se envió y quedó sin respuesta, o que ya estuvo en aguardando_confirmacao alguna vez, queda en aguardando_confirmacao y se resuelve consultando la clave cuando la UF vuelva, con cualquier política. Es lo que impide dos NF-e para la misma venta.

Política de la empresa

politica_contingencia en el perfil fiscal (PUT /v1/nfe/perfil-fiscal/{empresa_id}):

Política Nota que nunca salió Nota enviada sin respuesta
esperar (predeterminado) Queda en transmitindo (falha_envio.motivo: uf_indisponivel) y sale cuando la UF vuelva Queda en aguardando_confirmacao
svc Va a la SEFAZ Virtual de Contingência de la UF, si la UF la activó Queda en aguardando_confirmacao
epec Registra el EPEC en el Ambiente Nacional y transmite a la UF cuando esta vuelva Queda en aguardando_confirmacao

La política svc sin la SVC activada por la SEFAZ de la UF no emite: la nota espera, con el motivo. PR y PB no aceptan EPEC: la nota espera.

SVC (SEFAZ Virtual de Contingência)

La nota sale con tpEmis 6 (SVC-AN) o 7 (SVC-RS, la de Bahia), con la fecha de entrada en contingencia y el motivo en el XML y en el DANFE. La clave cambia con el tpEmis; el número es el mismo, porque la clave original nunca salió (queda en contingencia.chave_original y en chaves_anteriores). Autorizada en la SVC, la nota no vuelve a la UF: la SVC la comparte. La cancelación va a la propia SVC; la carta de corrección va a la UF (la SVC no tiene CC-e).

EPEC

La nota sale con tpEmis 4 y el evento EPEC (resumen de la nota) se registra en el Ambiente Nacional. Con él, el DANFE ya es válido: GET /v1/nfe/{id}/danfe trae el protocolo del EPEC, el motivo y la hora de la contingencia. La NF-e va a la UF en cuanto esta vuelva, con la misma clave y los mismos datos. El plazo es de 168 horas desde el EPEC; cuando faltan 24, el webhook NFE_CONTINGENCIA avisa. Si la UF rechaza la NF-e, la corrección no puede cambiar destinatario, fecha de emisión, total, ICMS ni ICMS-ST (son los datos del EPEC): contingencia.epec.correcao lo explica.

Conciliación

Cuando la UF vuelve, Sudrel consulta la clave original de toda nota que fue a contingencia. Si existe en la SEFAZ (lo que no debería ocurrir), la original se cancela dentro de las 24 horas, recibes NFE_CONTINGENCIA con contingencia.situacao: duplicata_cancelada y el equipo de Sudrel trata el caso como incidente.

Estado de las UF

GET /v1/sefaz/status muestra cada UF en la que hubo emisión reciente en el entorno de tu clave: normal, instavel (una señal mala, la emisión no cambia) o indisponivel, a partir del status del servicio de la SEFAZ y de la tasa real de fallas de las transmisiones, y si la SVC está activada. Si cambia: webhook SEFAZ_STATUS_ALTERADO.

Fuentes: NT 2013.007 v1.03 (SVC) y NT 2014.001 v1.41 (EPEC), del Portal Nacional da NF-e.

Rutas de esta sección, con prueba en la página