Próximo número

Consulta la serie y el próximo número que se usaría al emitir, sin emitir nada. El tipo de comprobante se deriva de tipoDocumento y tipo (venta/devolución): RUT es e-Factura / e-Factura Nota de Crédito, el resto es e-Ticket / e-Ticket Nota de Crédito. No contempla comprobantes de exportación.

Es solo informativo: el número puede cambiar si otro comprobante se emite entre esta consulta y el llamado real a ventaCrear (no reserva el número).

La guía correspondiente está en Emitir un CFE.

Solicitud

La ruta POST /obtenerProximoNumero se agrega a la URL base del ambiente.

Enviá los headers x-api-key y x-api-secret. Cómo obtenerlos está en Credenciales.

El cuerpo es JSON (Content-Type: application/json).

Campos

Si falta un campo obligatorio, la API rechaza la solicitud.

Campo	Tipo	Obligatorio	Descripción	Ejemplo
tipoDocumento	number	Sí	Tipo de documento del cliente a facturar: 2=RUT, 3=CI, 4=Otros, 5=Pasaporte, 6=DNI, 7=NIFE. Determina, junto con tipo, qué tipo de comprobante (CFE) se va a emitir y por lo tanto a qué CAE consultar: RUT (2) es e-Factura, el resto es e-Ticket.	2
tipo	string	Sí	Si se va a emitir una venta o una devolución (nota de crédito). Valores: venta, devolucion.	venta

Respuesta 200

Serie y próximo número a usar

Si la operación sale bien, codigoError viene vacío.

Campo	Tipo	Obligatorio	Descripción	Ejemplo
descripcion	string	Sí	—	—
codigoError	string	Sí	—	—
serie	string	Sí	Serie del CAE que se va a usar.	A
numero	number	Sí	Próximo número a usar dentro de esa serie.	1523
tcfe	number	Sí	Tipo de comprobante consultado.	111

Errores

Una respuesta de error trae codigoError y descripcion. El mismo código puede significar cosas distintas según el endpoint. El índice completo está en Códigos de error.

Si fallan las credenciales o el formato del body, aplican los códigos comunes: A01 a A06, V01 y V02.

Código	Significado
E01	Empresa no encontrada
E02	No existe un CAE disponible para ese tipo de comprobante
E04	tipoDocumento inválido

HTTP 500

Error de validación o negocio (ver codigoError)

{
  "descripcion": "No existe un CAE disponible para el tipo de comprobante 111.",
  "codigoError": "E02",
  "serie": "",
  "numero": 0,
  "tcfe": 111
}

Ejemplos

Ejemplo con el valor de cada campo del contrato.

{
  "tipoDocumento": 2,
  "tipo": "venta"
}