Vendeurs

L'API Vendeurs permet de gérer le répertoire des vendeurs (particuliers et professionnels). Les vendeurs peuvent être réutilisés lors de l'enregistrement d'objets via leur vendeurId.

Lister les vendeurs

GET /vendeurs

Réponse `200`

[
  {
    "id": "uuid",
    "type": "particulier",
    "nom": "Jean Dupont",
    "dateNaissance": "1985-06-15",
    "lieuNaissance": "Paris",
    "nationalite": "Française",
    "adresse": "12 rue de la Paix, 75002 Paris",
    "identiteType": "CNI",
    "identiteNumero": "123456789",
    "identiteDelivrance": "Préfecture de Paris, 2020-01-15",
    "documents": [
      { "key": "doc-key", "url": "https://...", "addedAt": "2025-03-01T10:00:00Z" }
    ],
    "createdAt": "2025-03-01T10:00:00Z"
  }
]

Créer un vendeur

POST /vendeurs

Corps de la requête

Champ	Type	Requis	Description
`type`	`string`	Oui	`particulier` ou `professionnel`
`nom`	`string`	Oui	Nom complet
`dateNaissance`	`string`	Non	Date de naissance (particulier)
`lieuNaissance`	`string`	Non	Lieu de naissance
`nationalite`	`string`	Non	Nationalité
`adresse`	`string`	Non	Adresse postale
`identiteType`	`string`	Non	Type de pièce d'identité (CNI, passeport, etc.)
`identiteNumero`	`string`	Non	Numéro de pièce d'identité
`identiteDelivrance`	`string`	Non	Lieu et date de délivrance
`raisonSociale`	`string`	Non	Raison sociale (professionnel)
`siret`	`string`	Non	Numéro SIRET (professionnel)
`documents`	`array`	Non	Documents associés (clés de fichiers uploadés)

Réponse `201`

Retourne le vendeur créé avec son id.

Modifier un vendeur

PUT /vendeurs/{id}

Mêmes champs que la création. Seuls les champs fournis sont mis à jour.

Réponse `200`

Retourne le vendeur mis à jour.

Supprimer un vendeur

DELETE /vendeurs/{id}

Réponse `200`

Un vendeur ne peut être supprimé que s'il n'est référencé par aucun objet du registre.