Order Proposals

Manage order proposals in VARIO Cloud via API, including suppliers, proposal lines, ordering decisions, background generation and order creation.

Bestellvorschläge

Find an existing Resource by identifier

get

Path parameters

idinteger · int64Required

an identifier

Responses

200

successful operation

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

priceRequestInsteadOfOrderbooleanRead-onlyOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

Default: false

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

Default: false

processedbooleanOptional

Wurde der Bestellvorschlag verarbeitet

Default: false

404

Resource with given ID was not found

application/json

get/erp/order-proposals/{id}

GET /erp/order-proposals/{id} HTTP/1.1
Host: api.example.com
Accept: */*

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "usedOrderProposalGenerateRequest": {
    "generateTemplateId": 1,
    "purchaseStorageId": 1,
    "supplierPreference": "CHEAPEST",
    "needsAssessmentPreference": "REORDER_POINT",
    "salesNeedsAssessmentBase": "ORDERS",
    "averageMethod": "ARITHMETIC_MEAN",
    "trimmingPercentage": 1,
    "recognizeReservations": false,
    "recognizeOrders": false,
    "recognizeStock": false,
    "productWideNeedAssessmentAndOrder": false,
    "recognizeFabricationComponentBookings": false,
    "numberOfDaysToOrderFor": 1,
    "observationPeriodInLastDays": 1,
    "observationPeriods": [],
    "recognizeNotYetApprovedPrePaymentReservations": false,
    "cutOffForOrderReservationRecognitionInDays": 1,
    "recognizeArticlesWithNeedsAssessmentOnlyOnReservationBasis": false,
    "givenSupplierAccountId": 1,
    "priceRequestInsteadOfOrder": false,
    "articlePresetId": 1,
    "productGroupIds": [
      1
    ],
    "responsibleUserId": 1,
    "supplierPresetId": 1,
    "supplierAccountIds": [
      1
    ]
  },
  "purchaseOrderStorageRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "priceRequestInsteadOfOrder": false,
  "triggerMailOutputAfterDocumentCreation": false,
  "processed": false,
  "orderProposalSuppliers": []
}

Update existing Resource

put

Path parameters

idinteger · int64Required

an identifier

Body

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

priceRequestInsteadOfOrderbooleanRead-onlyOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

Default: false

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

Default: false

processedbooleanOptional

Wurde der Bestellvorschlag verarbeitet

Default: false

Responses

200

successful operation

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

priceRequestInsteadOfOrderbooleanRead-onlyOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

Default: false

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

Default: false

processedbooleanOptional

Wurde der Bestellvorschlag verarbeitet

Default: false

404

Resource was not found

application/json

422

Resource was not valid to process

application/json

put/erp/order-proposals/{id}

PUT /erp/order-proposals/{id} HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 1012

{
  "version": "text",
  "info": {},
  "id": "text",
  "usedOrderProposalGenerateRequest": {
    "generateTemplateId": 1,
    "purchaseStorageId": 1,
    "supplierPreference": "CHEAPEST",
    "needsAssessmentPreference": "REORDER_POINT",
    "salesNeedsAssessmentBase": "ORDERS",
    "averageMethod": "ARITHMETIC_MEAN",
    "trimmingPercentage": 1,
    "recognizeReservations": false,
    "recognizeOrders": false,
    "recognizeStock": false,
    "productWideNeedAssessmentAndOrder": false,
    "recognizeFabricationComponentBookings": false,
    "numberOfDaysToOrderFor": 1,
    "observationPeriodInLastDays": 1,
    "observationPeriods": [],
    "recognizeNotYetApprovedPrePaymentReservations": false,
    "cutOffForOrderReservationRecognitionInDays": 1,
    "recognizeArticlesWithNeedsAssessmentOnlyOnReservationBasis": false,
    "givenSupplierAccountId": 1,
    "priceRequestInsteadOfOrder": false,
    "articlePresetId": 1,
    "productGroupIds": [
      1
    ],
    "responsibleUserId": 1,
    "supplierPresetId": 1,
    "supplierAccountIds": [
      1
    ]
  },
  "purchaseOrderStorageRef": {
    "id": "text"
  },
  "triggerMailOutputAfterDocumentCreation": false,
  "processed": false,
  "orderProposalSuppliers": []
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "usedOrderProposalGenerateRequest": {
    "generateTemplateId": 1,
    "purchaseStorageId": 1,
    "supplierPreference": "CHEAPEST",
    "needsAssessmentPreference": "REORDER_POINT",
    "salesNeedsAssessmentBase": "ORDERS",
    "averageMethod": "ARITHMETIC_MEAN",
    "trimmingPercentage": 1,
    "recognizeReservations": false,
    "recognizeOrders": false,
    "recognizeStock": false,
    "productWideNeedAssessmentAndOrder": false,
    "recognizeFabricationComponentBookings": false,
    "numberOfDaysToOrderFor": 1,
    "observationPeriodInLastDays": 1,
    "observationPeriods": [],
    "recognizeNotYetApprovedPrePaymentReservations": false,
    "cutOffForOrderReservationRecognitionInDays": 1,
    "recognizeArticlesWithNeedsAssessmentOnlyOnReservationBasis": false,
    "givenSupplierAccountId": 1,
    "priceRequestInsteadOfOrder": false,
    "articlePresetId": 1,
    "productGroupIds": [
      1
    ],
    "responsibleUserId": 1,
    "supplierPresetId": 1,
    "supplierAccountIds": [
      1
    ]
  },
  "purchaseOrderStorageRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "priceRequestInsteadOfOrder": false,
  "triggerMailOutputAfterDocumentCreation": false,
  "processed": false,
  "orderProposalSuppliers": []
}

Delete an existing Resource

delete

Path parameters

idinteger · int64Required

an identifier

Responses

200

successful operation

application/json

contextstringOptional

message context

messageValuestringOptional

message

404

Resource was not found

application/json

409

unable to delete Resource, due to constraints, existing references or internal state

application/json

delete/erp/order-proposals/{id}

DELETE /erp/order-proposals/{id} HTTP/1.1
Host: api.example.com
Accept: */*

{
  "context": "text",
  "messageValue": "text"
}

put

Path parameters

idinteger · int64Required

order-proposal-line-idinteger · int64Required

Body

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

orderProposalIdstringRead-onlyOptional

Bestellvorschlag

proposedOrderAmountnumberRequired

vorgeschlagene zu bestellende Menge

Example: 19

toBeOrderedAmountnumberRequired

tatsächlich zu bestellende Menge

Example: 18

priceTotalnumberRead-onlyOptional

kalkulierter Gesamtpreis

determinedUnitPricenumberRead-onlyOptional

ermittelter Einzelpreis

negotiatedUnitPricenumberOptional

verhandelter Einzelpreis

totalPricenumberRead-onlyOptional

Gesamtpreis

deliveryTimeinteger · int32Read-onlyOptional

Lieferzeit

toBeOrderedbooleanOptional

Responses

200

OK

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

orderProposalIdstringRead-onlyOptional

Bestellvorschlag

proposedOrderAmountnumberRequired

vorgeschlagene zu bestellende Menge

Example: 19

toBeOrderedAmountnumberRequired

tatsächlich zu bestellende Menge

Example: 18

priceTotalnumberRead-onlyOptional

kalkulierter Gesamtpreis

determinedUnitPricenumberRead-onlyOptional

ermittelter Einzelpreis

negotiatedUnitPricenumberOptional

verhandelter Einzelpreis

totalPricenumberRead-onlyOptional

Gesamtpreis

deliveryTimeinteger · int32Read-onlyOptional

Lieferzeit

toBeOrderedbooleanOptional

put/erp/order-proposals/{id}/order-proposals/{order-proposal-line-id}

PUT /erp/order-proposals/{id}/order-proposals/{order-proposal-line-id} HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 287

