Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bookings
- 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
Create offer
curl --request POST \
--url https://api.maesn.dev/accounting/offers \
--header 'Content-Type: application/json' \
--data '{
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"contactId": "Contact id",
"currency": "EUR",
"lineItems": [
{
"accountCode": "8400",
"accountId": "a23cc-334rn-finsd-438m",
"description": "Description",
"itemId": "Item id",
"name": "Item name",
"quantity": "1",
"taxCode": "CODE.19",
"taxRatePercentage": "19",
"taxType": "type-19",
"type": "ITEM",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "5",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"unitAmount": "100",
"unitDiscountAmount": "5",
"unitDiscountPercentage": "5",
"unitName": "PIECE"
}
],
"name": "Offer name",
"offerDate": "2021-01-01T00:00:00Z",
"offerNumber": "Offer number",
"reference": "Reference",
"status": "DRAFT",
"taxRule": "NET",
"taxText": "tax description",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "19",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "Offer id",
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"contactId": "Contact id",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"lineItems": [
{
"id": "Offer line item id",
"accountCode": "8400",
"accountId": "a23cc-334rn-finsd-438m",
"createdDate": "2021-01-01T00:00:00Z",
"description": "Description",
"itemId": "Item id",
"name": "Item name",
"quantity": "1",
"taxCode": "CODE.19",
"taxRatePercentage": "19",
"taxType": "type-19",
"type": "ITEM",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "5",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"unitAmount": "100",
"unitDiscountAmount": "5",
"unitDiscountPercentage": "5",
"unitName": "STÜCK",
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"name": "Offer name",
"offerDate": "2021-01-01T00:00:00Z",
"offerNumber": "Offer number",
"reference": "Reference",
"status": "DRAFT",
"taxRule": "NET",
"taxText": "tax description",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "19",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"updatedDate": "2021-01-01T00:00:00Z"
}
}Test Api token:
663222ee
Test Account token:
85b30b51
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 Response Fields:
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: SELLING, DELIVERY,
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
Body
"Street"
"Building"
"City"
"12345"
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, SELLING "BILLING"
"Contact id"
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 "EUR"
"8400"
"a23cc-334rn-finsd-438m"
"Description"
"Item id"
"Item name"
"1"
"CODE.19"
"19"
"type-19"
COMMENT, ACCOUNT, ITEM, RESOURCE, VALUE, FIXED_ASSET, CHARGE "ITEM"
"5"
"5"
"500"
"100"
"19"
"100"
"5"
"5"
"PIECE"
"Offer name"
"2021-01-01T00:00:00Z"
"Offer number"
"Reference"
DRAFT, SENT, ACCEPTED, VOIDED, DECLINED, EXPIRED "DRAFT"
NET, GROSS, FREETAX, INTRACOMMUNITY, CONSTRUCTIONSERVICE, EXTERNALSERVICE, THIRDPARTYCOUNTRYSERVICE, THIRDPARTYCOUNTRYDELIVERY, REVERSECHARGE, VATSALES, EXPORT , NONE, DEFAULT, EU, NOTEU, SS, CUSTOM "NET"
"tax description"
"5"
"19"
"500"
"100"
"19"
Response
"Offer id"
"Street"
"Building"
"City"
"12345"
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, SELLING "BILLING"
"Contact id"
"2021-01-01T00:00:00Z"
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 "EUR"
"Offer line item id"
"8400"
"a23cc-334rn-finsd-438m"
"2021-01-01T00:00:00Z"
"Description"
"Item id"
"Item name"
"1"
"CODE.19"
"19"
"type-19"
COMMENT, ACCOUNT, ITEM, RESOURCE, VALUE, FIXED_ASSET, CHARGE "ITEM"
"5"
"5"
"500"
"100"
"19"
"100"
"5"
"5"
"STÜCK"
"2021-01-01T00:00:00Z"
"Offer name"
"2021-01-01T00:00:00Z"
"Offer number"
"Reference"
DRAFT, SENT, ACCEPTED, VOIDED, DECLINED, EXPIRED "DRAFT"
NET, GROSS, FREETAX, INTRACOMMUNITY, CONSTRUCTIONSERVICE, EXTERNALSERVICE, THIRDPARTYCOUNTRYSERVICE, THIRDPARTYCOUNTRYDELIVERY, REVERSECHARGE, VATSALES, EXPORT , NONE, DEFAULT, EU, NOTEU, SS, CUSTOM "NET"
"tax description"
"5"
"19"
"500"
"100"
"19"
"2021-01-01T00:00:00Z"
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/offers \
--header 'Content-Type: application/json' \
--data '{
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"contactId": "Contact id",
"currency": "EUR",
"lineItems": [
{
"accountCode": "8400",
"accountId": "a23cc-334rn-finsd-438m",
"description": "Description",
"itemId": "Item id",
"name": "Item name",
"quantity": "1",
"taxCode": "CODE.19",
"taxRatePercentage": "19",
"taxType": "type-19",
"type": "ITEM",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "5",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"unitAmount": "100",
"unitDiscountAmount": "5",
"unitDiscountPercentage": "5",
"unitName": "PIECE"
}
],
"name": "Offer name",
"offerDate": "2021-01-01T00:00:00Z",
"offerNumber": "Offer number",
"reference": "Reference",
"status": "DRAFT",
"taxRule": "NET",
"taxText": "tax description",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "19",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19"
}'{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "Offer id",
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"contactId": "Contact id",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"lineItems": [
{
"id": "Offer line item id",
"accountCode": "8400",
"accountId": "a23cc-334rn-finsd-438m",
"createdDate": "2021-01-01T00:00:00Z",
"description": "Description",
"itemId": "Item id",
"name": "Item name",
"quantity": "1",
"taxCode": "CODE.19",
"taxRatePercentage": "19",
"taxType": "type-19",
"type": "ITEM",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "5",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"unitAmount": "100",
"unitDiscountAmount": "5",
"unitDiscountPercentage": "5",
"unitName": "STÜCK",
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"name": "Offer name",
"offerDate": "2021-01-01T00:00:00Z",
"offerNumber": "Offer number",
"reference": "Reference",
"status": "DRAFT",
"taxRule": "NET",
"taxText": "tax description",
"totalDiscountAmount": "5",
"totalDiscountPercentage": "19",
"totalGrossAmount": "500",
"totalNetAmount": "100",
"totalTaxAmount": "19",
"updatedDate": "2021-01-01T00:00:00Z"
}
}