Release a reviewed draft invoice or credit note (tenant:trade:invoice:issue)
POST /api/trade/v1/sales/transactions/{id}/release
Module: Trade · operationId: releaseTransaction · Tag: Transactions · Auth: access token (Authorization: Bearer <accessToken>)
Issues a DRAFT invoice or credit note: it becomes SENT. A draft another module made
(numberPending: true, e.g. a project invoice of desk) now takes the next gapless number of the
tenant (RE-2026-00001), is dated today (Europe/Berlin) and gets its due date from its net days, so a
discarded draft never leaves a gap. A final invoice is released only while the interim invoices it
deducts are released and not revoked. Writes the protocol entry RELEASED and the event
trade.invoice.released. No request body.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Responses
- 200 The transaction (
application/json) - 401 No valid session or bearer token (no body).
- 404 Not found in the tenant. (
application/json) - 409
not_releasable: not a draft invoice or credit note;deduction_not_released: a deducted interim invoice is no longer released. (application/json) - 423 An active workflow locks the transaction. (
application/json)
Fields of the 200 answer:
addressId(string (uuid)): Masterdata address of the partner.createdAt(string (date-time), read-only): When the transaction was created.currency(string): ISO 4217; EUR when empty.customerNo(string, read-only): Customer number of the tenant.deliveryDate(string (date-time)): Delivery date.documentDate(string (date-time)): Today when empty on create.documentRefId(string (uuid)): DMS document of the transaction.dueDate(string (date-time)): Due date.eInvoiceValidation(object, read-only): The newest e-invoice check of the document (details:getInvoiceValidation). Set only for invoices and credit notes, only on reads (listTransactions,getTransaction), and absent when no check ran.error(string, read-only): Error of the last processing (e.g. of an inbound invoice).exchangeRate(number): 1 when empty.externalTransactionNumber(string): The other party's number: the supplier's invoice number (inbound invoices) or order confirmation number (purchase orders; only there it is written through this API).footerText(string): Text printed below the lines.frozenSnapshot(object, read-only): Evidence copy of an accepted offer; written once.grossTotal(number, read-only): Gross total, computed from the lines.headerText(string): Text printed above the lines.id(string (uuid), read-only): Id of the transaction.items(array of TransactionLine): Lines; on update they replace all lines when present.name(string, required): Name of the article or line.quantity(number, required): Quantity.articleNumber(string): Article number in masterdata.createdAt(string (date-time), read-only): When the line was created.description(string): Description of the line.discountPercent(number): Discount in percent.ean(string): EAN (GTIN) of the article.id(string (uuid), read-only): Id of the line.isOptional(boolean): The line is optional (position typeoptional).isSelected(boolean): Selected optional lines count in the totals.lineData(object): Facts of the line by type (e.g. serial numbers, sources).mpn(string): Manufacturer part number.parentItemId(string (uuid)): Line this line belongs to (e.g. a component of a bundle).positionNumber(integer, read-only): Set from the order ofitems.positionType(PositionType): Empty isnormal; the totals countnormallines and selectedoptionallines. (one ofnormal,optional,title,subtotal,text)predecessorLineId(string (uuid), read-only): The line of the previous version.productId(string (uuid)): Masterdata article (product) id.sortOrder(integer): Sort order (ascending).sourceLineId(string (uuid), read-only): Line this one was made from (order line of a delivery note or draft invoice, invoice line of a credit note). Set by the system; a value sent by a client is dropped.taxRate(number): Percent.totalPriceGross(number, read-only): Gross total of the line, computed.totalPriceNet(number, read-only): Net total of the line, computed.transactionId(string (uuid), read-only): Id of the transaction.unit(string): Unit of measure.unitPriceNet(number): Negative for a credit position.updatedAt(string (date-time), read-only): When the line was last changed.
metadata(object):metadata.workflowis owned by the workflow module and kept on every write.netDays(integer): Days until the net amount is due.netTotal(number, read-only): Computed from the lines.numberPending(boolean, read-only): A draft invoice or credit note another module made:transactionNumberis its id untilreleaseTransactiongives it the gapless number. Edits keep its number and status.opportunityId(string (uuid)): The crm opportunity the document was made for. Only the format is checked (400invalid,fieldopportunityId). A document made from another one (sourceTransactionId, e.g. the order of an accepted offer) inherits it; an update without it keeps the stored one. Carried in the eventstrade.transaction.*andtrade.offer.accepted.partnerReference(string): The partner's order reference (BT-13).paymentMethodCode(string): Code of the payment method in masterdata.paymentTermCode(string): Code of the payment terms: a snapshot taken when the document is made.paymentTermsText(string): Payment terms as printed text.predecessorId(string (uuid)): Previous version of the same document.recipientAddress(object): Address snapshot of the partner.recipientCompany(string): Company of the recipient.recipientEmail(string): E-mail of the recipient.recipientName(string): Name of the recipient.skontoDays1(integer): Days of the first cash discount.skontoDays2(integer): Days of the second cash discount.skontoRate1(number): Rate in percent of the first cash discount.skontoRate2(number): Rate in percent of the second cash discount.sourceKind(string): Where it came from:MANUAL(default),PORTAL, or the e-invoice/OCR kind of inbound invoices.sourceTransactionId(string (uuid)): Document this one was made from.status(TransactionStatus): Sales statuses areDRAFT,SENT,ACCEPTED,EXPIRED,REVOKED,CONVERTED; delivery notes made from an order areDELIVEREDorCANCELLED; issued invoices and credit notes areISSUED(set only byissueInvoiceDraft); purchase orders, goods receipts, inbound invoices and documents of the snapshot API use their own statuses (e.g.open,posted,MATCHED,issued).taxTotal(number, read-only): Tax total, computed from the lines.tenantName(string, read-only): Name of the tenant.transactionNumber(string): Assigned with the type's prefix when empty on create.transactionType(string): Code of a type of the tenant's catalogue; required on create.typeData(object): Facts of exactly one type (e.g.extractionof inbound invoices,acceptanceof accepted offers,sourcesof a draft invoice,correctedInvoiceandreturnToStockof a credit note,einvoiceof an issued invoice,dropShipDeliveryof a drop-ship delivery note,issueRefusal{reason,problems,at,mspInvoiceId} of a draft invoice whose issue the MSP poster refused – issuing it withissueInvoiceDraftmarks that MSP invoiceposted).updatedAt(string (date-time), read-only): When the transaction was last changed.validUntil(string (date-time)): Offers only.version(integer, read-only): Version of the document (createTransactionRevisionadds one).
Example 200 answer:
{
"addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c02",
"createdAt": "2026-11-03T06:00:00Z",
"currency": "EUR",
"customerNo": "99999",
"documentDate": "2026-11-19T00:00:00Z",
"dueDate": "2026-12-03T00:00:00Z",
"exchangeRate": 1,
"grossTotal": 568.82,
"headerText": "Fernwartung und Vor-Ort-Einsätze Oktober 2026",
"id": "5b8c9d0e-1f2a-4b3c-8d4e-6f7a8b9c0d01",
"items": [
{
"articleNumber": "DL-9002",
"id": "3a6b7c8d-9e0f-4a1b-8c2d-5e6f7a8b9c01",
"name": "Fernwartung je angefangene 15 Minuten",
"positionNumber": 1,
"positionType": "normal",
"quantity": 7,
"sortOrder": 1,
"taxRate": 19,
"totalPriceGross": 241.57,
"totalPriceNet": 203,
"transactionId": "5b8c9d0e-1f2a-4b3c-8d4e-6f7a8b9c0d01",
"unit": "STK",
"unitPriceNet": 29
},
{
"articleNumber": "DL-9001",
"id": "3a6b7c8d-9e0f-4a1b-8c2d-5e6f7a8b9c02",
"name": "Technikerstunde vor Ort",
"positionNumber": 2,
"positionType": "normal",
"quantity": 2,
"sortOrder": 2,
"taxRate": 19,
"totalPriceGross": 273.7,
"totalPriceNet": 230,
"transactionId": "5b8c9d0e-1f2a-4b3c-8d4e-6f7a8b9c0d01",
"unit": "STD",
"unitPriceNet": 115
},
{
"articleNumber": "DL-9004",
"id": "3a6b7c8d-9e0f-4a1b-8c2d-5e6f7a8b9c03",
"name": "Anfahrtspauschale Zone 1",
"positionNumber": 3,
"positionType": "normal",
"quantity": 1,
"sortOrder": 3,
"taxRate": 19,
"totalPriceGross": 53.55,
"totalPriceNet": 45,
"transactionId": "5b8c9d0e-1f2a-4b3c-8d4e-6f7a8b9c0d01",
"unit": "PAU",
"unitPriceNet": 45
}
],
"netDays": 14,
"netTotal": 478,
"numberPending": false,
"paymentTermCode": "14N",
"paymentTermsText": "14 Tage netto",
"recipientAddress": {
"city": "Regensburg",
"country": "DE",
"street": "Maximilianstraße 21",
"zip": "93047"
},
"recipientCompany": "Kanzlei Hofmann \u0026 Partner Rechtsanwälte mbB",
"recipientEmail": "f.pichler@hofmann-partner.example",
"recipientName": "Florian Pichler",
"sourceKind": "EXTERNAL",
"status": "SENT",
"taxTotal": 90.82,
"tenantName": "DEMO",
"transactionNumber": "RE-2026-0399",
"transactionType": "INVOICE",
"typeData": {
"externalReference": "desk:billing-run:2026-10:10002"
},
"updatedAt": "2026-11-19T08:40:00Z",
"version": 1
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/trade/v1/sales/transactions/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/release' \
-H "Authorization: Bearer $ACCESS_TOKEN"