{
  "version": "text",
  "info": {},
  "id": "text",
  "articleRef": {
    "id": "text"
  },
  "supplierAccountRef": {
    "id": "text"
  },
  "orderUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "proposedOrderAmount": 19,
  "toBeOrderedAmount": 18,
  "negotiatedUnitPrice": 1,
  "orderDocumentLineRef": {
    "id": "text"
  },
  "toBeOrdered": true
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "orderProposalId": "text",
  "articleRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "supplierAccountRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "orderUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "proposedOrderAmount": 19,
  "toBeOrderedAmount": 18,
  "priceTotal": 1,
  "productPrices": [],
  "productDiscounts": [],
  "determinedUnitPrice": 1,
  "negotiatedUnitPrice": 1,
  "totalPrice": 1,
  "deliveryTime": 1,
  "orderDocumentLineRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "toBeOrdered": true
}

delete

Path parameters

idinteger · int64Required

order-proposal-line-idinteger · int64Required

Responses

200

OK

application/json

contextstringOptional

message context

messageValuestringOptional

message

delete/erp/order-proposals/{id}/order-proposals/{order-proposal-line-id}

DELETE /erp/order-proposals/{id}/order-proposals/{order-proposal-line-id} HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

put

Path parameters

idinteger · int64Required

order-proposal-supplier-idinteger · int64Required

Body

Bestellvorschlag-Lieferanten-Beziehungen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

supplierIdstringOptional

ID des Lieferanten

priceRequestInsteadOfOrderbooleanOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

toBeOrderedbooleanOptional

Responses

200

OK

application/json

Bestellvorschlag-Lieferanten-Beziehungen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

supplierIdstringOptional

ID des Lieferanten

priceRequestInsteadOfOrderbooleanOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

toBeOrderedbooleanOptional

put/erp/order-proposals/{id}/order-proposal-suppliers/{order-proposal-supplier-id}

PUT /erp/order-proposals/{id}/order-proposal-suppliers/{order-proposal-supplier-id} HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 275

{
  "version": "text",
  "info": {},
  "id": "text",
  "supplierId": "text",
  "priceRequestInsteadOfOrder": true,
  "triggerMailOutputAfterDocumentCreation": true,
  "createdDocument": {
    "id": 1,
    "category": "CUSTOMER_OFFER",
    "documentType": "text",
    "documentState": "text",
    "number": "text"
  },
  "toBeOrdered": true
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "supplierId": "text",
  "priceRequestInsteadOfOrder": true,
  "triggerMailOutputAfterDocumentCreation": true,
  "createdDocument": {
    "id": 1,
    "category": "CUSTOMER_OFFER",
    "documentType": "text",
    "documentState": "text",
    "number": "text"
  },
  "toBeOrdered": true
}

delete

Path parameters

idinteger · int64Required

order-proposal-supplier-idinteger · int64Required

Responses

200

OK

application/json

contextstringOptional

message context

messageValuestringOptional

message

delete/erp/order-proposals/{id}/order-proposal-suppliers/{order-proposal-supplier-id}

DELETE /erp/order-proposals/{id}/order-proposal-suppliers/{order-proposal-supplier-id} HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

Create new Resource

post

Body

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

priceRequestInsteadOfOrderbooleanRead-onlyOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

Default: false

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

Default: false

processedbooleanOptional

Wurde der Bestellvorschlag verarbeitet

Default: false

Responses

200

successful operation

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

priceRequestInsteadOfOrderbooleanRead-onlyOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

Default: false

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

Default: false

processedbooleanOptional

Wurde der Bestellvorschlag verarbeitet

Default: false

422

Resource was not valid to process

application/json

post/erp/order-proposals

POST /erp/order-proposals HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 1012

