Documentation fournisseur

Alimentez votre app et récupérez vos commandes par API.

Connectez votre ERP, site e-commerce, caisse ou logiciel métier à SellViaApp. Envoyez catégories, produits et tarifs, puis récupérez les commandes confirmées de votre boutique au format JSON.

URL de basehttps://api.sellviaapp.com/

En-têtes requisX-API-Key + Bearer

Support développeursapi@sellviaapp.com

Démarrage rapide

Authentifiez, choisissez une route, testez.

Récupérez la X-API-Key et générez le Bearer dans Dashboard → API. Entrez-les ci-dessous, puis utilisez « Tester · Générer » sur un endpoint pour obtenir la réponse et le code cURL, PHP 8 ou JavaScript.

X-API-Key

Bearer token

Accès incompletsRenseignez la X-API-Key et le Bearer token pour préparer un test.

Accès conservés uniquement en mémoire pendant cette page. Pour une opération liée à un client, ajoutez customer_id.

À retenirHTTPS + JSON · gardez les deux accès côté serveur · ne transmettez jamais les jetons au support.

Temps réel

Connectez SellViaApp à tout système compatible HTTPS.

Un webhook avertit votre ERP, CRM, automatisation ou logiciel dès qu’un produit, un client, un panier, une commande, un document ou un réglage important change. Utilisez ensuite l’API pour relire l’objet complet lorsque nécessaire.

Créer la destination

Dans Dashboard → Webhooks, indiquez une URL HTTPS et choisissez les événements. Le secret n’est montré qu’une fois.

Vérifier la signature

Calculez HMAC-SHA256 sur timestamp.delivery_id.corps_brut et comparez le résultat à X-SellViaApp-Signature.

Accuser rapidement réception

Répondez en HTTP 2xx, dédupliquez avec X-SellViaApp-Event-Id puis traitez en arrière-plan.

Livraison fiableJusqu’à huit tentatives avec délais progressifs. Une destination en échec répété est automatiquement suspendue et chaque livraison reste visible et relançable dans la Dashboard.

payload = timestamp + "." + delivery_id + "." + raw_body
expected = "v1=" + HMAC_SHA256(payload, signing_secret)

Endpoints

Clients

Créer et gérer les comptes clients de chaque boutique.

5 routes

POST /customer/add Clé API

Créer un client et générer son login fournisseur.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

nom string Obligatoire

Nom du client.

prenom string Obligatoire

Prénom du client.

email email Obligatoire

Adresse e-mail unique chez le fournisseur.

denomination string Facultatif

Société, facultative.

password string Obligatoire

Au moins huit caractères.

address string Facultatif

Adresse postale.

zipcode string Facultatif

Code postal.

city string Facultatif

Ville.

country string Facultatif

Pays.

phone string Facultatif

Téléphone.

cellphone string Facultatif

Téléphone mobile.

vat_number string Facultatif

Numéro de TVA.

language string Facultatif

Code ISO de langue sur deux caractères.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /customer/list Clé + Bearer

Lister ou filtrer les informations client autorisées.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

page integer Facultatif

Numéro de page, à partir de 1.

per_page integer Facultatif

Nombre de résultats par page.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /customer/me Clé + Bearer

Récupérer le profil du client connecté.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /customer/update Clé + Bearer

Mettre à jour profil, langue, type, e-mail ou mot de passe.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

first_name string Facultatif

Prénom.

last_name string Facultatif

Nom.

company string Facultatif

Société.

email email Facultatif

Nouvelle adresse e-mail, unique dans la boutique.

address string Facultatif

Adresse postale.

zipcode string Facultatif

Code postal.

city string Facultatif

Ville.

country string Facultatif

Pays.

phone string Facultatif

Téléphone.

cellphone string Facultatif

Téléphone mobile.

vat_number string Facultatif

Numéro de TVA.

language string Facultatif

Code ISO de langue sur deux caractères.

account_type enum Facultatif

company | individual

notifications_enabled boolean Facultatif

Autoriser les notifications mobiles.

password string Facultatif

Nouveau mot de passe, au moins huit caractères.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /customer/deleteaccount Clé + Bearer

Désactiver le compte client dans la boutique active.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Endpoints

Catalogue

Familles, produits, photos, tarifs, stocks, promotions et favoris.

18 routes

GET /fam1/list Clé + Bearer

Lister les catégories principales.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /fam1/add Clé + Bearer

Créer une catégorie principale.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

name string Obligatoire

Nom visible de la catégorie.

