Instalar Sylius

Order Invoicer se conecta a su tienda Sylius a través de su API de administración (API Platform v2). Se autentica con las credenciales de un administrador que tenga acceso a la API: Order Invoicer las intercambia por un token de corta duración en cada sincronización. No se requiere ninguna clave de API permanente.

Requisitos previos

Sylius 2.x con la API habilitada (habilitada de forma predeterminada)
Su tienda es accesible a través de HTTPS
Una cuenta de administrador con acceso a la API (ROLE_API_ACCESS)

1. Habilitar el acceso a la API para un administrador

La API de administración de Sylius solo es accesible para los administradores que tienen el rol ROLE_API_ACCESS. Un administrador normal puede autenticarse, pero se le denegará el acceso a la API (error 403).

Le recomendamos crear un administrador dedicado para la integración:

Inicie sesión en el panel de administración de Sylius.
Abra Configuration → Administrators.
Cree un nuevo administrador (o edite uno existente) y active la opción API access (ROLE_API_ACCESS).
Guarde y, a continuación, anote su correo electrónico y su contraseña.

Un administrador dedicado facilita la revocación del acceso y evita exponer su cuenta principal. Order Invoicer solo necesita acceso de lectura a los pedidos.

2. Reunir sus datos de conexión

Necesitará tres datos:

URL de la tienda: la dirección raíz de su tienda, p. ej. https://store.example.com (sin /admin ni ruta: Order Invoicer añade /api/v2/admin automáticamente).
Correo electrónico del administrador: el correo electrónico del administrador con acceso a la API.
Contraseña del administrador: la contraseña de esa cuenta.

3. Conectar la tienda en Order Invoicer

En Order Invoicer, añada un conector y seleccione Sylius.
Introduzca la URL de la tienda, el correo electrónico y la contraseña del administrador.
Haga clic en Probar conexión para verificar sus credenciales.
Guarde: Order Invoicer comenzará a sincronizar los pedidos completados.

4. Verificar la configuración

Puede probar la autenticación de la API con cURL:

curl -X POST "https://store.example.com/api/v2/admin/administrators/token" \
  -H "Content-Type: application/ld+json" \
  -d '{"email":"admin@example.com","password":"your-password"}'

Una respuesta que contenga un campo token confirma que las credenciales son válidas y que el administrador tiene acceso a la API.

Resolución de problemas habituales

Error «The user doesn't have ROLE_API_ACCESS» (403)

El administrador se autenticó pero carece de acceso a la API. Active la opción API access en esa cuenta (véase el paso 1) o utilice un administrador dedicado.

Error «Invalid credentials» (401)

Compruebe el correo electrónico y la contraseña del administrador.
Asegúrese de que la cuenta esté activa.

Error de conexión o 404

Compruebe que la URL sea la raíz de la tienda (https://store.example.com), no la URL de administración (.../admin/...).
Asegúrese de que la tienda sea accesible a través de HTTPS y de que la API esté habilitada.

Soporte

Si tiene dificultades, póngase en contacto con nosotros en contact@orderinvoicer.com.

Nota: una vez completada esta configuración, puede vincular su herramienta de facturación en Order Invoicer.