Créer un fournisseur
POST
/v1/suppliers
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 champdetailsliste chaque erreur. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique 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êteRetry-After.
Une question ? contact@wanapos.com
