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 salesorder
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"
}
}
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 value"
Account key
"example value"
Body
Response
The response is of type object
.
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"
}
}