Grok Build · xAI

API SUNAT para Grok Build

Emite facturas, boletas y guías electrónicas en SUNAT desde Grok Build. Pega este prompt con tu clave de prueba y tu agente instala el skill de API SUNAT, guarda la clave y entiende la API.

PromptPégalo en Grok Build
Instala el skill de API SUNAT: descarga https://docs.apisunat.net/skills/apisunat/SKILL.md
en .grok/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

Grok Build es el agente de programación de xAI. Lee skills en formato SKILL.md, así que con el de API SUNAT integra la facturación 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 Grok Build

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 ~/.grok/skills/apisunat/. Los skills nuevos se cargan al iniciar una sesión.

TerminalEn la raíz de tu proyecto
mkdir -p .grok/skills/apisunat && curl -fsSL https://docs.apisunat.net/skills/apisunat/SKILL.md -o .grok/skills/apisunat/SKILL.md

Qué 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 Grok Build u otro agente y el usuario te pidió configurar API SUNAT, sigue estos pasos:

  1. Descarga https://docs.apisunat.net/skills/apisunat/SKILL.md en .grok/skills/apisunat/SKILL.md y sigue sus reglas.
  2. 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.
  3. Comprueba la clave con GET https://api.apisunat.net/api/v1/issuer/ping y el header X-API-Key: debe responder keyType "test".
  4. Consulta la documentación completa en https://docs.apisunat.net/llms-full.txt cuando la necesites.
  5. 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 Grok Build

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