API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · purchase_orders

Purchase Order Schema

Schema-ID
purchase_order
Collection
purchase_orders
Permissions
  • Lesenpurchase_order_view
  • Anlegenpurchase_order_create
  • Ändernpurchase_order_edit
  • Löschenpurchase_order_delete

Felder

Purchase Order Schema

purchase_orders4 Permissions

Einkaufsbestellung an einen Lieferanten mit Status-Workflow und Wareneingang.

purchaseOrderNumberstringoptional

Auto-generierte Bestellnummer (PO-{YYYY}-{NNNNN}).

max 64 ZeichenDefault: nullread-onlynullable
supplierIduuiderforderlich

Lieferanten-Party-UUID (party.isSupplier=true).

assignedToIdstringoptional

Verantwortlicher Einkäufer (User-UUID).

PatternDefault: nullnullable
orgUnitIdstringoptional

Verantwortliche Org-Einheit.

PatternDefault: nullnullable
statusstringerforderlich

Workflow: DRAFT → ORDERED → (PARTIALLY_RECEIVED →) RECEIVED. CANCELLED ist aus DRAFT/ORDERED erreichbar.

Werte
DRAFTORDEREDPARTIALLY_RECEIVEDRECEIVEDCANCELLED
Default: "DRAFT"
orderDatedatetimeoptional

Bestelldatum (gesetzt bei Übergang nach ORDERED).

Default: nullnullable
expectedDeliveryDatedatetimeoptional

Erwartetes Liefertermin.

Default: nullnullable
actualDeliveryDatedatetimeoptional

Tatsächlicher (vollständiger) Wareneingang.

Default: nullnullable
deliveryOrgUnitIdstringoptional

Eigene Niederlassung als Lieferadresse (Verweis auf org_unit).

PatternDefault: nullnullable
deliveryAddressobjectoptional

Eingebettete Lieferadresse, falls keine org_unit-Referenz.

Default: nullnullable
itemsobject[]optional
Default: []
iduuiderforderlich
positionNumberintegererforderlich
≥ 1
articleIduuiderforderlich
articleNamestringoptional
Default: nullnullable
articleNumberstringoptional
Default: nullnullable
supplierArticleNumberstringoptional
max 200 ZeichenDefault: nullnullable
descriptionstringoptional
max 4000 ZeichenDefault: nullnullable
quantityOrderedstringerforderlich
Pattern
quantityReceivedstringoptional

Bisher gebuchte Wareneingangsmenge.

PatternDefault: "0"
unitPricestringerforderlich
Pattern
discountPercentstringoptional
PatternDefault: nullnullable
taxRatestringoptional

Steuersatz in Prozent (z.B. "19").

PatternDefault: nullnullable
totalNetstringoptional

Computed: quantityOrdered × unitPrice × (1 − discountPercent/100).

PatternDefault: nullnullable
currencyCodestringoptional
PatternDefault: "EUR"
totalNetstringoptional
PatternDefault: nullnullable
totalTaxstringoptional
PatternDefault: nullnullable
totalGrossstringoptional
PatternDefault: nullnullable
notestringoptional

Externe Notiz an den Lieferanten.

max 4000 ZeichenDefault: nullnullable
internalNotestringoptional

Interne Notiz (nicht Lieferanten-sichtbar).

max 4000 ZeichenDefault: nullnullable
cancelReasonstringoptional
max 1000 ZeichenDefault: nullnullable
confirmedAtdatetimeoptional
Default: nullnullable
confirmedBystringoptional
PatternDefault: nullnullable
cancelledAtdatetimeoptional
Default: nullnullable
cancelledBystringoptional
PatternDefault: nullnullable
_iduuidoptional
read-only
schemastringoptional
Werte
purchase_order
read-only
schemaVersionintegeroptional
≥ 1read-only
tenantIduuidoptional
read-only
versionintegeroptional
≥ 0read-only
createdAtdatetimeoptional
read-only
updatedAtdatetimeoptional
read-only
createdByuuidoptional
read-only
updatedBystringoptional
Patternread-onlynullable
deletedAtdatetimeoptional
read-onlynullable
deletedBystringoptional
Patternread-onlynullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/purchase_orders — Liste, paginiert + filterbar
  • GET /api/v1/purchase_orders/<id> — Einzelne Entity
  • POST /api/v1/purchase_orders — Anlegen
  • PATCH /api/v1/purchase_orders/<id> — Teil-Update
  • DELETE /api/v1/purchase_orders/<id> — Soft-Delete
  • GET /api/v1/purchase_orders/<id>/timeline — Audit + Aktivitäten

Suche