Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Contacts
- Customers
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Offers
- Offer Lines
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tracking categories
- Transactions
- Authentication
- Tenant Management
- User
Sales Orders
Create salesorder
POST
/
accounting
/
salesOrders
curl --request POST \
--url https://api.maesn.dev/accounting/salesOrders \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"billingContactId": "1",
"comment": "comment",
"contactId": "1",
"currency": "EUR",
"deliveryDate": "2021-01-01T00:00:00Z",
"lineItems": [
{
"itemId": "Item id",
"description": "Description",
"itemName": "Item name",
"quantity": "1",
"taxCode": "CODE.19",
"taxRatePercentage": "19",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "5",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"unitAmount": "100",
"unitDiscountAmount": "5",
"unitDiscountPercentage": "5",
"unitName": "PIECE"
}
],
"oneLineAddress": "one line address",
"orderDate": "2021-01-01T00:00:00Z",
"projectId": "1",
"shippingContactId": "1",
"status": "OPEN",
"totalDiscountAmount": "0",
"totalDiscountPercentage": "0",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "0"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "1",
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"billingContactId": "1",
"comment": "comment",
"contactId": "1",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"deliveryDate": "2021-01-01T00:00:00Z",
"lineItems": [
{
"id": "1",
"itemId": "Item id",
"createdDate": "2021-01-01T00:00:00Z",
"description": "Description",
"itemName": "Item name",
"quantity": "1",
"taxCode": "CODE.19",
"taxRatePercentage": "19",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "5",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"unitAmount": "100",
"unitDiscountAmount": "5",
"unitDiscountPercentage": "5",
"unitName": "PIECE",
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"oneLineAddress": "one line address",
"orderDate": "2021-01-01T00:00:00Z",
"projectId": "1",
"shippingContactId": "1",
"status": "OPEN",
"totalDiscountAmount": "0",
"totalDiscountPercentage": "0",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "0",
"updatedDate": "2021-01-01T00:00:00Z"
}
}Test Api token:
663222ee
Test Account token:
85b30b51
Field support per integration
Please ensure the query parameter environmentName is accurately populated with the appropriate environment.
You can obtain this value by using the GET Environments endpoint available under the Authentication section.
Supported Request Parameters:
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, ZWR
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Available options: OPEN, CLOSED
Headers
API key
Example:
"example value"
Account key
Example:
"example value"
Body
application/json
Example:
"Street"
Example:
"Building"
Example:
"City"
Example:
"12345"
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"
Available options:
BILLING, DELIVERY, SELLING Example:
"BILLING"
Example:
"1"
Example:
"comment"
Example:
"1"
Available options:
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, ZWR Example:
"EUR"
Example:
"2021-01-01T00:00:00Z"
Example:
"Item id"
Example:
"Description"
Example:
"Item name"
Example:
"1"
Example:
"CODE.19"
Example:
"19"
Example:
"5"
Example:
"5"
Example:
"500"
Example:
"100"
Example:
"19"
Example:
"100"
Example:
"5"
Example:
"5"
Example:
"PIECE"
Example:
"one line address"
Example:
"2021-01-01T00:00:00Z"
Example:
"1"
Example:
"1"
Available options:
OPEN, CLOSED Example:
"OPEN"
Example:
"0"
Example:
"0"
Example:
"100"
Example:
"100"
Example:
"0"
Response
200 - application/json
Example:
"1"
Example:
"Street"
Example:
"Building"
Example:
"City"
Example:
"12345"
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"
Available options:
BILLING, DELIVERY, SELLING Example:
"BILLING"
Example:
"1"
Example:
"comment"
Example:
"1"
Example:
"2021-01-01T00:00:00Z"
Available options:
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, ZWR Example:
"EUR"
Example:
"2021-01-01T00:00:00Z"
Example:
"1"
Example:
"Item id"
Example:
"2021-01-01T00:00:00Z"
Example:
"Description"
Example:
"Item name"
Example:
"1"
Example:
"CODE.19"
Example:
"19"
Example:
"5"
Example:
"5"
Example:
"500"
Example:
"100"
Example:
"19"
Example:
"100"
Example:
"5"
Example:
"5"
Example:
"PIECE"
Example:
"2021-01-01T00:00:00Z"
Example:
"one line address"
Example:
"2021-01-01T00:00:00Z"
Example:
"1"
Example:
"1"
Available options:
OPEN, CLOSED Example:
"OPEN"
Example:
"0"
Example:
"0"
Example:
"100"
Example:
"100"
Example:
"0"
Example:
"2021-01-01T00:00:00Z"
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/salesOrders \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"billingContactId": "1",
"comment": "comment",
"contactId": "1",
"currency": "EUR",
"deliveryDate": "2021-01-01T00:00:00Z",
"lineItems": [
{
"itemId": "Item id",
"description": "Description",
"itemName": "Item name",
"quantity": "1",
"taxCode": "CODE.19",
"taxRatePercentage": "19",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "5",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"unitAmount": "100",
"unitDiscountAmount": "5",
"unitDiscountPercentage": "5",
"unitName": "PIECE"
}
],
"oneLineAddress": "one line address",
"orderDate": "2021-01-01T00:00:00Z",
"projectId": "1",
"shippingContactId": "1",
"status": "OPEN",
"totalDiscountAmount": "0",
"totalDiscountPercentage": "0",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "0"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "1",
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"billingContactId": "1",
"comment": "comment",
"contactId": "1",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"deliveryDate": "2021-01-01T00:00:00Z",
"lineItems": [
{
"id": "1",
"itemId": "Item id",
"createdDate": "2021-01-01T00:00:00Z",
"description": "Description",
"itemName": "Item name",
"quantity": "1",
"taxCode": "CODE.19",
"taxRatePercentage": "19",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "5",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"unitAmount": "100",
"unitDiscountAmount": "5",
"unitDiscountPercentage": "5",
"unitName": "PIECE",
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"oneLineAddress": "one line address",
"orderDate": "2021-01-01T00:00:00Z",
"projectId": "1",
"shippingContactId": "1",
"status": "OPEN",
"totalDiscountAmount": "0",
"totalDiscountPercentage": "0",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "0",
"updatedDate": "2021-01-01T00:00:00Z"
}
}