Integració amb Shopify

L’app de Shopify autoritza l’accés a una botiga; la botiga a Factuarea controla la facturació. El repositori oficial de l’app conté les instruccions d’instal·lació. Que existeixi una app pública implementada no acredita la publicació a Shopify App Store; fes servir el canal d’instal·lació facilitat per al teu desplegament.

Autoritza i configura

Completa l’autorització de Shopify i tria l’empresa de Factuarea. Conserva el domini permanent *.myshopify.com associat a la credencial del proveïdor. L’API de botigues rep l’integration_id existent; no accepta cap token d’accés de Shopify ni fa OAuth per tu. Revisa la configuració de la botiga i després habilita l’entorn i el comportament de facturació desitjats.

Les dades de comandes i compradors depenen dels permisos concedits i de l’accés a dades protegides de clients. Una instal·lació correcta no garanteix que es puguin llegir tots els camps del comprador. La disponibilitat del NIF afecta la facturació segons la política configurada. Per processar una devolució cal la factura original i una devolució liquidada i admesa; els canvis pendents o no admesos continuen visibles a la safata.

Connexió i versió d’API

curl -X POST "https://api.factuarea.com/v1/shopify/stores/$STORE_ID/connection-test" \
  -H "Authorization: Bearer $FACTUAREA_API_KEY" \
  -H "Idempotency-Key: shopify-check-2026-09-08"

Aquesta operació requereix shopify_store:write. L’HTTP 200 conté el resultat del diagnòstic: consulta reachable, credential_accepted, failure_code, api_version i supported_until. store_version és el nom del pla de la botiga quan s’informa. Factuarea selecciona la versió d’API i normalment la conserva fins i tot quan fallen les credencials o el transport.

Torna a autoritzar l’app davant de shopify_credentials_rejected; comprova la disponibilitat davant de shopify_store_unreachable. shopify_api_version_expired requereix actualitzar la versió d’API fixada pel connector, no rotar repetidament el token del comerciant. store_url_not_allowed requereix corregir la política de destinacions. La safata d’integracions explica els errors de cada comanda un cop recuperada la connectivitat.

Pantalles d’instal·lació i desconnexió

Shopify sol·licita primer read_orders i read_customers. Després d’autoritzar, vincula el compte de Factuarea en una pàgina independent fora del marc de Shopify. Completa el vincle i torna a obrir l’app: la pantalla distingeix una botiga autoritzada sense compte, un vincle pendent de confirmació i un compte confirmat. L’empresa connectada continua necessitant un pla amb integracions. La configuració de facturació és a Factuarea. Desinstal·lar l’app de Shopify elimina la sessió; desconnecta per separat la connexió del proveïdor a Factuarea i conserva les factures ja emeses.