Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Booking Proposals
- Contacts
- Customers
- Dimensions
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Journal Entries
- Offers
- Offer Lines
- Payments
- Payment Terms
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tax Rates
- Transactions
- Vendor Credits
- Authentication
- Tenant Management
- User
Patch supplier
curl --request PATCH \
--url https://api.maesn.dev/accounting/suppliers/{contactId} \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"contactType": "CONTACT_PERSON",
"companyName": "Company name",
"contactPersons": [
{
"salutation": "Mr",
"firstName": "John",
"lastName": "Doe",
"emailAddresses": [
"john.doe@company.com"
],
"phoneNumbers": [
"+49 7163307056"
]
}
],
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"postalCode": "12345",
"city": "City",
"countryCode": "DE",
"type": "BILLING"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"number": "1234",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"bankAccount": {
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"holder": "John Doe",
"sepa": true
},
"projectId": "1"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "1",
"contactType": "CONTACT_PERSON",
"companyName": "Company name",
"contactPersons": [
{
"salutation": "Mr",
"firstName": "John",
"lastName": "Doe",
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
]
}
],
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"postalCode": "12345",
"city": "City",
"countryCode": "DE",
"type": "BILLING"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"number": "1234",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "1",
"updatedDate": "2018-01-01T13:00:00.000Z"
}
}Test Api token:
663222ee
Test Account token:
85b30b51
Field support per integration
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.
Supported Request Parameters:
Available options: CONTACT_PERSON, COMPANY
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, ZW
Available options: BILLING
Path Parameters
Body
CONTACT_PERSON, COMPANY "Company name"
"Street"
"Building"
"12345"
"City"
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 "DE"
BILLING, DELIVERY, EMPTY, PRIVATE, WORK, PICKUP "1234"
"1"
Response
"1"
CONTACT_PERSON, COMPANY "CONTACT_PERSON"
"Company name"
"Mr"
"John"
"Doe"
"Street"
"Building"
"12345"
"City"
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 "DE"
BILLING, DELIVERY, EMPTY, PRIVATE, WORK, PICKUP "1234"
"1"
"2018-01-01T13:00:00.000Z"
Was this page helpful?
curl --request PATCH \
--url https://api.maesn.dev/accounting/suppliers/{contactId} \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"contactType": "CONTACT_PERSON",
"companyName": "Company name",
"contactPersons": [
{
"salutation": "Mr",
"firstName": "John",
"lastName": "Doe",
"emailAddresses": [
"john.doe@company.com"
],
"phoneNumbers": [
"+49 7163307056"
]
}
],
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"postalCode": "12345",
"city": "City",
"countryCode": "DE",
"type": "BILLING"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"number": "1234",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"bankAccount": {
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"holder": "John Doe",
"sepa": true
},
"projectId": "1"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "1",
"contactType": "CONTACT_PERSON",
"companyName": "Company name",
"contactPersons": [
{
"salutation": "Mr",
"firstName": "John",
"lastName": "Doe",
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
]
}
],
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"postalCode": "12345",
"city": "City",
"countryCode": "DE",
"type": "BILLING"
}
],
"emailAddresses": [
{
"email": "john.doe@company.com",
"type": "BUSINESS"
}
],
"number": "1234",
"phoneNumbers": [
{
"number": "+49 7163307056",
"type": "MOBILE"
}
],
"projectId": "1",
"updatedDate": "2018-01-01T13:00:00.000Z"
}
}