Order Invoicer

Installer Sylius

Configurez Sylius pour l'intégration avec Order Invoicer

Order Invoicer se connecte à votre boutique Sylius via son API Admin (API Platform v2). La connexion se fait avec les identifiants d'un administrateur disposant de l'accès API : Order Invoicer les échange contre un jeton temporaire à chaque synchronisation. Aucune clé API permanente n'est nécessaire.

Prérequis

  • Sylius 2.x avec l'API activée (activée par défaut)
  • Votre boutique est accessible via HTTPS
  • Un compte administrateur disposant de l'accès API (ROLE_API_ACCESS)

1. Activer l'accès API pour un administrateur

L'API Admin de Sylius n'est accessible qu'aux administrateurs possédant le rôle ROLE_API_ACCESS. Un administrateur classique peut s'authentifier mais se verra refuser l'accès à l'API (erreur 403).

Nous recommandons de créer un administrateur dédié à l'intégration :

  1. Connectez-vous à l'administration Sylius.
  2. Ouvrez Configuration → Administrateurs.
  3. Créez un nouvel administrateur (ou modifiez-en un existant) et activez l'option Accès API (API access / ROLE_API_ACCESS).
  4. Enregistrez, puis notez son e-mail et son mot de passe.

Un administrateur dédié facilite la révocation de l'accès et évite d'exposer le compte principal. Order Invoicer n'a besoin que d'un accès en lecture aux commandes.

2. Récupérer vos informations de connexion

Vous aurez besoin de trois informations :

  • URL de la boutique : l'adresse racine de votre boutique, par exemple https://boutique.exemple.com (sans /admin ni chemin — Order Invoicer ajoute automatiquement /api/v2/admin).
  • E-mail administrateur : l'e-mail de l'administrateur disposant de l'accès API.
  • Mot de passe administrateur : le mot de passe de ce compte.

3. Connecter la boutique dans Order Invoicer

  1. Dans Order Invoicer, ajoutez un connecteur et sélectionnez Sylius.
  2. Renseignez l'URL de la boutique, l'e-mail et le mot de passe administrateur.
  3. Cliquez sur Tester la connexion pour vérifier vos identifiants.
  4. Enregistrez : Order Invoicer commencera à synchroniser les commandes finalisées.

4. Vérifier la configuration

Vous pouvez tester l'authentification à l'API avec cURL :

curl -X POST "https://boutique.exemple.com/api/v2/admin/administrators/token" \
  -H "Content-Type: application/ld+json" \
  -d '{"email":"admin@exemple.com","password":"votre-mot-de-passe"}'

Une réponse contenant un champ token confirme que les identifiants sont valides et que l'administrateur a bien l'accès API.

Dépannage courant

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

  • L'administrateur s'est authentifié mais n'a pas l'accès API. Activez l'option Accès API sur ce compte (voir l'étape 1), ou utilisez un administrateur dédié.

Erreur « identifiants invalides » (401)

  • Vérifiez l'e-mail et le mot de passe de l'administrateur.
  • Assurez-vous que le compte est actif.

Erreur de connexion ou 404

  • Vérifiez que l'URL est bien la racine de la boutique (https://boutique.exemple.com) et non l'URL de l'administration (.../admin/...).
  • Assurez-vous que la boutique est accessible en HTTPS et que l'API est activée.

Support

Si vous rencontrez des difficultés, écrivez-nous à contact@orderinvoicer.com.

Note : une fois cette configuration terminée, vous pourrez lier votre outil de facturation dans Order Invoicer.

Sur cette page

Prérequis1. Activer l'accès API pour un administrateur2. Récupérer vos informations de connexion3. Connecter la boutique dans Order Invoicer4. Vérifier la configurationDépannage courantSupport