Classements

Créer un fournisseur

POST /v1/suppliers
vpn_key Permission write_products Compte comme une écriture

Crée un fournisseur et renvoie sa fiche. Seul name est obligatoire.

Un nom déjà pris est refusé avec l'erreur duplicate_name, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés.

Pour rattacher ensuite un produit à ce fournisseur, donnez son identifiant ou son nom à la création du produit.

Paramètres

dry_run Facultatif true pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec meta.dry_run à true. L'identifiant renvoyé n'est alors pas réservé.
Idempotency-Key Facultatif Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création.

Corps JSON à envoyer

Champ Type Description
name texte Nom du fournisseur. De 3 à 50 caractères. Un nom déjà pris est refusé (duplicate_name), sans tenir compte des majuscules ni des accents.
commercial1 texte Premier contact commercial. 100 caractères au maximum.
commercial2 texte Second contact commercial. 100 caractères au maximum.
tel texte Téléphone. 17 caractères au maximum.
mobile texte Mobile. 17 caractères au maximum.
email texte Adresse mail. 50 caractères au maximum.
tva_intra texte Numéro de TVA intracommunautaire. 32 caractères au maximum.
notes texte Notes libres. 5 000 caractères au maximum.
adresse objet Adresse du fournisseur. Seuls les champs envoyés changent.
adresse.ligne1 texte Adresse, première ligne. 50 caractères au maximum.
adresse.ligne2 texte Complément d'adresse. 50 caractères au maximum.
adresse.cp texte Code postal. 9 caractères au maximum.
adresse.ville texte Ville. 30 caractères au maximum.
adresse.pays_code texte Code du pays à deux lettres (voir GET /v1/countries). À la création, s'il est absent : le pays du magasin principal.
archived booléen À la modification seulement : true pour archiver, false pour remettre en service.

Exemple d'appel

curl -X POST "https://api.wanapos.com/v1/suppliers" \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"name":"Maison Verdier","commercial1":"Julie Arnaud","tel":"0472000000","email":"contact@maison-verdier.example","adresse":{"ligne1":"4 quai des Tanneurs","cp":"69009","ville":"Lyon","pays_code":"FR"}}'

Réponse en cas de succès (statut 201)

Le fournisseur créé.

Champ Type Description
data objet
data.id entier Identifiant du fournisseur. C'est la valeur de fournisseur.id dans un produit.
data.name texte Nom du fournisseur.
data.commercial1 texte Nom du premier contact commercial.
data.commercial2 texte Nom du second contact commercial.
data.tel texte Téléphone.
data.mobile texte Mobile.
data.email texte Adresse mail.
data.tva_intra texte Numéro de TVA intracommunautaire.
data.notes texte Notes libres du commerçant.
data.archived booléen true si le fournisseur est archivé : il n'est plus proposé dans l'application, mais les produits qui le portent le gardent.
data.date_creation texte Date de création.
data.date_update texte Date de la dernière modification. Chaîne vide si inconnue.
data.adresse objet Adresse du fournisseur.
data.adresse.ligne1 texte Adresse, première ligne.
data.adresse.ligne2 texte Complément d'adresse.
data.adresse.cp texte Code postal.
data.adresse.ville texte Ville.
data.adresse.id_pays entier Identifiant du pays (voir GET /v1/countries). 0 si non renseigné.
data.adresse.pays_code texte Code du pays à deux lettres.
data.adresse.pays texte Nom du pays en français.
meta objet
meta.request_id texte Identifiant de l'appel, à communiquer à l'assistance en cas de problème.
{
    "data": {
        "id": 7,
        "name": "Maison Verdier",
        "commercial1": "Julie Arnaud",
        "commercial2": "",
        "tel": "0472000000",
        "mobile": "",
        "email": "contact@maison-verdier.example",
        "tva_intra": "",
        "notes": "",
        "archived": false,
        "date_creation": "2026-03-14T10:22:00+01:00",
        "date_update": "2026-10-02T16:05:00+02:00",
        "adresse": {
            "ligne1": "4 quai des Tanneurs",
            "ligne2": "",
            "cp": "69009",
            "ville": "Lyon",
            "id_pays": 63,
            "pays_code": "FR",
            "pays": "France"
        }
    },
    "meta": {
        "request_id": "3f9a1c0b7d2e4a61"
    }
}

Erreurs possibles

  • 401 Clé absente, inconnue ou révoquée. Codes : missing_key, invalid_key.
  • 403 Appel refusé pour ce compte ou cette clé. Codes : api_not_activated, account_not_eligible, access_blocked, missing_scope.
  • 409 Ce nom est déjà porté par un autre élément du même classement. Code : duplicate_name. Le message et l'indication donnent l'identifiant existant. Rien n'a été enregistré.
  • 422 Données envoyées invalides. Code : validation_failed. Le champ details liste chaque erreur.
  • 429 Quota dépassé. Codes : rate_limited, daily_quota_exceeded, too_many_failed_attempts. L'en-tête Retry-After indique combien de secondes attendre.
  • 503 Une autre écriture est en cours sur ce compte. Code : account_busy. Renvoyer la même requête après le délai de l'en-tête Retry-After.

Voir toutes les erreurs

Une question ? contact@wanapos.com