external_key string Facultatif

Identifiant stable provenant de votre logiciel.

sort_order integer Facultatif

Ordre d’affichage, à partir de 1.

image_url url Facultatif

Adresse HTTPS de l’image.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /fam1/update Clé + Bearer

Modifier une catégorie principale.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la catégorie à modifier.

name string Obligatoire

Nom visible de la catégorie.

external_key string Facultatif

Identifiant stable provenant de votre logiciel.

sort_order integer Facultatif

Ordre d’affichage, à partir de 1.

image_url url Facultatif

Adresse HTTPS de l’image.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /fam1/delete Clé + Bearer

Masquer une catégorie principale.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la catégorie à masquer.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /fam2/list Clé + Bearer

Lister les sous-catégories.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

category_id integer Facultatif

Limiter les résultats à une catégorie principale.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /fam2/add Clé + Bearer

Créer une sous-catégorie.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

category_id integer Obligatoire

Identifiant de la catégorie principale parente.

name string Obligatoire

Nom visible de la catégorie.

external_key string Facultatif

Identifiant stable provenant de votre logiciel.

sort_order integer Facultatif

Ordre d’affichage, à partir de 1.

image_url url Facultatif

Adresse HTTPS de l’image.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /fam2/update Clé + Bearer

Modifier une sous-catégorie.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la sous-catégorie à modifier.

name string Obligatoire

Nom visible de la catégorie.

external_key string Facultatif

Identifiant stable provenant de votre logiciel.

sort_order integer Facultatif

Ordre d’affichage, à partir de 1.

image_url url Facultatif

Adresse HTTPS de l’image.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /fam2/delete Clé + Bearer

Masquer une sous-catégorie.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la sous-catégorie à masquer.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /product/list Clé + Bearer

Lister et rechercher les produits avec pagination.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

page integer Facultatif

Numéro de page, à partir de 1.

per_page integer Facultatif

Nombre de résultats par page.

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

search string Facultatif

Recherche par code, nom ou description.

category_id integer Facultatif

Filtre de catégorie principale.

subcategory_id integer Facultatif

Filtre de sous-catégorie.

price_group string Facultatif

Groupe tarifaire du client.

favorites boolean Facultatif

Afficher uniquement les favoris.

promotions boolean Facultatif

Afficher uniquement les promotions actives.

new boolean Facultatif

Afficher uniquement les nouveautés.

progressive boolean Facultatif

Pagination rapide sans calculer le nombre total.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /product/image URL signée

Servir une photo produit signée, compressible et mise en cache.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

supplier string Obligatoire

Suffixe public de la boutique.

id integer Obligatoire

Identifiant du produit.

slot integer Facultatif

Numéro de photo de 1 à 5.

signature string Obligatoire

Signature du lien fournie par product/list.

variant enum Facultatif

small | thumb | large

Sortie

Résultats possibles

200Image binaire avec son type MIME

400Requête ou JSON invalide

401Authentification absente ou invalide

403Signature du lien invalide

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

200 Le corps contient directement l’image binaire et l’en-tête Content-Type indique son format.

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /product/add Clé + Bearer

Créer un produit.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

code string Obligatoire

Code article unique dans la boutique.

name string Obligatoire

Nom visible dans l’application.

description string Facultatif

Description détaillée du produit.

base_price decimal Facultatif

Prix de vente hors taxes selon votre configuration.

vat_rate decimal Facultatif

Taux de TVA, par exemple 21.

category_id integer Facultatif

Identifiant de la catégorie principale.

subcategory_id integer Facultatif

Identifiant de la sous-catégorie.

external_key string Facultatif

Identifiant stable provenant de votre ERP.

unit string Facultatif

Code de l’unité, par exemple pc.

unit_name string Facultatif

Nom lisible de l’unité.

image_url url Facultatif

Adresse HTTPS de la photo principale.

is_new boolean Facultatif

Mettre le produit en avant comme nouveauté.

active boolean Facultatif

Détermine la visibilité du produit.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /product/update Clé + Bearer

Modifier un produit.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant du produit à modifier.

code string Obligatoire

Code article unique dans la boutique.

name string Obligatoire

Nom visible dans l’application.

description string Facultatif

Description détaillée du produit.

base_price decimal Facultatif

Prix de vente hors taxes selon votre configuration.

vat_rate decimal Facultatif

Taux de TVA, par exemple 21.

category_id integer Facultatif

Identifiant de la catégorie principale.

