Integración con Shopify

La app de Shopify autoriza el acceso a una tienda; la tienda en Factuarea controla la facturación. El repositorio oficial de la app contiene las instrucciones de instalación. Que exista una app pública implementada no acredita su publicación en Shopify App Store; utiliza el canal de instalación facilitado para tu despliegue.

Autoriza y configura

Completa la autorización de Shopify y elige la empresa de Factuarea. Conserva el dominio permanente *.myshopify.com asociado a la credencial del proveedor. La API de tiendas recibe el integration_id existente; no acepta un token de acceso de Shopify ni realiza OAuth por ti. Revisa la configuración de la tienda y después habilita el entorno y el comportamiento de facturación deseados.

Los datos de pedidos y compradores dependen de los permisos concedidos y del acceso a datos protegidos de clientes. Una instalación correcta no garantiza que se puedan leer todos los campos del comprador. La disponibilidad del NIF afecta a la facturación según la política configurada. Para procesar una devolución se necesita la factura original y una devolución liquidada y admitida; los cambios pendientes o no admitidos siguen visibles en la bandeja.

Conexión y versión de 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"

Esta operación requiere shopify_store:write. El HTTP 200 contiene el resultado del diagnóstico: consulta reachable, credential_accepted, failure_code, api_version y supported_until. store_version es el nombre del plan de la tienda cuando se informa. Factuarea selecciona la versión de API y normalmente la conserva incluso cuando fallan las credenciales o el transporte.

Vuelve a autorizar la app ante shopify_credentials_rejected; comprueba la disponibilidad ante shopify_store_unreachable. shopify_api_version_expired requiere actualizar la versión de API fijada por el conector, no rotar repetidamente el token del comerciante. store_url_not_allowed requiere corregir la política de destinos. La bandeja de integraciones explica los fallos de cada pedido una vez recuperada la conectividad.

Pantallas de instalación y desconexión

Shopify solicita primero read_orders y read_customers. Tras autorizar, vincula tu cuenta de Factuarea en una página independiente fuera del marco de Shopify. Completa el vínculo y vuelve a abrir la app: su pantalla distingue una tienda autorizada sin cuenta, un vínculo pendiente de confirmación y una cuenta confirmada. La empresa conectada sigue necesitando un plan con integraciones. La configuración de facturación está en Factuarea. Desinstalar la app de Shopify elimina su sesión; desconecta por separado la conexión del proveedor en Factuarea y conserva las facturas ya emitidas.