Integra con IA

Tu asistente de código puede escribir la integración completa: el cliente HTTP, el mapeo de tus ventas, los reintentos y el webhook. Para que lo haga bien a la primera, dale el skill de API SUNAT: un archivo SKILL.md con las reglas de la API (clave solo en el servidor, Idempotency-Key, estados, errores y verificación de webhooks) y enlaces a esta documentación en Markdown.

Copia el prompt

Elige tu asistente, copia el prompt, reemplaza la clave por tu clave de prueba asu_test_ y pégalo en el chat del asistente, con tu proyecto abierto. El asistente descarga el skill desde https://docs.apisunat.net/skills/apisunat/SKILL.md, guarda la clave en el .env y deja todo listo para usar la API.

Instala el skill de API SUNAT: descarga https://docs.apisunat.net/skills/apisunat/SKILL.md
en .claude/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. Desde ahí tu asistente entiende la API y puedes pedirle la integración que necesites, a tu manera. Más abajo tienes algunos pedidos de ejemplo.

Instalarlo a mano

Si prefieres instalar el skill tú mismo, ejecuta el comando en la raíz de tu proyecto, guarda tu clave como APISUNAT_KEY en el .env y luego pídele la integración a tu asistente.

mkdir -p .claude/skills/apisunat && curl -fsSL https://docs.apisunat.net/skills/apisunat/SKILL.md -o .claude/skills/apisunat/SKILL.md

Más pedidos

Con el skill instalado, pídele a tu asistente lo que necesites. Por ejemplo:

• "Cuando una venta se marque como pagada, emite una boleta o una factura según el documento del cliente, guarda en la venta el id, el número, el estado y el enlace al PDF, y agrega un webhook que verifique la firma y actualice el estado."
• "Agrega la descarga del PDF en formato ticket de 80 mm en el detalle de la venta."
• "Emite una nota de crédito cuando se anule una venta ya facturada."
• "Muestra los errores de la API al usuario según su code."

1. 1

   Prueba en beta

   Con una clave asu_test_ todo se emite en SUNAT beta, con numeración propia desde 90000001, sin validez tributaria y sin consumir tu plan.

2. 2

   Revisa el resultado

   Confirma que la boleta y la factura de prueba vuelven con status: "accepted" y que el PDF se descarga.

3. 3

   Pasa a producción

   Cuando todo funcione, cambia a una clave asu_live_ y habilita producción en tu RUC. Ese cambio lo decides tú, no el asistente.

Documentación para IA

Además del skill, toda la documentación está disponible en formatos que los asistentes leen bien: