Ir al contenido

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).

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 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.

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.