Aller au contenu principal

Update existing auction

PUT 
/company/auction

Permet de modifier une enchère existante. Seules les enchères en état 'brouillon' peuvent être éditées.

Fournir la capacité d'éditer les enchères avant leur publication.

Objectif​

Permettre des ajustements et des corrections dans les données de l'enchère tant qu'elle reste à l'état de brouillon.

Cas d'Utilisation​

  • Corriger des erreurs dans les adresses ou les dates avant la publication
  • Ajuster le poids, le volume ou le type de chargement
  • Modifier le prix initial ou d'adjudication
  • Mettre à jour la description ou les notes supplémentaires
  • Changer l'état en 'publié' pour démarrer la période d'enchères

Logique de Publication Automatique​

Lorsque l'état est mis à jour sur publié, le système exécute automatiquement :

flowchart LR
  A[Statut = publié] --> B{date_start valide ?}
  B -->|Non définie| C[date_start = MAINTENANT]
  B -->|Dans le passé| C
  B -->|Future| D[Conserver date_start]
  C --> E[Valider données complètes]
  D --> E
  E --> F{Validation OK ?}
  F -->|Non| G[400 Erreur de Validation]
  F -->|Oui| H[Envoyer notifications]
  H --> I[Publier sur le marketplace]

Ajustement automatique de date_start :

  • Si date_start n'est pas définie OU date_start < date actuelle
  • On définit date_start = new Date() (date/heure actuelle)
  • Garantit que les enchères publiées aient une date de début valide

Validations supplémentaires lors de la publication :

  • date_start et date_end doivent exister et être futures
  • etl_date et etd_date doivent être valides
  • Le poids et la hauteur du chargement doivent être positifs
  • Les adresses doivent exister et être valides

Restriction importante :

  • Seules les enchères en état 'brouillon' peuvent être éditées
  • Une fois publiée, verrouillée ou attribuée, elle NE PEUT PLUS

Request​

Responses​

Enchère mise à jour avec succès