cURL
curl --request POST \
--url https://api.maesn.dev/accounting/journalEntries \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form files=@example-file \
--form filesPos=123 \
--form 'journal_entry={
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2021-06",
"accountingReason": "COMMERCIAL",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"exchangeRate": "1,2045",
"isProvisional": "false",
"isReversal": false,
"journalLineItems": [
{
"id": "123f57fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountCode": "4034",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountNumber": "1200",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"recordType": "STANDARD",
"transactionDate": "2021-01-01T00:00:00Z",
"version": "AAAAACnY3os1"
}'import requests
url = "https://api.maesn.dev/accounting/journalEntries"
files = { "files": ("example-file", open("example-file", "rb")) }
payload = {
"filesPos": "123",
"journal_entry": "{
\"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",
\"accountingPeriodId\": \"2021-06\",
\"accountingReason\": \"COMMERCIAL\",
\"currency\": \"EUR\",
\"description\": \"Hotel for dreamforce\",
\"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",
\"exchangeRate\": \"1,2045\",
\"isProvisional\": \"false\",
\"isReversal\": false,
\"journalLineItems\": [
{
\"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",
\"accountCode\": \"4034\",
\"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",
\"accountNumber\": \"1200\",
\"currency\": \"EUR\",
\"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",
\"debitCreditIndicator\": \"DEBIT\",
\"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",
\"dimensions\": [
{
\"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",
\"categoryName\": \"CostCenter\",
\"code\": \"KD1\",
\"name\": \"Material/Waren\"
}
],
\"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",
\"documentNumber\": \"123456789\",
\"exchangeRate\": 1,
\"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",
\"taxRate\": {
\"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",
\"code\": \"03\",
\"name\": \"Tax19\",
\"taxRatePercentage\": \"19\"
},
\"thirdPartyCode\": \"112233\",
\"totalGrossAmount\": 1190,
\"totalNetAmount\": 1000,
\"totalTaxAmount\": 190
}
],
\"journalCode\": \"60\",
\"journalType\": \"FIN\",
\"number \": \"21900030\",
\"recordType\": \"STANDARD\",
\"transactionDate\": \"2021-01-01T00:00:00Z\",
\"version\": \"AAAAACnY3os1\"
}"
}
headers = {
"X-API-KEY": "<x-api-key>",
"X-ACCOUNT-KEY": "<x-account-key>"
}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('files', '<string>');
form.append('filesPos', '123');
form.append('journal_entry', '{
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2021-06",
"accountingReason": "COMMERCIAL",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"exchangeRate": "1,2045",
"isProvisional": "false",
"isReversal": false,
"journalLineItems": [
{
"id": "123f57fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountCode": "4034",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountNumber": "1200",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"recordType": "STANDARD",
"transactionDate": "2021-01-01T00:00:00Z",
"version": "AAAAACnY3os1"
}');
const options = {
method: 'POST',
headers: {'X-API-KEY': '<x-api-key>', 'X-ACCOUNT-KEY': '<x-account-key>'}
};
options.body = form;
fetch('https://api.maesn.dev/accounting/journalEntries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.maesn.dev/accounting/journalEntries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"filesPos\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"journal_entry\"\r\n\r\n{\r\n \"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",\r\n \"accountingPeriodId\": \"2021-06\",\r\n \"accountingReason\": \"COMMERCIAL\",\r\n \"currency\": \"EUR\",\r\n \"description\": \"Hotel for dreamforce\",\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"exchangeRate\": \"1,2045\",\r\n \"isProvisional\": \"false\",\r\n \"isReversal\": false,\r\n \"journalLineItems\": [\r\n {\r\n \"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountCode\": \"4034\",\r\n \"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountNumber\": \"1200\",\r\n \"currency\": \"EUR\",\r\n \"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",\r\n \"debitCreditIndicator\": \"DEBIT\",\r\n \"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\r\n \"categoryName\": \"CostCenter\",\r\n \"code\": \"KD1\",\r\n \"name\": \"Material/Waren\"\r\n }\r\n ],\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"documentNumber\": \"123456789\",\r\n \"exchangeRate\": 1,\r\n \"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",\r\n \"taxRate\": {\r\n \"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",\r\n \"code\": \"03\",\r\n \"name\": \"Tax19\",\r\n \"taxRatePercentage\": \"19\"\r\n },\r\n \"thirdPartyCode\": \"112233\",\r\n \"totalGrossAmount\": 1190,\r\n \"totalNetAmount\": 1000,\r\n \"totalTaxAmount\": 190\r\n }\r\n ],\r\n \"journalCode\": \"60\",\r\n \"journalType\": \"FIN\",\r\n \"number \": \"21900030\",\r\n \"recordType\": \"STANDARD\",\r\n \"transactionDate\": \"2021-01-01T00:00:00Z\",\r\n \"version\": \"AAAAACnY3os1\"\r\n}\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"X-ACCOUNT-KEY: <x-account-key>",
"X-API-KEY: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.maesn.dev/accounting/journalEntries"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"filesPos\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"journal_entry\"\r\n\r\n{\r\n \"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",\r\n \"accountingPeriodId\": \"2021-06\",\r\n \"accountingReason\": \"COMMERCIAL\",\r\n \"currency\": \"EUR\",\r\n \"description\": \"Hotel for dreamforce\",\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"exchangeRate\": \"1,2045\",\r\n \"isProvisional\": \"false\",\r\n \"isReversal\": false,\r\n \"journalLineItems\": [\r\n {\r\n \"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountCode\": \"4034\",\r\n \"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountNumber\": \"1200\",\r\n \"currency\": \"EUR\",\r\n \"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",\r\n \"debitCreditIndicator\": \"DEBIT\",\r\n \"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\r\n \"categoryName\": \"CostCenter\",\r\n \"code\": \"KD1\",\r\n \"name\": \"Material/Waren\"\r\n }\r\n ],\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"documentNumber\": \"123456789\",\r\n \"exchangeRate\": 1,\r\n \"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",\r\n \"taxRate\": {\r\n \"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",\r\n \"code\": \"03\",\r\n \"name\": \"Tax19\",\r\n \"taxRatePercentage\": \"19\"\r\n },\r\n \"thirdPartyCode\": \"112233\",\r\n \"totalGrossAmount\": 1190,\r\n \"totalNetAmount\": 1000,\r\n \"totalTaxAmount\": 190\r\n }\r\n ],\r\n \"journalCode\": \"60\",\r\n \"journalType\": \"FIN\",\r\n \"number \": \"21900030\",\r\n \"recordType\": \"STANDARD\",\r\n \"transactionDate\": \"2021-01-01T00:00:00Z\",\r\n \"version\": \"AAAAACnY3os1\"\r\n}\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<x-api-key>")
req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.maesn.dev/accounting/journalEntries")
.header("X-API-KEY", "<x-api-key>")
.header("X-ACCOUNT-KEY", "<x-account-key>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"filesPos\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"journal_entry\"\r\n\r\n{\r\n \"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",\r\n \"accountingPeriodId\": \"2021-06\",\r\n \"accountingReason\": \"COMMERCIAL\",\r\n \"currency\": \"EUR\",\r\n \"description\": \"Hotel for dreamforce\",\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"exchangeRate\": \"1,2045\",\r\n \"isProvisional\": \"false\",\r\n \"isReversal\": false,\r\n \"journalLineItems\": [\r\n {\r\n \"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountCode\": \"4034\",\r\n \"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountNumber\": \"1200\",\r\n \"currency\": \"EUR\",\r\n \"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",\r\n \"debitCreditIndicator\": \"DEBIT\",\r\n \"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\r\n \"categoryName\": \"CostCenter\",\r\n \"code\": \"KD1\",\r\n \"name\": \"Material/Waren\"\r\n }\r\n ],\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"documentNumber\": \"123456789\",\r\n \"exchangeRate\": 1,\r\n \"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",\r\n \"taxRate\": {\r\n \"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",\r\n \"code\": \"03\",\r\n \"name\": \"Tax19\",\r\n \"taxRatePercentage\": \"19\"\r\n },\r\n \"thirdPartyCode\": \"112233\",\r\n \"totalGrossAmount\": 1190,\r\n \"totalNetAmount\": 1000,\r\n \"totalTaxAmount\": 190\r\n }\r\n ],\r\n \"journalCode\": \"60\",\r\n \"journalType\": \"FIN\",\r\n \"number \": \"21900030\",\r\n \"recordType\": \"STANDARD\",\r\n \"transactionDate\": \"2021-01-01T00:00:00Z\",\r\n \"version\": \"AAAAACnY3os1\"\r\n}\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.maesn.dev/accounting/journalEntries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"filesPos\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"journal_entry\"\r\n\r\n{\r\n \"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",\r\n \"accountingPeriodId\": \"2021-06\",\r\n \"accountingReason\": \"COMMERCIAL\",\r\n \"currency\": \"EUR\",\r\n \"description\": \"Hotel for dreamforce\",\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"exchangeRate\": \"1,2045\",\r\n \"isProvisional\": \"false\",\r\n \"isReversal\": false,\r\n \"journalLineItems\": [\r\n {\r\n \"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountCode\": \"4034\",\r\n \"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountNumber\": \"1200\",\r\n \"currency\": \"EUR\",\r\n \"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",\r\n \"debitCreditIndicator\": \"DEBIT\",\r\n \"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\r\n \"categoryName\": \"CostCenter\",\r\n \"code\": \"KD1\",\r\n \"name\": \"Material/Waren\"\r\n }\r\n ],\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"documentNumber\": \"123456789\",\r\n \"exchangeRate\": 1,\r\n \"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",\r\n \"taxRate\": {\r\n \"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",\r\n \"code\": \"03\",\r\n \"name\": \"Tax19\",\r\n \"taxRatePercentage\": \"19\"\r\n },\r\n \"thirdPartyCode\": \"112233\",\r\n \"totalGrossAmount\": 1190,\r\n \"totalNetAmount\": 1000,\r\n \"totalTaxAmount\": 190\r\n }\r\n ],\r\n \"journalCode\": \"60\",\r\n \"journalType\": \"FIN\",\r\n \"number \": \"21900030\",\r\n \"recordType\": \"STANDARD\",\r\n \"transactionDate\": \"2021-01-01T00:00:00Z\",\r\n \"version\": \"AAAAACnY3os1\"\r\n}\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
}
},
"data": [
{
"id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountingPeriodId": "2021-06",
"accountingReason": "COMMERCIAL",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"files": [
"file1.pdf"
],
"exchangeRate": "1,2045",
"isProvisional": "false",
"isReversal": false,
"journalLineItems": [
{
"id": "123f57fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountCode": "4034",
"accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
"accountNumber": 8200,
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190,
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"recordType": "STANDARD",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z",
"version": "AAAAACnY3os1"
}
]
}Journal Entries
Create journal entry
POST
/
accounting
/
journalEntries
cURL
curl --request POST \
--url https://api.maesn.dev/accounting/journalEntries \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form files=@example-file \
--form filesPos=123 \
--form 'journal_entry={
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2021-06",
"accountingReason": "COMMERCIAL",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"exchangeRate": "1,2045",
"isProvisional": "false",
"isReversal": false,
"journalLineItems": [
{
"id": "123f57fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountCode": "4034",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountNumber": "1200",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"recordType": "STANDARD",
"transactionDate": "2021-01-01T00:00:00Z",
"version": "AAAAACnY3os1"
}'import requests
url = "https://api.maesn.dev/accounting/journalEntries"
files = { "files": ("example-file", open("example-file", "rb")) }
payload = {
"filesPos": "123",
"journal_entry": "{
\"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",
\"accountingPeriodId\": \"2021-06\",
\"accountingReason\": \"COMMERCIAL\",
\"currency\": \"EUR\",
\"description\": \"Hotel for dreamforce\",
\"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",
\"exchangeRate\": \"1,2045\",
\"isProvisional\": \"false\",
\"isReversal\": false,
\"journalLineItems\": [
{
\"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",
\"accountCode\": \"4034\",
\"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",
\"accountNumber\": \"1200\",
\"currency\": \"EUR\",
\"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",
\"debitCreditIndicator\": \"DEBIT\",
\"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",
\"dimensions\": [
{
\"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",
\"categoryName\": \"CostCenter\",
\"code\": \"KD1\",
\"name\": \"Material/Waren\"
}
],
\"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",
\"documentNumber\": \"123456789\",
\"exchangeRate\": 1,
\"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",
\"taxRate\": {
\"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",
\"code\": \"03\",
\"name\": \"Tax19\",
\"taxRatePercentage\": \"19\"
},
\"thirdPartyCode\": \"112233\",
\"totalGrossAmount\": 1190,
\"totalNetAmount\": 1000,
\"totalTaxAmount\": 190
}
],
\"journalCode\": \"60\",
\"journalType\": \"FIN\",
\"number \": \"21900030\",
\"recordType\": \"STANDARD\",
\"transactionDate\": \"2021-01-01T00:00:00Z\",
\"version\": \"AAAAACnY3os1\"
}"
}
headers = {
"X-API-KEY": "<x-api-key>",
"X-ACCOUNT-KEY": "<x-account-key>"
}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('files', '<string>');
form.append('filesPos', '123');
form.append('journal_entry', '{
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2021-06",
"accountingReason": "COMMERCIAL",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"exchangeRate": "1,2045",
"isProvisional": "false",
"isReversal": false,
"journalLineItems": [
{
"id": "123f57fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountCode": "4034",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountNumber": "1200",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"recordType": "STANDARD",
"transactionDate": "2021-01-01T00:00:00Z",
"version": "AAAAACnY3os1"
}');
const options = {
method: 'POST',
headers: {'X-API-KEY': '<x-api-key>', 'X-ACCOUNT-KEY': '<x-account-key>'}
};
options.body = form;
fetch('https://api.maesn.dev/accounting/journalEntries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.maesn.dev/accounting/journalEntries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"filesPos\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"journal_entry\"\r\n\r\n{\r\n \"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",\r\n \"accountingPeriodId\": \"2021-06\",\r\n \"accountingReason\": \"COMMERCIAL\",\r\n \"currency\": \"EUR\",\r\n \"description\": \"Hotel for dreamforce\",\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"exchangeRate\": \"1,2045\",\r\n \"isProvisional\": \"false\",\r\n \"isReversal\": false,\r\n \"journalLineItems\": [\r\n {\r\n \"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountCode\": \"4034\",\r\n \"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountNumber\": \"1200\",\r\n \"currency\": \"EUR\",\r\n \"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",\r\n \"debitCreditIndicator\": \"DEBIT\",\r\n \"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\r\n \"categoryName\": \"CostCenter\",\r\n \"code\": \"KD1\",\r\n \"name\": \"Material/Waren\"\r\n }\r\n ],\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"documentNumber\": \"123456789\",\r\n \"exchangeRate\": 1,\r\n \"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",\r\n \"taxRate\": {\r\n \"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",\r\n \"code\": \"03\",\r\n \"name\": \"Tax19\",\r\n \"taxRatePercentage\": \"19\"\r\n },\r\n \"thirdPartyCode\": \"112233\",\r\n \"totalGrossAmount\": 1190,\r\n \"totalNetAmount\": 1000,\r\n \"totalTaxAmount\": 190\r\n }\r\n ],\r\n \"journalCode\": \"60\",\r\n \"journalType\": \"FIN\",\r\n \"number \": \"21900030\",\r\n \"recordType\": \"STANDARD\",\r\n \"transactionDate\": \"2021-01-01T00:00:00Z\",\r\n \"version\": \"AAAAACnY3os1\"\r\n}\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"X-ACCOUNT-KEY: <x-account-key>",
"X-API-KEY: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.maesn.dev/accounting/journalEntries"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"filesPos\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"journal_entry\"\r\n\r\n{\r\n \"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",\r\n \"accountingPeriodId\": \"2021-06\",\r\n \"accountingReason\": \"COMMERCIAL\",\r\n \"currency\": \"EUR\",\r\n \"description\": \"Hotel for dreamforce\",\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"exchangeRate\": \"1,2045\",\r\n \"isProvisional\": \"false\",\r\n \"isReversal\": false,\r\n \"journalLineItems\": [\r\n {\r\n \"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountCode\": \"4034\",\r\n \"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountNumber\": \"1200\",\r\n \"currency\": \"EUR\",\r\n \"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",\r\n \"debitCreditIndicator\": \"DEBIT\",\r\n \"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\r\n \"categoryName\": \"CostCenter\",\r\n \"code\": \"KD1\",\r\n \"name\": \"Material/Waren\"\r\n }\r\n ],\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"documentNumber\": \"123456789\",\r\n \"exchangeRate\": 1,\r\n \"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",\r\n \"taxRate\": {\r\n \"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",\r\n \"code\": \"03\",\r\n \"name\": \"Tax19\",\r\n \"taxRatePercentage\": \"19\"\r\n },\r\n \"thirdPartyCode\": \"112233\",\r\n \"totalGrossAmount\": 1190,\r\n \"totalNetAmount\": 1000,\r\n \"totalTaxAmount\": 190\r\n }\r\n ],\r\n \"journalCode\": \"60\",\r\n \"journalType\": \"FIN\",\r\n \"number \": \"21900030\",\r\n \"recordType\": \"STANDARD\",\r\n \"transactionDate\": \"2021-01-01T00:00:00Z\",\r\n \"version\": \"AAAAACnY3os1\"\r\n}\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<x-api-key>")
req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.maesn.dev/accounting/journalEntries")
.header("X-API-KEY", "<x-api-key>")
.header("X-ACCOUNT-KEY", "<x-account-key>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"filesPos\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"journal_entry\"\r\n\r\n{\r\n \"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",\r\n \"accountingPeriodId\": \"2021-06\",\r\n \"accountingReason\": \"COMMERCIAL\",\r\n \"currency\": \"EUR\",\r\n \"description\": \"Hotel for dreamforce\",\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"exchangeRate\": \"1,2045\",\r\n \"isProvisional\": \"false\",\r\n \"isReversal\": false,\r\n \"journalLineItems\": [\r\n {\r\n \"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountCode\": \"4034\",\r\n \"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountNumber\": \"1200\",\r\n \"currency\": \"EUR\",\r\n \"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",\r\n \"debitCreditIndicator\": \"DEBIT\",\r\n \"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\r\n \"categoryName\": \"CostCenter\",\r\n \"code\": \"KD1\",\r\n \"name\": \"Material/Waren\"\r\n }\r\n ],\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"documentNumber\": \"123456789\",\r\n \"exchangeRate\": 1,\r\n \"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",\r\n \"taxRate\": {\r\n \"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",\r\n \"code\": \"03\",\r\n \"name\": \"Tax19\",\r\n \"taxRatePercentage\": \"19\"\r\n },\r\n \"thirdPartyCode\": \"112233\",\r\n \"totalGrossAmount\": 1190,\r\n \"totalNetAmount\": 1000,\r\n \"totalTaxAmount\": 190\r\n }\r\n ],\r\n \"journalCode\": \"60\",\r\n \"journalType\": \"FIN\",\r\n \"number \": \"21900030\",\r\n \"recordType\": \"STANDARD\",\r\n \"transactionDate\": \"2021-01-01T00:00:00Z\",\r\n \"version\": \"AAAAACnY3os1\"\r\n}\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.maesn.dev/accounting/journalEntries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"filesPos\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"journal_entry\"\r\n\r\n{\r\n \"accountId\": \"d1bfd23-517d-4ec6-b7d4-56f86c7cf246\",\r\n \"accountingPeriodId\": \"2021-06\",\r\n \"accountingReason\": \"COMMERCIAL\",\r\n \"currency\": \"EUR\",\r\n \"description\": \"Hotel for dreamforce\",\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"exchangeRate\": \"1,2045\",\r\n \"isProvisional\": \"false\",\r\n \"isReversal\": false,\r\n \"journalLineItems\": [\r\n {\r\n \"id\": \"123f57fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountCode\": \"4034\",\r\n \"accountId\": \"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9\",\r\n \"accountNumber\": \"1200\",\r\n \"currency\": \"EUR\",\r\n \"customerId\": \"782d89b56-13ae-47a6-8a2a-45e6ddc50d9\",\r\n \"debitCreditIndicator\": \"DEBIT\",\r\n \"description\": \"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021\",\r\n \"dimensions\": [\r\n {\r\n \"id\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\r\n \"categoryName\": \"CostCenter\",\r\n \"code\": \"KD1\",\r\n \"name\": \"Material/Waren\"\r\n }\r\n ],\r\n \"documentId\": \"b5e624e5-fb9e-4836-a443-87a3820f5b48\",\r\n \"documentNumber\": \"123456789\",\r\n \"exchangeRate\": 1,\r\n \"supplierId\": \"998933b56-13ae-47a6-8a32a-45e6ddc50d9\",\r\n \"taxRate\": {\r\n \"id\": \"1895b05b-38a6-4a6a-9653-166389894350\",\r\n \"code\": \"03\",\r\n \"name\": \"Tax19\",\r\n \"taxRatePercentage\": \"19\"\r\n },\r\n \"thirdPartyCode\": \"112233\",\r\n \"totalGrossAmount\": 1190,\r\n \"totalNetAmount\": 1000,\r\n \"totalTaxAmount\": 190\r\n }\r\n ],\r\n \"journalCode\": \"60\",\r\n \"journalType\": \"FIN\",\r\n \"number \": \"21900030\",\r\n \"recordType\": \"STANDARD\",\r\n \"transactionDate\": \"2021-01-01T00:00:00Z\",\r\n \"version\": \"AAAAACnY3os1\"\r\n}\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
}
},
"data": [
{
"id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountingPeriodId": "2021-06",
"accountingReason": "COMMERCIAL",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"files": [
"file1.pdf"
],
"exchangeRate": "1,2045",
"isProvisional": "false",
"isReversal": false,
"journalLineItems": [
{
"id": "123f57fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountCode": "4034",
"accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
"accountNumber": 8200,
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190,
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"recordType": "STANDARD",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z",
"version": "AAAAACnY3os1"
}
]
}Field support per integration
bexio
bexio
Supported request parameters:
file[]
string
required
Show properties
Show properties
JournalLineItem[]
required
Show properties
Show properties
string
required
enum
required
Available options (3-letter ISO 4217):
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWRstring
string
required
string
number
required
string
The
number field is optional. It can be used to define groups of journal entries with the same reference number.string
required
Business Central
Business Central
If you’re not using the Interactive Authentication Flow, make sure the query parameters
environmentName and companyId are correctly populated.
You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.
Dinero
Dinero
Supported request fields:
string
required
Show properties
Show properties
boolean
Indicates whether the journal entry is provisional (draft) or booked (finalized).If set to
true, a provisional journal entry is created; if set to false, a booked journal entry is created.Defaults to
true if not provided.JournalLineItem[]
required
Show properties
Show properties
string
Id for the journal line.It can also be used to pair debit/credit entries.
Line items with the same
id value will be combined into a single Dinero line with both account and contra-account.Pairing Scenario: When two line items share the same id (one DEBIT, one CREDIT), they will be sent as a single line with:Accountfrom the DEBIT itemContra accountfrom the CREDIT itemAmountfrom the DEBIT item (always positive)
string
required
The account number. Must be numeric.When
documentId is present, the accountNumber should be a bank accountstring
required
enum
required
Available options:
DEBIT, CREDITstring
Reference to an invoice/bill ID for payment lines. When provided, the line becomes a payment that settles the referenced document.
number
required
The net amount for the line item. Must be a positive amount.
string
Journal entry number. Must be numeric.
string
required
For date format details visits the
Standardized Data section.It is the date the accounting entry is booked into the records.file[]
Exact Online
Exact Online
If you’re not using the Interactive Authentication Flow, make sure the query parameter
companyId is correctly populated.
You can obtain this value by using the GET Companies endpoint available under the Authentication section.string
required
Show properties
Show properties
string
string
accountingPeriodId accepted format: YYYY-MM .string
required
string
required
JournalLineItem[]
Show properties
Show properties
string
required
string
Dimension[]
string
number
file[]
number[]
The
filesPos field is an array of line item positions (starting from 1) that correspond to each uploaded file.
The value at index i in filesPos refers to the line item that the file at index i in the files array should be linked to.
This field is required when uploading files.Example:
If you’re uploading 2 files, and you want to link the first file to line item 1 and the second file to line item 3:
filesPos: [1, 3]
fortnox
fortnox
This endpoint creates finalized journal entries, which cannot be modified afterwards.
VAT must be posted as its own journal line, using the relevant account id for VAT (e.g. 2611 for 25% output VAT).
string
required
file[]
Holded
Holded
- This endpoint creates finalized journal entries.
- VAT must be posted as its own journal line, using the relevant account number for VAT.
- The response only returns the
idof the created journal entry. UseGET /accounting/journalEntries/{journalEntryId}to retrieve the full details.
string
required
Show properties
Show properties
string
JournalLineItem[]
required
Debit and credit amounts must balance (sum to zero).
string
required
Odoo
Odoo
Sage Active
Sage Active
If you’re not using the Interactive Authentication Flow, make sure the query parameter
companyId is correctly populated.
You can obtain this value by using the GET Companies endpoint available under the Authentication section. Please use the id field as the companyId.string
required
file[]
Twinfield
Twinfield
If you’re not using the Interactive Authentication Flow, make sure the query parameter
companyId is correctly populated.
You can obtain this value by using the GET Companies endpoint available under the Authentication section.string
required
string
string
boolean
JournalLineItem[]
required
Show properties
Show properties
Note that each journal line can reference only one entity type. Please include only one of the following fields: customerId, supplierId, or dimension.
string
required
string
string
string
string
string
number
required
Tripletex
Tripletex
Use the Interactive Authentication Flow to connect Tripletex. It works for both token types: with an accountant token, the user picks the client company from a list;
with a regular single-company token, the user’s own company is selected automatically and no list is shown. You can also set companyId directly if you already know the client company id (accountant tokens only).
string
required
Show properties
Show properties
string
Defaults to
NOK if not provided. When a different currency is used, exchangeRate is required.string
required
string
Required when
currency is not NOK.boolean
Indicates whether the journal entry is provisional (draft) or booked (finalized).If set to
true, a provisional journal entry is created; if set to false, a booked journal entry is created.Defaults to true if not provided.JournalLineItem[]
required
Debit and credit amounts must balance (sum to zero).
string
required
file[]
Allowed file types: PDF, JPG, PNG, TIFF.
Visma e-conomic
Visma e-conomic
Supported request fields:
string
required
Show properties
Show properties
string
required
string
string
boolean
Indicates whether the journal entry is provisional (draft) or booked (finalized).If set to
true, a provisional journal entry is created; if set to false, a booked journal entry is created.Defaults to
true if not provided.string
required
Must be a valid integer.You can obtain the value by using the
GET JournalsJournalLineItem[]
required
Maximum 2 line items are allowed per journal entry. When 2 line items are provided, one must be DEBIT and one must be CREDIT with the same amount.To create multiple entries for a voucher, create multiple journal entries with same
number.string
The voucher number.The field is optional. It can be used to assign the same voucher number to multiple journal entries that belong to or reference the same voucher.
If you do not need to associate multiple journal entries with the same voucher number, it is recommended to let the server generate the number automatically.
This helps avoid accidentally choosing a voucher number that is already associated with an unrelated journal entry in the user’s account.
string
required
For date format details visit the
Standardized Data section.file[]
Only one file is supported. Allowed file types: PDF, JPG, PNG. Maximum file size: 9MB.If the
number field is used and a file is already associated with the same voucher number,
the new file and the existing file will be merged.
Xero
Xero
Supported request parameters:
string
required
Show properties
Show properties
string
string
required
JournalLineItem[]
required
Show properties
Show properties
string
required
enum
Available options (3-letter ISO 4217):
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GQE, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZM, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEB, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMK, ZWRstring
string
string
string
number
required
number
required
number
string
string
file[]
required
Headers
API key
Example:
"example value"
Account key
Example:
"example value"
Unique key to ensure idempotent requests. If provided, duplicate requests with the same key will return the cached response instead of creating duplicate resources.
Example:
"order-12345-invoice-001"
Body
multipart/form-data
Last modified on October 9, 2026
Was this page helpful?