Modifier un fournisseur
PATCH
/v1/suppliers/{id}
Permission write_products
Compte comme une écriture
Modifie un fournisseur et renvoie sa fiche après modification.
La modification est partielle : seuls les champs envoyés changent. Il n'existe pas de suppression : pour retirer un élément, archivez-le avec archived à true. Les produits qui le portent le gardent. Pour vider un champ texte, envoyez-le avec une chaîne vide.
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.
Paramètres
id |
Obligatoire | Identifiant du fournisseur (champ id). |
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 PATCH "https://api.wanapos.com/v1/suppliers/7" \
-H "Authorization: Bearer VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"mobile":"0611223344","adresse":{"ville":"Villeurbanne","cp":"69100"}}'
Réponse en cas de succès (statut 200)
Le fournisseur après modification.
| 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. -
404
L'élément demandé n'existe pas sur ce compte. Code :
resource_not_found. -
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
