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

Material Bucket Schema

Schema-ID
material_bucket
Collection
material_buckets
Permissions
  • Lesenmaterial_bucket_view
  • Anlegenmaterial_bucket_create
  • Ändernmaterial_bucket_edit
  • Löschenmaterial_bucket_delete

Felder

Material Bucket Schema

material_buckets4 Permissions

Schema for validating material bucket entities (Lagertool / Wegfahr-Buckets)

statusstringerforderlich

OPEN = aktiv, CLOSED = abgeschlossen

Werte
OPENCLOSED
Default: "OPEN"
bucketNumberstringoptional

Auto-generated sequence number (e.g. M-2026-00001)

max 30 Zeichenread-only
descriptionstringoptional

Optional description / Beschreibung

max 2000 Zeichennullable
partyIduuidoptional

Linked customer (Party UUID)

nullable
ticketIduuidoptional

Linked ticket UUID

nullable
projectIduuidoptional

Linked project UUID

nullable
partyNamestringoptional

Denormalized customer name

max 300 Zeichennullable
ticketNumberstringoptional

Denormalized ticket number

max 30 Zeichennullable
projectNumberstringoptional

Denormalized project number

max 30 Zeichennullable
assignedToIduuidoptional

Technician user ID who owns this bucket

nullable
closedAtdatetimeoptional

Timestamp when bucket was closed

nullable
closedByuuidoptional

User ID who closed the bucket

nullable
itemsobject[]optional

Scanned / added material items

Default: []
iduuiderforderlich

Unique item ID (UUIDv7)

articleIdstringerforderlich

Reference to the source article (local UUID or weclapp article id)

1–64 Zeichen
articleNumberstringoptional

Denormalized article number

max 50 Zeichennullable
namestringerforderlich

Denormalized article name

max 300 Zeichen
skustringoptional

Denormalized EAN / SKU

max 50 Zeichennullable
quantityintegererforderlich

Quantity (locked to 1 when serialNumber is set)

≥ 1Default: 1
serialNumberstringoptional

Serial number (if set, quantity must be 1)

max 100 Zeichennullable
notesstringoptional

Optional notes for this item

max 1000 Zeichennullable
billedAtdatetimeoptional

Timestamp when bucket was billed

nullable
billedByuuidoptional

User ID who billed the bucket

nullable
invoiceIduuidoptional

Invoice UUID generated from this bucket

nullable
tagsstring[]optional

Tags for categorization

Default: []

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

Suche