Factuarea APIDevelopers
Suport
Ves a l'app

Obtenir una botiga connectada

Obtén una botiga connectada pel seu id (UUID v7).

  • Retorna la connexió amb el proveïdor de què depèn, l'identificador que el proveïdor va assignar a la botiga i la seva configuració completa de facturació.
  • Retorna 404 si no existeix o pertany a una altra empresa.
  • Totes dues respostes són idèntiques deliberadament per no revelar si existeix una botiga d'una altra empresa.
GET
/stores/{store}

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de ruta

store*string

Headers

Factuarea-Version?string

Fixa la versió de l'API (YYYY-MM-DD, versionat per data estil Stripe) per a aquesta petició; omet-lo per usar la versió fixada de la clau, o l'última si no n'hi ha cap. Versió no suportada → 400 unsupported_api_version; mal formada → 400 parameter_invalid_format. La versió efectiva es reflecteix a la capçalera de resposta Factuarea-Version. Consulta la guia de Versioning.

Formatdate
X-Active-Profile?string

Opera en nom d'una empresa filla (API key mestra de gestoria): passa el seu id públic (UUID v7) i la petició s'executa contra les dades d'aquella filla sense canviar l'scope, el tier ni l'environment de la clau (omet-lo per usar la pròpia empresa de la clau). UUID no vàlid → 400 parameter_invalid_uuid; id desconegut o no propi → 404 profile_not_found. Consulta la guia d'Acting on behalf.

Formatuuid

Cos de la resposta

application/json

application/json

application/json

application/json

application/json

application/json

Anterior/v1/stores
POST

Connectar una botiga

Connecta una botiga de comerç electrònic a la teva empresa. integration_id identifica la connexió amb el proveïdor de què depèn la botiga, i external_store_id és l'identificador que el proveïdor assigna a la botiga. És únic per proveïdor dins de la teva empresa: una segona botiga amb el mateix proveïdor i identificador es rebutja amb store_already_connected. La facturació automàtica està desactivada fins que l'activis; connectar una botiga no comença a emetre factures. Si envies remote_base_url, es comprova amb la política de destinacions de sortida de la teva empresa i es rebutja amb…

Següent/v1/stores/{store}
PUT

Actualitzar la configuració de la botiga

Actualitza la configuració d'una botiga connectada: name, la sèrie de numeració (series_id; null recupera la sèrie predeterminada de la teva empresa), el llindar de factura simplificada, si s'exigeix NIF del comprador, si els preus inclouen impostos, si es facturen i s'envien per email les comandes pagades automàticament, remote_base_url i environment. Tots els camps són opcionals; els omesos conserven el seu valor. El proveïdor i external_store_id no es poden modificar perquè formen la identitat de la botiga.