Get started
Integrations
- Overview
- AbaConnect
- Abacus
- bexio
- BuchhaltungsButler
- DATEV Rechnungswesen
- DATEV Unternehmen Online
- Exact Online
- fortnox
- FreeAgent
- FreshBooks
- Holded
- Lexware Office
- Microsoft Business Central
- Moneybird
- Odoo
- Pennylane
- Qonto
- QuickBooks
- Sage Accounting
- Sage Active
- sevdesk
- Snelstart
- Twinfield
- Visma eAcccounting
- Visma e-conomic
- weclapp
- Xentral
- Xero
Use cases
cURL
Copy
Ask AI
curl --request POST \
--url https://api.maesn.dev/accounting/contacts/bulk \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '
{
"accountNumberLength": 4,
"chartOfAccount": "SKR03",
"entries": [
{
"addresses": [
{
"addressLine1": "Lucky street 1",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"accountNumber": 70000,
"bankAccounts": [
{
"bic": "COBADEFFXXX",
"holder": "John Doe",
"iban": "DE89370400440532013000",
"sepa": true,
"isMainAccount": true,
"name": "Sparkasse"
}
],
"companyName": "maesn",
"contactPersons": "[]",
"contactType": "COMPANY",
"emailAddresses": [
{
"email": "[email protected]",
"type": "BUSINESS"
}
],
"number": "1042",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "3",
"vatId": "DE33445672452"
}
],
"fiscalYearStartDate": "2025-01-01"
}
'Copy
Ask AI
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
}
},
"data": {
"id": "433445",
"accountNumberLength": 4,
"chartOfAccount": "SKR03",
"createdDate": "2025-04-06T00:00:00Z",
"entries": [
{
"addresses": [
{
"addressLine1": "Lucky street 1",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"accountNumber": 70000,
"bankAccounts": [
{
"bic": "COBADEFFXXX",
"holder": "John Doe",
"iban": "DE89370400440532013000",
"sepa": true,
"isMainAccount": true,
"name": "Sparkasse"
}
],
"companyName": "maesn",
"contactPersons": "[]",
"contactType": "COMPANY",
"emailAddresses": [
{
"email": "[email protected]",
"type": "BUSINESS"
}
],
"number": "1042",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "3",
"vatId": "DE33445672452"
}
],
"fiscalYearStartDate": "2025-01-01",
"taskId": "ABBDU8834993NND"
}
}Contacts
Create contacts bulk
POST
/
accounting
/
contacts
/
bulk
cURL
Copy
Ask AI
curl --request POST \
--url https://api.maesn.dev/accounting/contacts/bulk \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '
{
"accountNumberLength": 4,
"chartOfAccount": "SKR03",
"entries": [
{
"addresses": [
{
"addressLine1": "Lucky street 1",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"accountNumber": 70000,
"bankAccounts": [
{
"bic": "COBADEFFXXX",
"holder": "John Doe",
"iban": "DE89370400440532013000",
"sepa": true,
"isMainAccount": true,
"name": "Sparkasse"
}
],
"companyName": "maesn",
"contactPersons": "[]",
"contactType": "COMPANY",
"emailAddresses": [
{
"email": "[email protected]",
"type": "BUSINESS"
}
],
"number": "1042",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "3",
"vatId": "DE33445672452"
}
],
"fiscalYearStartDate": "2025-01-01"
}
'Copy
Ask AI
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
}
},
"data": {
"id": "433445",
"accountNumberLength": 4,
"chartOfAccount": "SKR03",
"createdDate": "2025-04-06T00:00:00Z",
"entries": [
{
"addresses": [
{
"addressLine1": "Lucky street 1",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"accountNumber": 70000,
"bankAccounts": [
{
"bic": "COBADEFFXXX",
"holder": "John Doe",
"iban": "DE89370400440532013000",
"sepa": true,
"isMainAccount": true,
"name": "Sparkasse"
}
],
"companyName": "maesn",
"contactPersons": "[]",
"contactType": "COMPANY",
"emailAddresses": [
{
"email": "[email protected]",
"type": "BUSINESS"
}
],
"number": "1042",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "3",
"vatId": "DE33445672452"
}
],
"fiscalYearStartDate": "2025-01-01",
"taskId": "ABBDU8834993NND"
}
}Field support per integration
DATEV Rechnungswesen
DATEV Rechnungswesen
This endpoints is asynchronous. To check the status of the request, use the
GET asyncTask endpoint.For more info about asynchronous tasks visit the Asynchronous Task section.If you’re not using the Interactive Authentication Flow, make sure the query parameter
companyId is accurately populated with the appropriate company ID. You can obtain this value by using the GET Companies endpoint available under the Authentication section.The
accountNumberLength field specifies the length of the G/L accounts.
The value must match the configuration defined in the end user’s mandate settings within the DATEV application.Available options:
SKR03, SKR04, SKR42, SKR51, SKR14Show properties
Show properties
Show properties
Show properties
Available options (ISO 3166-1 alpha-2):
AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZWAvailable options:
BILLING, WORKAvailable options:
CONTACT_PERSON, COMPANYYYYY-MM-DD date format, e.g., 2025-01-01The
fiscalYearStartDate field should be set to the first day of the fiscal year, which is usually January 1st.
If your fiscal year begins on a different date, please adjust this field accordingly.If the provided date does not match the actual fiscal year start date, DATEV will not return an error code. However, the booking entries will not be posted in Rechnungswesen.
Headers
API key
Example:
"example value"
Account key
Example:
"example value"
Query Parameters
Body
application/json
Example:
4
Available options:
SKR03, SKR04, SKR42, SKR51, SKR14 Example:
"SKR03"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
"Lucky street 1"
Example:
"2nd floor"
Example:
"Berlin"
Available options:
AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW Example:
"DE"
Example:
"10243"
Available options:
BILLING, DELIVERY, EMPTY, PRIVATE, WORK, PICKUP Example:
"BILLING"
Example:
70000
Show child attributes
Show child attributes
Example:
"COBADEFFXXX"
Example:
"John Doe"
Example:
"DE89370400440532013000"
Example:
true
Example:
true
Example:
"Sparkasse"
Example:
"maesn"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
Available options:
BUSINESS, PRIVATE, OFFICE, INVOICE, PAYMENT, OTHER Example:
"BUSINESS"
Example:
"John"
Example:
"Doe"
Example:
"Mr"
Example:
"[]"
Available options:
CONTACT_PERSON, COMPANY Example:
"COMPANY"
Show child attributes
Show child attributes
Example:
Available options:
BUSINESS, PRIVATE, OFFICE, INVOICE, PAYMENT, OTHER Example:
"BUSINESS"
Example:
"1042"
Example:
"3"
Example:
"DE33445672452"
Example:
"2025-01-01"
Response
200 - application/json
Show child attributes
Show child attributes
Example:
"433445"
Example:
4
Available options:
SKR03, SKR04, SKR42, SKR51, SKR14 Example:
"SKR03"
Example:
"2025-04-06T00:00:00Z"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
"Lucky street 1"
Example:
"2nd floor"
Example:
"Berlin"
Available options:
AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW Example:
"DE"
Example:
"10243"
Available options:
BILLING, DELIVERY, EMPTY, PRIVATE, WORK, PICKUP Example:
"BILLING"
Example:
70000
Show child attributes
Show child attributes
Example:
"COBADEFFXXX"
Example:
"John Doe"
Example:
"DE89370400440532013000"
Example:
true
Example:
true
Example:
"Sparkasse"
Example:
"maesn"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
Available options:
BUSINESS, PRIVATE, OFFICE, INVOICE, PAYMENT, OTHER Example:
"BUSINESS"
Example:
"John"
Example:
"Doe"
Example:
"Mr"
Example:
"[]"
Available options:
CONTACT_PERSON, COMPANY Example:
"COMPANY"
Show child attributes
Show child attributes
Example:
Available options:
BUSINESS, PRIVATE, OFFICE, INVOICE, PAYMENT, OTHER Example:
"BUSINESS"
Example:
"1042"
Example:
"3"
Example:
"DE33445672452"
Example:
"2025-01-01"
Example:
"ABBDU8834993NND"
Was this page helpful?
⌘I