Numeración (e-NCF)
Cada e-CF lleva un e-NCF (por ejemplo E310000000001: E, el tipo y 10 dígitos) de una secuencia. En producción
la secuencia la autoriza la DGII; en TesteCF (pruebas) no: tú defines el rango (por ejemplo, del 1 al 1,000,000 por
tipo) y lo registras en la ficha de tu empresa de pruebas. Puedes usar las dos formas de numerar a la vez, en la misma empresa:
| Forma | Cómo | Quién elige el número |
|---|---|---|
| Asignada por el servicio | JSON sin encabezado.idDoc.encf (y sin fechaVencimientoSecuencia) |
Nosotros, de la secuencia registrada en el portal. Viene en la respuesta (encf). |
| Propia | JSON con encabezado.idDoc.encf, o XML firmado |
Tu sistema |
La respuesta y las consultas dicen quién numeró cada comprobante en numberedBy (Service o Client).
Asignada por el servicio
Sección titulada «Asignada por el servicio»Hace falta una secuencia vigente del tipo de e-CF, registrada en la ficha de la empresa y del ambiente de la
empresa (cada ambiente tiene las suyas). Si no hay una con números disponibles: 409 sequence.unavailable.
Los números nunca se repiten ni se saltan sin registro: cada solicitud toma el siguiente libre de forma atómica. Un
documento con errores (422) no consume número.
Tu sistema lleva el contador y envía el e-NCF. Reglas:
| Regla | Error |
|---|---|
Formato: E + tipo + 10 dígitos |
422 encf.invalid |
El tipo del e-NCF coincide con tipoeCF |
422 encf.type_mismatch |
| Sin usar en la empresa y el ambiente | 409 invoice.encf_taken |
Un e-NCF tuyo nunca se cambia por otro. Si ya está usado, la respuesta es 409 y no se emite nada: tu sistema
decide qué número sigue.
No hace falta registrar la secuencia en el portal. En ese caso envía también fechaVencimientoSecuencia (la que
autorizó la DGII; no la llevan los tipos 32 y 34), o la respuesta es 422 sequence.expiry_required. Si la DGII no
autorizó el número, lo rechaza ella (código 135).
Si la secuencia sí está registrada, además debe estar vigente (422 sequence.expired) y la fecha de vencimiento,
si la envías, debe ser la registrada (422 sequence.expiry_mismatch).
Si usas las dos formas: tramos
Sección titulada «Si usas las dos formas: tramos»Si emites desde el portal (o con JSON sin e-NCF) y desde tu sistema con números propios, divide la secuencia en tramos para que nunca choquen. En la ficha de la empresa → Secuencias → «Tramos»:
| Modo | Qué hace |
|---|---|
| Compartida (por defecto) | Las dos formas usan todo el rango. El servicio salta los números que ya usó tu sistema, pero tu sistema recibe 409 si envía uno que ya asignó el servicio. |
| Dividida (recomendada) | El servicio asigna solo en su tramo (por ejemplo, 1–1,000) y tu sistema usa el resto. Un e-NCF tuyo dentro del tramo del servicio da 422 encf.outside_client_range. |
| Solo de tu sistema | El servicio no asigna números de esa secuencia. |
La ficha muestra, por secuencia, cuántos números le quedan al servicio y el último e-NCF que usó tu sistema.
Correcciones
Sección titulada «Correcciones»Un comprobante rechazado por la DGII se corrige con POST /v1/invoices/{id}/resend y el documento corregido (ver
Cómo enviar). Se reutiliza el mismo e-NCF solo si la DGII respondió que no lo
consumió (secuenciaUtilizada = false); si no, hace falta uno nuevo. Si el e-NCF era tuyo y la DGII lo consumió, la
respuesta es 422 encf.consumed: envía la corrección con otro número.