Suport

Com contactar amb l'equip de l'API de Factuarea, què incloure en reportar un problema, com funciona l'accés a l'API, la pàgina d'estat i el changelog.

Aquesta pàgina és l'única font de veritat sobre com contactar amb l'equip de l'API de Factuarea i què enviar perquè puguem ajudar-te ràpid.

Contacte

info@factuarea.com

El canal per a tot el que estigui relacionat amb l'API: dubtes d'integració, reports de bugs i incidències.

Escriu des de l'email associat a la teva empresa a Factuarea.

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.

No comparteixis mai el secret d'una API key en un email de suport. Envia el request_id — podem trobar la key i la petició només amb això. Si un secret ha quedat exposat, rota o revoca la key des del dashboard primer.

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

422 on POST /v1/invoices — request_id req_01JBVH7K9Y4N3CDQ2EHJB1AGSV

Accés a l'API

L'API pública i el servidor MCP estan inclosos en tots els plans de Factuarea — no hi ha programa beta ni add-on a banda. Crea les teves keys des de Dashboard → Developers → API Keys; el teu tier de rate limit es deriva del teu pla (consulta Límits de peticions). Si les teves crides retornen 403 addon_not_active, la teva empresa no té un pla actiu que inclogui accés a l'API — contracta o renova un pla des del dashboard.

Pàgina d'estat

Una pàgina d'estat pública (uptime i historial d'incidències) viurà a status.factuarea.com. Fins llavors, avisem les empreses afectades 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.