Erforderliche Berechtigungen: deliveries:patch
Aktualisiert eine bestehende Lieferung und ihre Positionen. Änderungen werden in der Lieferhistorie protokolliert. Nur Lieferungen, die dem Kunden des API-Schlüssels gehören, können bearbeitet werden. Markierte (gesperrte) Lieferungen können nicht bearbeitet werden. Um eine markierte Lieferung zu aktualisieren, muss sie zuerst über die Web-App entmarkiert werden.
| Scope | Tenant type |
|---|---|
deliveries:patch | Customer only (CUSTOMER_ONLY) |
| Header | Required | Description |
|---|---|---|
x-api-key | Yes | API key with scope deliveries:patch |
x-change-reason | No | Reason for the change (stored in delivery history) |
| Field | Type | Description |
|---|---|---|
comment | string | Free-text comment |
planned_arrival_time | string (ISO 8601) | Planned arrival time |
order_number | string | Order number |
project_id | uuid | Project assignment |
project_number | string | Project number |
invoice_number | string | Invoice number |
delivery_number | string | Delivery note number |
work_type_id | string | Work type ID |
charging_number | string | Charging number |
received_at | string (ISO 8601) | Received timestamp |
invoice_matched | boolean | Invoice matching confirmed |
marked | boolean | Mark delivery as verified |
charged | boolean | Mark delivery as charged |
properties | object | Additional properties (merged with existing) |
plant | object | Plant ({ "title": "..." }) |
| Field | Type | Description |
|---|---|---|
title | string | Item description |
quantity | number | Quantity |
unit | string | Unit of measure |
product_number | string | Product number |
type | string | Item type |
work_type_id | string | Work type ID |
marked | boolean | Mark item as verified |
invoice_matched | boolean | Invoice matching confirmed |
charged | boolean | Mark item as charged |
purchase_order_item_id | uuid | Link to a purchase order item |
marked, invoice_matched, charged) are changed at the delivery level, all items are synchronized.marked: true automatically sets received_at to the current timestamp.properties are merged with existing properties.| Code | Description |
|---|---|
200 | Delivery successfully updated (or returned unchanged) |
400 | Invalid input or delivery is marked/locked |
403 | Forbidden — delivery belongs to another customer |
404 | Delivery not found |
422 | Update failed |
API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.
Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.
Grund für die Änderung (wird in der Lieferhistorie gespeichert)
Lieferungs-ID (UUID)
Alle Felder sind optional. Nur angegebene Felder werden aktualisiert.
Freitext-Kommentar
Geplante Ankunftszeit (ISO 8601)
Bestellnummer
Projektzuordnung
Projektnummer
Rechnungsnummer
Lieferscheinnummer
Leistungsart-ID
Verrechnungsnummer
Empfangszeitpunkt (ISO 8601)
Rechnungszuordnung bestätigt
Lieferung als verifiziert markieren
Lieferung als berechnet markieren
Positionen der Lieferung
Zusätzliche Eigenschaften (wird mit bestehenden zusammengeführt)
Lieferung erfolgreich aktualisiert (oder unverändert zurückgegeben)
Lieferungs-ID
Lieferscheinnummer
Kommentar
Geplante Ankunftszeit
Ob die Lieferung markiert/verifiziert wurde
Rechnungszuordnung bestätigt
Lieferung als berechnet markiert
Empfangszeitpunkt