Soporte

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

La API pública de Factuarea está en beta privada, y los participantes de la beta reciben soporte prioritario durante este periodo. Esta página es la única fuente de verdad sobre cómo contactarnos y qué enviar.

Contacto

info@factuarea.com

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

Escribe desde el email asociado a tu empresa en Factuarea. Para las solicitudes de acceso beta en concreto, sigue el checklist de Solicitar acceso beta (razón social, NIF, caso de uso, volumen estimado) — respondemos en ≤ 5 días hábiles.

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

Estado de la beta

Durante la beta privada:

Solo las empresas en la lista de acceso pueden generar keys con scope de desarrollador.
Los participantes de la beta reciben soporte prioritario y aviso anticipado de los cambios.
El programa se cierra cuando alcancemos cobertura completa de los endpoints públicos y un SLO de uptime estable (≥ 99,9%), momento en el que la API pasa a GA y la activación se vuelve self-service. Consulta Solicitar acceso beta.

Página de estado

Una página de estado pública (uptime e historial de incidencias) vivirá en status.factuarea.com cuando la API alcance GA. Hasta entonces, avisamos a los participantes de la beta 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.