Conceptos
Consecutivo
El número consecutivo de 20 dígitos, quién lo asigna y por qué nunca se puede reutilizar una vez que llegó a Hacienda.
El número consecutivo (NumeroConsecutivo) numera los comprobantes de cada emisor. Tiene 20 dígitos, aparece en las posiciones 22–41 de la clave y en la API se llama consecutive_number.
Estructura
Sección titulada «Estructura»| Posición | Largo | Campo | Valores |
|---|---|---|---|
| 1–3 | 3 | Sucursal | 001–999 |
| 4–8 | 5 | Terminal | 00001–99999 |
| 9–10 | 2 | Tipo de comprobante | 01–10 |
| 11–20 | 10 | Número | 0000000001–9999999999 |
El consecutivo 00100001010000001042 se lee así: sucursal 001, terminal 00001, tipo 01 (Factura Electrónica), comprobante número 1042.
Códigos de tipo de comprobante:
| Código | Comprobante |
|---|---|
01 |
Factura Electrónica |
02 |
Nota de Débito Electrónica |
03 |
Nota de Crédito Electrónica |
04 |
Tiquete Electrónico |
05 |
Mensaje Receptor: aceptación |
06 |
Mensaje Receptor: aceptación parcial |
07 |
Mensaje Receptor: rechazo |
08 |
Factura Electrónica de Compra |
09 |
Factura Electrónica de Exportación |
10 |
Recibo Electrónico de Pago |
Cada combinación de sucursal, terminal y tipo es una serie independiente. La sucursal 002 y la sucursal 001 llevan su propia numeración de facturas, y las facturas y los tiquetes de una misma terminal también. Ver sucursal y terminal.
Quién lo asigna
Sección titulada «Quién lo asigna»Aster puede numerar por vos. Si no enviás document.consecutive_number, Aster asigna el siguiente número de la serie. Lleva un contador por organización, ambiente, sucursal, terminal y tipo de comprobante, así que los comprobantes de prueba nunca gastan números de producción y dos solicitudes simultáneas nunca reciben el mismo número.
O podés enviar el tuyo, junto con la clave, en document.clave y document.consecutive_number. Es lo habitual si ya tenés numeración propia o venís de otro proveedor (ver migrar).
Un consecutivo no se reutiliza
Sección titulada «Un consecutivo no se reutiliza»Una vez que un consecutivo llegó a Hacienda no se puede volver a usar en otra clave, sin importar si el comprobante fue aceptado o rechazado (Decreto 44739-H y Resolución MH-DGT-RES-0027-2024, artículo 2). Hacienda rechaza el segundo comprobante con el mismo consecutivo aunque la clave sea distinta.
Aster aplica esa regla por organización y ambiente antes de firmar:
| Situación | Respuesta |
|---|---|
| Enviás una clave que ya existe | 409 duplicate_clave |
| Enviás un consecutivo que ya se usó en ese ambiente | 409 duplicate_consecutive |
En el caso excepcional de dos solicitudes simultáneas con el mismo consecutivo, una de ellas puede recibir 422 con el mismo código. Tratalo igual.
El único caso en que un consecutivo queda libre es cuando el comprobante terminó en estado error: el envío falló de forma definitiva y el comprobante nunca llegó a Hacienda. Los errores que Aster devuelve antes de firmar (422 validation_error, certificate_expired, 402 quota_exceeded y similares) no registran el comprobante, así que tampoco gastan el consecutivo.
Los ambientes de pruebas y producción de Hacienda son espacios de numeración separados. El mismo consecutivo puede existir una vez en cada uno.
Reemplazar un comprobante rechazado
Sección titulada «Reemplazar un comprobante rechazado»Si Hacienda rechaza un comprobante, corregí el problema y emití uno nuevo, con clave y consecutivo nuevos, que haga referencia al rechazado:
reference.document_type:10(comprobante rechazado por Hacienda)reference.code:16(sustituye comprobante electrónico rechazado)reference.number: la clave del comprobante rechazado
{ "reference": { "document_type": "10", "number": "50608102600310165432100100001010000001042147201936", "date": "2026-10-08T10:20:00-06:00", "code": "16", "reason": "Sustituye factura rechazada por error en el CABYS" }}Si dejás que Aster numere, simplemente no enviés clave ni consecutive_number: el reemplazo recibe el siguiente número de la serie.