Ir al contenido

Beta privada · apertura 23 de diciembre

Pide la propuesta del SIRE de un periodo

POST /v1/emisores/{ruc}/sire/propuestas

Pide a SUNAT la propuesta del RVIE (ventas) o del RCE (compras). SUNAT la prepara en segundo plano: responde 202 y consultas el resultado con el id.

Dato Valor
Permiso sire:leer
Cobro Reserva el precio de tu saldo y lo cobra solo si el servicio confirma (por ejemplo, SUNAT acepta).
Idempotency-Key Obligatoria
Credenciales en la llamada Si envías credenciales, la clave necesita credenciales:por_llamada.
Herramienta MCP sire_propuesta_pedir (Próximamente)
Nombre En Requerido Tipo Descripción
ruc path Sí string RUC del emisor o contribuyente.
Idempotency-Key header Sí 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
registro “RVIE” | “RCE” Sí RVIE ventas e ingresos; RCE compras.
periodo string Sí Periodo tributario AAAAMM.
credenciales object No Credenciales por llamada: se usan solo en esta petición y no se guardan. Requiere el permiso credenciales:por_llamada. Si tu RUC usa la bóveda, no las envíes. Para el SIRE.
credenciales.sol object Sí Usuario secundario SOL del emisor. Nunca se guarda en registros ni se devuelve.
credenciales.sol.usuario string Sí Usuario secundario SOL, sin el RUC (lo agregamos con el RUC del emisor).
credenciales.sol.clave string (password) Sí Clave SOL del usuario secundario.
credenciales.api_sunat object Sí Credenciales de la API de SUNAT (guías y SIRE), generadas en SOL. Nunca se guarda en registros ni se devuelve.
credenciales.api_sunat.client_id string Sí
credenciales.api_sunat.client_secret string (password) Sí

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl -X POST "https://api-sandbox.opennexum.com/v1/emisores/20000000001/sire/propuestas" \
-H "Authorization: Bearer onx_test_…" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"registro": "RVIE",
"periodo": "202611"
}'

Propuesta en cola.

Campo Tipo Requerido Descripción
estado “en_cola” Sí
recurso object Sí Lo que se creó y queda en proceso.
recurso.tipo “comprobante” | “baja” | “resumen” | “guia” | “sire_propuesta” | “mensaje” | “entrega” | “clave” | “conexion” | “webhook” Sí
recurso.id string Sí
consulta_url string Sí Ruta para consultar cómo va.
mensaje string Sí
reintento_en string (date-time) No Próximo intento estimado, si aplica.

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