Record an offer from snapshots (tenant:trade:sales:write)
POST /api/trade/v1/offers
Module: Trade · operationId: createIssuedOffer · Tag: Issued documents · Auth: access token (Authorization: Bearer <accessToken>)
Stores an OFFER with status open; totalAmount is stored as the net total. Publishes trade.offer.created.
Request body
application/json (required)
addressId(string (uuid)): Masterdata address of the customer.addressSnapshot(AddressSnapshot): Frozen copy of the partner address (GoBD).articleSnapshots(array of object): Lines as sent. Recognised keys:articleNumber,name,description,quantity(default 1),unit,unitPriceNet(orprice),discountPercent,taxRate; the entry is kept as sent.offerNumber(string): Number of the offer.totalAmount(number): Net total.
Example:
{
"addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c05",
"addressSnapshot": {
"city": "Neutraubling",
"companyName": "Donau Maschinenbau AG",
"country": "DE",
"street": "Werkstraße 100",
"zip": "93073"
},
"articleSnapshots": [
{
"articleNumber": "HW-1002",
"name": "Notebook EliteBook 860 G11, i7, 32 GB, 1 TB SSD",
"quantity": 4,
"taxRate": 19,
"unitPriceNet": 1699
},
{
"articleNumber": "HW-1004",
"name": "USB-C Dockingstation 100 W",
"quantity": 4,
"taxRate": 19,
"unitPriceNet": 189
}
],
"offerNumber": "AN-2026-0188",
"totalAmount": 7552
}
Responses
- 201 Recorded (
application/json) - 400 Error (
application/json) - 401 No valid session or bearer token (no body).
Fields of the 201 answer:
addressId(string): Masterdata address of the customer.addressSnapshot(AddressSnapshot): Frozen copy of the partner address (GoBD).articleSnapshots(array of object): Lines as sent. Recognised keys:articleNumber,name,description,quantity(default 1),unit,unitPriceNet(orprice),discountPercent,taxRate; the entry is kept as sent.createdAt(string (date-time)): When the offer was created.customerNo(string): Customer number of the tenant.id(string (uuid)): Id of the offer.offerNumber(string): Number of the offer.status(string): Status of the offer.tenantName(string): Name of the tenant.totalAmount(number): Total of the offer.
Example 201 answer:
{
"addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c05",
"addressSnapshot": {
"city": "Neutraubling",
"companyName": "Donau Maschinenbau AG",
"country": "DE",
"street": "Werkstraße 100",
"zip": "93073"
},
"articleSnapshots": [
{
"articleNumber": "HW-1002",
"name": "Notebook EliteBook 860 G11, i7, 32 GB, 1 TB SSD",
"quantity": 4,
"taxRate": 19,
"unitPriceNet": 1699
},
{
"articleNumber": "HW-1004",
"name": "USB-C Dockingstation 100 W",
"quantity": 4,
"taxRate": 19,
"unitPriceNet": 189
}
],
"createdAt": "2026-11-18T14:05:00Z",
"customerNo": "99999",
"id": "6d9e0f1a-2b3c-4d4e-8f5a-7b8c9d0e1f02",
"offerNumber": "AN-2026-0188",
"status": "open",
"tenantName": "DEMO",
"totalAmount": 7552
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/trade/v1/offers' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"addressId":"3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c05","addressSnapshot":{"city":"Neutraubling","companyName":"Donau Maschinenbau AG","country":"DE","street":"Werkstraße 100","zip":"93073"},"articleSnapshots":[{"articleNumber":"HW-1002","name":"Notebook EliteBook 860 G11, i7, 32 GB, 1 TB SSD","quantity":4,"taxRate":19,"unitPriceNet":1699},{"articleNumber":"HW-1004","name":"USB-C Dockingstation 100 W","quantity":4,"taxRate":19,"unitPriceNet":189}],"offerNumber":"AN-2026-0188","totalAmount":7552}'