Suport

L'API pública de Factuarea està en beta privada, i els participants de la beta reben suport prioritari durant aquest període. Aquesta pàgina és l'única font de veritat sobre com contactar-nos i què enviar.

Contacte

Escriu des de l'email associat a la teva empresa a Factuarea. Per a les sol·licituds d'accés beta en concret, segueix el checklist de Sol·licitar accés beta (raó social, NIF, cas d'ús, volum estimat) — responem en ≤ 5 dies hàbils.

Què incloure en reportar un problema

Cada resposta de l'API porta un request_id únic (a l'embolcall d'error sota error.request_id, i a la capçalera de resposta X-Request-Id). És el més útil que ens pots enviar — ens permet correlacionar logs, mètriques i traces per investigar ràpidament.

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

Un bon report inclou:

• request_id de la crida que falla (o diversos, si és intermitent).
• HTTP status i el type / code de l'embolcall d'error.
• Endpoint i mètode — p. ex. POST /v1/invoices.
• Entorn — live o test (el prefix de la key que vas fer servir, fact_live_ o fact_test_). No enganxis mai el secret de la key.
• Què esperaves vs. què va passar, i la marca de temps aproximada.

Un assumpte que ja porti l'essencial ens ajuda a triar:

422 on POST /v1/invoices — request_id req_01JBVH7K9Y4N3CDQ2EHJB1AGSV

Estat de la beta

Durant la beta privada:

• Només les empreses a la llista d'accés poden generar keys amb scope de desenvolupador.
• Els participants de la beta reben suport prioritari i avís anticipat dels canvis.
• El programa es tanca quan assolim cobertura completa dels endpoints públics i un SLO d'uptime estable (≥ 99,9%), moment en què l'API passa a GA i l'activació esdevé self-service. Consulta Sol·licitar accés beta.

Pàgina d'estat

Una pàgina d'estat pública (uptime i historial d'incidències) viurà a status.factuarea.com quan l'API assoleixi GA. Fins llavors, avisem els participants de la beta de les incidències i del manteniment planificat directament per email als contactes registrats de les keys.

Changelog

Cada canvi a /v1 — camps nous, endpoints nous, esdeveniments nous, correccions de validació i deprecacions — es publica al Changelog. Els breaking changes mai no arriben a /v1; només apareixen en una futura /v2. Consulta Versionat per conèixer el compromís d'estabilitat.

Self-service primer

Abans d'obrir un tiquet, això sol respondre la pregunta més de pressa:

• FAQ — les preguntes d'integració més habituals.
• Errors — busca el teu code per veure la causa i la solució.
• Autenticació — keys, scopes, rotació.
• Límits de peticions — quotes i back-off.