# OpenNexum > La API peruana para agentes de IA y programadores: una sola clave para comprobantes SUNAT (Nexum Comprobantes) y mensajería de Meta (Nexum Conecta), con saldo prepagado en soles. Solo fuentes oficiales y legales. Autenticación: `Authorization: Bearer onx_live_…` (producción) u `onx_test_…` (sandbox). Los errores traen un `codigo` estable; la lista completa está en la página de errores. ## Guías - [Documentación de OpenNexum](https://docs.opennexum.com/index.md): Una sola clave para comprobantes SUNAT y mensajería, con saldo en soles. Solo fuentes oficiales y legales. - [Inicio rápido](https://docs.opennexum.com/inicio-rapido.md): Con una clave onx_test_ haces tu primera consulta de RUC y de tipo de cambio en el sandbox, en minutos. - [Autenticación](https://docs.opennexum.com/autenticacion.md): Cómo enviar tu clave onx_live_ u onx_test_, y qué son los permisos, el tope y el alcance por RUC. - [Permisos](https://docs.opennexum.com/permisos.md): Qué puede hacer cada clave y qué rutas exigen cada permiso. - [Idempotencia](https://docs.opennexum.com/idempotencia.md): Con la cabecera Idempotency-Key puedes repetir una petición sin cobrar ni emitir dos veces. - [Saldo y error 402](https://docs.opennexum.com/saldo-y-402.md): Cómo funciona el saldo prepagado en soles y qué hacer cuando la API responde 402 con recarga_url. - [Límites y error 429](https://docs.opennexum.com/limites-y-429.md): Qué pasa si haces demasiadas peticiones seguidas y cómo usar la cabecera Retry-After. - [Errores](https://docs.opennexum.com/errores.md): Cada código de error de la API con su estado HTTP y lo que debes hacer. - [Nexum Comprobantes](https://docs.opennexum.com/comprobantes.md): Emite facturas, boletas y notas electrónicas a SUNAT, y consulta RUC, tipo de cambio y padrones, con tu propio certificado. - [Nexum Conecta](https://docs.opennexum.com/conecta.md): WhatsApp, Instagram y Messenger como funciones de tu API: bandeja, mensajes, plantillas, comprobante por WhatsApp y webhooks firmados. - [Para agentes de IA](https://docs.opennexum.com/agentes.md): Cómo conectar a Claude Code, Codex u otro agente: documentación en texto plano, skill, confirmación humana y lo que llega próximamente (MCP, OAuth, login). ## Referencia de la API - [Referencia de la API](https://docs.opennexum.com/referencia.md): Todas las rutas de la API v1, generadas desde openapi.json. - [Dice quién eres](https://docs.opennexum.com/referencia/cuenta/yo_ver.md): Devuelve la cuenta (id público y nombre), el entorno, el tipo de credencial (clave o token OAuth), sus permisos, los RUC a los que llega y su tope. Basta una credencial válida y no cobra. Nunca devuelve la clave ni el token. - [Consulta tu saldo](https://docs.opennexum.com/referencia/cuenta/cuenta_saldo.md): Devuelve el saldo disponible y reservado en soles, el tope de la clave que pregunta y el enlace de recarga. - [Lista tu consumo](https://docs.opennexum.com/referencia/cuenta/cuenta_consumo.md): Movimientos de tu saldo del periodo (por omisión, el mes en curso): reservas, cobros y liberaciones con la operación y la clave que los hizo, y las recargas acreditadas. Trae además el gasto de cada clave o agente en todo el periodo. - [Declara una recarga por Yape o Plin](https://docs.opennexum.com/referencia/cuenta/recarga_crear.md): Una persona paga por Yape o Plin y declara el pago: monto, método, número de operación, día del pago y la captura (voucher) en base64. La recarga queda `en_revision` hasta que la revisamos; se acredita una sola vez y luego te enviamos la factura. El mismo número de operación (o el mismo voucher) no se registra dos veces. - [Abre un ticket de soporte](https://docs.opennexum.com/referencia/cuenta/ticket_crear.md): Reporta un problema o propone una mejora. Basta una clave válida, así que un agente puede reportar lo que le falla; incluye el `request_id`. Te respondemos en el ticket. Nunca pegues claves, contraseñas ni certificados. - [Lista tus tickets de soporte](https://docs.opennexum.com/referencia/cuenta/ticket_listar.md): Tickets que abrió esta clave, del más reciente al más antiguo, sin sus mensajes. - [Consulta un ticket de soporte](https://docs.opennexum.com/referencia/cuenta/ticket_ver.md): Un ticket que abrió esta clave, con todos sus mensajes y su estado. Úsalo para ver si ya te respondimos. - [Responde en un ticket de soporte](https://docs.opennexum.com/referencia/cuenta/ticket_responder.md): Agrega tu mensaje a un ticket que abrió esta clave. Un ticket cerrado no recibe mensajes: abre otro. - [Cierra un ticket de soporte](https://docs.opennexum.com/referencia/cuenta/ticket_cerrar.md): Cierra un ticket que abrió esta clave cuando ya no necesitas ayuda. Cerrar uno ya cerrado no cambia nada. - [Lista las claves de tu cuenta](https://docs.opennexum.com/referencia/claves/clave_listar.md): Claves activas y revocadas del entorno de tu clave (`live` o `test`), con sus permisos, alcance por RUC y tope. Nunca devuelve la clave completa. Los agentes conectados por OAuth no salen aquí: se ven y desconectan en el panel. - [Crea una clave con tope y permisos](https://docs.opennexum.com/referencia/claves/clave_crear.md): Crea una clave para un agente, nunca con más permisos, RUC, tope o plazo que la clave que la crea. Siempre espera la aprobación de una persona (202). Ya aprobada, repite la petición con la misma `Idempotency-Key`: la primera respuesta 201 trae `secreto`; las siguientes responden `ya_registrado` (el secreto no se guarda). Si la persona la rechaza o la aprobación vence, responde `estado_no_permite`. - [Revoca una clave](https://docs.opennexum.com/referencia/claves/clave_revocar.md): La clave deja de funcionar al instante. No se puede deshacer; crea otra si la necesitas. Puedes revocar tu propia clave o una que creó ella (o sus descendientes); una clave nunca revoca a la que la creó. Las demás se revocan desde el panel. - [Consulta una aprobación pendiente](https://docs.opennexum.com/referencia/confirmaciones/confirmacion_ver.md): Estado de una operación que respondió 202 `requiere_confirmacion`. Basta una clave válida, pero solo la ve la clave que la pidió, y consultarla no la cambia. Cuando está `aprobada`, repite la misma petición (misma `Idempotency-Key` y mismo cuerpo) antes de `expira_en` para hacerla; entonces queda `usada`. - [Consulta un RUC](https://docs.opennexum.com/referencia/datos/ruc_consultar.md): Razón social, estado, condición y dirección desde el padrón reducido de SUNAT. Gratis hasta el cupo mensual de tu plan; luego se descuenta del saldo. - [Consulta los padrones de un RUC](https://docs.opennexum.com/referencia/datos/ruc_padrones.md): Indica si el RUC es agente de retención, agente de percepción o buen contribuyente, según SUNAT. - [Consulta el tipo de cambio](https://docs.opennexum.com/referencia/datos/tipo_cambio_consultar.md): Compra y venta oficiales del dólar para una fecha, según el BCRP. Sin fecha, el de hoy en Lima. - [Registra un RUC emisor](https://docs.opennexum.com/referencia/emisores/emisor_crear.md): Agrega un RUC a tu cuenta para emitir. Revisamos el padrón: si el RUC está obligado a OSE, no se acepta en la v1; si ya está en otra cuenta, responde `ya_registrado` (se transfiere por soporte). - [Lista tus RUC emisores](https://docs.opennexum.com/referencia/emisores/emisor_listar.md): RUC emisores de tu cuenta a los que tiene acceso la clave. - [Consulta un RUC emisor](https://docs.opennexum.com/referencia/emisores/emisor_ver.md): Datos del emisor, entorno y modo de credenciales. - [Guarda credenciales en la bóveda](https://docs.opennexum.com/referencia/emisores/credenciales_guardar.md): Guarda el certificado y el usuario SOL secundario cifrados. Solo funciona con la bóveda activa; mientras tanto responde `boveda_inactiva` y debes enviar `credenciales` en cada llamada. No se expone a agentes por MCP: un certificado no debe pasar por el chat. - [Lista las series de un emisor](https://docs.opennexum.com/referencia/emisores/serie_listar.md): Series registradas y el último número asignado en cada una. - [Crea una serie](https://docs.opennexum.com/referencia/emisores/serie_crear.md): Registra una serie (F001, B001, T001…). Si vienes de otro sistema, indica el último número usado. - [Ensaya un comprobante sin emitirlo](https://docs.opennexum.com/referencia/comprobantes/comprobante_validar.md): Calcula los totales y revisa las reglas de SUNAT con el mismo cuerpo de la emisión, sin numerar, sin enviar y sin cobrar. Úsalo antes de emitir algo dudoso. - [Emite una factura, boleta o nota](https://docs.opennexum.com/referencia/comprobantes/comprobante_emitir.md): Emite y envía a SUNAT. El número lo asigna el servidor. Reserva el precio del saldo y lo cobra solo si SUNAT acepta; si SUNAT rechaza, se libera. Si SUNAT no responde, queda `en_cola` (202) y se envía solo. Según tu clave, notas, bajas o montos altos esperan la aprobación de una persona (202 `requiere_confirmacion`). - [Lista comprobantes de un emisor](https://docs.opennexum.com/referencia/comprobantes/comprobante_listar.md): Comprobantes del RUC, del más reciente al más antiguo, con filtros por tipo, serie, estado y fechas. - [Consulta un comprobante](https://docs.opennexum.com/referencia/comprobantes/comprobante_ver.md): Detalle, estado ante SUNAT y enlaces de descarga de un comprobante. - [Descarga el XML firmado](https://docs.opennexum.com/referencia/comprobantes/comprobante_xml.md): XML UBL 2.1 firmado tal como se envió a SUNAT. - [Descarga el CDR](https://docs.opennexum.com/referencia/comprobantes/comprobante_cdr.md): Constancia de recepción (CDR) de SUNAT en XML. Mientras está `en_cola` responde `estado_no_permite`. - [Descarga el PDF](https://docs.opennexum.com/referencia/comprobantes/comprobante_pdf.md): Representación impresa con QR, en A4 o ticket de 80 mm. - [Da de baja un comprobante](https://docs.opennexum.com/referencia/comprobantes/comprobante_anular.md): Comunicación de baja para facturas y resumen diario para boletas, dentro del plazo de SUNAT. La baja es asíncrona (202 `en_cola`). Según tu clave, puede esperar la aprobación de una persona. - [Pregunta a SUNAT el estado de un comprobante](https://docs.opennexum.com/referencia/comprobantes/comprobante_consultar_sunat.md): Consulta el estado en SUNAT, guarda el CDR si llega y devuelve el comprobante actualizado. - [Envía el resumen diario de boletas](https://docs.opennexum.com/referencia/resumenes/resumen_crear.md): Arma el resumen diario con las boletas del día que faltan informar y lo envía a SUNAT. Es asíncrono: consulta el resumen con su `id`. - [Lista resúmenes y comunicaciones de baja](https://docs.opennexum.com/referencia/resumenes/resumen_listar.md): Resúmenes diarios (RC) y comunicaciones de baja (RA) del emisor, con su estado en SUNAT. - [Consulta un resumen](https://docs.opennexum.com/referencia/resumenes/resumen_ver.md): Estado de un resumen diario o de una comunicación de baja, con el ticket y la respuesta de SUNAT. - [Emite una guía de remisión remitente](https://docs.opennexum.com/referencia/guias/guia_emitir.md): Emite la guía (09) por la API de SUNAT. El número lo asigna el servidor. Reserva el precio y lo cobra solo si SUNAT la acepta; si SUNAT no responde, queda `en_cola`. - [Lista guías de un emisor](https://docs.opennexum.com/referencia/guias/guia_listar.md): Guías de remisión del emisor, de la más reciente a la más antigua. - [Consulta una guía](https://docs.opennexum.com/referencia/guias/guia_ver.md): Detalle y estado ante SUNAT de una guía de remisión. - [Pide la propuesta del SIRE de un periodo](https://docs.opennexum.com/referencia/sire/sire_propuesta_pedir.md): 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`. - [Consulta una propuesta del SIRE](https://docs.opennexum.com/referencia/sire/sire_propuesta_ver.md): Estado de la propuesta y, cuando está `lista`, sus totales. - [Lista las líneas de una propuesta del SIRE](https://docs.opennexum.com/referencia/sire/sire_registros_listar.md): Comprobantes de la propuesta, normalizados. Solo cuando la propuesta está `lista`. - [Crea una conexión de WhatsApp, Instagram o Messenger](https://docs.opennexum.com/referencia/conexiones/conexion_crear.md): Crea la conexión y devuelve `alta_url` para que una persona complete el alta con el proveedor. El proveedor es un dato de la conexión: tu integración no cambia si el número pasa de un proveedor a otro. - [Lista tus conexiones](https://docs.opennexum.com/referencia/conexiones/conexion_listar.md): Conexiones de la cuenta con su canal, proveedor y estado. - [Consulta una conexión](https://docs.opennexum.com/referencia/conexiones/conexion_ver.md): Estado de una conexión y, si está pendiente, su enlace de alta. - [Borra una conexión](https://docs.opennexum.com/referencia/conexiones/conexion_borrar.md): Desconecta el número o la cuenta. Las conversaciones quedan guardadas para consulta. Según tu clave, puede esperar la aprobación de una persona. - [Prueba una conexión](https://docs.opennexum.com/referencia/conexiones/conexion_probar.md): Verifica con el proveedor que la conexión funciona. No envía mensajes a nadie. - [Envía un mensaje](https://docs.opennexum.com/referencia/mensajes/mensaje_enviar.md): Envía texto, un archivo o una plantilla por la conexión indicada. Fuera de la ventana de atención solo acepta plantillas (si no, 409 `ventana_cerrada` con plantillas sugeridas). Si el proveedor no confirma, el mensaje queda `incierto` y no se reenvía solo. Los cargos de Meta por mensaje los paga tu cuenta de Meta. - [Consulta un mensaje](https://docs.opennexum.com/referencia/mensajes/mensaje_ver.md): Estado de entrega de un mensaje enviado o detalle de uno recibido. - [Lista conversaciones](https://docs.opennexum.com/referencia/mensajes/conversacion_listar.md): Bandeja de WhatsApp, Instagram y Messenger, con la ventana de atención de cada conversación. - [Consulta una conversación](https://docs.opennexum.com/referencia/mensajes/conversacion_ver.md): Contacto, ventana de atención y mensajes sin leer de una conversación. - [Lista los mensajes de una conversación](https://docs.opennexum.com/referencia/mensajes/conversacion_mensajes.md): Mensajes enviados y recibidos, del más reciente al más antiguo. - [Envía un comprobante por mensaje](https://docs.opennexum.com/referencia/mensajes/comprobante_enviar.md): Envía el PDF de un comprobante de tu cuenta (aceptado u observado) por WhatsApp. Dentro de la ventana de atención va como documento con un texto corto (serie, número y total, o el tuyo). Fuera de ella usamos una plantilla de utilidad aprobada de la conexión con un documento en el encabezado (la que indiques o la que encontremos); si no hay una, o la conexión es de Zernio, responde 409 `ventana_cerrada` con `detalle.plantilla_faltante`: qué falta y el texto sugerido para registrarla en Meta. Un resultado `incierto` no se reenvía solo. Reserva el precio y lo cobra solo si se envía. - [Lista plantillas](https://docs.opennexum.com/referencia/plantillas/plantilla_listar.md): Plantillas de mensaje por conexión, con su estado de revisión. - [Crea una plantilla](https://docs.opennexum.com/referencia/plantillas/plantilla_crear.md): Crea una plantilla y la manda a revisión. Te avisamos con el evento `plantilla.estado`. - [Registra un webhook](https://docs.opennexum.com/referencia/webhooks/webhook_crear.md): Registra tu endpoint para recibir eventos normalizados y firmados. Siempre espera la aprobación de una persona (por ese endpoint pasarán los mensajes de tus clientes). Ya aprobado, repite la petición con la misma `Idempotency-Key`: la primera respuesta 201 trae `secreto`; las siguientes responden `ya_registrado`. - [Lista tus webhooks](https://docs.opennexum.com/referencia/webhooks/webhook_listar.md): Webhooks registrados, sus eventos y su estado. Nunca devuelve el secreto. - [Borra un webhook](https://docs.opennexum.com/referencia/webhooks/webhook_borrar.md): Deja de enviar eventos a ese endpoint y cancela las entregas pendientes. Según tu clave, puede esperar la aprobación de una persona. - [Envía un evento de prueba](https://docs.opennexum.com/referencia/webhooks/webhook_probar.md): Envía un evento `webhook.prueba` firmado y devuelve cómo respondió tu endpoint. - [Rota el secreto de un webhook](https://docs.opennexum.com/referencia/webhooks/webhook_rotar_secreto.md): Genera un secreto nuevo. Durante 24 horas firmamos con los dos (dos `v1` en la cabecera) para que cambies el tuyo sin perder eventos. - [Lista entregas de eventos](https://docs.opennexum.com/referencia/webhooks/entrega_listar.md): Intentos de entrega a tus webhooks, con el código HTTP que respondió tu endpoint. - [Reintenta una entrega](https://docs.opennexum.com/referencia/webhooks/entrega_reintentar.md): Vuelve a encolar una entrega fallida o pausada. El evento conserva su `id` para que no lo dupliques. - [Eventos de webhook](https://docs.opennexum.com/referencia/eventos-webhook.md): Qué te enviamos desde Nexum Conecta y cómo verificar la firma X-Nexum-Signature. ## Opcional - [OpenAPI 3.1](https://docs.opennexum.com/openapi.json): el contrato completo en JSON. - [Documentación completa en un solo archivo](https://docs.opennexum.com/llms-full.txt) - [Skill instalable para agentes](https://docs.opennexum.com/skill/opennexum/SKILL.md): borrador.