API SUNAT para Cursor
Emite facturas, boletas y guías electrónicas en SUNAT desde Cursor. 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 .cursor/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
Cursor es el editor con agente de IA. Con el skill de API SUNAT en .cursor/skills, su agente integra la emisión de comprobantes en tu proyecto.
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 Cursor
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
Cursor también lee los skills de .claude/skills/, así que si ya lo instalaste para Claude Code no necesitas repetirlo.
mkdir -p .cursor/skills/apisunat && curl -fsSL https://docs.apisunat.net/skills/apisunat/SKILL.md -o .cursor/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 Cursor u otro agente y el usuario te pidió configurar API SUNAT, sigue estos pasos:
- Descarga https://docs.apisunat.net/skills/apisunat/SKILL.md en .cursor/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 Cursor
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