Il existe deux façons d'envoyer des commandes à Fabrixa : connecter la boutique que vous gérez déjà (Shopify ou WooCommerce) sans avoir à écrire de code, ou développer directement sur l'API d'intégration. Ce guide couvre les deux méthodes : connectez un canal de vente en quelques minutes, ou passez de l'authentification au fulfilment en quinze minutes.
La plupart des boutiques ne touchent jamais à l'API. Ajoutez Fabrixa comme canal de vente et les commandes passées sur votre boutique sont directement transmises à la production : synchronisation des produits, mise à jour des statuts, sans avoir à écrire ni à maintenir de code. La méthode API présentée plus loin est destinée aux vitrines personnalisées et aux plateformes POD.
Dans votre tableau de bord, ouvrez Create channel et choisissez votre type d'intégration. Chaque canal conserve ses propres produits, commandes importées et règles d'importation : connectez-en autant que vous en utilisez.
Aucune clé à copier. Autorisez Fabrixa depuis votre interface d'administration Shopify et la connexion est établie.
Create channel, sélectionnez Shopify.Une boutique WordPress se connecte à l'aide d'une paire de clés REST en lecture/écriture — générée dans WooCommerce, puis collée une seule fois dans Fabrixa.
Settings → Advanced → REST API → Add key avec Lecture/Écriture autorisations.ck_ et le secret cs_ et le domaine de votre boutique dans Fabrixa.Vous vendez des produits personnalisés ? Fabrixa Studio — l'éditeur de design white-label — est également disponible sur les boutiques Shopify et WooCommerce, ce qui permet à vos clients de personnaliser les produits sous votre marque. Voir Fabrixa Studio →
Les boutiques connectées apparaissent à côté de vos canaux API et partenaires dans la vue « Canaux » : produits synchronisés, commandes reçues, dernière référence importée et chiffre d'affaires par canal. Passez un canal du statut « Brouillon » au statut « Actif » lorsque vous êtes prêt ; cela n'entraîne aucun changement en aval.
Vous préférez créer une boutique en ligne personnalisée ou votre propre plateforme POD ? La suite de ce guide présente la méthode API : de l'authentification au fulfilment en quatre étapes.
Trois éléments vous permettent de passer de zéro à une commande réelle. Ils sont tous délivrés depuis votre tableau de bord Fabrixa ou par votre Solutions Engineer.
Un Application Access Token et une Application Key. Ces deux éléments sont obligatoires pour chaque requête : le jeton doit figurer dans l'en-tête « Authorization », et la clé dans l'en-tête « X-Application-Key ». Créez un canal de vente dans votre tableau de bord pour les générer instantanément — aucune demande d'accès nécessaire.
Un endpoint HTTPS accessible au public qui accepte les requêtes POST au format JSON. « Localhost » fonctionne en mode développement via un tunnel. Vous vérifiez la signature HMAC-SHA256 de chaque payload avant de le traiter.
Votre fichier d'impression — au format PDF, TIFF, JPG ou PNG — accessible via HTTPS sans authentification. Couleurs RGB, jusqu’à 50 Mo et 15 000 px par côté. Les PDF de plusieurs pages doivent comporter une page par calque. Nous récupérons le fichier et générons les fichiers d'impression adaptés lors du rendu du travail.
Chaque requête est envoyée à l'URL de base https://api.fabrixa.com/v2/integration les deux en-têtes étant définis. GET /ping vérifie que le jeton et la clé sont valides avant toute autre opération.
A 401 signifie qu'un en-tête manque ou que le jeton a été révoqué. A 403 signifie que les identifiants sont valides mais qu'ils ne disposent pas des autorisations nécessaires pour accéder à la ressource.
# Verify auth before anything else curl https://api.fabrixa.com/v2/integration/ping \ -H "Accept: application/json" \ -H "Authorization: Bearer APPLICATION_ACCESS_TOKEN" \ -H "X-Application-Key: APPLICATION_KEY" # 200 OK → credentials valid # 401 → missing header or revoked token # 403 → valid, but no access to the resource
Le catalogue affiche les variantes de produit avec leurs codes SKU et variant_id. Chaque réponse de la liste est encadrée par la balise standard links / meta / data enveloppe, donc numérotez les pages avec le next_page lien. Mise en cache locale — le catalogue n'est pas généré à chaque requête.
Le détail complet des champs figure dans la Référence Swagger.
GET /v2/integration/products?page=1
{
"links": {
"self": ".../products?page=1",
"next_page": ".../products?page=2",
"prev_page": null
},
"meta": { "total": 248, "current_page": 1, "per_page": 10 },
"data": [
{ "id": 1306, "name": "Unisex AOP T-shirt", "SKU": "COF099191" }
]
}
Envoyer rows (SKU + quantité + un fichier PDF source), customer et shipping_address. Définissez votre propre number en tant que référence — si vous ne l'indiquez pas, nous en générerons un. Enregistrez l'identifiant de commande Fabrixa renvoyé en association avec votre commande.
Les commandes Studio remplacent sources par un cart_item_key — tout le reste est identique.
POST /v2/integration/orders
{
"number": "ORD-2026-0142",
"purchased_at": "2026-05-28 14:22:01",
"rows": [
{
"sku": "COF099191",
"quantity": 1,
"sources": [
{ "type": "file", "url": "https://cdn.you.com/art/9812.pdf" }
]
}
],
"customer": {
"first_name": "Maria", "last_name": "Silva",
"email": "maria@example.com", "phone": "+351912345678"
},
"shipping_address": {
"address": "Rua do Carmo 42", "city": "Lisboa",
"postal_code": "1200-094",
"country_code": "PT", "country": "Portugal"
}
}
Configurez l'URL de votre webhook dans le tableau de bord. Nous y envoyons order.created et order.updated en POST avec le corps complet de la commande, un en-tête x-webhook-signature (HMAC-SHA256) et un en-tête x-webhook-topic et vérifiez la signature, renvoyez rapidement un 200 puis traitez de manière asynchrone.
Tous les événements et les extraits de code de vérification se trouvent dans la référence des webhooks.
# Request headers content-type: application/json x-webhook-topic: order.updated x-webhook-signature: YmEwNjBhMGMy...AxMw== # Body (truncated) { "id": 23069, "number": "1250211835", "status": "imported", "fulfillment_status": "unfulfilled", "updated_at": "2026-05-28T07:43:52Z" }
Les erreurs sont renvoyées au format JSON, jamais au format HTML. Le errors.messages array indique ce qui a échoué ; en cas d'erreur 400, il répertorie les champs qui n'ont pas été validés.
Erreur de validation, identifiants manquants ou révoqués, autorisations insuffisantes ou ressource inconnue.
30 requêtes par application et par minute. X-RateLimit-Limit et X-RateLimit-Remaining figurent dans chaque réponse.
Côté serveur. Réessayez avec back-off ; si le problème persiste, envoyez l'identifiant de la requête à votre Solutions Engineer.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Pour toute assistance en matière d'intégration, de problèmes liés aux identifiants ou aux canaux de vente, d'exigences spécifiques ou de planification des capacités, veuillez vous adresser au canal technique des Solutions Engineers (SE), et non au service commercial. Réponse sous un jour ouvré.
