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",
      "lineNumber": "2",
      "optional": true,
      "parentLineNumber": "1",
      "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",
            "lineNumber": "2",
            "optional": True,
            "parentLineNumber": "1",
            "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',
        lineNumber: '2',
        optional: true,
        parentLineNumber: '1',
        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',
                'lineNumber' => '2',
                'optional' => true,
                'parentLineNumber' => '1',
                '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      \"lineNumber\": \"2\",\n      \"optional\": true,\n      \"parentLineNumber\": \"1\",\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      \"lineNumber\": \"2\",\n      \"optional\": true,\n      \"parentLineNumber\": \"1\",\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      \"lineNumber\": \"2\",\n      \"optional\": true,\n      \"parentLineNumber\": \"1\",\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",
      "lineNumber": "2",
      "optional": true,
      "parentLineNumber": "1",
      "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",
            "lineNumber": "2",
            "optional": True,
            "parentLineNumber": "1",
            "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',
        lineNumber: '2',
        optional: true,
        parentLineNumber: '1',
        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',
                'lineNumber' => '2',
                'optional' => true,
                'parentLineNumber' => '1',
                '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      \"lineNumber\": \"2\",\n      \"optional\": true,\n      \"parentLineNumber\": \"1\",\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      \"lineNumber\": \"2\",\n      \"optional\": true,\n      \"parentLineNumber\": \"1\",\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      \"lineNumber\": \"2\",\n      \"optional\": true,\n      \"parentLineNumber\": \"1\",\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 and an objectId. Use /asyncTask/{taskId} to check the task status and obtain the final result once it is ready. The objectId is the projectId you sent in the request. If the request completes instantly, you get a response body back instead, but only the id is populated. That id is the same as the objectId.

Supported request parameters:

string

LineItem[]

Show properties

string

A unique identifier for this line item, used so other line items can reference it as their parent via parentLineNumber. Only needed when this line is part of a collective position — either as the parent or as a child. Must be a whole number between 1 and 999 (max 3 digits).

boolean

string

The lineNumber of this line’s parent. Setting this turns the line into a child of a collective position — the line it points to (and this line itself) will be grouped together as a collective position instead of a standalone line item. Collective positions support one level of nesting only: a line referenced as a parentLineNumber cannot itself have a parentLineNumber.

number

Price per unit

string

Supported values: PIECE, HOUR

string

number

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:

string

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

string

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

LineItem[]

Show properties

string

number

Note that quantity can be a decimal numeral.

string

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

string

enum

Available options: OPEN, CLOSED

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

Total discount applied, in the document currency.

Example:

10

totalDiscountPercentage

string

Total discount applied, as a percentage.

Example:

10

totalGrossAmount

string

Gross total — the net amount plus tax (the total payable, including VAT).

Example:

109

totalNetAmount

string

Net total — the sum of all line amounts before tax (excluding VAT).

Example:

100

totalTaxAmount

string

Tax (VAT) total — the difference between the gross and net totals.

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