Ir al contenido

Beta privada · apertura 23 de diciembre

Crea una serie

POST /v1/emisores/{ruc}/series

Registra una serie (F001, B001, T001…). Si vienes de otro sistema, indica el último número usado.

Dato Valor
Permiso emisores:administrar
Cobro No cobra.
Idempotency-Key Opcional
Herramienta MCP serie_crear (Próximamente)
Nombre En Requerido Tipo Descripción
ruc path Sí string RUC del emisor o contribuyente.
Idempotency-Key header No string Identifica una operación para que repetirla no la duplique. Si repites la petición con la misma clave y el mismo cuerpo, recibes la misma respuesta; con otro cuerpo, idempotencia_en_conflicto. Se guarda 24 horas.
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

application/json, obligatorio. Los campos anidados van con punto y los de listas con []. No se aceptan campos desconocidos.

Campo Tipo Requerido Descripción
tipo “01” | “03” | “07” | “08” | “09” Sí 01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito, 09 guía de remisión remitente.
serie string Sí
ultimo_numero integer No Si vienes de otro sistema, el último número que usaste; seguimos desde el siguiente.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl -X POST "https://api-sandbox.opennexum.com/v1/emisores/20000000001/series" \
-H "Authorization: Bearer onx_test_…" \
-H "Content-Type: application/json" \
-d '{
"tipo": "01",
"serie": "texto"
}'

Serie creada.

Campo Tipo Requerido Descripción
tipo “01” | “03” | “07” | “08” | “09” Sí 01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito, 09 guía de remisión remitente.
serie string Sí
ultimo_numero integer Sí Último número asignado; el próximo será este + 1.
creada_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).

Cada código tiene su explicación en Errores.