{
  "version": "text",
  "info": {},
  "id": "text",
  "usedOrderProposalGenerateRequest": {
    "generateTemplateId": 1,
    "purchaseStorageId": 1,
    "supplierPreference": "CHEAPEST",
    "needsAssessmentPreference": "REORDER_POINT",
    "salesNeedsAssessmentBase": "ORDERS",
    "averageMethod": "ARITHMETIC_MEAN",
    "trimmingPercentage": 1,
    "recognizeReservations": false,
    "recognizeOrders": false,
    "recognizeStock": false,
    "productWideNeedAssessmentAndOrder": false,
    "recognizeFabricationComponentBookings": false,
    "numberOfDaysToOrderFor": 1,
    "observationPeriodInLastDays": 1,
    "observationPeriods": [],
    "recognizeNotYetApprovedPrePaymentReservations": false,
    "cutOffForOrderReservationRecognitionInDays": 1,
    "recognizeArticlesWithNeedsAssessmentOnlyOnReservationBasis": false,
    "givenSupplierAccountId": 1,
    "priceRequestInsteadOfOrder": false,
    "articlePresetId": 1,
    "productGroupIds": [
      1
    ],
    "responsibleUserId": 1,
    "supplierPresetId": 1,
    "supplierAccountIds": [
      1
    ]
  },
  "purchaseOrderStorageRef": {
    "id": "text"
  },
  "triggerMailOutputAfterDocumentCreation": false,
  "processed": false,
  "orderProposalSuppliers": []
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "usedOrderProposalGenerateRequest": {
    "generateTemplateId": 1,
    "purchaseStorageId": 1,
    "supplierPreference": "CHEAPEST",
    "needsAssessmentPreference": "REORDER_POINT",
    "salesNeedsAssessmentBase": "ORDERS",
    "averageMethod": "ARITHMETIC_MEAN",
    "trimmingPercentage": 1,
    "recognizeReservations": false,
    "recognizeOrders": false,
    "recognizeStock": false,
    "productWideNeedAssessmentAndOrder": false,
    "recognizeFabricationComponentBookings": false,
    "numberOfDaysToOrderFor": 1,
    "observationPeriodInLastDays": 1,
    "observationPeriods": [],
    "recognizeNotYetApprovedPrePaymentReservations": false,
    "cutOffForOrderReservationRecognitionInDays": 1,
    "recognizeArticlesWithNeedsAssessmentOnlyOnReservationBasis": false,
    "givenSupplierAccountId": 1,
    "priceRequestInsteadOfOrder": false,
    "articlePresetId": 1,
    "productGroupIds": [
      1
    ],
    "responsibleUserId": 1,
    "supplierPresetId": 1,
    "supplierAccountIds": [
      1
    ]
  },
  "purchaseOrderStorageRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "priceRequestInsteadOfOrder": false,
  "triggerMailOutputAfterDocumentCreation": false,
  "processed": false,
  "orderProposalSuppliers": []
}

post

Path parameters

idinteger · int64Required

supplier-idinteger · int64Required

Responses

200

OK

No content

post/erp/order-proposals/{id}/suppliers/{supplier-id}/setProposalLinesToBeOrdered

POST /erp/order-proposals/{id}/suppliers/{supplier-id}/setProposalLinesToBeOrdered HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

No content

post

Path parameters

idinteger · int64Required

supplier-idinteger · int64Required

Responses

200

OK

No content

post/erp/order-proposals/{id}/suppliers/{supplier-id}/setProposalLinesToBeNotOrdered

POST /erp/order-proposals/{id}/suppliers/{supplier-id}/setProposalLinesToBeNotOrdered HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

No content

post

Path parameters

idinteger · int64Required

Responses

200

OK

application/json

contextstringOptional

message context

messageValuestringOptional

message

post/erp/order-proposals/{id}/perform-create-orders

POST /erp/order-proposals/{id}/perform-create-orders HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

post

Path parameters

idinteger · int64Required

Body

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

orderProposalIdstringRead-onlyOptional

Bestellvorschlag

proposedOrderAmountnumberRequired

vorgeschlagene zu bestellende Menge

Example: 19

toBeOrderedAmountnumberRequired

tatsächlich zu bestellende Menge

Example: 18

priceTotalnumberRead-onlyOptional

kalkulierter Gesamtpreis

determinedUnitPricenumberRead-onlyOptional

ermittelter Einzelpreis

negotiatedUnitPricenumberOptional

verhandelter Einzelpreis

totalPricenumberRead-onlyOptional

Gesamtpreis

deliveryTimeinteger · int32Read-onlyOptional

Lieferzeit

toBeOrderedbooleanOptional

Responses

200

OK

application/json

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

priceRequestInsteadOfOrderbooleanRead-onlyOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

Default: false

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

Default: false

processedbooleanOptional

Wurde der Bestellvorschlag verarbeitet

Default: false

post/erp/order-proposals/{id}/order-proposals

POST /erp/order-proposals/{id}/order-proposals HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 287

{
  "version": "text",
  "info": {},
  "id": "text",
  "articleRef": {
    "id": "text"
  },
  "supplierAccountRef": {
    "id": "text"
  },
  "orderUnit": {
    "id": 1,
    "name": "text",
    "abbreviation": "text"
  },
  "proposedOrderAmount": 19,
  "toBeOrderedAmount": 18,
  "negotiatedUnitPrice": 1,
  "orderDocumentLineRef": {
    "id": "text"
  },
  "toBeOrdered": true
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "usedOrderProposalGenerateRequest": {
    "generateTemplateId": 1,
    "purchaseStorageId": 1,
    "supplierPreference": "CHEAPEST",
    "needsAssessmentPreference": "REORDER_POINT",
    "salesNeedsAssessmentBase": "ORDERS",
    "averageMethod": "ARITHMETIC_MEAN",
    "trimmingPercentage": 1,
    "recognizeReservations": false,
    "recognizeOrders": false,
    "recognizeStock": false,
    "productWideNeedAssessmentAndOrder": false,
    "recognizeFabricationComponentBookings": false,
    "numberOfDaysToOrderFor": 1,
    "observationPeriodInLastDays": 1,
    "observationPeriods": [],
    "recognizeNotYetApprovedPrePaymentReservations": false,
    "cutOffForOrderReservationRecognitionInDays": 1,
    "recognizeArticlesWithNeedsAssessmentOnlyOnReservationBasis": false,
    "givenSupplierAccountId": 1,
    "priceRequestInsteadOfOrder": false,
    "articlePresetId": 1,
    "productGroupIds": [
      1
    ],
    "responsibleUserId": 1,
    "supplierPresetId": 1,
    "supplierAccountIds": [
      1
    ]
  },
  "purchaseOrderStorageRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "priceRequestInsteadOfOrder": false,
  "triggerMailOutputAfterDocumentCreation": false,
  "processed": false,
  "orderProposalSuppliers": []
}

post

Path parameters

idinteger · int64Required

Body

Bestellvorschlag-Lieferanten-Beziehungen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

supplierIdstringOptional

ID des Lieferanten

priceRequestInsteadOfOrderbooleanOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

toBeOrderedbooleanOptional

Responses

200

OK

application/json

Bestellvorschlag-Lieferanten-Beziehungen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

supplierIdstringOptional

ID des Lieferanten

priceRequestInsteadOfOrderbooleanOptional

Soll eine Preisanfrage erstellt werden anstatt einer Bestellung

triggerMailOutputAfterDocumentCreationbooleanOptional

Soll die erstellte Bestellung direkt per Mail versandt werden

toBeOrderedbooleanOptional

post/erp/order-proposals/{id}/order-proposal-suppliers

POST /erp/order-proposals/{id}/order-proposal-suppliers HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 275

{
  "version": "text",
  "info": {},
  "id": "text",
  "supplierId": "text",
  "priceRequestInsteadOfOrder": true,
  "triggerMailOutputAfterDocumentCreation": true,
  "createdDocument": {
    "id": 1,
    "category": "CUSTOMER_OFFER",
    "documentType": "text",
    "documentState": "text",
    "number": "text"
  },
  "toBeOrdered": true
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "supplierId": "text",
  "priceRequestInsteadOfOrder": true,
  "triggerMailOutputAfterDocumentCreation": true,
  "createdDocument": {
    "id": 1,
    "category": "CUSTOMER_OFFER",
    "documentType": "text",
    "documentState": "text",
    "number": "text"
  },
  "toBeOrdered": true
}

post

Body

Infos zur Erzeugung eines Bestellvorschlags

generateTemplateIdinteger · int64Optional

Template Vorlage

purchaseStorageIdinteger · int64Required

ID des Bestell-Lagers

supplierPreferencestring · enumRequired

Lieferanten-Präferenz

Possible values:

needsAssessmentPreferencestring · enumRequired

Art der Bedarfsermittlung

Possible values:

salesNeedsAssessmentBasestring · enumOptional

