Create bill

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/bills \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
  "addresses": [
    {
      "addressLine1": "Main street 45",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "billDate": "2021-01-01T00:00:00Z",
  "billNumber": "1020",
  "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "deliveryDate": "2021-01-01T00:00:00Z",
  "dueDate": "2021-07-01T00:00:00Z",
  "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
  "journalCode": "30",
  "lineItems": [
    {
      "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
      "accountNumber": "200",
      "deferredEndDate": "2021-06-01T00:00:00Z",
      "deferredStartDate": "2021-01-01T00:00:00Z",
      "description": "SEOUL Guest Chair, red",
      "dimensions": [
        {
          "name": "C1",
          "categoryName": "CostCenter"
        }
      ],
      "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
      "itemName": "RED CHAIR",
      "quantity": 1,
      "taxCode": "03",
      "taxRatePercentage": 19,
      "totalDiscountAmount": 10,
      "totalDiscountPercentage": 10,
      "totalGrossAmount": 109,
      "totalNetAmount": 100,
      "totalTaxAmount": 19,
      "unitAmount": 100,
      "unitDiscountAmount": 10,
      "unitDiscountPercentage": 10,
      "unitName": "PIECE"
    }
  ],
  "name": "Office Supplies",
  "oneLineAddress": "Main street 45, Berlin",
  "paidDate": "2021-01-25T00:00:00Z",
  "paymentDays": 30,
  "paymentReference": "Edefad142e764894",
  "paymentStatus": "PENDING",
  "paymentTermCode": "21",
  "reference": "026 / 245",
  "shippingDate": "2021-01-01T00:00:00Z",
  "shippingType": "DELIVERY",
  "status": "DRAFT",
  "taxRule": "NET",
  "taxText": "Tax 19 percent",
  "totalDiscountAmount": 10,
  "totalDiscountPercentage": 10,
  "totalGrossAmount": 109,
  "totalNetAmount": 100,
  "totalTaxAmount": 19
}
'

import requests

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

payload = {
    "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
    "addresses": [
        {
            "addressLine1": "Main street 45",
            "addressLine2": "2nd floor",
            "city": "Berlin",
            "countryCode": "DE",
            "postalCode": "10243",
            "type": "BILLING"
        }
    ],
    "billDate": "2021-01-01T00:00:00Z",
    "billNumber": "1020",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "dueDate": "2021-07-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "journalCode": "30",
    "lineItems": [
        {
            "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
            "accountNumber": "200",
            "deferredEndDate": "2021-06-01T00:00:00Z",
            "deferredStartDate": "2021-01-01T00:00:00Z",
            "description": "SEOUL Guest Chair, red",
            "dimensions": [
                {
                    "name": "C1",
                    "categoryName": "CostCenter"
                }
            ],
            "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
            "itemName": "RED CHAIR",
            "quantity": 1,
            "taxCode": "03",
            "taxRatePercentage": 19,
            "totalDiscountAmount": 10,
            "totalDiscountPercentage": 10,
            "totalGrossAmount": 109,
            "totalNetAmount": 100,
            "totalTaxAmount": 19,
            "unitAmount": 100,
            "unitDiscountAmount": 10,
            "unitDiscountPercentage": 10,
            "unitName": "PIECE"
        }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentDays": 30,
    "paymentReference": "Edefad142e764894",
    "paymentStatus": "PENDING",
    "paymentTermCode": "21",
    "reference": "026 / 245",
    "shippingDate": "2021-01-01T00:00:00Z",
    "shippingType": "DELIVERY",
    "status": "DRAFT",
    "taxRule": "NET",
    "taxText": "Tax 19 percent",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19
}
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({
    accountId: '6733a433-9662-4a40-8e36-e38ebda94fe1',
    addresses: [
      {
        addressLine1: 'Main street 45',
        addressLine2: '2nd floor',
        city: 'Berlin',
        countryCode: 'DE',
        postalCode: '10243',
        type: 'BILLING'
      }
    ],
    billDate: '2021-01-01T00:00:00Z',
    billNumber: '1020',
    contactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    currency: 'EUR',
    deliveryDate: '2021-01-01T00:00:00Z',
    dueDate: '2021-07-01T00:00:00Z',
    fileId: '93c6b8e0-80a4-4c22-a46c-18beebab82d6',
    journalCode: '30',
    lineItems: [
      {
        accountId: '6733a433-9662-4a40-8e36-e38ebda94fe1',
        accountNumber: '200',
        deferredEndDate: '2021-06-01T00:00:00Z',
        deferredStartDate: '2021-01-01T00:00:00Z',
        description: 'SEOUL Guest Chair, red',
        dimensions: [{name: 'C1', categoryName: 'CostCenter'}],
        itemId: '4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b',
        itemName: 'RED CHAIR',
        quantity: 1,
        taxCode: '03',
        taxRatePercentage: 19,
        totalDiscountAmount: 10,
        totalDiscountPercentage: 10,
        totalGrossAmount: 109,
        totalNetAmount: 100,
        totalTaxAmount: 19,
        unitAmount: 100,
        unitDiscountAmount: 10,
        unitDiscountPercentage: 10,
        unitName: 'PIECE'
      }
    ],
    name: 'Office Supplies',
    oneLineAddress: 'Main street 45, Berlin',
    paidDate: '2021-01-25T00:00:00Z',
    paymentDays: 30,
    paymentReference: 'Edefad142e764894',
    paymentStatus: 'PENDING',
    paymentTermCode: '21',
    reference: '026 / 245',
    shippingDate: '2021-01-01T00:00:00Z',
    shippingType: 'DELIVERY',
    status: 'DRAFT',
    taxRule: 'NET',
    taxText: 'Tax 19 percent',
    totalDiscountAmount: 10,
    totalDiscountPercentage: 10,
    totalGrossAmount: 109,
    totalNetAmount: 100,
    totalTaxAmount: 19
  })
};

fetch('https://api.maesn.dev/accounting/bills', 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/bills",
  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([
    'accountId' => '6733a433-9662-4a40-8e36-e38ebda94fe1',
    'addresses' => [
        [
                'addressLine1' => 'Main street 45',
                'addressLine2' => '2nd floor',
                'city' => 'Berlin',
                'countryCode' => 'DE',
                'postalCode' => '10243',
                'type' => 'BILLING'
        ]
    ],
    'billDate' => '2021-01-01T00:00:00Z',
    'billNumber' => '1020',
    'contactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'currency' => 'EUR',
    'deliveryDate' => '2021-01-01T00:00:00Z',
    'dueDate' => '2021-07-01T00:00:00Z',
    'fileId' => '93c6b8e0-80a4-4c22-a46c-18beebab82d6',
    'journalCode' => '30',
    'lineItems' => [
        [
                'accountId' => '6733a433-9662-4a40-8e36-e38ebda94fe1',
                'accountNumber' => '200',
                'deferredEndDate' => '2021-06-01T00:00:00Z',
                'deferredStartDate' => '2021-01-01T00:00:00Z',
                'description' => 'SEOUL Guest Chair, red',
                'dimensions' => [
                                [
                                                                'name' => 'C1',
                                                                'categoryName' => 'CostCenter'
                                ]
                ],
                'itemId' => '4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b',
                'itemName' => 'RED CHAIR',
                'quantity' => 1,
                'taxCode' => '03',
                'taxRatePercentage' => 19,
                'totalDiscountAmount' => 10,
                'totalDiscountPercentage' => 10,
                'totalGrossAmount' => 109,
                'totalNetAmount' => 100,
                'totalTaxAmount' => 19,
                'unitAmount' => 100,
                'unitDiscountAmount' => 10,
                'unitDiscountPercentage' => 10,
                'unitName' => 'PIECE'
        ]
    ],
    'name' => 'Office Supplies',
    'oneLineAddress' => 'Main street 45, Berlin',
    'paidDate' => '2021-01-25T00:00:00Z',
    'paymentDays' => 30,
    'paymentReference' => 'Edefad142e764894',
    'paymentStatus' => 'PENDING',
    'paymentTermCode' => '21',
    'reference' => '026 / 245',
    'shippingDate' => '2021-01-01T00:00:00Z',
    'shippingType' => 'DELIVERY',
    'status' => 'DRAFT',
    'taxRule' => 'NET',
    'taxText' => 'Tax 19 percent',
    'totalDiscountAmount' => 10,
    'totalDiscountPercentage' => 10,
    'totalGrossAmount' => 109,
    'totalNetAmount' => 100,
    'totalTaxAmount' => 19
  ]),
  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/bills"

	payload := strings.NewReader("{\n  \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\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  \"billDate\": \"2021-01-01T00:00:00Z\",\n  \"billNumber\": \"1020\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"dueDate\": \"2021-07-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"journalCode\": \"30\",\n  \"lineItems\": [\n    {\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"accountNumber\": \"200\",\n      \"deferredEndDate\": \"2021-06-01T00:00:00Z\",\n      \"deferredStartDate\": \"2021-01-01T00:00:00Z\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"name\": \"C1\",\n          \"categoryName\": \"CostCenter\"\n        }\n      ],\n      \"itemId\": \"4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"itemName\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\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  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentDays\": 30,\n  \"paymentReference\": \"Edefad142e764894\",\n  \"paymentStatus\": \"PENDING\",\n  \"paymentTermCode\": \"21\",\n  \"reference\": \"026 / 245\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingType\": \"DELIVERY\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19\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/bills")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\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  \"billDate\": \"2021-01-01T00:00:00Z\",\n  \"billNumber\": \"1020\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"dueDate\": \"2021-07-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"journalCode\": \"30\",\n  \"lineItems\": [\n    {\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"accountNumber\": \"200\",\n      \"deferredEndDate\": \"2021-06-01T00:00:00Z\",\n      \"deferredStartDate\": \"2021-01-01T00:00:00Z\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"name\": \"C1\",\n          \"categoryName\": \"CostCenter\"\n        }\n      ],\n      \"itemId\": \"4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"itemName\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\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  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentDays\": 30,\n  \"paymentReference\": \"Edefad142e764894\",\n  \"paymentStatus\": \"PENDING\",\n  \"paymentTermCode\": \"21\",\n  \"reference\": \"026 / 245\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingType\": \"DELIVERY\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\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  \"billDate\": \"2021-01-01T00:00:00Z\",\n  \"billNumber\": \"1020\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"dueDate\": \"2021-07-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"journalCode\": \"30\",\n  \"lineItems\": [\n    {\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"accountNumber\": \"200\",\n      \"deferredEndDate\": \"2021-06-01T00:00:00Z\",\n      \"deferredStartDate\": \"2021-01-01T00:00:00Z\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"name\": \"C1\",\n          \"categoryName\": \"CostCenter\"\n        }\n      ],\n      \"itemId\": \"4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"itemName\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\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  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentDays\": 30,\n  \"paymentReference\": \"Edefad142e764894\",\n  \"paymentStatus\": \"PENDING\",\n  \"paymentTermCode\": \"21\",\n  \"reference\": \"026 / 245\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingType\": \"DELIVERY\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19\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",
    "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
    "addresses": [
      {
        "addressLine1": "Main street 45",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "billDate": "2021-01-01T00:00:00Z",
    "billNumber": "1020",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "dueDate": "2021-07-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "journalCode": "30",
    "lineItems": [
      {
        "id": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
        "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
        "accountNumber": "200",
        "createdDate": "2021-01-01T00:00:00Z",
        "deferredEndDate": "2021-06-01T00:00:00Z",
        "deferredStartDate": "2021-01-01T00:00:00Z",
        "description": "SEOUL Guest Chair, red",
        "dimensions": [
          {
            "name": "C1",
            "categoryName": "CostCenter"
          }
        ],
        "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "itemName": "RED CHAIR",
        "quantity": 1,
        "taxCode": "03",
        "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"
      }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentDays": 30,
    "paymentReference": "Edefad142e764894",
    "paymentStatus": "PENDING",
    "paymentTermCode": "21",
    "reference": "026 / 245",
    "shippingDate": "2021-01-01T00:00:00Z",
    "shippingType": "DELIVERY",
    "status": "DRAFT",
    "taxRule": "NET",
    "taxText": "Tax 19 percent",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "updatedDate": "2021-01-01T00:00:00Z"
  }
}

POST

accounting

bills

cURL

curl --request POST \
  --url https://api.maesn.dev/accounting/bills \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
  "addresses": [
    {
      "addressLine1": "Main street 45",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "billDate": "2021-01-01T00:00:00Z",
  "billNumber": "1020",
  "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "deliveryDate": "2021-01-01T00:00:00Z",
  "dueDate": "2021-07-01T00:00:00Z",
  "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
  "journalCode": "30",
  "lineItems": [
    {
      "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
      "accountNumber": "200",
      "deferredEndDate": "2021-06-01T00:00:00Z",
      "deferredStartDate": "2021-01-01T00:00:00Z",
      "description": "SEOUL Guest Chair, red",
      "dimensions": [
        {
          "name": "C1",
          "categoryName": "CostCenter"
        }
      ],
      "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
      "itemName": "RED CHAIR",
      "quantity": 1,
      "taxCode": "03",
      "taxRatePercentage": 19,
      "totalDiscountAmount": 10,
      "totalDiscountPercentage": 10,
      "totalGrossAmount": 109,
      "totalNetAmount": 100,
      "totalTaxAmount": 19,
      "unitAmount": 100,
      "unitDiscountAmount": 10,
      "unitDiscountPercentage": 10,
      "unitName": "PIECE"
    }
  ],
  "name": "Office Supplies",
  "oneLineAddress": "Main street 45, Berlin",
  "paidDate": "2021-01-25T00:00:00Z",
  "paymentDays": 30,
  "paymentReference": "Edefad142e764894",
  "paymentStatus": "PENDING",
  "paymentTermCode": "21",
  "reference": "026 / 245",
  "shippingDate": "2021-01-01T00:00:00Z",
  "shippingType": "DELIVERY",
  "status": "DRAFT",
  "taxRule": "NET",
  "taxText": "Tax 19 percent",
  "totalDiscountAmount": 10,
  "totalDiscountPercentage": 10,
  "totalGrossAmount": 109,
  "totalNetAmount": 100,
  "totalTaxAmount": 19
}
'

import requests

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

payload = {
    "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
    "addresses": [
        {
            "addressLine1": "Main street 45",
            "addressLine2": "2nd floor",
            "city": "Berlin",
            "countryCode": "DE",
            "postalCode": "10243",
            "type": "BILLING"
        }
    ],
    "billDate": "2021-01-01T00:00:00Z",
    "billNumber": "1020",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "dueDate": "2021-07-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "journalCode": "30",
    "lineItems": [
        {
            "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
            "accountNumber": "200",
            "deferredEndDate": "2021-06-01T00:00:00Z",
            "deferredStartDate": "2021-01-01T00:00:00Z",
            "description": "SEOUL Guest Chair, red",
            "dimensions": [
                {
                    "name": "C1",
                    "categoryName": "CostCenter"
                }
            ],
            "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
            "itemName": "RED CHAIR",
            "quantity": 1,
            "taxCode": "03",
            "taxRatePercentage": 19,
            "totalDiscountAmount": 10,
            "totalDiscountPercentage": 10,
            "totalGrossAmount": 109,
            "totalNetAmount": 100,
            "totalTaxAmount": 19,
            "unitAmount": 100,
            "unitDiscountAmount": 10,
            "unitDiscountPercentage": 10,
            "unitName": "PIECE"
        }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentDays": 30,
    "paymentReference": "Edefad142e764894",
    "paymentStatus": "PENDING",
    "paymentTermCode": "21",
    "reference": "026 / 245",
    "shippingDate": "2021-01-01T00:00:00Z",
    "shippingType": "DELIVERY",
    "status": "DRAFT",
    "taxRule": "NET",
    "taxText": "Tax 19 percent",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19
}
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({
    accountId: '6733a433-9662-4a40-8e36-e38ebda94fe1',
    addresses: [
      {
        addressLine1: 'Main street 45',
        addressLine2: '2nd floor',
        city: 'Berlin',
        countryCode: 'DE',
        postalCode: '10243',
        type: 'BILLING'
      }
    ],
    billDate: '2021-01-01T00:00:00Z',
    billNumber: '1020',
    contactId: 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    currency: 'EUR',
    deliveryDate: '2021-01-01T00:00:00Z',
    dueDate: '2021-07-01T00:00:00Z',
    fileId: '93c6b8e0-80a4-4c22-a46c-18beebab82d6',
    journalCode: '30',
    lineItems: [
      {
        accountId: '6733a433-9662-4a40-8e36-e38ebda94fe1',
        accountNumber: '200',
        deferredEndDate: '2021-06-01T00:00:00Z',
        deferredStartDate: '2021-01-01T00:00:00Z',
        description: 'SEOUL Guest Chair, red',
        dimensions: [{name: 'C1', categoryName: 'CostCenter'}],
        itemId: '4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b',
        itemName: 'RED CHAIR',
        quantity: 1,
        taxCode: '03',
        taxRatePercentage: 19,
        totalDiscountAmount: 10,
        totalDiscountPercentage: 10,
        totalGrossAmount: 109,
        totalNetAmount: 100,
        totalTaxAmount: 19,
        unitAmount: 100,
        unitDiscountAmount: 10,
        unitDiscountPercentage: 10,
        unitName: 'PIECE'
      }
    ],
    name: 'Office Supplies',
    oneLineAddress: 'Main street 45, Berlin',
    paidDate: '2021-01-25T00:00:00Z',
    paymentDays: 30,
    paymentReference: 'Edefad142e764894',
    paymentStatus: 'PENDING',
    paymentTermCode: '21',
    reference: '026 / 245',
    shippingDate: '2021-01-01T00:00:00Z',
    shippingType: 'DELIVERY',
    status: 'DRAFT',
    taxRule: 'NET',
    taxText: 'Tax 19 percent',
    totalDiscountAmount: 10,
    totalDiscountPercentage: 10,
    totalGrossAmount: 109,
    totalNetAmount: 100,
    totalTaxAmount: 19
  })
};

fetch('https://api.maesn.dev/accounting/bills', 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/bills",
  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([
    'accountId' => '6733a433-9662-4a40-8e36-e38ebda94fe1',
    'addresses' => [
        [
                'addressLine1' => 'Main street 45',
                'addressLine2' => '2nd floor',
                'city' => 'Berlin',
                'countryCode' => 'DE',
                'postalCode' => '10243',
                'type' => 'BILLING'
        ]
    ],
    'billDate' => '2021-01-01T00:00:00Z',
    'billNumber' => '1020',
    'contactId' => 'eaa28f49-6028-4b6e-bb12-d8f6278073fc',
    'currency' => 'EUR',
    'deliveryDate' => '2021-01-01T00:00:00Z',
    'dueDate' => '2021-07-01T00:00:00Z',
    'fileId' => '93c6b8e0-80a4-4c22-a46c-18beebab82d6',
    'journalCode' => '30',
    'lineItems' => [
        [
                'accountId' => '6733a433-9662-4a40-8e36-e38ebda94fe1',
                'accountNumber' => '200',
                'deferredEndDate' => '2021-06-01T00:00:00Z',
                'deferredStartDate' => '2021-01-01T00:00:00Z',
                'description' => 'SEOUL Guest Chair, red',
                'dimensions' => [
                                [
                                                                'name' => 'C1',
                                                                'categoryName' => 'CostCenter'
                                ]
                ],
                'itemId' => '4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b',
                'itemName' => 'RED CHAIR',
                'quantity' => 1,
                'taxCode' => '03',
                'taxRatePercentage' => 19,
                'totalDiscountAmount' => 10,
                'totalDiscountPercentage' => 10,
                'totalGrossAmount' => 109,
                'totalNetAmount' => 100,
                'totalTaxAmount' => 19,
                'unitAmount' => 100,
                'unitDiscountAmount' => 10,
                'unitDiscountPercentage' => 10,
                'unitName' => 'PIECE'
        ]
    ],
    'name' => 'Office Supplies',
    'oneLineAddress' => 'Main street 45, Berlin',
    'paidDate' => '2021-01-25T00:00:00Z',
    'paymentDays' => 30,
    'paymentReference' => 'Edefad142e764894',
    'paymentStatus' => 'PENDING',
    'paymentTermCode' => '21',
    'reference' => '026 / 245',
    'shippingDate' => '2021-01-01T00:00:00Z',
    'shippingType' => 'DELIVERY',
    'status' => 'DRAFT',
    'taxRule' => 'NET',
    'taxText' => 'Tax 19 percent',
    'totalDiscountAmount' => 10,
    'totalDiscountPercentage' => 10,
    'totalGrossAmount' => 109,
    'totalNetAmount' => 100,
    'totalTaxAmount' => 19
  ]),
  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/bills"

	payload := strings.NewReader("{\n  \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\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  \"billDate\": \"2021-01-01T00:00:00Z\",\n  \"billNumber\": \"1020\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"dueDate\": \"2021-07-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"journalCode\": \"30\",\n  \"lineItems\": [\n    {\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"accountNumber\": \"200\",\n      \"deferredEndDate\": \"2021-06-01T00:00:00Z\",\n      \"deferredStartDate\": \"2021-01-01T00:00:00Z\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"name\": \"C1\",\n          \"categoryName\": \"CostCenter\"\n        }\n      ],\n      \"itemId\": \"4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"itemName\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\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  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentDays\": 30,\n  \"paymentReference\": \"Edefad142e764894\",\n  \"paymentStatus\": \"PENDING\",\n  \"paymentTermCode\": \"21\",\n  \"reference\": \"026 / 245\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingType\": \"DELIVERY\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19\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/bills")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\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  \"billDate\": \"2021-01-01T00:00:00Z\",\n  \"billNumber\": \"1020\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"dueDate\": \"2021-07-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"journalCode\": \"30\",\n  \"lineItems\": [\n    {\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"accountNumber\": \"200\",\n      \"deferredEndDate\": \"2021-06-01T00:00:00Z\",\n      \"deferredStartDate\": \"2021-01-01T00:00:00Z\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"name\": \"C1\",\n          \"categoryName\": \"CostCenter\"\n        }\n      ],\n      \"itemId\": \"4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"itemName\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\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  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentDays\": 30,\n  \"paymentReference\": \"Edefad142e764894\",\n  \"paymentStatus\": \"PENDING\",\n  \"paymentTermCode\": \"21\",\n  \"reference\": \"026 / 245\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingType\": \"DELIVERY\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\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  \"billDate\": \"2021-01-01T00:00:00Z\",\n  \"billNumber\": \"1020\",\n  \"contactId\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\n  \"currency\": \"EUR\",\n  \"deliveryDate\": \"2021-01-01T00:00:00Z\",\n  \"dueDate\": \"2021-07-01T00:00:00Z\",\n  \"fileId\": \"93c6b8e0-80a4-4c22-a46c-18beebab82d6\",\n  \"journalCode\": \"30\",\n  \"lineItems\": [\n    {\n      \"accountId\": \"6733a433-9662-4a40-8e36-e38ebda94fe1\",\n      \"accountNumber\": \"200\",\n      \"deferredEndDate\": \"2021-06-01T00:00:00Z\",\n      \"deferredStartDate\": \"2021-01-01T00:00:00Z\",\n      \"description\": \"SEOUL Guest Chair, red\",\n      \"dimensions\": [\n        {\n          \"name\": \"C1\",\n          \"categoryName\": \"CostCenter\"\n        }\n      ],\n      \"itemId\": \"4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b\",\n      \"itemName\": \"RED CHAIR\",\n      \"quantity\": 1,\n      \"taxCode\": \"03\",\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  \"name\": \"Office Supplies\",\n  \"oneLineAddress\": \"Main street 45, Berlin\",\n  \"paidDate\": \"2021-01-25T00:00:00Z\",\n  \"paymentDays\": 30,\n  \"paymentReference\": \"Edefad142e764894\",\n  \"paymentStatus\": \"PENDING\",\n  \"paymentTermCode\": \"21\",\n  \"reference\": \"026 / 245\",\n  \"shippingDate\": \"2021-01-01T00:00:00Z\",\n  \"shippingType\": \"DELIVERY\",\n  \"status\": \"DRAFT\",\n  \"taxRule\": \"NET\",\n  \"taxText\": \"Tax 19 percent\",\n  \"totalDiscountAmount\": 10,\n  \"totalDiscountPercentage\": 10,\n  \"totalGrossAmount\": 109,\n  \"totalNetAmount\": 100,\n  \"totalTaxAmount\": 19\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",
    "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
    "addresses": [
      {
        "addressLine1": "Main street 45",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "billDate": "2021-01-01T00:00:00Z",
    "billNumber": "1020",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "dueDate": "2021-07-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "journalCode": "30",
    "lineItems": [
      {
        "id": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
        "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
        "accountNumber": "200",
        "createdDate": "2021-01-01T00:00:00Z",
        "deferredEndDate": "2021-06-01T00:00:00Z",
        "deferredStartDate": "2021-01-01T00:00:00Z",
        "description": "SEOUL Guest Chair, red",
        "dimensions": [
          {
            "name": "C1",
            "categoryName": "CostCenter"
          }
        ],
        "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "itemName": "RED CHAIR",
        "quantity": 1,
        "taxCode": "03",
        "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"
      }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentDays": 30,
    "paymentReference": "Edefad142e764894",
    "paymentStatus": "PENDING",
    "paymentTermCode": "21",
    "reference": "026 / 245",
    "shippingDate": "2021-01-01T00:00:00Z",
    "shippingType": "DELIVERY",
    "status": "DRAFT",
    "taxRule": "NET",
    "taxText": "Tax 19 percent",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "updatedDate": "2021-01-01T00:00:00Z"
  }
}

Field support per integration

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.

Supported request fields:

string

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

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

required

LineItem[]

required

Show properties

string

required

string

required

string

Date to identify the start of the range for deferred costs. Use together with deferredStartDate.

string

Date to identify the start of the range for deferred costs. Use together with deferredEndDate.

string

Dimension[]

Show properties

string

required

string

required

number

Note that quantity can be a decimal numeral.

string

If the taxCode is not provided, it will be set to the default tax code for the account.

number

The total amount for the item excluding tax.

If the taxCode is provided and is of type INCLUSIVE, the totalNetAmount will be treated as a gross amount (i.e., including tax).

string

enum

Available options: OPEN, PAID, OVERDUE

fortnox

Supported request fields:

string

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

string

required

enum

string

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

BillLineItem[]

Show properties

Fortnox may automatically generate an empty line item by default.

string

Dimension[]

Show properties

string

required

string

number

string

number

Lexware Office

Supported request fields:

string

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

It is required when status is OPEN.

string

It is required when status is OPEN.

string

required

string

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

BillLineItem[]

Show properties

string

required

number

required

number

required

It is the line item total amount including tax.

enum

Available options: DRAFT, OPEN

If not provided, the default value is DRAFT.

number

It is the sum of all line items totalGrossAmount.

It is required when status is OPEN.

number

It is required when status is OPEN.

Headers

X-API-KEY

string

API key

X-ACCOUNT-KEY

string

Account key

Query Parameters

companyId

string

environmentName

string

Body

application/json

accountId

string

Example:

"6733a433-9662-4a40-8e36-e38ebda94fe1"

addresses

object[]

Show child attributes

billDate

string

Example:

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

billNumber

string

Example:

"1020"

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"

dueDate

string

Example:

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

fileId

string

Example:

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

journalCode

string

Example:

"30"

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"

paymentDays

number

Example:

30

paymentReference

string

Example:

"Edefad142e764894"

paymentStatus

enum<string>

Available options:

NO_OPEN_ITEM,

PENDING,

PAID,

PARTLY_PAID,

CANCELED,

PARTIAL_CANCELLATION,

BAD_DEBT,

DEBITED,

CREDIT_NOTE_CLEARED,

CLEARED_WITH_CREDIT_NOTE,

UNKNOWN

Example:

"PENDING"

paymentTermCode

string

Example:

"21"

reference

string

Example:

"026 / 245"

shippingDate

string

Example:

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

shippingType

enum<string>

Available options:

SERVICE,

SERVICEPERIOD,

DELIVERY,

DELIVERYPERIOD,

NONE

Example:

"DELIVERY"

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"

totalDiscountAmount

number

Example:

10

totalDiscountPercentage

number

Example:

10

totalGrossAmount

number

Example:

109

totalNetAmount

number

Example:

100

totalTaxAmount

number

Example:

19

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Knowledgebase

Field support per integration

Headers

Query Parameters

Body

Response

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration