Soporte

Cómo contactar con el equipo de la API de Factuarea, qué incluir al reportar un problema, cómo funciona el acceso a la API, la página de estado y el changelog.

Esta página es la única fuente de verdad sobre cómo contactar con el equipo de la API de Factuarea y qué enviar para que podamos ayudarte rápido.

Contacto

info@factuarea.com

El canal para todo lo relacionado con la API: dudas de integración, reportes de bugs e incidencias.

Escribe desde el email asociado a tu empresa en Factuarea.

Qué incluir al reportar un problema

Cada respuesta de la API lleva un request_id único (en el envoltorio de error bajo error.request_id, y en la cabecera de respuesta X-Request-Id). Es lo más útil que puedes enviarnos — nos permite correlacionar logs, métricas y trazas para investigar rápidamente.

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid",
    "message": "El campo client_id es obligatorio.",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

Un buen reporte incluye:

request_id de la llamada que falla (o varios, si es intermitente).
HTTP status y el type / code del envoltorio de error.
Endpoint y método — p. ej. POST /v1/invoices.
Entorno — live o test (el prefijo de la key que usaste, fact_live_ o fact_test_). Nunca pegues el secreto de la key.
Qué esperabas vs. qué ocurrió, y la marca de tiempo aproximada.

Nunca compartas el secreto de una API key en un email de soporte. Envía el request_id — podemos encontrar la key y la petición solo con eso. Si un secreto ha quedado expuesto, rota o revoca la key desde el dashboard primero.

Un asunto que ya lleve lo esencial nos ayuda a triar:

422 on POST /v1/invoices — request_id req_01JBVH7K9Y4N3CDQ2EHJB1AGSV

Acceso a la API

La API pública y el servidor MCP están incluidos en todos los planes de Factuarea — no hay programa beta ni add-on aparte. Crea tus keys desde Dashboard → Developers → API Keys; tu tier de rate limit se deriva de tu plan (consulta Límites de peticiones). Si tus llamadas devuelven 403 addon_not_active, tu empresa no tiene un plan activo que incluya acceso a la API — contrata o renueva un plan desde el dashboard.

Página de estado

Una página de estado pública (uptime e historial de incidencias) vivirá en status.factuarea.com. Hasta entonces, avisamos a las empresas afectadas de las incidencias y del mantenimiento planificado directamente por email a los contactos registrados de las keys.

Changelog

Cada cambio en /v1 — campos nuevos, endpoints nuevos, eventos nuevos, correcciones de validación y deprecaciones — se publica en el Changelog. Los breaking changes nunca llegan a /v1; solo aparecen en una futura /v2. Consulta Versionado para conocer el compromiso de estabilidad.

Self-service primero

Antes de abrir un ticket, esto suele responder la pregunta más rápido:

FAQ — las preguntas de integración más habituales.
Errores — busca tu code para ver la causa y la solución.
Autenticación — keys, scopes, rotación.
Límites de peticiones — cuotas y back-off.