Grundlage für die SALES-Bedarfsermittlung

Possible values:

averageMethodstring · enumOptional

Mittelwertverfahren für die SALES-Bedarfsermittlung

Possible values:

trimmingPercentagenumberOptional

Trim-Prozentsatz pro Seite, 0 bis < 50 (Pflichtfeld bei TRIMMED_MEAN)

recognizeReservationsbooleanOptional

Reservierungen beachten für zu bestellende Menge

Default: false

recognizeOrdersbooleanOptional

Bestellungen beachten für zu bestellende Menge

Default: false

recognizeStockbooleanOptional

Lagerbestand beachten für zu bestellende Menge

Default: false

productWideNeedAssessmentAndOrderbooleanOptional

Produktweite Bedarfsermittlung und Bestellung über alle Gebinde des Produkts

Default: false

recognizeFabricationComponentBookingsbooleanOptional

Material-Abgänge aus Produktion (netto) zusätzlich zum Sales-Verbrauch zählen (nur SALES)

Default: false

numberOfDaysToOrderForinteger · int32Optional

Anzahl Tage, für die bestellt werden soll

observationPeriodInLastDaysinteger · int32Optional

Beobachtungszeitraum in Tagen rückwirkend ab heute (Alternative zu observationPeriods)

recognizeNotYetApprovedPrePaymentReservationsbooleanOptional

Noch nicht zur Lieferung freigegebene Vorkasse-Reservierungen beachten

Default: false

cutOffForOrderReservationRecognitionInDaysinteger · int32Optional

Stichtag-Einschränkung für die Reservierungsberücksichtigung in Tagen

recognizeArticlesWithNeedsAssessmentOnlyOnReservationBasisbooleanOptional

Artikel mit Bedarfsermittlung nur auf Reservierungsbasis berücksichtigen

Default: false

givenSupplierAccountIdinteger · int64Optional

ID des Vorgabe-Lieferanten-Accounts

priceRequestInsteadOfOrderbooleanOptional

Anfrage statt Bestellung erzeugen

Default: false

articlePresetIdinteger · int64Optional

ID eines CUnit-Query-Presets zur Einschränkung der Artikel

productGroupIdsinteger · int64[]Optional

IDs der Warengruppen, auf die die Artikelauswahl eingeschränkt werden soll

responsibleUserIdinteger · int64Optional

ID des zuständigen Mitarbeiters, auf den die Artikelauswahl eingeschränkt werden soll

supplierPresetIdinteger · int64Optional

ID eines CUnit-Query-Presets zur Einschränkung der Lieferanten

supplierAccountIdsinteger · int64[]Optional

IDs der Lieferanten-Accounts, auf die der Bestellvorschlag eingeschränkt wird

Responses

200

OK

application/json

contextstringOptional

message context

messageValuestringOptional

message

post/erp/order-proposals/generate-background

POST /erp/order-proposals/generate-background HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 803

{
  "generateTemplateId": 1,
  "purchaseStorageId": 1,
  "supplierPreference": "CHEAPEST",
  "needsAssessmentPreference": "REORDER_POINT",
  "salesNeedsAssessmentBase": "ORDERS",
  "averageMethod": "ARITHMETIC_MEAN",
  "trimmingPercentage": 1,
  "recognizeReservations": false,
  "recognizeOrders": false,
  "recognizeStock": false,
  "productWideNeedAssessmentAndOrder": false,
  "recognizeFabricationComponentBookings": false,
  "numberOfDaysToOrderFor": 1,
  "observationPeriodInLastDays": 1,
  "observationPeriods": [],
  "recognizeNotYetApprovedPrePaymentReservations": false,
  "cutOffForOrderReservationRecognitionInDays": 1,
  "recognizeArticlesWithNeedsAssessmentOnlyOnReservationBasis": false,
  "givenSupplierAccountId": 1,
  "priceRequestInsteadOfOrder": false,
  "articlePresetId": 1,
  "productGroupIds": [
    1
  ],
  "responsibleUserId": 1,
  "supplierPresetId": 1,
  "supplierAccountIds": [
    1
  ]
}

200

OK

{
  "context": "text",
  "messageValue": "text"
}