Use case
The entrepreneur has two basement shops, two locations (cost centers). Daily cash sales are imported for accounting as voucher (ledger receipt). Sales are divided by different locations (location = cost center = dimension).
In example some custom-specified accounts are used alongside Procountor’s default accounts. No cash report attached.
Used endpoints
GET /dimensions endpoint fetches dimensions and items of used dimensions. Dimensions and items are handled by their unique (database) ids in Procountor API. Ids need to be mapped with other system’s cost centers.
POST /ledgerreceipts endpoint creates a new voucher (ledgerReceipt in API). Status of new ledger receipt is always “UNFINISHED”. The ledger receipt can be also approved via Procountor API by using PUT /ledgerreceipts/{receiptId}/approve endpoint.
Example posting a ledger receipt of daily cash sales by different accounts receivables. Debit transactions as positive, credit transactions as negative. Total of receipts should be zero, but some rounding / reconciliations may occur.
{
"type": "JOURNAL",
"status": "UNFINISHED",
"name": "Cash sales (daily)",
"receiptDate": "2025-10-01",
"vatType": "SALES",
"vatProcessing": "FINLAND",
"vatStatus": 1,
"accountantsNotes": "Daily cash sales based on data from cash software",
"transactions": [
{
"transactionType": "ENTRY",
"account": "1700",
"accountingValue": 195.42,
"vatPercent": 0.0,
"vatType": "SALES",
"vatStatus": 12,
"description": "1700 / Accounts receivable",
"dimensionItemValues": [
{
"dimensionId": 279751,
"itemId": 777728,
"value": 195.42
}
],
"vatDeductionPercent": 100.0
},
{
"transactionType": "ENTRY",
"account": "1701",
"accountingValue": 2666.62,
"vatPercent": 0.0,
"vatType": "SALES",
"vatStatus": 12,
"description": "1701 / Bank card receivable",
"dimensionItemValues": [
{
"dimensionId": 279751,
"itemId": 777728,
"value": 2666.62
}
],
"vatDeductionPercent": 100.0
},
{
"transactionType": "ENTRY",
"account": "1702",
"accountingValue": 706.18,
"vatPercent": 0.0,
"vatType": "SALES",
"vatStatus": 12,
"description": "1702 / Credit card receivable",
"dimensionItemValues": [
{
"dimensionId": 279751,
"itemId": 777730,
"value": 706.18
}
],
"vatDeductionPercent": 100.0
},
{
"transactionType": "ENTRY",
"account": "3001",
"accountingValue": -121.3,
"vatPercent": 25.5,
"vatType": "SALES",
"vatStatus": 1,
"description": "3001 / Stuff sales",
"dimensionItemValues": [
{
"dimensionId": 279751,
"itemId": 777728,
"value": -121.3
}
],
"vatDeductionPercent": 100.0
},
{
"transactionType": "ENTRY",
"account": "3005",
"accountingValue": -2350.45,
"vatPercent": 14.0,
"vatType": "SALES",
"vatStatus": 1,
"description": "3005 / Food sales",
"dimensionItemValues": [
{
"dimensionId": 279751,
"itemId": 777730,
"value": -2350.45
}
],
"vatDeductionPercent": 100.0
},
{
"transactionType": "ENTRY",
"account": "3010",
"accountingValue": -507.5,
"vatPercent": 25.5,
"vatType": "SALES",
"vatStatus": 1,
"description": "3010 / Alcoholic beverages",
"dimensionItemValues": [
{
"dimensionId": 279751,
"itemId": 777730,
"value": -507.5
}
],
"vatDeductionPercent": 100.0
},
{
"transactionType": "ENTRY",
"account": "3015",
"accountingValue": -34.0,
"vatPercent": 0.0,
"vatType": "SALES",
"vatStatus": 12,
"description": "3015 / Stamp sales",
"dimensionItemValues": [
{
"dimensionId": 279751,
"itemId": 777728,
"value": -34.0
}
],
"vatDeductionPercent": 100.0
},
{
"transactionType": "ENTRY",
"account": "3020",
"accountingValue": -75.0,
"vatPercent": 0.0,
"vatType": "SALES",
"vatStatus": 12,
"description": "3020 / Lottery sales",
"dimensionItemValues": [
{
"dimensionId": 279751,
"itemId": 777728,
"value": -75.0
}
],
"vatDeductionPercent": 100.0
}
]
}The id of saved ledger receipt is useful to be stored. By using the id of ledger receipt, you can search, update or invalidate it later via API if needed.
Other information
Chart of accounts is available via Procountor API
GET /coa
Used VAT status codes are available via Procountor API
GET /vats/default
