Create invoice

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/invoices \
  --header 'Content-Type: application/json' \
  --data '
{
  "addresses": [
    {
      "addressLine1": "Main street 45",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "discountPercentage": 10,
  "dueDate": "2021-02-01T00:00:00Z",
  "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
  "grossTotalAmount": 119,
  "invoiceDate": "2021-01-01T00:00:00Z",
  "invoiceNumber": "1020",
  "invoiceType": "STANDARD",
  "journalCode": "50",
  "lineAmountTypes": "EXCLUSIVE",
  "lineItems": [
    {
      "accountCode": "1890",
      "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
      "description": "SEOUL Guest Chair, red",
      "dimensions": [
        {
          "id": "c1d2e3f4-5678-9abc-def0-1234567890ab",
          "categoryName": "CostCenter",
          "name": "C1"
        }
      ],
      "discountItemPercentage": 10,
      "grossAmount": 109,
      "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
      "name": "RED CHAIR",
      "quantity": 1,
      "taxCode": "03",
      "taxRatePercentage": 19,
      "taxType": "Tax 19 percent",
      "type": "SERVICE",
      "unitAmount": 100,
      "unitName": "PIECE"
    }
  ],
  "name": "Office Supplies",
  "oneLineAddress": "Main street 45, Berlin",
  "paidDate": "2021-01-25T00:00:00Z",
  "paymentTermDuration": 30,
  "paymentTermId": "1",
  "reference": "RCXF197253F",
  "salesOrderId": "30911",
  "shippingDate": "2021-01-01T00:00:00Z",
  "shippingEndDate": "2021-01-10T00:00:00Z",
  "shippingType": "DELIVERYPERIOD",
  "status": "DRAFT",
  "taxRule": "NET",
  "taxText": "Tax 19 percent"
}
'

import requests

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

payload = {
    "addresses": [
        {
            "addressLine1": "Main street 45",
            "addressLine2": "2nd floor",
            "city": "Berlin",
            "countryCode": "DE",
            "postalCode": "10243",
            "type": "BILLING"
        }
    ],
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "discountPercentage": 10,
    "dueDate": "2021-02-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "grossTotalAmount": 119,
    "invoiceDate": "2021-01-01T00:00:00Z",
    "invoiceNumber": "1020",
    "invoiceType": "STANDARD",
    "journalCode": "50",
    "lineAmountTypes": "EXCLUSIVE",
    "lineItems": [
        {
            "accountCode": "1890",
            "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
            "description": "SEOUL Guest Chair, red",
            "dimensions": [
                {
                    "id": "c1d2e3f4-5678-9abc-def0-1234567890ab",
                    "categoryName": "CostCenter",
                    "name": "C1"
                }
            ],
            "discountItemPercentage": 10,
            "grossAmount": 109,
            "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
            "name": "RED CHAIR",
            "quantity": 1,
            "taxCode": "03",
            "taxRatePercentage": 19,
            "taxType": "Tax 19 percent",
            "type": "SERVICE",
            "unitAmount": 100,
            "unitName": "PIECE"
        }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentTermDuration": 30,
    "paymentTermId": "1",
    "reference": "RCXF197253F",
    "salesOrderId": "30911",
    "shippingDate": "2021-01-01T00:00:00Z",
    "shippingEndDate": "2021-01-10T00:00:00Z",
    "shippingType": "DELIVERYPERIOD",
    "status": "DRAFT",
    "taxRule": "NET",
    "taxText": "Tax 19 percent"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    addresses: [
      {
        addressLine1: 'Main street 45',
        addressLine2: '2nd floor',
        city: 'Berlin',
        countryCode: 'DE',
        postalCode: '10243',
        type: 'BILLING'
      }
    ],
    contactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    currency: 'EUR',
    discountPercentage: 10,
    dueDate: '2021-02-01T00:00:00Z',
    fileId: '93c6b8e0-80a4-4c22-a46c-18beebab82d6',
    grossTotalAmount: 119,
    invoiceDate: '2021-01-01T00:00:00Z',
    invoiceNumber: '1020',
    invoiceType: 'STANDARD',
    journalCode: '50',
    lineAmountTypes: 'EXCLUSIVE',
    lineItems: [
      {
        accountCode: '1890',
        accountId: '6733a433-9662-4a40-8e36-e38ebda94fe1',
        description: 'SEOUL Guest Chair, red',
        dimensions: [
          {
            id: 'c1d2e3f4-5678-9abc-def0-1234567890ab',
            categoryName: 'CostCenter',
            name: 'C1'
          }
        ],
        discountItemPercentage: 10,
        grossAmount: 109,
        itemId: '9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b',
        name: 'RED CHAIR',
        quantity: 1,
        taxCode: '03',
        taxRatePercentage: 19,
        taxType: 'Tax 19 percent',
        type: 'SERVICE',
        unitAmount: 100,
        unitName: 'PIECE'
      }
    ],
    name: 'Office Supplies',
    oneLineAddress: 'Main street 45, Berlin',
    paidDate: '2021-01-25T00:00:00Z',
    paymentTermDuration: 30,
    paymentTermId: '1',
    reference: 'RCXF197253F',
    salesOrderId: '30911',
    shippingDate: '2021-01-01T00:00:00Z',
    shippingEndDate: '2021-01-10T00:00:00Z',
    shippingType: 'DELIVERYPERIOD',
    status: 'DRAFT',
    taxRule: 'NET',
    taxText: 'Tax 19 percent'
  })
};

fetch('https://api.maesn.dev/accounting/invoices', 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/invoices",
  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'
        ]
    ],
    'contactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'currency' => 'EUR',
    'discountPercentage' => 10,
    'dueDate' => '2021-02-01T00:00:00Z',
    'fileId' => '93c6b8e0-80a4-4c22-a46c-18beebab82d6',
    'grossTotalAmount' => 119,
    'invoiceDate' => '2021-01-01T00:00:00Z',
    'invoiceNumber' => '1020',
    'invoiceType' => 'STANDARD',
    'journalCode' => '50',
    'lineAmountTypes' => 'EXCLUSIVE',
    'lineItems' => [
        [
                'accountCode' => '1890',
                'accountId' => '6733a433-9662-4a40-8e36-e38ebda94fe1',
                'description' => 'SEOUL Guest Chair, red',
                'dimensions' => [
                                [
                                                                'id' => 'c1d2e3f4-5678-9abc-def0-1234567890ab',
                                                                'categoryName' => 'CostCenter',
                                                                'name' => 'C1'
                                ]
                ],
                'discountItemPercentage' => 10,
                'grossAmount' => 109,
                'itemId' => '9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b',
                'name' => 'RED CHAIR',
                'quantity' => 1,
                'taxCode' => '03',
                'taxRatePercentage' => 19,
                'taxType' => 'Tax 19 percent',
                'type' => 'SERVICE',
                'unitAmount' => 100,
                'unitName' => 'PIECE'
        ]
    ],
    'name' => 'Office Supplies',
    'oneLineAddress' => 'Main street 45, Berlin',
    'paidDate' => '2021-01-25T00:00:00Z',
    'paymentTermDuration' => 30,
    'paymentTermId' => '1',
    'reference' => 'RCXF197253F',
    'salesOrderId' => '30911',
    'shippingDate' => '2021-01-01T00:00:00Z',
    'shippingEndDate' => '2021-01-10T00:00:00Z',
    'shippingType' => 'DELIVERYPERIOD',
    'status' => 'DRAFT',
    'taxRule' => 'NET',
    'taxText' => 'Tax 19 percent'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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/invoices"

	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  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"discountPercentage\": 10,\n  \"dueDate\": \"2021-02-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"grossTotalAmount\": 119,\n  \"invoiceDate\": \"2021-01-01T00:00:00Z\",\n  \"invoiceNumber\": \"1020\",\n  \"invoiceType\": \"STANDARD\",\n  \"journalCode\": \"50\",\n  \"lineAmountTypes\": \"EXCLUSIVE\",\n  \"lineItems\": [\n    {\n      \"accountCode\": \"1890\",\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"id\": \"c1d2e3f4-5678-9abc-def0-1234567890ab\",\n          \"categoryName\": \"CostCenter\",\n          \"name\": \"C1\"\n        }\n      ],\n      \"discountItemPercentage\": 10,\n      \"grossAmount\": 109,\n      \"itemId\": \"9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"name\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\n      \"taxRatePercentage\": 19,\n      \"taxType\": \"Tax 19 percent\",\n      \"type\": \"SERVICE\",\n      \"unitAmount\": 100,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentTermDuration\": 30,\n  \"paymentTermId\": \"1\",\n  \"reference\": \"RCXF197253F\",\n  \"salesOrderId\": \"30911\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingEndDate\": \"2021-01-10T00:00:00Z\",\n  \"shippingType\": \"DELIVERYPERIOD\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\"\n}")

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

	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/invoices")
  .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  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"discountPercentage\": 10,\n  \"dueDate\": \"2021-02-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"grossTotalAmount\": 119,\n  \"invoiceDate\": \"2021-01-01T00:00:00Z\",\n  \"invoiceNumber\": \"1020\",\n  \"invoiceType\": \"STANDARD\",\n  \"journalCode\": \"50\",\n  \"lineAmountTypes\": \"EXCLUSIVE\",\n  \"lineItems\": [\n    {\n      \"accountCode\": \"1890\",\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"id\": \"c1d2e3f4-5678-9abc-def0-1234567890ab\",\n          \"categoryName\": \"CostCenter\",\n          \"name\": \"C1\"\n        }\n      ],\n      \"discountItemPercentage\": 10,\n      \"grossAmount\": 109,\n      \"itemId\": \"9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"name\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\n      \"taxRatePercentage\": 19,\n      \"taxType\": \"Tax 19 percent\",\n      \"type\": \"SERVICE\",\n      \"unitAmount\": 100,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentTermDuration\": 30,\n  \"paymentTermId\": \"1\",\n  \"reference\": \"RCXF197253F\",\n  \"salesOrderId\": \"30911\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingEndDate\": \"2021-01-10T00:00:00Z\",\n  \"shippingType\": \"DELIVERYPERIOD\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
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  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"discountPercentage\": 10,\n  \"dueDate\": \"2021-02-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"grossTotalAmount\": 119,\n  \"invoiceDate\": \"2021-01-01T00:00:00Z\",\n  \"invoiceNumber\": \"1020\",\n  \"invoiceType\": \"STANDARD\",\n  \"journalCode\": \"50\",\n  \"lineAmountTypes\": \"EXCLUSIVE\",\n  \"lineItems\": [\n    {\n      \"accountCode\": \"1890\",\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"id\": \"c1d2e3f4-5678-9abc-def0-1234567890ab\",\n          \"categoryName\": \"CostCenter\",\n          \"name\": \"C1\"\n        }\n      ],\n      \"discountItemPercentage\": 10,\n      \"grossAmount\": 109,\n      \"itemId\": \"9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"name\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\n      \"taxRatePercentage\": 19,\n      \"taxType\": \"Tax 19 percent\",\n      \"type\": \"SERVICE\",\n      \"unitAmount\": 100,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentTermDuration\": 30,\n  \"paymentTermId\": \"1\",\n  \"reference\": \"RCXF197253F\",\n  \"salesOrderId\": \"30911\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingEndDate\": \"2021-01-10T00:00:00Z\",\n  \"shippingType\": \"DELIVERYPERIOD\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\"\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": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "invoiceId": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "addresses": [
      {
        "addressLine1": "Main street 45",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "discountAmount": 10,
    "dueDate": "2021-02-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "invoiceDate": "2021-01-01T00:00:00Z",
    "invoiceNumber": "1020",
    "invoiceType": "STANDARD",
    "journalCode": "50",
    "lineAmountType": "EXCLUSIVE",
    "lineItems": [
      {
        "lineItemId": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
        "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
        "createdDate": "2021-01-01T00:00:00Z",
        "description": "SEOUL Guest Chair, red",
        "dimensions": [
          {
            "id": "c1d2e3f4-5678-9abc-def0-1234567890ab",
            "categoryName": "CostCenter",
            "name": "C1"
          }
        ],
        "discountItemAmount": 10,
        "discountItemPercentage": 10,
        "grossAmount": 109,
        "itemsAmount": 100,
        "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "name": "RED CHAIR",
        "quantity": 1,
        "taxCode": "03",
        "taxRatePercentage": 19,
        "unitAmount": 100,
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentStatus": "PENDING",
    "paymentTermDuration": 30,
    "paymentTermId": "1",
    "reference": "RCXF197253F",
    "salesOrderId": "30911",
    "shippingDate": "2021-01-01T00:00:00Z",
    "status": "DRAFT",
    "sumNetAmount": 100,
    "taxRule": "NET",
    "totalAmount": 109,
    "totalTaxAmount": 19,
    "updatedDate": "2021-01-01T00:00:00Z"
  }
}

POST

accounting

invoices

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/invoices \
  --header 'Content-Type: application/json' \
  --data '
{
  "addresses": [
    {
      "addressLine1": "Main street 45",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "discountPercentage": 10,
  "dueDate": "2021-02-01T00:00:00Z",
  "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
  "grossTotalAmount": 119,
  "invoiceDate": "2021-01-01T00:00:00Z",
  "invoiceNumber": "1020",
  "invoiceType": "STANDARD",
  "journalCode": "50",
  "lineAmountTypes": "EXCLUSIVE",
  "lineItems": [
    {
      "accountCode": "1890",
      "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
      "description": "SEOUL Guest Chair, red",
      "dimensions": [
        {
          "id": "c1d2e3f4-5678-9abc-def0-1234567890ab",
          "categoryName": "CostCenter",
          "name": "C1"
        }
      ],
      "discountItemPercentage": 10,
      "grossAmount": 109,
      "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
      "name": "RED CHAIR",
      "quantity": 1,
      "taxCode": "03",
      "taxRatePercentage": 19,
      "taxType": "Tax 19 percent",
      "type": "SERVICE",
      "unitAmount": 100,
      "unitName": "PIECE"
    }
  ],
  "name": "Office Supplies",
  "oneLineAddress": "Main street 45, Berlin",
  "paidDate": "2021-01-25T00:00:00Z",
  "paymentTermDuration": 30,
  "paymentTermId": "1",
  "reference": "RCXF197253F",
  "salesOrderId": "30911",
  "shippingDate": "2021-01-01T00:00:00Z",
  "shippingEndDate": "2021-01-10T00:00:00Z",
  "shippingType": "DELIVERYPERIOD",
  "status": "DRAFT",
  "taxRule": "NET",
  "taxText": "Tax 19 percent"
}
'

import requests

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

payload = {
    "addresses": [
        {
            "addressLine1": "Main street 45",
            "addressLine2": "2nd floor",
            "city": "Berlin",
            "countryCode": "DE",
            "postalCode": "10243",
            "type": "BILLING"
        }
    ],
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "discountPercentage": 10,
    "dueDate": "2021-02-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "grossTotalAmount": 119,
    "invoiceDate": "2021-01-01T00:00:00Z",
    "invoiceNumber": "1020",
    "invoiceType": "STANDARD",
    "journalCode": "50",
    "lineAmountTypes": "EXCLUSIVE",
    "lineItems": [
        {
            "accountCode": "1890",
            "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
            "description": "SEOUL Guest Chair, red",
            "dimensions": [
                {
                    "id": "c1d2e3f4-5678-9abc-def0-1234567890ab",
                    "categoryName": "CostCenter",
                    "name": "C1"
                }
            ],
            "discountItemPercentage": 10,
            "grossAmount": 109,
            "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
            "name": "RED CHAIR",
            "quantity": 1,
            "taxCode": "03",
            "taxRatePercentage": 19,
            "taxType": "Tax 19 percent",
            "type": "SERVICE",
            "unitAmount": 100,
            "unitName": "PIECE"
        }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentTermDuration": 30,
    "paymentTermId": "1",
    "reference": "RCXF197253F",
    "salesOrderId": "30911",
    "shippingDate": "2021-01-01T00:00:00Z",
    "shippingEndDate": "2021-01-10T00:00:00Z",
    "shippingType": "DELIVERYPERIOD",
    "status": "DRAFT",
    "taxRule": "NET",
    "taxText": "Tax 19 percent"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    addresses: [
      {
        addressLine1: 'Main street 45',
        addressLine2: '2nd floor',
        city: 'Berlin',
        countryCode: 'DE',
        postalCode: '10243',
        type: 'BILLING'
      }
    ],
    contactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    currency: 'EUR',
    discountPercentage: 10,
    dueDate: '2021-02-01T00:00:00Z',
    fileId: '93c6b8e0-80a4-4c22-a46c-18beebab82d6',
    grossTotalAmount: 119,
    invoiceDate: '2021-01-01T00:00:00Z',
    invoiceNumber: '1020',
    invoiceType: 'STANDARD',
    journalCode: '50',
    lineAmountTypes: 'EXCLUSIVE',
    lineItems: [
      {
        accountCode: '1890',
        accountId: '6733a433-9662-4a40-8e36-e38ebda94fe1',
        description: 'SEOUL Guest Chair, red',
        dimensions: [
          {
            id: 'c1d2e3f4-5678-9abc-def0-1234567890ab',
            categoryName: 'CostCenter',
            name: 'C1'
          }
        ],
        discountItemPercentage: 10,
        grossAmount: 109,
        itemId: '9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b',
        name: 'RED CHAIR',
        quantity: 1,
        taxCode: '03',
        taxRatePercentage: 19,
        taxType: 'Tax 19 percent',
        type: 'SERVICE',
        unitAmount: 100,
        unitName: 'PIECE'
      }
    ],
    name: 'Office Supplies',
    oneLineAddress: 'Main street 45, Berlin',
    paidDate: '2021-01-25T00:00:00Z',
    paymentTermDuration: 30,
    paymentTermId: '1',
    reference: 'RCXF197253F',
    salesOrderId: '30911',
    shippingDate: '2021-01-01T00:00:00Z',
    shippingEndDate: '2021-01-10T00:00:00Z',
    shippingType: 'DELIVERYPERIOD',
    status: 'DRAFT',
    taxRule: 'NET',
    taxText: 'Tax 19 percent'
  })
};

fetch('https://api.maesn.dev/accounting/invoices', 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/invoices",
  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'
        ]
    ],
    'contactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'currency' => 'EUR',
    'discountPercentage' => 10,
    'dueDate' => '2021-02-01T00:00:00Z',
    'fileId' => '93c6b8e0-80a4-4c22-a46c-18beebab82d6',
    'grossTotalAmount' => 119,
    'invoiceDate' => '2021-01-01T00:00:00Z',
    'invoiceNumber' => '1020',
    'invoiceType' => 'STANDARD',
    'journalCode' => '50',
    'lineAmountTypes' => 'EXCLUSIVE',
    'lineItems' => [
        [
                'accountCode' => '1890',
                'accountId' => '6733a433-9662-4a40-8e36-e38ebda94fe1',
                'description' => 'SEOUL Guest Chair, red',
                'dimensions' => [
                                [
                                                                'id' => 'c1d2e3f4-5678-9abc-def0-1234567890ab',
                                                                'categoryName' => 'CostCenter',
                                                                'name' => 'C1'
                                ]
                ],
                'discountItemPercentage' => 10,
                'grossAmount' => 109,
                'itemId' => '9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b',
                'name' => 'RED CHAIR',
                'quantity' => 1,
                'taxCode' => '03',
                'taxRatePercentage' => 19,
                'taxType' => 'Tax 19 percent',
                'type' => 'SERVICE',
                'unitAmount' => 100,
                'unitName' => 'PIECE'
        ]
    ],
    'name' => 'Office Supplies',
    'oneLineAddress' => 'Main street 45, Berlin',
    'paidDate' => '2021-01-25T00:00:00Z',
    'paymentTermDuration' => 30,
    'paymentTermId' => '1',
    'reference' => 'RCXF197253F',
    'salesOrderId' => '30911',
    'shippingDate' => '2021-01-01T00:00:00Z',
    'shippingEndDate' => '2021-01-10T00:00:00Z',
    'shippingType' => 'DELIVERYPERIOD',
    'status' => 'DRAFT',
    'taxRule' => 'NET',
    'taxText' => 'Tax 19 percent'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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/invoices"

	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  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"discountPercentage\": 10,\n  \"dueDate\": \"2021-02-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"grossTotalAmount\": 119,\n  \"invoiceDate\": \"2021-01-01T00:00:00Z\",\n  \"invoiceNumber\": \"1020\",\n  \"invoiceType\": \"STANDARD\",\n  \"journalCode\": \"50\",\n  \"lineAmountTypes\": \"EXCLUSIVE\",\n  \"lineItems\": [\n    {\n      \"accountCode\": \"1890\",\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"id\": \"c1d2e3f4-5678-9abc-def0-1234567890ab\",\n          \"categoryName\": \"CostCenter\",\n          \"name\": \"C1\"\n        }\n      ],\n      \"discountItemPercentage\": 10,\n      \"grossAmount\": 109,\n      \"itemId\": \"9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"name\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\n      \"taxRatePercentage\": 19,\n      \"taxType\": \"Tax 19 percent\",\n      \"type\": \"SERVICE\",\n      \"unitAmount\": 100,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentTermDuration\": 30,\n  \"paymentTermId\": \"1\",\n  \"reference\": \"RCXF197253F\",\n  \"salesOrderId\": \"30911\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingEndDate\": \"2021-01-10T00:00:00Z\",\n  \"shippingType\": \"DELIVERYPERIOD\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\"\n}")

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

	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/invoices")
  .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  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"discountPercentage\": 10,\n  \"dueDate\": \"2021-02-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"grossTotalAmount\": 119,\n  \"invoiceDate\": \"2021-01-01T00:00:00Z\",\n  \"invoiceNumber\": \"1020\",\n  \"invoiceType\": \"STANDARD\",\n  \"journalCode\": \"50\",\n  \"lineAmountTypes\": \"EXCLUSIVE\",\n  \"lineItems\": [\n    {\n      \"accountCode\": \"1890\",\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"id\": \"c1d2e3f4-5678-9abc-def0-1234567890ab\",\n          \"categoryName\": \"CostCenter\",\n          \"name\": \"C1\"\n        }\n      ],\n      \"discountItemPercentage\": 10,\n      \"grossAmount\": 109,\n      \"itemId\": \"9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"name\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\n      \"taxRatePercentage\": 19,\n      \"taxType\": \"Tax 19 percent\",\n      \"type\": \"SERVICE\",\n      \"unitAmount\": 100,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentTermDuration\": 30,\n  \"paymentTermId\": \"1\",\n  \"reference\": \"RCXF197253F\",\n  \"salesOrderId\": \"30911\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingEndDate\": \"2021-01-10T00:00:00Z\",\n  \"shippingType\": \"DELIVERYPERIOD\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
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  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"discountPercentage\": 10,\n  \"dueDate\": \"2021-02-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"grossTotalAmount\": 119,\n  \"invoiceDate\": \"2021-01-01T00:00:00Z\",\n  \"invoiceNumber\": \"1020\",\n  \"invoiceType\": \"STANDARD\",\n  \"journalCode\": \"50\",\n  \"lineAmountTypes\": \"EXCLUSIVE\",\n  \"lineItems\": [\n    {\n      \"accountCode\": \"1890\",\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"id\": \"c1d2e3f4-5678-9abc-def0-1234567890ab\",\n          \"categoryName\": \"CostCenter\",\n          \"name\": \"C1\"\n        }\n      ],\n      \"discountItemPercentage\": 10,\n      \"grossAmount\": 109,\n      \"itemId\": \"9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"name\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\n      \"taxRatePercentage\": 19,\n      \"taxType\": \"Tax 19 percent\",\n      \"type\": \"SERVICE\",\n      \"unitAmount\": 100,\n      \"unitName\": \"PIECE\"\n    }\n  ],\n  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentTermDuration\": 30,\n  \"paymentTermId\": \"1\",\n  \"reference\": \"RCXF197253F\",\n  \"salesOrderId\": \"30911\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingEndDate\": \"2021-01-10T00:00:00Z\",\n  \"shippingType\": \"DELIVERYPERIOD\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\"\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": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "invoiceId": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "addresses": [
      {
        "addressLine1": "Main street 45",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "discountAmount": 10,
    "dueDate": "2021-02-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "invoiceDate": "2021-01-01T00:00:00Z",
    "invoiceNumber": "1020",
    "invoiceType": "STANDARD",
    "journalCode": "50",
    "lineAmountType": "EXCLUSIVE",
    "lineItems": [
      {
        "lineItemId": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
        "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
        "createdDate": "2021-01-01T00:00:00Z",
        "description": "SEOUL Guest Chair, red",
        "dimensions": [
          {
            "id": "c1d2e3f4-5678-9abc-def0-1234567890ab",
            "categoryName": "CostCenter",
            "name": "C1"
          }
        ],
        "discountItemAmount": 10,
        "discountItemPercentage": 10,
        "grossAmount": 109,
        "itemsAmount": 100,
        "itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "name": "RED CHAIR",
        "quantity": 1,
        "taxCode": "03",
        "taxRatePercentage": 19,
        "unitAmount": 100,
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentStatus": "PENDING",
    "paymentTermDuration": 30,
    "paymentTermId": "1",
    "reference": "RCXF197253F",
    "salesOrderId": "30911",
    "shippingDate": "2021-01-01T00:00:00Z",
    "status": "DRAFT",
    "sumNetAmount": 100,
    "taxRule": "NET",
    "totalAmount": 109,
    "totalTaxAmount": 19,
    "updatedDate": "2021-01-01T00:00:00Z"
  }
}

Field support per integration

BuchhaltungsButler

Supported request parameters:

string

required

string

required

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

Address[]

Show properties

string

enum

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

LineItem[]

required

Show properties

string

required

number

required

Note that quantity can be a decimal numeral.

number

required

number

required

string

required

number

Business Central

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 request parameters:

string

required

enum

Available options: STANDARD

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

string

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

Address[]

Show properties

string

enum

Available options: SELLING, DELIVERY

LineItem[]

Show properties

string

number

Note that quantity can be a decimal numeral.

number

Exact Online

If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.

To create invoices in Exact Online, your account must have one of the following package subscriptions enabled:

Manufacturing (any tier)
Professional Services (Plus, Professional, or Premium)
Wholesale & Distribution (any tier)
Accountancy Premium
Accounting

Supported request parameters:

string

required

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

number

string

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

string

required

LineItem[]

Show properties

string

required

string

Dimension[]

Show properties

string

required

string

number

string

The taxCode is used to determine the tax rate for the line item.

If taxCode is not provided, the default tax code will be used (if available).

number

If taxCode is provided, this taxRatePercentage will be overridden by the tax rate associated with the provided taxCode.

number

required

The unitAmount is the net amount charged for each unit of the line item.

When the taxCode is of type INCLUSIVE, then the unitAmount will be treated as a gross amount (i.e., including tax).

string

fortnox

Supported request parameters:

Address[]

Show properties

string

enum

Available options: BILLING, DELIVERY

string

required

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

string

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

string

Unique alpha numeric code identifying the invoice.

enum

Available options: STANDARD

string

LineItem[]

Show properties

string

Dimension[]

Show properties

string

number

string

number

string

number

string

Lexware Office

As a minimum a valid contactId OR a name and countryCode must be provided. We recommend to always provide a valid address in addition in the latter case

Supported request parameters:

string

enum

required

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

required

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

Address[]

Show properties

string

enum

Available options: BILLING

enum

required

Available options:NET, TAXFREE, INTRACOMMUNITY_GOODS, INTRACOMMUNITY_SERVICE, EXPORT_SERVICE, EXPORT_GOODS, REVERSE_CHARGE , GROSS, CONSTRUCTION_SERVICE, PHOTOVOLTAIC_EQUIPMENT

LineItem[]

required

Show properties

string

Note that this field is required if type is SERVICE_ITEM or MATERIAL

string

required

string

number

Note that quantity can be a decimal numeral.

enum

required

Available options: SERVICE_ITEM, MATERIAL, CUSTOM, TEXT

string

required

number

Note that this field is required if taxRule is NET

number

Note that this field is required if taxRule is GROSS

number

required

number

enum

required

Available options:SERVICE, SERVICEPERIOD, DELIVERY, DELIVERYPERIOD, NONE

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z.Note that this field is required if shippingType is SERVICE, DELIVERY, SERVICEPERIOD or DELIVERYPERIOD.

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z.Note that this field is required if shippingType is SERVICEPERIOD or DELIVERYPERIOD

number

QuickBooks

Supported request parameters:

Address[]

Show properties

string

enum

Available options: BILLING,DELIVERY

string

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

string

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

string

LineItem[]

required

Show properties

string

number

required

Note that quantity can be a decimal numeral.

string

The field is not supported for non UK companies. For UK companies it is required.

number

required

enum

Available options: DRAFT,OPEN

Sage Active

Supported request parameters:

string

required

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

string

Additional document number.

LineItem[]

required

Show properties

string

required

The product ID.

string

required

number

Note that quantity can be a decimal numeral.

number

Sevdesk

Supported request parameters:

string

required

string

Additional reference number. May be customer number, order number or similar.

enum

required

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

required

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

enum

required

Available options: DRAFT, SUBMITTED, AUTHORISED, PAID, CANCELED

enum

required

Available options: STANDARD

enum

required

Available options:NET, TAXFREE, INTRACOMMUNITY_SERVICE, EXPORT_SERVICE, REVERSE_CHARGE, SMALL_BUSINESS_VAT_EXEMPTION , NON_DOMESTIC_SERVICE, OSS_GOODS, OSS_ELECTRONIC_SERVICES, OSS_SERVICES

string

required

Tax description

LineItem[]

required

Show properties

string

required

number

required

Note that quantity can be a decimal numeral.

string

number

required

number

string

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

string

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

number

weclapp

Supported request parameters:

Address[]

Show properties

string

enum

Available options: BILLING, DELIVERY

string

required

string

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

string

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

string

Unique alpha numeric code identifying the invoice.

enum

Available options: STANDARD

LineItem[]

Show properties

string

number

Note that quantity can be a decimal numeral.

number

string

enum

Available options: PENDING, PAID, CLEARED_WITH_CREDIT_NOTE, CREDIT_NOTE_CLEARED, NO_OPEN_ITEM, UNKNOWN

string

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

enum

Available options: DRAFT, SUBMITTED, DOCUMENT_CREATED, OPEN, VOIDED

number

Xero

Supported request parameters:

string

required

string

Additional reference number. May be customer number, order number or similar.

enum

required

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

required

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

enum

required

Available options: DRAFT, SUBMITTED, AUTHORISED, PAID, CANCELED

enum

required

Available options: STANDARD

LineItem[]

required

Show properties

number

required

Note that quantity can be a decimal numeral.

string

number

required

number

enum

Available options: EXCLUSIVE, INCLUSIVE, NOTAX

string

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

Headers

X-API-KEY

string

API key

X-ACCOUNT-KEY

string

Account key

Query Parameters

companyId

string

environmentName

string

Body

application/json

addresses

object[]

Show child attributes

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"

discountPercentage

number

Example:

10

dueDate

string

Example:

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

fileId

string

Example:

"93c6b8e0-80a4-4c22-a46c-18beebab82d6"

grossTotalAmount

number

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

Example:

119

invoiceDate

string

Example:

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

invoiceNumber

string

Example:

"1020"

invoiceType

enum<string>

Available options:

STANDARD

Example:

"STANDARD"

journalCode

string

Example:

"50"

lineAmountTypes

enum<string>

Available options:

EXCLUSIVE,

INCLUSIVE,

NOTAX

Example:

"EXCLUSIVE"

lineItems

object[]

Show child attributes

name

string

Example:

"Office Supplies"

oneLineAddress

string

Example:

"Main street 45, Berlin"

paidDate

string

Example:

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

paymentTermDuration

number

Example:

30

paymentTermId

string

Example:

"1"

reference

string

Example:

"RCXF197253F"

salesOrderId

string

Example:

"30911"

shippingDate

string

Example:

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

shippingEndDate

string

Example:

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

shippingType

enum<string>

Available options:

SERVICE,

SERVICEPERIOD,

DELIVERY,

DELIVERYPERIOD,

NONE

Example:

"DELIVERYPERIOD"

status

enum<string>

Available options:

DRAFT,

CORRECTIVE,

SUBMITTED,

DOCUMENT_CREATED,

OPEN,

PARTIALLY_PAID,

PAID,

PARTIALLY_OVERDUE,

OVERDUE,

VOIDED

Example:

"DRAFT"

taxRule

enum<string>

Available options:

NET,

TAXFREE,

INTRACOMMUNITY_GOODS,

INTRACOMMUNITY_SERVICE,

EXPORT_SERVICE,

EXPORT_GOODS,

REVERSE_CHARGE,

GROSS,

CONSTRUCTION_SERVICE,

PHOTOVOLTAIC_EQUIPMENT,

SMALL_BUSINESS_VAT_EXEMPTION,

NON_DOMESTIC_SERVICE,

OSS_GOODS,

OSS_ELECTRONIC_SERVICES,

OSS_SERVICES

Example:

"NET"

taxText

string

Example:

"Tax 19 percent"

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Knowledgebase

Create invoice

Field support per integration

Headers

Query Parameters

Body

Response

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration