Edit delivery
PUT/company/delivery/:service_code
Aktualisiert die Details einer bestehenden Lieferung. Die bearbeitbaren Felder hängen vom aktuellen Status der Lieferung ab.
Ziel
Ermöglicht Unternehmen, bestimmte Aspekte ihrer Lieferungen je nach aktuellem Status zu ändern und dabei eine Änderungskontrolle über replannedBy zu wahren.
Anwendungsfälle
- Ändern von Lade-/Entladedaten bei geplanten oder akzeptierten Lieferungen
- Aktualisieren von Ladungsdetails (Gewicht, Höhe, Paletten, Temperatur)
- Korrigieren der Lademeter
- Einleiten eines Neuplanungsprozesses, der eine Genehmigung erfordert
Bearbeitbare Felder nach Status
Status 'planned' oder 'replanned':
Bearbeitbar: etl_date, etd_date, pallets_num, fresh_cargo_temp, cargo_weight, cargo_height, linear_meters
Status 'accepted':
Bearbeitbar: etl_date, etd_date
Jede andere Bearbeitung:
- Ändert den Status zu 'replanned'
- Setzt
replannedByauf 'cia' (Unternehmen)
Validierungsablauf
flowchart TD
A[Bearbeitungsanfrage erhalten] --> B{Lieferung existiert?}
B -->|Nein| C[404 NOT_FOUND]
B -->|Ja| D{Gehört Lieferung dem Unternehmen?}
D -->|Nein| E[404 NOT_ALLOWED]
D -->|Ja| F{Ist Finalstatus?}
F -->|Ja| G[401 NOT_ALLOWED]
F -->|Nein| H[Bearbeitbare Schlüssel abrufen]
H --> I{Irgendwelche gültigen Schlüssel?}
I -->|Nein| J[401 NOT_ALLOWED]
I -->|Ja| K[Felder aktualisieren]
K --> L[Status auf 'replanned' setzen]
L --> M[replannedBy auf 'cia' setzen]
M --> N[Änderungen speichern - 200]
Hinweise
Request
Responses
- 200
- 400
- 401
- 404
Versand erfolgreich aktualisiert
Operation nicht erlaubt. Tritt auf, wenn:
- Die bereitgestellten Daten ungültig sind
Nicht autorisiert. Das JWT-Token ist ungültig oder abgelaufen, oder die angeforderten Felder können für den aktuellen Status nicht bearbeitet werden.
Sendung nicht gefunden. Der angegebene service_code existiert nicht oder gehört nicht zum Unternehmen des authentifizierten Benutzers.