Próximo consecutivo
GET /api/v1/consecutivos/proximo?tipo={01|02|03|04}
Devuelve el próximo número de consecutivo que se asignaría a un comprobante del tipo indicado, sin consumirlo (no afecta la secuencia). Útil para mostrar al usuario un número tentativo antes de confirmar la emisión.
Autenticación
| Atributo | Valor |
|---|---|
| Scope requerido | facturas:read |
Query params
| Parámetro | Valores | Descripción |
|---|---|---|
tipo | 01, 02, 03, 04 | Tipo de comprobante |
Respuestas
200 OK
{ "tipo": "01", "proximo": 1234 }400 Bad Request
{ "error": "Tipo no válido. Use 01 (FE), 02 (ND), 03 (NC) o 04 (TE)." }Cuándo usarlo
- Mostrar al usuario el número estimado antes de confirmar la venta.
- Pre-validar tu pipeline interno.
- Sincronizar con sistemas contables que necesitan conocer el rango actual.
⚠ Atención
Es un valor estimado. Si otro proceso emite un comprobante entre tu consulta y tu emisión, el número real puede diferir. No bases lógica crítica en este valor; tomá el numeroConsecutivo real desde la respuesta de POST /facturas.