subcategory_id integer Facultatif

Identifiant de la sous-catégorie.

external_key string Facultatif

Identifiant stable provenant de votre ERP.

unit string Facultatif

Code de l’unité, par exemple pc.

unit_name string Facultatif

Nom lisible de l’unité.

image_url url Facultatif

Adresse HTTPS de la photo principale.

is_new boolean Facultatif

Mettre le produit en avant comme nouveauté.

active boolean Facultatif

Détermine la visibilité du produit.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /product/delete Clé + Bearer

Masquer un produit.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant du produit à masquer.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /product/favoris Clé + Bearer

Ajouter ou retirer un produit des favoris.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

product_id integer Obligatoire

Identifiant du produit.

favorite boolean Facultatif

true pour ajouter, false pour retirer ; bascule l’état si absent.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /price/list Clé + Bearer

Lister les tarifs applicables au groupe client, avec repli sur le prix de vente du produit.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

product_id integer Facultatif

Limiter le résultat à un produit.

price_group string Facultatif

Groupe tarifaire, 01 par défaut.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /mark/list Clé + Bearer

Lister les marques disponibles.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /size/list Clé + Bearer

Lister les tailles disponibles.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /libweb/list Clé + Bearer

Lister les libellés web de référence, avec repli sur les libellés du catalogue.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Endpoints

Panier et commandes

Gérer le panier puis confirmer une commande de manière atomique.

10 routes

GET /order/list Clé + Bearer

Lister toutes les commandes confirmées de la boutique avec pagination.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

page integer Facultatif

Numéro de page, à partir de 1.

per_page integer Facultatif

Nombre de résultats par page.

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

guid string Facultatif

Filtrer une commande confirmée par son GUID.

from_date date Facultatif

Filtrer à partir de cette date au format YYYY-MM-DD.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /order/delete Clé + Bearer

Vider et supprimer le panier courant.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /order/total Clé + Bearer

Calculer sous-total, TVA et total du panier.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /order/shipping/quote Clé + Bearer

Calculer les frais de livraison selon le panier, le mode de remise et le pays.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

delivery_mode enum Obligatoire

pickup | delivery

delivery_country string Facultatif

