API SUNAT para Hermes Agent
Emite facturas, boletas y guías electrónicas en SUNAT desde Hermes Agent. 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 con:
hermes skills install https://docs.apisunat.net/skills/apisunat/SKILL.md --name apisunat
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
Hermes Agent es el agente de código abierto de Nous Research. Instala skills desde una URL, así que el de API SUNAT queda listo con un solo comando.
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 Hermes Agent
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
Hermes lo guarda en ~/.hermes/skills/ y lo activa en la siguiente sesión; para usarlo ya, ejecuta /reset.
hermes skills install https://docs.apisunat.net/skills/apisunat/SKILL.md --name apisunatQué 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 Hermes Agent u otro agente y el usuario te pidió configurar API SUNAT, sigue estos pasos:
- Ejecuta hermes skills install https://docs.apisunat.net/skills/apisunat/SKILL.md --name apisunat 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 Hermes Agent
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