API SUNAT para Codex
Emite facturas, boletas y guías electrónicas en SUNAT desde Codex. Pega este prompt con tu clave de prueba y tu agente instala el skill de API SUNAT, guarda la clave y entiende la API.
Instala el skill de API SUNAT: descarga https://docs.apisunat.net/skills/apisunat/SKILL.md
en .agents/skills/apisunat/SKILL.md y sigue sus reglas.
Mi clave API de prueba es: asu_test_PEGA_AQUI_TU_CLAVE
Guárdala como APISUNAT_KEY en el .env del proyecto (agrégalo al
.gitignore si no está) y nunca la escribas en el código. Luego lee
la documentación del skill y confírmame que quedó todo listo para
usar API SUNAT.Listo en tres pasos
Codex es el agente de programación de OpenAI. Lee los skills de .agents/skills, así que con el de API SUNAT integra la facturación siguiendo las reglas de la API.
Crea tu cuenta y una clave de prueba
Las claves asu_test_ emiten en SUNAT beta, con numeración propia y sin consumir tu plan.
Pega el prompt en Codex
Reemplaza la clave del prompt por la tuya. Tu agente instala el skill, guarda la clave y entiende la API.
Pídele lo que necesites
Con las reglas de la API ya cargadas, tu agente integra o emite comprobantes a tu manera.
Instálalo a mano
Para tenerlo en todos tus proyectos, usa ~/.agents/skills/apisunat/.
mkdir -p .agents/skills/apisunat && curl -fsSL https://docs.apisunat.net/skills/apisunat/SKILL.md -o .agents/skills/apisunat/SKILL.mdQué le puedes pedir
Después de configurarlo, pídeselo con tus palabras. Por ejemplo:
- “Cuando una venta se marque como pagada, emite una boleta o una factura según el documento del cliente y guarda el número y el enlace al PDF.”
- “Agrega un webhook que verifique la firma y actualice el estado del comprobante.”
- “Emite una nota de crédito cuando se anule una venta ya facturada.”
- “Muestra los errores de la API al usuario según su código.”
Para agentes de IA que leen esta página
Si eres Codex u otro agente y el usuario te pidió configurar API SUNAT, sigue estos pasos:
- Descarga https://docs.apisunat.net/skills/apisunat/SKILL.md en .agents/skills/apisunat/SKILL.md y sigue sus reglas.
- Pide al usuario su clave de prueba asu_test_ y guárdala como APISUNAT_KEY en el .env del proyecto, fuera del código y de git.
- Comprueba la clave con GET https://api.apisunat.net/api/v1/issuer/ping y el header X-API-Key: debe responder keyType "test".
- Consulta la documentación completa en https://docs.apisunat.net/llms-full.txt cuando la necesites.
- Avisa al usuario que todo quedó listo y pregúntale qué quiere hacer. No cambies a una clave asu_live_ si el usuario no lo pide.
Emite tu primera factura con Codex
Crea tu cuenta, genera una clave de prueba y pégala en el prompt. Tu agente deja todo listo para emitir en SUNAT beta.
Empieza gratis