Code ISO à 2 lettres ou nom du pays de livraison.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Frais de livraison calculés",
    "data": {
        "delivery_mode": "delivery",
        "country_code": "BE",
        "shipping_mode": "country_rules",
        "shipping_fee": 6.9,
        "free_shipping": false,
        "free_shipping_from": 75,
        "amount_until_free": 25,
        "product_total": 50,
        "total": 56.9,
        "rule": "country:BE",
        "currency": "EUR",
        "currency_symbol": "€"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /order/count/line Clé + Bearer

Compter les lignes présentes dans le panier.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /order/sendtomegawin Clé + Bearer

Confirmer la commande, son mode de remise et son adresse.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

order_guid uuid Facultatif

GUID du panier à confirmer.

delivery_mode enum Obligatoire

pickup | delivery

delivery_address string Facultatif

Obligatoire pour une livraison.

delivery_country string Facultatif

Code ISO à 2 lettres ou nom du pays utilisé pour calculer le tarif.

delivery_date date Facultatif

YYYY-MM-DD

delivery_comment string Facultatif

Instruction de remise.

language string Facultatif

Langue des e-mails transactionnels.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /orderline/add Clé + Bearer

Ajouter un produit et une quantité au panier.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

product_id integer Obligatoire

Identifiant du produit à ajouter.

quantity decimal Obligatoire

Quantité strictement supérieure à zéro.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /orderline/list Clé + Bearer

Récupérer les lignes du panier.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /orderline/update Clé + Bearer

Modifier la quantité d’une ligne.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

item_id integer Obligatoire

Identifiant de la ligne du panier.

quantity decimal Obligatoire

Quantité ; zéro retire la ligne.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /orderline/delete Clé + Bearer

Retirer une ligne du panier.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

item_id integer Obligatoire

Identifiant de la ligne à retirer.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Endpoints

Paiements clients

Choisir le paiement à la livraison ou ouvrir un paiement Stripe sécurisé, puis consulter son état vérifié côté serveur.

4 routes

GET /payment/config Clé + Bearer

Récupérer les modes de paiement Stripe activés et le fournisseur Stripe sélectionné pour l’app.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /payment/checkout/create Clé + Bearer

Créer ou reprendre une page Stripe Checkout pour une commande ou réservation non payée appartenant au client connecté. Un choix de paiement à la livraison encore modifiable est remplacé en sécurité.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

purpose_type enum Obligatoire

order | booking

purpose_id integer Obligatoire

Identifiant de la commande confirmée ou de la réservation confirmée par le client.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /payment/pay-later Clé + Bearer

Enregistrer le paiement à la livraison ou remplacer un paiement Stripe encore ouvert après vérification et expiration sécurisée de sa session.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

purpose_type enum Obligatoire

order | booking

purpose_id integer Obligatoire

Identifiant de la commande ou réservation autorisée.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /payment/status Clé + Bearer

Consulter l’état d’un paiement ; seul le webhook Stripe signé peut confirmer le statut payé.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

reference string Facultatif

Référence SellViaApp du paiement. Sinon, fournir purpose_type et purpose_id.

purpose_type enum Facultatif

order | booking

purpose_id integer Facultatif

Identifiant de l’objet payé.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Endpoints

Documents

Factures, devis, bons et leurs lignes.

8 routes

POST /document/add Clé + Bearer

Créer un document lié au client.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

doc_type string Facultatif

invoice | estimate | purchase_order

doc_number string Facultatif

Numéro du document ; généré automatiquement si absent lors de la création.

doc_date date Facultatif

YYYY-MM-DD

due_date date Facultatif

YYYY-MM-DD

payment_method string Facultatif

Mode de paiement.

remark string Facultatif

Remarque libre.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /document/list Clé + Bearer

Lister ou filtrer les documents.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

doc_type string Facultatif

Filtrer selon le type de document.

guid uuid Facultatif

Filtrer selon le GUID du document.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /document/update Clé + Bearer

Mettre à jour un document identifié par son GUID.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

document_guid uuid Obligatoire

GUID du document à modifier.

doc_type string Facultatif

invoice | estimate | purchase_order

doc_number string Facultatif

Numéro du document ; généré automatiquement si absent lors de la création.

doc_date date Facultatif

YYYY-MM-DD

due_date date Facultatif

YYYY-MM-DD

payment_method string Facultatif

Mode de paiement.

remark string Facultatif

Remarque libre.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /document/delete Clé + Bearer

Supprimer un document et ses lignes.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

document_guid uuid Obligatoire

GUID du document à supprimer.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /documentline/add Clé + Bearer

Ajouter une ligne et recalculer le document.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

document_guid uuid Obligatoire

GUID du document.

text string Facultatif

Description de la ligne.

quantity decimal Facultatif

Quantité, valeur initiale 1.

unit_price decimal Facultatif

Prix unitaire hors TVA.

vat_rate decimal Facultatif

Taux de TVA, valeur initiale 21.

discount_percentage decimal Facultatif

Remise en pourcentage.

product_code string Facultatif

Code article associé.

product_id integer Facultatif

Identifiant du produit associé.

packages decimal Facultatif

Nombre de colis.

Sortie

Résultats possibles

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /documentline/list Clé + Bearer

Récupérer le document avec toutes ses lignes.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

guid uuid Obligatoire

GUID du document dont les lignes doivent être récupérées.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /documentline/update Clé + Bearer

Modifier une ligne identifiée par son GUID.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

document_guid uuid Obligatoire

GUID du document.

line_guid uuid Obligatoire

GUID de la ligne à modifier.

text string Facultatif

Description de la ligne.

quantity decimal Facultatif

Quantité, valeur initiale 1.

unit_price decimal Facultatif

Prix unitaire hors TVA.

vat_rate decimal Facultatif

Taux de TVA, valeur initiale 21.

discount_percentage decimal Facultatif

Remise en pourcentage.

product_code string Facultatif

Code article associé.

product_id integer Facultatif

Identifiant du produit associé.

packages decimal Facultatif

Nombre de colis.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /documentline/delete Clé + Bearer

Supprimer une ligne et recalculer les totaux.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

document_guid uuid Obligatoire

GUID du document.

line_guid uuid Obligatoire

GUID de la ligne à supprimer.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Endpoints

Webhooks temps réel

Recevoir automatiquement les changements SellViaApp dans votre ERP, CRM, automatisation ou service métier.

10 routes

GET /webhooks/events Clé + Bearer

Lister tous les événements disponibles et la version de contrat.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /webhooks/endpoints/list Clé + Bearer

Lister les destinations, leur état et leurs compteurs.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /webhooks/endpoints/create Clé + Bearer

Créer une destination HTTPS et obtenir son secret de signature une seule fois.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

label string Obligatoire

Nom interne de cette destination.

target_url url Obligatoire

URL publique HTTPS sur le port 443. Les réseaux privés et redirections sont refusés.

events array Obligatoire

Événements exacts, groupe avec product.* ou tous avec *.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /webhooks/endpoints/update Clé + Bearer

Modifier la destination, les événements ou mettre en pause.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la destination.

label string Facultatif

Nouveau libellé.

target_url url Facultatif

Nouvelle URL HTTPS.

events array Facultatif

Nouvelle sélection d’événements.

status enum Facultatif

active | paused

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /webhooks/endpoints/delete Clé + Bearer

Supprimer logiquement une destination.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la destination.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /webhooks/endpoints/rotate-secret Clé + Bearer

Remplacer le secret HMAC et l’afficher une seule fois.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant de la destination.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /webhooks/deliveries/list Clé + Bearer

Consulter les livraisons, réponses, erreurs et tentatives.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

page integer Facultatif

Numéro de page, à partir de 1.

per_page integer Facultatif

Nombre de résultats par page.

status enum Facultatif

pending | processing | retry | delivered | failed

endpoint_id integer Facultatif

Limiter à une destination.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /webhooks/deliveries/retry Clé + Bearer

Relancer une livraison précise sans réémettre les autres.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant interne de la livraison.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /webhooks/test Clé + Bearer

Émettre et livrer un événement de test signé.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

endpoint_id integer Obligatoire

Destination à tester.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /webhooks/stats Clé + Bearer

Obtenir les indicateurs des trente derniers jours.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Endpoints

Notifications et intégrations

Notifications mobiles et synchronisations externes.

47 routes

GET /admin/notification/sendtomobile Clé + Bearer

Récupérer les notifications mobiles.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /admin/notification/setdelivery Clé + Bearer

Marquer une notification comme distribuée.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

customer_id integer Facultatif

Requis uniquement avec un jeton d’intégration lorsque l’opération concerne un client précis.

guid string Obligatoire

Jeton GUID de la notification.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /woocommerce/categories/sync Clé + Bearer

Synchroniser par lots les catégories et sous-catégories WooCommerce.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 500 catégories. Chaque objet utilise external_id, name et, pour une sous-catégorie, parent_external_id.

items[].external_id string Obligatoire

Identifiant WooCommerce stable.

items[].name string Obligatoire

Nom visible.

items[].parent_external_id string Facultatif

Identifiant de la catégorie parente.

items[].sort_order integer Facultatif

Ordre d’affichage.

items[].images array Facultatif

Jusqu’à cinq URLs HTTPS.

items[].active boolean Facultatif

false archive la catégorie.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /woocommerce/products/sync Clé + Bearer

Synchroniser produits, variations, images, prix, TVA, stock et visibilité.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 250 produits ou variations par lot.

items[].external_id string Obligatoire

Identifiant WooCommerce stable, utilisé contre les doublons.

items[].type enum Facultatif

simple | variable | variation

items[].parent_external_id string Facultatif

Produit parent d’une variation.

items[].sku string Facultatif

SKU ; un code de repli est généré si absent.

items[].name string Obligatoire

Nom du produit.

items[].description string Facultatif

Description du produit.

items[].regular_price decimal Facultatif

Prix standard.

items[].sale_price decimal Facultatif

Prix promotionnel.

items[].date_on_sale_from date Facultatif

Début de promotion ISO 8601.

items[].date_on_sale_to date Facultatif

Fin de promotion ISO 8601.

items[].vat_rate decimal Facultatif

Taux de TVA.

items[].stock_quantity integer Facultatif

Stock disponible.

items[].category_external_id string Facultatif

Catégorie principale synchronisée.

items[].subcategory_external_id string Facultatif

Sous-catégorie synchronisée.

items[].images array Facultatif

Jusqu’à cinq images HTTPS.

items[].attributes array Facultatif

Attributs de variation WooCommerce.

items[].active boolean Facultatif

Visibilité dans SellViaApp.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /woocommerce/customers/sync Clé + Bearer

Créer ou mettre à jour les comptes clients WooCommerce sans envoyer d’e-mail.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 250 comptes clients par lot. Aucun e-mail n’est envoyé.

items[].external_id string Obligatoire

Identifiant utilisateur WooCommerce stable.

items[].username string Obligatoire

Identifiant WooCommerce conservé exactement dans client.login.

items[].email email Facultatif

Adresse e-mail du client, utilisée contre les doublons.

items[].first_name string Facultatif

Prénom du client.

items[].last_name string Facultatif

Nom du client.

items[].company string Facultatif

Société ou dénomination.

items[].phone string Facultatif

Numéro de téléphone.

items[].vat_number string Facultatif

Numéro de TVA.

items[].language iso-639-1 Facultatif

Langue en deux caractères ; anglais par défaut.

items[].billing object Facultatif

Adresse de facturation WooCommerce complète.

items[].shipping object Facultatif

Adresse de livraison conservée dans les métadonnées de synchronisation.

items[].active boolean Facultatif

État actif du compte.

items[].send_email boolean Facultatif

Doit rester false. L’API n’envoie aucun e-mail pour cette route.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /woocommerce/products/inventory Clé + Bearer

Mettre à jour rapidement uniquement les prix, promotions, stocks ou la visibilité.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 500 mises à jour légères.

items[].external_id string Obligatoire

Produit déjà synchronisé.

items[].stock_quantity integer Facultatif

Nouvelle quantité.

items[].regular_price decimal Facultatif

Nouveau prix standard.

items[].sale_price decimal Facultatif

Nouveau prix promotionnel.

items[].active boolean Facultatif

Nouvelle visibilité.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /woocommerce/products/archive Clé + Bearer

Archiver en lots les produits WooCommerce supprimés sans toucher aux commandes.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

entity_type enum Facultatif

product | category | subcategory

items array Obligatoire

Liste de 500 identifiants externes maximum.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /woocommerce/orders/feed Clé + Bearer

Récupérer les commandes confirmées avec curseur et réconciliation.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

cursor string Facultatif

Curseur opaque reçu dans la réponse précédente.

updated_since datetime Facultatif

Date ISO 8601 du début de lecture.

limit integer Facultatif

1 à 100 commandes.

unacknowledged_only boolean Facultatif

true par défaut pour éviter les doublons.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /woocommerce/orders/acknowledge Clé + Bearer

Confirmer qu’une commande a été importée dans WooCommerce.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Commandes traitées par WooCommerce.

items[].order_guid string Obligatoire

GUID SellViaApp retourné par le flux.

items[].external_order_id string Facultatif

Identifiant de commande WooCommerce.

items[].status enum Obligatoire

imported | failed | ignored

items[].error string Facultatif

Explication si l’import a échoué.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /woocommerce/webhooks/subscribe Clé + Bearer

Enregistrer un webhook WooCommerce HTTPS signé.

Entrée

Corps JSON

NomTypePrésenceDescription

target_url url Obligatoire

URL publique HTTPS ; les réseaux privés sont refusés.

events array Facultatif

order.created | order.updated | order.cancelled | *

Sortie

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /woocommerce/webhooks/list Clé + Bearer

Lister les webhooks WooCommerce actifs.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /woocommerce/webhooks/delete Clé + Bearer

Désactiver un webhook WooCommerce.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Identifiant du webhook.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /woocommerce/webhooks/process Clé + Bearer

Traiter les livraisons webhook en attente avec reprise automatique.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

limit integer Facultatif

Nombre maximal de livraisons à traiter.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /woocommerce/sync/logs Clé + Bearer

Consulter le journal technique de synchronisation.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

page integer Facultatif

Numéro de page, à partir de 1.

per_page integer Facultatif

Nombre de résultats par page.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/categories/sync Clé + Bearer

Synchroniser les collections et types de produits Shopify.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 500 collections ou types de produits.

items[].external_id string Obligatoire

GID Shopify stable.

items[].name string Obligatoire

Nom visible.

items[].parent_external_id string Facultatif

Collection parente d’un type de produit.

items[].images array Facultatif

URLs HTTPS.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/categories/archive Clé + Bearer

Archiver une collection Shopify supprimée.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

GID des collections supprimées.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/products/sync Clé + Bearer

Synchroniser les produits, variantes, images, prix, stocks et visibilité Shopify.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 250 variantes Shopify par lot.

items[].external_id string Obligatoire

GID de la variante.

items[].parent_external_id string Facultatif

GID du produit parent.

items[].sku string Facultatif

SKU

items[].name string Obligatoire

Titre produit et variante.

items[].regular_price decimal Facultatif

Prix standard ou compare-at.

items[].sale_price decimal Facultatif

Prix promotionnel actif.

items[].stock_quantity integer Facultatif

Quantité disponible.

items[].images array Facultatif

Jusqu’à cinq images HTTPS.

items[].active boolean Facultatif

Visibilité dans SellViaApp.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /shopify/products/inventory Clé + Bearer

Mettre à jour rapidement prix, stock ou visibilité Shopify.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 500 mises à jour légères.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/products/archive Clé + Bearer

Archiver des variantes Shopify par identifiant.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

GID des variantes à archiver.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/products/archive-parent Clé + Bearer

Archiver toutes les variantes d’un produit Shopify supprimé.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 100 GID de produits parents.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/customers/sync Clé + Bearer

Synchroniser les clients Shopify sans envoyer d’e-mail.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 250 clients ; aucun e-mail envoyé.

items[].external_id string Obligatoire

GID client Shopify.

items[].username string Obligatoire

Identifiant utilisé dans SellViaApp.

items[].email email Facultatif

Adresse du client.

items[].send_email boolean Facultatif

Doit rester false.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/customers/redact Clé + Bearer

Anonymiser les données client demandées par Shopify.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Facultatif

GID des clients à anonymiser.

all boolean Facultatif

Anonymise tous les clients Shopify lors de shop/redact.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /shopify/orders/feed Clé + Bearer

Récupérer les commandes SellViaApp non importées dans Shopify.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

cursor string Facultatif

Curseur opaque.

limit integer Facultatif

1–100

unacknowledged_only boolean Facultatif

true recommandé.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/orders/acknowledge Clé + Bearer

Confirmer l’import d’une commande dans Shopify.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Commandes importées.

items[].order_guid string Obligatoire

GUID SellViaApp.

items[].external_order_id string Facultatif

GID Shopify créé.

items[].status enum Obligatoire

imported | failed | ignored

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/webhooks/subscribe Clé + Bearer

Enregistrer le webhook SellViaApp signé du connecteur Shopify.

Entrée

Corps JSON

NomTypePrésenceDescription

target_url url Obligatoire

URL HTTPS du connecteur.

events array Facultatif

order.created | order.updated | order.cancelled | *

Sortie

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /shopify/webhooks/list Clé + Bearer

Lister les webhooks du connecteur Shopify.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /shopify/webhooks/delete Clé + Bearer

Désactiver un webhook Shopify.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Webhook ID

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /shopify/webhooks/process Clé + Bearer

Retraiter les notifications Shopify en attente.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

limit integer Facultatif

Nombre maximal.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /shopify/account Clé + Bearer

Identifier la boutique et récupérer son compte de test mobile.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /shopify/sync/logs Clé + Bearer

Consulter le journal Shopify isolé de WooCommerce.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

page integer Facultatif

Numéro de page, à partir de 1.

per_page integer Facultatif

Nombre de résultats par page.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/connect Public

Relier une instance Wix à un compte Dashboard SellViaApp existant.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

email email Obligatoire

E-mail utilisé pour le Dashboard SellViaApp.

password string Obligatoire

Vérifié une seule fois et jamais conservé par le connecteur.

instance_id string Obligatoire

Identifiant Wix stable de l’installation.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /wix/account Clé + Bearer

Identifier le compte SellViaApp relié à Wix et son compte mobile de test.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/disconnect Clé + Bearer

Révoquer le jeton du connecteur et déconnecter Wix.

Entrée

Paramètres possibles

Corps JSON

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/categories/sync Clé + Bearer

Synchroniser les catégories ou collections Wix Stores V1/V3.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 500 catégories ou collections Wix par lot.

items[].external_id string Obligatoire

Identifiant Wix stable.

items[].name string Obligatoire

Nom visible dans l’app.

items[].parent_external_id string Facultatif

Identifiant de la catégorie parente.

items[].image url Facultatif

Image HTTPS de présentation.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/products/sync Clé + Bearer

Synchroniser les produits Wix avec images, prix, stock et visibilité.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 250 produits ou variantes Wix par lot.

items[].external_id string Obligatoire

Identifiant produit ou variante Wix.

items[].parent_external_id string Facultatif

Produit parent d’une variante.

items[].sku string Facultatif

SKU

items[].name string Obligatoire

Titre du produit.

items[].regular_price decimal Facultatif

Prix normal.

items[].sale_price decimal Facultatif

Prix promotionnel actif.

items[].stock_quantity integer Facultatif

Stock disponible.

items[].images array Facultatif

Jusqu’à cinq images HTTPS.

items[].visible boolean Facultatif

Visibilité dans SellViaApp.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /wix/products/inventory Clé + Bearer

Mettre à jour rapidement prix, stock ou visibilité Wix.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Mises à jour légères de prix, stock ou visibilité.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/products/archive Clé + Bearer

Archiver les produits Wix supprimés.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

entity_type enum Facultatif

product | category | subcategory

items array Obligatoire

Identifiants externes Wix à archiver.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/customers/sync Clé + Bearer

Synchroniser les contacts Wix sans envoyer d’e-mail.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Maximum 250 contacts ; aucun e-mail SellViaApp envoyé.

items[].external_id string Obligatoire

Identifiant du contact Wix.

items[].username string Obligatoire

E-mail ou identifiant de repli.

items[].active boolean Facultatif

true pour les contacts synchronisés.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/customers/redact Clé + Bearer

Anonymiser un ou plusieurs contacts Wix synchronisés.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

all boolean Facultatif

Anonymiser tous les contacts provenant de Wix.

items array Facultatif

Identifiants externes Wix à anonymiser lorsque all est faux.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/privacy/shop-redact Clé + Bearer

Supprimer les données provenant de Wix après désinstallation.

Entrée

Paramètres possibles

Corps JSON

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /wix/orders/feed Clé + Bearer

Lire les commandes SellViaApp à rapprocher avec Wix.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

cursor string Facultatif

Curseur opaque de la page précédente.

updated_since datetime Facultatif

Date ISO 8601 facultative.

limit integer Facultatif

1–100

unacknowledged_only boolean Facultatif

true par défaut pour éviter les doublons.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/orders/acknowledge Clé + Bearer

Enregistrer le résultat d’un rapprochement de commande Wix.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

items array Obligatoire

Résultats de rapprochement.

items[].order_guid string Obligatoire

GUID de commande SellViaApp.

items[].external_order_id string Facultatif

Identifiant de commande Wix lié.

items[].status enum Obligatoire

imported | failed | ignored

items[].error string Facultatif

Erreur compréhensible en cas d’échec.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/webhooks/subscribe Clé + Bearer

Créer une destination SellViaApp signée pour le connecteur Wix.

Entrée

Corps JSON

NomTypePrésenceDescription

target_url url Obligatoire

URL HTTPS du système destinataire.

events array Facultatif

order.created | order.updated | order.cancelled | *

Sortie

201Ressource créée

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /wix/webhooks/list Clé + Bearer

Lister les webhooks SellViaApp du connecteur Wix.

Entrée

Paramètres possibles

URL (query)

Aucun paramètre métier n’est attendu. Envoyez uniquement les en-têtes d’authentification indiqués.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /wix/webhooks/delete Clé + Bearer

Désactiver un webhook du connecteur Wix.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

id integer Obligatoire

Webhook ID

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /wix/webhooks/process Clé + Bearer

Traiter les livraisons SellViaApp en attente pour Wix.

Entrée

Paramètres possibles

Corps JSON

NomTypePrésenceDescription

limit integer Facultatif

Nombre maximal de livraisons.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /wix/sync/logs Clé + Bearer

Consulter le journal de synchronisation Wix isolé.

Entrée

Paramètres possibles

URL (query)

NomTypePrésenceDescription

page integer Facultatif

Numéro de page, à partir de 1.

per_page integer Facultatif

Nombre de résultats par page.

Sortie

Résultats possibles

200Opération réussie

400Requête ou JSON invalide

401Authentification absente ou invalide

403Accès insuffisant

404Ressource demandée introuvable

409Conflit avec les données existantes

422Paramètre refusé par la validation

429Limite de requêtes atteinte

5xxIncident technique temporaire

Exemple de succès

{
    "success": true,
    "message": "Opération réussie",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Exemple d’erreur

{
    "success": false,
    "message": "La requête ne peut pas être traitée.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Vérifiez les paramètres indiqués.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Référence

Réponses et erreurs

Chaque ligne possède un bouton « Paramètres et réponses » qui indique les champs obligatoires ou facultatifs, les statuts possibles et des exemples JSON. Une liste vide signifie que la ressource n’est pas encore alimentée, pas que la route est en panne.

400Requête invalide

401Authentification requise

403Accès refusé

404Ressource ou route absente

409Conflit métier

422Validation impossible

429Trop de requêtes

5xxIncident technique

Atelier API

Endpoint

GET

Paramètres URLUne ligne par paramètre : nom=valeur Corps JSONModifiez les valeurs d’exemple avant le test.

Le code généré contient les accès saisis. Conservez-les côté serveur et ne partagez jamais une capture non masquée.

Réponse API