Documentación › Emisión de NF-e
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
- GET/v1/sefaz/status · Estado de la SEFAZ de cada UF para la NF-e