Create invoice

POST/v1/invoices

Create a new invoice in the active tenant.

Datenmodell

Diese Operation arbeitet auf der Entität Invoice (invoice). Alle 48 Felder — Typ, Validierung, Pflichtangabe, Beziehungen — stehen in der Schema-Referenz.

Pflichtfelder: partyId, status
Server-verwaltet: _id, schema, schemaVersion, tenantId, version, createdAt, updatedAt, createdBy, updatedBy, deletedAt, deletedBy, invoiceNumber, lockedAt, lockedBy, contentHash, recordAddressSnapshot, deliveryAddressSnapshot, weclappId, weclappBaseUrl, externalVersion, syncedAt, customerPaymentReportedAt, customerPaymentReportedBy, customerPaymentReference, projectId — diese Felder vergibt die Plattform; im Request werden sie verworfen.

Request Body

Name	Typ	Beschreibung
`partyId`erforderlich	`string`
`invoiceDate`	`string<date>`
`dueDate`	`string<date>`
`paymentTermsDays`	`integer`
`defaultVatRate`	`string`
`source`	`string`
`salesOrderId`	`string`
`introText`	`string`
`closingText`	`string`
`note`	`string`
`items`erforderlich	`object[]`

Beispiel

curl -X POST https://api.codemeta-os.de/v1/invoices \
  -H "X-Tenant-Id: $TENANT" \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
  "partyId": "string",
  "invoiceDate": "string",
  "dueDate": "string",
  "paymentTermsDays": 0,
  "defaultVatRate": "string",
  "source": "MANUAL",
  "salesOrderId": "string",
  "introText": "string",
  "closingText": "string",
  "note": "string",
  "items": []
}'

const result = await cm.invoices.post({
  "partyId": "string",
  "invoiceDate": "string",
  "dueDate": "string",
  "paymentTermsDays": 0,
  "defaultVatRate": "string",
  "source": "MANUAL",
  "salesOrderId": "string",
  "introText": "string",
  "closingText": "string",
  "note": "string",
  "items": []
});

Antwortcodes

HTTP	Bedeutung
`201`	Default Response