GuíaEjemplosReferencia API
apisunat.netIngresar

Primeros pasos

  • API SUNAT
  • Inicio rápido
  • Integra con IA
  • Servidor MCP
  • n8n
  • Autenticación
  • Planes y límites
  • Planillas y honorarios

Configurar el RUC

  • Emisores
  • Establecimientos y series

Emitir

  • Documentos
  • Idempotencia
  • Estados
  • Correos
  • Catálogos

Integración

  • Errores
  • Webhooks
  • Cambios

Servidor MCP

Usa API SUNAT desde Claude, ChatGPT, Cursor, Codex o VS Code: conector remoto con OAuth o servidor local apisunat-mcp.

El servidor MCP apisunat-mcp conecta tu agente de IA con API SUNAT: emite y consulta comprobantes, anula, emite guías de remisión y explica los códigos de error de SUNAT. Es gratuito y de código abierto (MIT).

Puedes usarlo de dos formas: como conector remoto (sin instalar nada ni copiar claves) o instalado en tu equipo con una clave de API.

Conector remoto (recomendado)

Agrega esta URL como conector MCP en tu asistente:

text
https://api.apisunat.net/mcp

Al conectar se abre API SUNAT: inicias sesión, eliges la empresa y el entorno:

  • Pruebas: emite en SUNAT beta, sin validez tributaria y sin consumir tu plan.
  • Producción: emite comprobantes reales. Se habilita cuando la empresa tiene registrados su usuario SOL y su certificado digital.

La conexión tiene acceso total en el entorno elegido y usa su propia clave de API, que verás en API Keys; en la página Conectores de la consola ves las conexiones activas y las desconectas. Para cambiar de entorno, desconéctala y vuelve a conectar.

En claude.ai o Claude Desktop: Configuración → Conectores → Agregar conector personalizado y pega la URL.

Instalación local (con clave de API)

Necesitas Node.js 18 o superior y una clave de API. Con una clave asu_test_ emites en SUNAT beta sin consumir tu plan. Ver Autenticación.

bash
claude mcp add apisunat --env APISUNAT_API_KEY=asu_test_tu_clave -- npx -y apisunat-mcp

Herramientas

HerramientaEndpointQué hace
issue_documentPOST /documentsEmite factura, boleta, nota de crédito o débito y retención
get_documentGET /documents/{id}Consulta un comprobante y su estado
list_documentsGET /documentsLista comprobantes por tipo, estado y fechas
resend_documentPOST /documents/{id}/resendReenvía a SUNAT un comprobante en error
query_sunat_statusPOST /documents/{id}/query-sunatConsulta el ticket en SUNAT
send_document_emailPOST /documents/{id}/emailsEnvía el PDF y el XML por correo
void_documentsPOST /voidsAnula comprobantes
issue_guide / get_guidePOST /guides, GET /guides/{id}Guías de remisión remitente
calculate_totalsPOST /calculationsCalcula totales e IGV sin emitir
get_accountGET /accountPlan y consumo del mes
list_issuersGET /issuersRUC registrados
get_catalog / search_sunat_productsGET /catalogs/...Catálogos de SUNAT
explain_sunat_errorsin llamadaExplica un código de error de SUNAT; funciona sin clave

issue_document, issue_guide y void_documents piden idempotency_key: usa un id estable de la venta. Si el agente repite la llamada, la API devuelve el mismo resultado. Ver Idempotencia.

Variables de entorno

VariableDescripción
APISUNAT_API_KEYClave asu_test_ o asu_live_. Sin ella solo funciona explain_sunat_error.
APISUNAT_BASE_URLOpcional. Por defecto https://api.apisunat.net/api/v1/issuer.

Skill o MCP

El servidor MCP sirve para que el agente opere la API: emitir, consultar o anular desde la conversación. Si quieres que el agente escriba la integración en tu propio sistema, usa el skill de la integración con IA. Puedes usar los dos.

Integra con IA< Previousn8nNext >

Powered by heyo

On this page

Conector remoto (recomendado)Instalación local (con clave de API)HerramientasVariables de entornoSkill o MCP