Objets (Livre de police)

L'API Objets permet de gérer les entrées du livre de police numérique : enregistrement d'objets mobiliers, suivi du stock et des ventes, gestion des photos.

Chaque objet reçoit automatiquement un numéro d'ordre séquentiel, conforme aux exigences réglementaires.

Lister les objets

Récupère tous les objets du registre.

GET /objets

Réponse `200`

[
  {
    "id": "uuid",
    "numero": 1,
    "typeOperation": "achat",
    "designation": "Montre ancienne en or",
    "marques": "Marque visible au dos",
    "provenanceDéclarée": "Succession familiale",
    "quantite": 1,
    "prixAchat": 150.00,
    "modePaiement": "espèces",
    "dateAchat": "2025-03-01",
    "vendeurType": "particulier",
    "vendeurNom": "Jean Dupont",
    "vendeurId": "uuid",
    "photos": [
      { "key": "photo-key", "url": "https://...", "addedAt": "2025-03-01T10:00:00Z" }
    ],
    "statut": "en_stock",
    "dateVente": null,
    "prixVente": null,
    "auditCount": 3,
    "createdAt": "2025-03-01T10:00:00Z",
    "deletedAt": null
  }
]

Créer un objet

Enregistre un nouvel objet dans le livre de police. Le numero est attribué automatiquement.

POST /objets

Corps de la requête

Champ	Type	Requis	Description
`typeOperation`	`string`	Oui	`achat`, `dépôt`, `reprise`, `échange`
`designation`	`string`	Oui	Description de l'objet
`marques`	`string`	Non	Marques, signes distinctifs
`provenanceDéclarée`	`string`	Non	Provenance déclarée par le vendeur
`quantite`	`number`	Oui	Quantité
`prixAchat`	`number`	Oui	Prix d'achat en euros
`modePaiement`	`string`	Non	`virement`, `chèque`, `espèces`, `carte`, `autre`
`dateAchat`	`string`	Oui	Date d'achat (ISO 8601)
`vendeurType`	`string`	Non	`particulier`, `professionnel`
`vendeurNom`	`string`	Oui	Nom du vendeur
`vendeurDateNaissance`	`string`	Non	Date de naissance
`vendeurLieuNaissance`	`string`	Non	Lieu de naissance
`vendeurNationalite`	`string`	Non	Nationalité
`vendeurAdresse`	`string`	Non	Adresse
`vendeurIdentiteType`	`string`	Non	Type de pièce d'identité
`vendeurIdentiteNumero`	`string`	Non	Numéro de pièce d'identité
`vendeurIdentiteDelivrance`	`string`	Non	Date/lieu de délivrance
`vendeurRaisonSociale`	`string`	Non	Raison sociale (vendeur professionnel)
`vendeurSiret`	`string`	Non	SIRET (vendeur professionnel)
`vendeurId`	`string`	Non	ID d'un vendeur existant du répertoire
`photos`	`array`	Non	Tableau de clés de photos uploadées
`signatureKey`	`string`	Non	Clé de la signature numérique

Réponse `201`

Retourne l'objet créé avec son id et son numero attribué automatiquement.

Modifier un objet

PUT /objets/{id}

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

Réponse `200`

Retourne l'objet mis à jour.

Supprimer un objet

La suppression est logique (soft delete) : l'objet reste dans le registre avec une date deletedAt pour assurer la traçabilité réglementaire.

DELETE /objets/{id}

Corps de la requête

Champ	Type	Requis	Description
`reason`	`string`	Oui	Motif de suppression (traçabilité)

Changer le statut (stock / vendu)

Permet de suivre le cycle de vie d'un objet : passage en stock ou marquage comme vendu.

PUT /objets/{id}/statut

Corps de la requête

Champ	Type	Requis	Description
`statut`	`string`	Oui	`en_stock` ou `vendu`
`dateVente`	`string`	Si vendu	Date de vente (ISO 8601)
`prixVente`	`number`	Si vendu	Prix de vente en euros

Exemple — marquer comme vendu

{
  "statut": "vendu",
  "dateVente": "2025-06-15",
  "prixVente": 280.00
}

Exemple — remettre en stock

{
  "statut": "en_stock"
}

Upload de photo

POST /objets/upload-photo

Content-Type : multipart/form-data

Champ	Type	Description
`photo`	`File`	Fichier image (JPEG, PNG)

Réponse `200`

{
  "key": "photo-key-uuid",
  "url": "https://storage.registeo.fr/..."
}

Utilisez la key retournée dans le champ photos lors de la création ou modification d'un objet.

Supprimer une photo d'objet

DELETE /objets/{objetId}/photos

Champ	Type	Description
`key`	`string`	Clé de la photo à supprimer

Supprimer une photo temporaire

Supprime une photo uploadée mais non encore associée à un objet.

DELETE /objets/uploaded-photo

Champ	Type	Description
`key`	`string`	Clé de la photo temporaire