--- title: ¿Cómo solucionar los errores más comunes al usar la API? description: Conozca el significado de los errores más comunes al usar la API de Alegra y descubra los requisitos para asegurar una conexión exitosa. --- [Ir directamente al contenido](https://ayuda.alegra.com/cri/solucionar-los-errores-comunes-al-usar-la-api#main-content) ![costa rica](https://ayuda.alegra.com/hs-fs/hubfs/costa%20rica.png?width=60&height=60&name=costa%20rica.png) - [Colombia](https://ayuda.alegra.com/col) - [México](https://ayuda.alegra.com/mex) - [R. Dominicana](https://ayuda.alegra.com/dom) - [Costa Rica](https://ayuda.alegra.com/cri) - [España](https://ayuda.alegra.com/esp) - [Panamá](https://ayuda.alegra.com/pan) - [Perú](https://ayuda.alegra.com/per) - [Argentina](https://ayuda.alegra.com/arg) - [Venezuela](https://ayuda.alegra.com/ven) Abrir navegación principal Cerrar navegación principal - [Colombia](https://ayuda.alegra.com/col) - [México](https://ayuda.alegra.com/mex) - [R. Dominicana](https://ayuda.alegra.com/dom) - [Costa Rica](https://ayuda.alegra.com/cri) - [España](https://ayuda.alegra.com/esp) - [Panamá](https://ayuda.alegra.com/pan) - [Perú](https://ayuda.alegra.com/per) - [Argentina](https://ayuda.alegra.com/arg) - [Venezuela](https://ayuda.alegra.com/ven) Hola. ¿Cómo podemos ayudarte? - No hay sugerencias porque el campo de búsqueda está vacío. 1. [Costa Rica](https://ayuda.alegra.com/cri?hsLang=es-cr) 2. [Integraciones](https://ayuda.alegra.com/cri/integraciones?hsLang=es-cr) # ¿Cómo solucionar los errores más comunes al usar la API? Al conectar sus aplicaciones con [Alegra](https://www.alegra.com/costarica/?utm_source=help-center&utm_medium=product-marketing&utm_campaign=cri-ac-como_solucionar_los_errores_mas_comunes_al_usar_la_api_costa_rica-tmd_pmkt), es posible que encuentre algunos códigos de respuesta. Estos números son simplemente la forma en que el sistema le explica qué necesita para que la conexión sea exitosa: aquí le enseñamos a interpretarlos y solucionarlos rápidamente. 🛠️✨ #### 👉 Índice 1. [❓ ¿Qué significan los códigos de error en la API?](https://ayuda.alegra.com/cri/solucionar-los-errores-comunes-al-usar-la-api#p1) 2. [🔑 ¿Qué requisitos necesita para evitar estos errores?](https://ayuda.alegra.com/cri/solucionar-los-errores-comunes-al-usar-la-api#p2) 3. [⁉️ ¿Qué preguntas frecuentes debe conocer al usar la API?](https://ayuda.alegra.com/cri/solucionar-los-errores-comunes-al-usar-la-api#p3) ### ❓ ¿Qué significan los códigos de error en la API? Los errores se dividen en códigos numéricos que le ayudan a identificar rápidamente qué está fallando en la comunicación entre sus sistemas y Alegra: - ⚠️ **Error 400 (solicitud incorrecta)**: indica que existe un error en la estructura de la información enviada. Verifique que no falten campos obligatorios (como el nombre del cliente) o que los datos no tengan formatos inválidos. - 🔐 **Error 401 (no autorizado)**: corresponde a un problema de identificación. Generalmente ocurre cuando el token de API es incorrecto, contiene espacios adicionales o el correo de autenticación no coincide con el registrado. - 💳 **Error 402 (pago requerido)**: este código está relacionado con el estado de su cuenta. Aparece cuando la suscripción ha vencido o cuando intenta utilizar una funcionalidad que no está incluida en su plan actual. - 🚫 **Error 403 (prohibido)**: el sistema reconoce su usuario, pero no cuenta con permisos para realizar esa acción. Confirme que tenga acceso al módulo que desea consultar (como nómina o inventario). 💡 **AlegraTip**: si encuentra un código diferente o quiere profundizar en los detalles técnicos, puede consultar nuestra guía sobre [respuestas del API y manejo de errores](https://developer.alegra.com/reference/respuestas-del-api-y-manejo-de-errores?utm_source=help-center&utm_medium=product-marketing&utm_campaign=col-ac-como_solucionar_los_errores_mas_comunes_al_usar_la_api-tmd_pmkt). Además, le invitamos a explorar el portal de [Alegra API](https://developer.alegra.com/?utm_source=help-center) para obtener toda la información necesaria para sus integraciones. [![Arriba Índice HC](https://ayuda.alegra.com/hs-fs/hubfs/Arriba%20%C3%8Dndice%20HC.png?width=30&height=30&name=Arriba%20%C3%8Dndice%20HC.png)](https://ayuda.alegra.com/cri/solucionar-los-errores-comunes-al-usar-la-api#i) ### 🔑 ¿Qué requisitos necesita para evitar estos errores? Para que su integración funcione siempre correctamente, asegúrase de cumplir con estos puntos básicos: 1. **Credenciales vigentes**: verifique que su correo y su **token** estén bien configurados en la herramienta que esté conectando. [🔍 ¿Cómo conectar tu cuenta de Alegra con otras aplicaciones usando la API?](https://ayuda.alegra.com/int/alegra-api-conecta-tu-cuenta-con-otras-aplicaciones?hsLang=es-cr#p2) 2. **Plan activo**: asegúrase de tener una suscripción de Alegra al día para evitar bloqueos por falta de pago. 3. **Límites de la API**: recuerde que existe un límite de solicitudes por minuto para garantizar la estabilidad del sistema. [![Arriba Índice HC](https://ayuda.alegra.com/hs-fs/hubfs/Arriba%20%C3%8Dndice%20HC.png?width=30&height=30&name=Arriba%20%C3%8Dndice%20HC.png)](https://ayuda.alegra.com/cri/solucionar-los-errores-comunes-al-usar-la-api#i) ### ⁉️ ¿Qué preguntas frecuentes debe conocer al usar la API? #### 🧾 ¿Necesito tener creados los productos y clientes para poder facturar? Sí. Debe tener creados los **contactos** e **ítems** en Alegra, ya sea desde la interfaz o mediante la API. #### 🔢 ¿Cómo gestiono las numeraciones de facturación de mis documentos? Puede usar la numeración principal enviando **stamp \> generateStamp: true** o una específica con **numberTemplate \> id**. #### 🔔 ¿Cómo configuro los webhooks? Necesita una URL que reciba solicitudes **POST (HTTPS)** y responda con código **2XX en menos de 5 segundos** para mantener activa la suscripción. [![Arriba Índice HC](https://ayuda.alegra.com/hs-fs/hubfs/Arriba%20%C3%8Dndice%20HC.png?width=30&height=30&name=Arriba%20%C3%8Dndice%20HC.png)](https://ayuda.alegra.com/cri/solucionar-los-errores-comunes-al-usar-la-api#i) **¿Aún no tiene cuenta en Alegra?** **[![Botóns regístrese - CRI](https://ayuda.alegra.com/hs-fs/hubfs/Im%C3%A1genes%20ayudas/Bot%C3%B3ns%20reg%C3%ADstrese%20-%20CRI.png?width=137&height=50&name=Bot%C3%B3ns%20reg%C3%ADstrese%20-%20CRI.png)](https://app.alegra.com/user/register/country/costarica?utm_source=help-center&utm_medium=product-marketing&utm_campaign=cri-ac-como_solucionar_los_errores_mas_comunes_al_usar_la_api_costa_rica-tmd_pmkt)** - [Alegra ERP](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#main-content) - [Ingresos](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#ingresos) - [Reportes](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#reportes) - [Gastos](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#gastos) - [Impuestos y Retenciones](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#impuestos-y-retenciones) - [Emisión de documentos](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#emisi%C3%B3n-de-documentos) - [Bancos](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#bancos) - [Contactos](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#contactos) - [Contabilidad inteligente](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#contabilidad-inteligente) - [Inventario](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#inventario) - [Configuración](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#configuraci%C3%B3n) - [Contabilidad](https://ayuda.alegra.com/cri/alegra-erp?hsLang=es-cr#contabilidad) - [Alegra POS](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#main-content) - [Ingresos](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#ingresos) - [Contactos](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#contactos) - [Configuración](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#configuraci%C3%B3n) - [Gestión de efectivo](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#gesti%C3%B3n-de-efectivo) - [Inventario](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#inventario) - [Emisión de documentos](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#emisi%C3%B3n-de-documentos) - [Devoluciones](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#devoluciones) - [Turnos](https://ayuda.alegra.com/cri/alegra-pos?hsLang=es-cr#turnos) - [Facturación Electrónica](https://ayuda.alegra.com/cri/facturaci%C3%B3n-electr%C3%B3nica?hsLang=es-cr) - [Primeros Pasos](https://ayuda.alegra.com/cri/primeros-pasos?hsLang=es-cr) - [Migraciones](https://ayuda.alegra.com/cri/migraciones?hsLang=es-cr) - [Integraciones](https://ayuda.alegra.com/cri/integraciones?hsLang=es-cr) - [Alegra IA](https://ayuda.alegra.com/cri/alegra-ia?hsLang=es-cr) - [Alegra MCP](https://ayuda.alegra.com/cri/alegra-mcp?hsLang=es-cr) - [Espacio Contador](https://ayuda.alegra.com/cri/espacio-contador?hsLang=es-cr) - [App Móvil](https://ayuda.alegra.com/cri/app-m%C3%B3vil?hsLang=es-cr) - [Alegra Ventas](https://ayuda.alegra.com/cri/alegra-ventas?hsLang=es-cr) - [Alianzas Académicas](https://ayuda.alegra.com/cri/alianzas-acad%C3%A9micas?hsLang=es-cr) COPYRIGHT © 2026 Soluciones Alegra S.A.S. Copyright © 2026, Alegra