Al conectar sus aplicaciones con Alegra, 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
❓ ¿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. Además, le invitamos a explorar el portal de Alegra API para obtener toda la información necesaria para sus integraciones.
🔑 ¿Qué requisitos necesita para evitar estos errores?
Para que su integración funcione siempre correctamente, asegúrase de cumplir con estos puntos básicos:
-
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?
-
Plan activo: asegúrase de tener una suscripción de Alegra al día para evitar bloqueos por falta de pago.
-
Límites de la API: recuerde que existe un límite de solicitudes por minuto para garantizar la estabilidad del sistema.
⁉️ ¿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.
¿Aún no tiene cuenta en Alegra?
