Create sales order

cURL

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": "Main street 45",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "billingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "comment": "Due today",
  "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "deliveryDate": "2021-01-01T00:00:00Z",
  "lineItems": [
    {
      "itemId": "efa82f42-fd85-11e1-a21f-0800200c9a33",
      "description": "SEOUL Guest Chair, red",
      "itemName": "RED CHAIR",
      "optional": true,
      "quantity": 1,
      "taxCode": "CODE.19",
      "taxRatePercentage": 19,
      "totalDiscountAmount": 10,
      "totalDiscountPercentage": 10,
      "totalGrossAmount": 109,
      "totalNetAmount": 100,
      "totalTaxAmount": 19,
      "unitAmount": 100,
      "unitDiscountAmount": 10,
      "unitDiscountPercentage": 10,
      "unitName": "PIECE"
    }
  ],
  "oneLineAddress": "Main street 45, Berlin",
  "orderDate": "2021-01-01T00:00:00Z",
  "projectId": "1",
  "shippingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "status": "OPEN",
  "totalDiscountAmount": 10,
  "totalDiscountPercentage": 10,
  "totalGrossAmount": 109,
  "totalNetAmount": 100,
  "totalTaxAmount": 19,
  "version": "1"
}
'

import requests

url = "https://api.maesn.dev/accounting/salesOrders"

payload = {
    "addresses": [
        {
            "addressLine1": "Main street 45",
            "addressLine2": "2nd floor",
            "city": "Berlin",
            "countryCode": "DE",
            "postalCode": "10243",
            "type": "BILLING"
        }
    ],
    "billingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "comment": "Due today",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "lineItems": [
        {
            "itemId": "efa82f42-fd85-11e1-a21f-0800200c9a33",
            "description": "SEOUL Guest Chair, red",
            "itemName": "RED CHAIR",
            "optional": True,
            "quantity": 1,
            "taxCode": "CODE.19",
            "taxRatePercentage": 19,
            "totalDiscountAmount": 10,
            "totalDiscountPercentage": 10,
            "totalGrossAmount": 109,
            "totalNetAmount": 100,
            "totalTaxAmount": 19,
            "unitAmount": 100,
            "unitDiscountAmount": 10,
            "unitDiscountPercentage": 10,
            "unitName": "PIECE"
        }
    ],
    "oneLineAddress": "Main street 45, Berlin",
    "orderDate": "2021-01-01T00:00:00Z",
    "projectId": "1",
    "shippingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "status": "OPEN",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "version": "1"
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "X-ACCOUNT-KEY": "<x-account-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-API-KEY': '<x-api-key>',
    'X-ACCOUNT-KEY': '<x-account-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    addresses: [
      {
        addressLine1: 'Main street 45',
        addressLine2: '2nd floor',
        city: 'Berlin',
        countryCode: 'DE',
        postalCode: '10243',
        type: 'BILLING'
      }
    ],
    billingContactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    comment: 'Due today',
    contactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    currency: 'EUR',
    deliveryDate: '2021-01-01T00:00:00Z',
    lineItems: [
      {
        itemId: 'efa82f42-fd85-11e1-a21f-0800200c9a33',
        description: 'SEOUL Guest Chair, red',
        itemName: 'RED CHAIR',
        optional: true,
        quantity: 1,
        taxCode: 'CODE.19',
        taxRatePercentage: 19,
        totalDiscountAmount: 10,
        totalDiscountPercentage: 10,
        totalGrossAmount: 109,
        totalNetAmount: 100,
        totalTaxAmount: 19,
        unitAmount: 100,
        unitDiscountAmount: 10,
        unitDiscountPercentage: 10,
        unitName: 'PIECE'
      }
    ],
    oneLineAddress: 'Main street 45, Berlin',
    orderDate: '2021-01-01T00:00:00Z',
    projectId: '1',
    shippingContactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    status: 'OPEN',
    totalDiscountAmount: 10,
    totalDiscountPercentage: 10,
    totalGrossAmount: 109,
    totalNetAmount: 100,
    totalTaxAmount: 19,
    version: '1'
  })
};

