Al conectar tus aplicaciones con Alegra, es posible que encuentres algunos códigos de respuesta. Estos números son simplemente la forma en que el sistema te explica qué necesita para que la conexión sea exitosa: aquí te enseñamos a interpretarlos y solucionarlos rápidamente. 🛠️✨
👉 Índice
❓ ¿Qué significan los códigos de error en la API?
Los errores se dividen en códigos numéricos que te ayudan a identificar rápidamente qué está fallando en la comunicación entre tus sistemas y Alegra:
-
⚠️ Error 400 (solicitud incorrecta): indica que hay un error en la estructura de la información que enviaste. Revisa que no falten campos obligatorios (como el nombre del cliente) o que los datos no tengan formatos inválidos.
-
🔐 Error 401 (no autorizado): es un problema de identificación. Suele ocurrir porque el token de API es incorrecto, tiene 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 tu cuenta. Aparece cuando la suscripción ha vencido o cuando intentas usar una funcionalidad que no está incluida en tu plan actual.
-
🚫 Error 403 (prohibido): el sistema sabe quién eres, pero no tienes permisos para esa acción. Confirma que tu usuario tenga acceso al módulo que intentas consultar (como nómina o inventario).
💡 AlegraTip: si encuentras un código diferente o quieres profundizar en los detalles técnicos, puedes consultar nuestra guía sobre respuestas del API y manejo de errores. Además, te invitamos a explorar el portal de Alegra API para obtener toda la información necesaria para tus integraciones.
🔑 ¿Qué requisitos necesitas para evitar estos errores?
Para que tu integración funcione siempre correctamente, asegúrate de cumplir con estos puntos básicos:
-
Credenciales vigentes: verifica que tu correo y tu token estén bien configurados en la herramienta que estés conectando. 🔍 ¿Cómo conectar tu cuenta de Alegra con otras aplicaciones usando la API?
-
Plan activo: asegúrate de tener una suscripción de Alegra al día para evitar bloqueos por falta de pago.
-
Límites de la API: recuerda que existe un límite de solicitudes por minuto para garantizar la estabilidad del sistema.
⁉️ ¿Qué preguntas frecuentes debes conocer al usar la API?
🧾 ¿Necesito tener creados los productos y clientes para poder facturar?
Sí. Debes 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?
Puedes usar la numeración principal enviando stamp > generateStamp: true o una específica con numberTemplate > id.
🔔 ¿Cómo configuro los webhooks?
Necesitas una URL que reciba solicitudes POST (HTTPS) y responda con código 2XX en menos de 5 segundos para mantener activa la suscripción.
¿Aún no tienes cuenta en Alegra?
