Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bill Lines
- 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"
}
}
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 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
Response
The response is of type object
.
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"
}
}