fetch('https://api.maesn.dev/accounting/salesOrders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.maesn.dev/accounting/salesOrders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'addresses' => [
        [
                'addressLine1' => 'Main street 45',
                'addressLine2' => '2nd floor',
                'city' => 'Berlin',
                'countryCode' => 'DE',
                'postalCode' => '10243',
                'type' => 'BILLING'
        ]
    ],
    'billingContactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'comment' => 'Due today',
    'contactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'currency' => 'EUR',
    'deliveryDate' => '2021-01-01T00:00:00Z',
    'lineItems' => [
        [
                'itemId' => 'efa82f42-fd85-11e1-a21f-0800200c9a33',
                'description' => 'SEOUL Guest Chair, red',
                'itemName' => 'RED CHAIR',
                'optional' => true,
                'quantity' => 1,
                'taxCode' => 'CODE.19',
                'taxRatePercentage' => 19,
                'totalDiscountAmount' => 10,
                'totalDiscountPercentage' => 10,
                'totalGrossAmount' => 109,
                'totalNetAmount' => 100,
                'totalTaxAmount' => 19,
                'unitAmount' => 100,
                'unitDiscountAmount' => 10,
                'unitDiscountPercentage' => 10,
                'unitName' => 'PIECE'
        ]
    ],
    'oneLineAddress' => 'Main street 45, Berlin',
    'orderDate' => '2021-01-01T00:00:00Z',
    'projectId' => '1',
    'shippingContactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'status' => 'OPEN',
    'totalDiscountAmount' => 10,
    'totalDiscountPercentage' => 10,
    'totalGrossAmount' => 109,
    'totalNetAmount' => 100,
    'totalTaxAmount' => 19,
    'version' => '1'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-ACCOUNT-KEY: <x-account-key>",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.maesn.dev/accounting/salesOrders"

	payload := strings.NewReader("{\n  \"addresses\": [\n    {\n      \"addressLine1\": \"Main street 45\",\n      \"addressLine2\": \"2nd floor\",\n      \"city\": \"Berlin\",\n      \"countryCode\": \"DE\",\n      \"postalCode\": \"10243\",\n      \"type\": \"BILLING\"\n    }\n  ],\n  \"billingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"comment\": \"Due today\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"lineItems\": [\n    {\n      \"itemId\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"itemName\": \"RED CHAIR\",\n      \"optional\": true,\n      \"quantity\": 1,\n      \"taxCode\": \"CODE.19\",\n      \"taxRatePercentage\": 19,\n      \"totalDiscountAmount\": 10,\n      \"totalDiscountPercentage\": 10,\n      \"totalGrossAmount\": 109,\n      \"totalNetAmount\": 100,\n      \"totalTaxAmount\": 19,\n      \"unitAmount\": 100,\n      \"unitDiscountAmount\": 10,\n      \"unitDiscountPercentage\": 10,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"orderDate\": \"2021-01-01T00:00:00Z\",\n  \"projectId\": \"1\",\n  \"shippingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"status\": \"OPEN\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19,\n  \"version\": \"1\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<x-api-key>")
	req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.maesn.dev/accounting/salesOrders")
  .header("X-API-KEY", "<x-api-key>")
  .header("X-ACCOUNT-KEY", "<x-account-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"addresses\": [\n    {\n      \"addressLine1\": \"Main street 45\",\n      \"addressLine2\": \"2nd floor\",\n      \"city\": \"Berlin\",\n      \"countryCode\": \"DE\",\n      \"postalCode\": \"10243\",\n      \"type\": \"BILLING\"\n    }\n  ],\n  \"billingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"comment\": \"Due today\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"lineItems\": [\n    {\n      \"itemId\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"itemName\": \"RED CHAIR\",\n      \"optional\": true,\n      \"quantity\": 1,\n      \"taxCode\": \"CODE.19\",\n      \"taxRatePercentage\": 19,\n      \"totalDiscountAmount\": 10,\n      \"totalDiscountPercentage\": 10,\n      \"totalGrossAmount\": 109,\n      \"totalNetAmount\": 100,\n      \"totalTaxAmount\": 19,\n      \"unitAmount\": 100,\n      \"unitDiscountAmount\": 10,\n      \"unitDiscountPercentage\": 10,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"orderDate\": \"2021-01-01T00:00:00Z\",\n  \"projectId\": \"1\",\n  \"shippingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"status\": \"OPEN\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19,\n  \"version\": \"1\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.maesn.dev/accounting/salesOrders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"addresses\": [\n    {\n      \"addressLine1\": \"Main street 45\",\n      \"addressLine2\": \"2nd floor\",\n      \"city\": \"Berlin\",\n      \"countryCode\": \"DE\",\n      \"postalCode\": \"10243\",\n      \"type\": \"BILLING\"\n    }\n  ],\n  \"billingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"comment\": \"Due today\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"lineItems\": [\n    {\n      \"itemId\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"itemName\": \"RED CHAIR\",\n      \"optional\": true,\n      \"quantity\": 1,\n      \"taxCode\": \"CODE.19\",\n      \"taxRatePercentage\": 19,\n      \"totalDiscountAmount\": 10,\n      \"totalDiscountPercentage\": 10,\n      \"totalGrossAmount\": 109,\n      \"totalNetAmount\": 100,\n      \"totalTaxAmount\": 19,\n      \"unitAmount\": 100,\n      \"unitDiscountAmount\": 10,\n      \"unitDiscountPercentage\": 10,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"orderDate\": \"2021-01-01T00:00:00Z\",\n  \"projectId\": \"1\",\n  \"shippingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"status\": \"OPEN\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19,\n  \"version\": \"1\"\n}"

response = http.request(request)
puts response.read_body

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
    "addresses": [
      {
        "addressLine1": "Main street 45",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "billingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "comment": "Due today",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "lineItems": [
      {
        "id": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "itemId": "efa82f42-fd85-11e1-a21f-0800200c9a33",
        "createdDate": "2021-01-01T00:00:00Z",
        "description": "SEOUL Guest Chair, red",
        "itemName": "RED CHAIR",
        "quantity": 1,
        "taxCode": "CODE.19",
        "taxRatePercentage": 19,
        "totalDiscountAmount": 10,
        "totalDiscountPercentage": 10,
        "totalGrossAmount": 109,
        "totalNetAmount": 100,
        "totalTaxAmount": 19,
        "unitAmount": 100,
        "unitDiscountAmount": 10,
        "unitDiscountPercentage": 10,
        "unitName": "PIECE",
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "oneLineAddress": "Main street 45, Berlin",
    "orderDate": "2021-01-01T00:00:00Z",
    "projectId": "1",
    "shippingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "status": "OPEN",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "updatedDate": "2021-01-01T00:00:00Z",
    "version": "1"
  }
}

POST

accounting

salesOrders

cURL

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": "Main street 45",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "billingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "comment": "Due today",
  "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "deliveryDate": "2021-01-01T00:00:00Z",
  "lineItems": [
    {
      "itemId": "efa82f42-fd85-11e1-a21f-0800200c9a33",
      "description": "SEOUL Guest Chair, red",
      "itemName": "RED CHAIR",
      "optional": true,
      "quantity": 1,
      "taxCode": "CODE.19",
      "taxRatePercentage": 19,
      "totalDiscountAmount": 10,
      "totalDiscountPercentage": 10,
      "totalGrossAmount": 109,
      "totalNetAmount": 100,
      "totalTaxAmount": 19,
      "unitAmount": 100,
      "unitDiscountAmount": 10,
      "unitDiscountPercentage": 10,
      "unitName": "PIECE"
    }
  ],
  "oneLineAddress": "Main street 45, Berlin",
  "orderDate": "2021-01-01T00:00:00Z",
  "projectId": "1",
  "shippingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "status": "OPEN",
  "totalDiscountAmount": 10,
  "totalDiscountPercentage": 10,
  "totalGrossAmount": 109,
  "totalNetAmount": 100,
  "totalTaxAmount": 19,
  "version": "1"
}
'

import requests

url = "https://api.maesn.dev/accounting/salesOrders"

payload = {
    "addresses": [
        {
            "addressLine1": "Main street 45",
            "addressLine2": "2nd floor",
            "city": "Berlin",
            "countryCode": "DE",
            "postalCode": "10243",
            "type": "BILLING"
        }
    ],
    "billingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "comment": "Due today",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "lineItems": [
        {
            "itemId": "efa82f42-fd85-11e1-a21f-0800200c9a33",
            "description": "SEOUL Guest Chair, red",
            "itemName": "RED CHAIR",
            "optional": True,
            "quantity": 1,
            "taxCode": "CODE.19",
            "taxRatePercentage": 19,
            "totalDiscountAmount": 10,
            "totalDiscountPercentage": 10,
            "totalGrossAmount": 109,
            "totalNetAmount": 100,
            "totalTaxAmount": 19,
            "unitAmount": 100,
            "unitDiscountAmount": 10,
            "unitDiscountPercentage": 10,
            "unitName": "PIECE"
        }
    ],
    "oneLineAddress": "Main street 45, Berlin",
    "orderDate": "2021-01-01T00:00:00Z",
    "projectId": "1",
    "shippingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "status": "OPEN",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "version": "1"
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "X-ACCOUNT-KEY": "<x-account-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-API-KEY': '<x-api-key>',
    'X-ACCOUNT-KEY': '<x-account-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    addresses: [
      {
        addressLine1: 'Main street 45',
        addressLine2: '2nd floor',
        city: 'Berlin',
        countryCode: 'DE',
        postalCode: '10243',
        type: 'BILLING'
      }
    ],
    billingContactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    comment: 'Due today',
    contactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    currency: 'EUR',
    deliveryDate: '2021-01-01T00:00:00Z',
    lineItems: [
      {
        itemId: 'efa82f42-fd85-11e1-a21f-0800200c9a33',
        description: 'SEOUL Guest Chair, red',
        itemName: 'RED CHAIR',
        optional: true,
        quantity: 1,
        taxCode: 'CODE.19',
        taxRatePercentage: 19,
        totalDiscountAmount: 10,
        totalDiscountPercentage: 10,
        totalGrossAmount: 109,
        totalNetAmount: 100,
        totalTaxAmount: 19,
        unitAmount: 100,
        unitDiscountAmount: 10,
        unitDiscountPercentage: 10,
        unitName: 'PIECE'
      }
    ],
    oneLineAddress: 'Main street 45, Berlin',
    orderDate: '2021-01-01T00:00:00Z',
    projectId: '1',
    shippingContactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    status: 'OPEN',
    totalDiscountAmount: 10,
    totalDiscountPercentage: 10,
    totalGrossAmount: 109,
    totalNetAmount: 100,
    totalTaxAmount: 19,
    version: '1'
  })
};

fetch('https://api.maesn.dev/accounting/salesOrders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.maesn.dev/accounting/salesOrders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'addresses' => [
        [
                'addressLine1' => 'Main street 45',
                'addressLine2' => '2nd floor',
                'city' => 'Berlin',
                'countryCode' => 'DE',
                'postalCode' => '10243',
                'type' => 'BILLING'
        ]
    ],
    'billingContactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'comment' => 'Due today',
    'contactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'currency' => 'EUR',
    'deliveryDate' => '2021-01-01T00:00:00Z',
    'lineItems' => [
        [
                'itemId' => 'efa82f42-fd85-11e1-a21f-0800200c9a33',
                'description' => 'SEOUL Guest Chair, red',
                'itemName' => 'RED CHAIR',
                'optional' => true,
                'quantity' => 1,
                'taxCode' => 'CODE.19',
                'taxRatePercentage' => 19,
                'totalDiscountAmount' => 10,
                'totalDiscountPercentage' => 10,
                'totalGrossAmount' => 109,
                'totalNetAmount' => 100,
                'totalTaxAmount' => 19,
                'unitAmount' => 100,
                'unitDiscountAmount' => 10,
                'unitDiscountPercentage' => 10,
                'unitName' => 'PIECE'
        ]
    ],
    'oneLineAddress' => 'Main street 45, Berlin',
    'orderDate' => '2021-01-01T00:00:00Z',
    'projectId' => '1',
    'shippingContactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'status' => 'OPEN',
    'totalDiscountAmount' => 10,
    'totalDiscountPercentage' => 10,
    'totalGrossAmount' => 109,
    'totalNetAmount' => 100,
    'totalTaxAmount' => 19,
    'version' => '1'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-ACCOUNT-KEY: <x-account-key>",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.maesn.dev/accounting/salesOrders"

	payload := strings.NewReader("{\n  \"addresses\": [\n    {\n      \"addressLine1\": \"Main street 45\",\n      \"addressLine2\": \"2nd floor\",\n      \"city\": \"Berlin\",\n      \"countryCode\": \"DE\",\n      \"postalCode\": \"10243\",\n      \"type\": \"BILLING\"\n    }\n  ],\n  \"billingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"comment\": \"Due today\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"lineItems\": [\n    {\n      \"itemId\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"itemName\": \"RED CHAIR\",\n      \"optional\": true,\n      \"quantity\": 1,\n      \"taxCode\": \"CODE.19\",\n      \"taxRatePercentage\": 19,\n      \"totalDiscountAmount\": 10,\n      \"totalDiscountPercentage\": 10,\n      \"totalGrossAmount\": 109,\n      \"totalNetAmount\": 100,\n      \"totalTaxAmount\": 19,\n      \"unitAmount\": 100,\n      \"unitDiscountAmount\": 10,\n      \"unitDiscountPercentage\": 10,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"orderDate\": \"2021-01-01T00:00:00Z\",\n  \"projectId\": \"1\",\n  \"shippingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"status\": \"OPEN\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19,\n  \"version\": \"1\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<x-api-key>")
	req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.maesn.dev/accounting/salesOrders")
  .header("X-API-KEY", "<x-api-key>")
  .header("X-ACCOUNT-KEY", "<x-account-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"addresses\": [\n    {\n      \"addressLine1\": \"Main street 45\",\n      \"addressLine2\": \"2nd floor\",\n      \"city\": \"Berlin\",\n      \"countryCode\": \"DE\",\n      \"postalCode\": \"10243\",\n      \"type\": \"BILLING\"\n    }\n  ],\n  \"billingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"comment\": \"Due today\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"lineItems\": [\n    {\n      \"itemId\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"itemName\": \"RED CHAIR\",\n      \"optional\": true,\n      \"quantity\": 1,\n      \"taxCode\": \"CODE.19\",\n      \"taxRatePercentage\": 19,\n      \"totalDiscountAmount\": 10,\n      \"totalDiscountPercentage\": 10,\n      \"totalGrossAmount\": 109,\n      \"totalNetAmount\": 100,\n      \"totalTaxAmount\": 19,\n      \"unitAmount\": 100,\n      \"unitDiscountAmount\": 10,\n      \"unitDiscountPercentage\": 10,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"orderDate\": \"2021-01-01T00:00:00Z\",\n  \"projectId\": \"1\",\n  \"shippingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"status\": \"OPEN\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19,\n  \"version\": \"1\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.maesn.dev/accounting/salesOrders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"addresses\": [\n    {\n      \"addressLine1\": \"Main street 45\",\n      \"addressLine2\": \"2nd floor\",\n      \"city\": \"Berlin\",\n      \"countryCode\": \"DE\",\n      \"postalCode\": \"10243\",\n      \"type\": \"BILLING\"\n    }\n  ],\n  \"billingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"comment\": \"Due today\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"lineItems\": [\n    {\n      \"itemId\": \"efa82f42-fd85-11e1-a21f-0800200c9a33\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"itemName\": \"RED CHAIR\",\n      \"optional\": true,\n      \"quantity\": 1,\n      \"taxCode\": \"CODE.19\",\n      \"taxRatePercentage\": 19,\n      \"totalDiscountAmount\": 10,\n      \"totalDiscountPercentage\": 10,\n      \"totalGrossAmount\": 109,\n      \"totalNetAmount\": 100,\n      \"totalTaxAmount\": 19,\n      \"unitAmount\": 100,\n      \"unitDiscountAmount\": 10,\n      \"unitDiscountPercentage\": 10,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"orderDate\": \"2021-01-01T00:00:00Z\",\n  \"projectId\": \"1\",\n  \"shippingContactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"status\": \"OPEN\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19,\n  \"version\": \"1\"\n}"

response = http.request(request)
puts response.read_body

{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
    "addresses": [
      {
        "addressLine1": "Main street 45",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "billingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "comment": "Due today",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "lineItems": [
      {
        "id": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "itemId": "efa82f42-fd85-11e1-a21f-0800200c9a33",
        "createdDate": "2021-01-01T00:00:00Z",
        "description": "SEOUL Guest Chair, red",
        "itemName": "RED CHAIR",
        "quantity": 1,
        "taxCode": "CODE.19",
        "taxRatePercentage": 19,
        "totalDiscountAmount": 10,
        "totalDiscountPercentage": 10,
        "totalGrossAmount": 109,
        "totalNetAmount": 100,
        "totalTaxAmount": 19,
        "unitAmount": 100,
        "unitDiscountAmount": 10,
        "unitDiscountPercentage": 10,
        "unitName": "PIECE",
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "oneLineAddress": "Main street 45, Berlin",
    "orderDate": "2021-01-01T00:00:00Z",
    "projectId": "1",
    "shippingContactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "status": "OPEN",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "updatedDate": "2021-01-01T00:00:00Z",
    "version": "1"
  }
}

Field support per integration

AbaConnect

This endpoint is asynchronous. If the request has not completed, the response returns a taskId. Use /asyncTask/{taskId} to check the task status and obtain the final result once it is ready.

Supported request parameters:

billingContactId

string

comment

string

contactId

string

lineItems

LineItem[]

Show properties

description

string

optional

boolean

quantity

number

totalDiscountPercentage

number

unitAmount

number

Price per unit

unitName

string

Supported values: PIECE, HOUR

projectId

string

totalDiscountPercentage

number

version

string

abacus

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:

billingContactId

string

comment

string

contactId

string

currency

enum

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

deliveryDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

lineItems

LineItem[]

Show properties

string

itemId

string

description

string

quantity

number

Note that quantity can be a decimal numeral.

taxRatePercentage

string

totalDiscountAmount

string

totalDiscountPercentage

string

totalGrossAmount

string

totalNetAmount

string

totalTaxAmount

string

unitAmount

string

orderDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

shippingContactId

string

status

enum

Available options: OPEN, CLOSED

totalDiscountPercentage

number

totalGrossAmount

number

Headers

X-API-KEY

string

required

API key

Example:

"example value"

X-ACCOUNT-KEY

string

required

Account key

Example:

"example value"

Query Parameters

companyId

string

environmentName

string

Body

application/json

addresses

object[]

Show child attributes

billingContactId

string

Example:

"eaa28f49-6028-4b6e-bb12-d8f6278073fc"

comment

string

Example:

"Due today"

contactId

string

Example:

"eaa28f49-6028-4b6e-bb12-d8f6278073fc"

currency

enum<string>

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"

deliveryDate

string

Example:

"2021-01-01T00:00:00Z"

lineItems

object[]

Show child attributes

oneLineAddress

string

Example:

"Main street 45, Berlin"

orderDate

string

Example:

"2021-01-01T00:00:00Z"

projectId

string

Example:

"1"

shippingContactId

string

Example:

"eaa28f49-6028-4b6e-bb12-d8f6278073fc"

status

enum<string>

Available options:

OPEN,

CLOSED

Example:

"OPEN"

totalDiscountAmount

string

Example:

10

totalDiscountPercentage

string

Example:

10

totalGrossAmount

string

Example:

109

totalNetAmount

string

Example:

100

totalTaxAmount

string

Example:

19

version

string

Example:

"1"

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Knowledgebase

Create sales order

Field support per integration

Headers

Query Parameters

Body

Response

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration