Postings: add free posting
postings_add_freeAdd a free posting to the accounting system by specifying date, description, amount, debit and credit accounts, and VAT rate. Record journal entries directly.
Instructions
🟡 WRITE · creates data — Creates new records (receipts, transactions, postings, invoices, master data). Not idempotent — calling twice may create duplicates. add free posting Add a free posting.
Endpoint: POST /postings/add/free
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vat | Yes | The vat rate of the posting. Possible vats: - 0_none ('keine Ust.') - 19_vat ('19% Ust.') - 7_vat ('7% Ust.') - 19_pre ('19% Vst.') - 7_pre ('7% Vst.') - 19_both_1 ('§13b 19% USt./VSt.') - 19_both_2 ('I.g.E. 19% USt./VSt.') - 7_both ('I.g.E. 7% USt./VSt.') - 19_both_1_no_pre ('§13b 19/16% USt.') - 19_both_2_no_pre ('i.g.E. 19/16% USt.') - 7_both_no_pre ('i.g.E. 7/5% USt.') - 19_pre_app ('19/16% Aufz. VSt.') - 7_pre_app ('7/5% Aufz. VSt.') - 19_both_app_1 ('§13b 19/16% USt./Aufz. VSt.') - 19_both_app_2 ('i.g.E. 19/16% USt./Aufz. VSt.') - 7_both_app ('i.g.E. 7/5% USt./Aufz. VSt.') | |
| date | Yes | The date of the posting. | |
| amount | Yes | The amount of the posting. | |
| api_key | No | Optional. The BB customer api_key to act on. Defaults to the BB_API_KEY configured on the server — only set this to target a different customer. | |
| postingtext | Yes | The description of the posting. | |
| cost_location | No | The cost location number. If specified, field will be validated. | |
| cost_location_two | No | The cost location two number. If specified, field will be validated. | |
| postingaccount_debit | Yes | The debit account number of the posting. | |
| postingaccount_credit | Yes | The credit account number of the posting. |