### Ping Endpoint Response Example

Source: https://developers.lexware.io/docs

This is an example of the JSON response received after successfully pinging the Lexware API. It includes the user's authorized email address.

```json
{
    "userEmail": "yourEmail@example.org"
}

```

--------------------------------

### Sample Payment Conditions Response

Source: https://developers.lexware.io/docs

Example JSON response when retrieving the list of payment conditions.

```json
[
    {
        "id": "65be0654-60b6-11eb-b66d-5731dbc9bf6b",
        "paymentTermLabelTemplate": "Zahlbar in {paymentRange} Tagen, rein netto ohne Abzug",
        "paymentTermDuration": 14,
        "organizationDefault": false
    },
    {
        "id": "3fcc62d1-0925-456d-890b-779b56e7289e",
        "paymentTermLabelTemplate": "10 Tage - 3 %, 30 Tage netto",
        "paymentTermDuration": 30,
        "paymentDiscountConditions": {
            "discountRange": 10,
            "discountPercentage": 3.00
        },
        "organizationDefault": true
    }
]
```

--------------------------------

### Sample VAT-Free Tax Conditions

Source: https://developers.lexware.io/docs

Example of how to structure tax conditions for VAT-free sales, including the tax type and a descriptive note.

```json
"taxConditions": {
    "taxType": "constructionService13b",
    "taxTypeNote": "Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)"
}
```

--------------------------------

### Name Pattern Matching Example

Source: https://developers.lexware.io/docs

Demonstrates name pattern matching using the underscore `_` for a single arbitrary character and percentage `%` for an arbitrary number of arbitrary characters.

```text
email=n_d_e@example.com will find both john.doe@example.com and n_d_e@example.com
```

--------------------------------

### Sample Response for Print Layouts

Source: https://developers.lexware.io/docs

This is an example of the JSON response when retrieving the list of print layouts. It includes the ID, name, and default status for each layout.

```json
[
    {
        "id": "0dda299a-b5db-11ee-93dd-1755da51b5dc",
        "name": "Standard",
        "default": true
    },
    {
        "id": "1ecf228c-b5db-11ee-bdaa-bbbd077b15cd",
        "name": "Alternate layout",
        "default": false
    }
]
```

--------------------------------

### Retrieve Payment Conditions List

Source: https://developers.lexware.io/docs

Use this endpoint to get a list of configured payment conditions. Replace `{accessToken}` with your actual access token.

```bash
curl https://api.lexware.io/v1/payment-conditions
-X GET
-H "Authorization: Bearer {accessToken}"
-H "Accept: application/json"
```

--------------------------------

### Webhook Callback Payload Example

Source: https://developers.lexware.io/docs

This is a sample JSON payload received from a Lexware webhook callback for an event subscription.

```json
{
  "organizationId": "aa93e8a8-2aa3-470b-b914-caad8a255dd8",
  "eventType": "contact.changed",
  "resourceId": "4d43ad14-671d-4e0c-fd4b-2fd8cc117eff",
  "eventDate": "2023-04-11T12:30:00.000+02:00"
}
```

--------------------------------

### Sample Response for Contacts

Source: https://developers.lexware.io/docs

Example JSON response when retrieving contacts. This structure includes contact details and pagination information.

```json
{
  "content": [
  {
    "id": "e9066f04-8cc7-4616-93f8-ac9ecc8479c8",
    "organizationId": "aa93e8a8-2aa3-470b-b914-caad8a255dd8",
    "version": 0,
    "roles": {
      "customer": {
        "number": 10308
      }
    },
    "person": {
      "salutation": "Frau",
      "firstName": "Inge",
      "lastName": "Musterfrau"
    },
    "archived": false
  },
  {
    "id": "313ef116-a432-4823-9dfe-1b1200eb458a",
    "organizationId": "aa93e8a8-2aa3-470b-b914-caad8a255dd8",
    "version": 0,
    "roles": {
      "customer": {
        "number": 10309
      }
    },
    "person": {
      "salutation": "Herr",
      "firstName": "Max",
      "lastName": "Mustermann"
    },
    "archived": true
  }
],
"totalPages": 1,
"totalElements": 2,
"last": true,
"sort": [
  {
    "direction": "ASC",
    "property": "name",
    "ignoreCase": false,
    "nullHandling": "NATIVE",
    "ascending": true
  }
],
"size": 25,
"number": 0,
"first": true,
"numberOfElements": 2
}
```

--------------------------------

### Retrieve List of Print Layouts

Source: https://developers.lexware.io/docs

Use this endpoint to get a read-only list of print layouts available for sales vouchers. Replace {accessToken} with your valid authentication token.

```bash
curl https://api.lexware.io/v1/print-layouts
-X GET
-H "Authorization: Bearer {accessToken}"
-H "Accept: application/json"
```

--------------------------------

### Retrieve All Event Subscriptions Request

Source: https://developers.lexware.io/docs

Send a GET request to retrieve a list of all your event subscriptions.

```bash
curl https://api.lexware.io/v1/event-subscriptions
-X GET
-H "Authorization: Bearer {accessToken}"
-H "Accept: application/json"
```

--------------------------------

### Create Dunning cURL Command

Source: https://developers.lexware.io/docs

Example cURL command to send a POST request to create a dunning. It includes authorization and content type headers.

```bash
curl https://api.lexware.io/v1/dunnings?precedingSalesVoucherId=58e512ce-ea13-11eb-bac8-2f511e28942a
-X POST
-H "Authorization: Bearer {accessToken}"
-H "Content-Type: application/json"
-H "Accept: application/json"
-d \
'{
  "archived": false,
  "voucherDate": "2023-07-22T00:00:00.000+02:00",
  "address": {
    "name": "Bike & Ride GmbH & Co. KG",
    "supplement": "Gebäude 10",
    "street": "Musterstraße 42",
    "city": "Freiburg",
    "zip": "79112",
    "countryCode": "DE"
  },
  "lineItems": [
    {
      "type": "custom",
      "name": "Energieriegel Testpaket",
      "quantity": 1,
      "unitName": "Stück",
      "unitPrice": {
        "currency": "EUR",
        "netAmount": 5,
        "taxRatePercentage": 0
      },
      "discountPercentage": 0
    },
    {
      "type": "text",
      "name": "Strukturieren Sie Ihre Belege durch Text-Elemente.",
      "description": "Das hilft beim Verständnis"
    }
  ],
  "totalPrice": {
    "currency": "EUR",
    "totalNetAmount": 15.0,
    "totalGrossAmount": 17.85,
    "totalTaxAmount": 2.85
  },
  "taxConditions": {
    "taxType": "net"
  },
  "title": "Mahnung",
  "introduction": "Wir bitten Sie, die nachfolgend aufgelisteten Lieferungen/Leistungen unverzüglich zu begleichen.",
  "remark": "Sollten Sie den offenen Betrag bereits beglichen haben, betrachten Sie dieses Schreiben als gegenstandslos."
}'
```

--------------------------------

### Email Pattern Matching Example

Source: https://developers.lexware.io/docs

Demonstrates email pattern matching using the underscore `_` for a single arbitrary character. Note the escaped underscore to match the literal character.

```text
email=a_b@example.com will find a.b@example.com, a_b@example.com, and azb@example.com
email=a\_b@example.com will _only_ find a_b@example.com
```

--------------------------------

### Credit Note JSON Example

Source: https://developers.lexware.io/docs

This JSON object represents a sample credit note with multiple line items. Fields with no content are displayed with 'null' for demonstration purposes.

```json
{
   "id":"e9066f04-8cc7-4616-93f8-ac9ecc8479c8",
   "organizationId":"aa93e8a8-2aa3-470b-b914-caad8a255dd8",
   "createdDate":"2023-06-17T18:32:07.480+02:00",
   "updatedDate":"2023-06-17T18:32:07.551+02:00",
   "version":1,
   "language":"de",
   "archived":false,
   "voucherStatus":"draft",
   "voucherNumber":"GS0007",
   "voucherDate":"2023-02-22T00:00:00.000+01:00",
   "address":{
      "name":"Bike & Ride GmbH & Co. KG",
      "supplement":"Gebäude 10",
      "street":"Musterstraße 42",
      "city":"Freiburg",
      "zip":"79112",
      "countryCode":"DE"
   },
   "electronicDocumentProfile":"NONE",
   "lineItems":[
      {
         "type":"custom",
         "name":"Abus Kabelschloss Primo 590 ",
         "description":"- 9,5 mm starkes, smoke-mattes Spiralkabel mit integrierter Halterlösung zur Befestigung am Sattelklemmbolzen\n- bewährter Qualitäts-Schließzylinder mit praktischem Wendeschlüssel\n- KabelØ: 9,5 mm, Länge: 150 cm",
         "quantity":2,
         "unitName":"Stück",
         "unitPrice":{
            "currency":"EUR",
            "netAmount":13.4,
            "grossAmount":15.946,
            "taxRatePercentage":19
         },
         "lineItemAmount":26.8
      },
      {
         "type":"custom",
         "name":"Energieriegel Testpaket",
         "quantity":1,
         "unitName":"Stück",
         "unitPrice":{
            "currency":"EUR",
            "netAmount":5,
            "grossAmount":5,
            "taxRatePercentage":0
         },
         "lineItemAmount":5
      }
   ],
   "totalPrice":{
      "currency":"EUR",
      "totalNetAmount":31.8,
      "totalGrossAmount":36.89,
      "totalTaxAmount":5.09
   },
   "taxAmounts":[
      {
         "taxRatePercentage":0,
         "taxAmount":0,
         "netAmount":5
      },
      {
         "taxRatePercentage":19,
         "taxAmount":5.09,
         "netAmount":26.8
      }
   ],
   "taxConditions":{
      "taxType":"net"
   },
   "relatedVouchers":[],
   "printLayoutId": "28c212c4-b6dd-11ee-b80a-dbc65f4ceccf",
   "title":"Rechnungskorrektur",
   "introduction":"Rechnungskorrektur zur Rechnung RE-00020",
   "remark":"Folgende Lieferungen/Leistungen schreiben wir Ihnen gut.",
   "files":{
      "documentFileId":"a79fea19-a892-4ea9-89ad-e879946329a3"
   }
}
```

--------------------------------

### Sample Posting Categories Response

Source: https://developers.lexware.io/docs

An example of the JSON response structure for the posting categories endpoint.

```json
[
  {
      "id": "cf03a2b0-f838-474f-ac5e-67adb9b830c7",
      "name": "Reise MA",
      "type": "outgo",
      "contactRequired": false,
      "splitAllowed": true,
      "groupName": "Reisen"
  },
  {
      "id": "3620798f-ae06-4492-b775-1c87eb99247c",
      "name": "Fahrtkosten MA",
      "type": "outgo",
      "contactRequired": false,
      "splitAllowed": true,
      "groupName": "Reisen"
  },
  {
      "id": "8f8664a1-fd86-11e1-a21f-0800200c9a66",
      "name": "Einnahmen",
      "type": "income",
      "contactRequired": false,
      "splitAllowed": true,
      "groupName": "Einnahmen"
  },
  {
      "id": "8f8664a0-fd86-11e1-a21f-0800200c9a66",
      "name": "Dienstleistung",
      "type": "income",
      "contactRequired": false,
      "splitAllowed": true,
      "groupName": "Einnahmen"
  }
]
```

--------------------------------

### Create Lexware Article Request

Source: https://developers.lexware.io/docs

Use this cURL command to send a POST request to create a new article. Ensure you replace `{accessToken}` with your valid authentication token.

```curl
curl https://api.lexware.io/v1/articles
-X POST
-H "Authorization: Bearer {accessToken}"
-H "Content-Type: application/json"
-H "Accept: application/json"
-d \
'{
  "title": "Lexware buchhaltung Premium 2024",
  "type": "PRODUCT",
  "unitName": "Download-Code",
  "articleNumber": "LXW-BUHA-2024-001",
  "price": {
    "netPrice": 61.90,
    "leadingPrice": "NET",
    "taxRate": 19
  }
}'

```

--------------------------------

### Create Event Subscription Response

Source: https://developers.lexware.io/docs

Sample response received after successfully creating an event subscription.

```json
{
    "id": "49aa2f76-c51a-4df3-ae83-3a103d781494",
    "resourceUri": "https://api.lexware.io/v1/event-subscriptions/49aa2f76-c51a-4df3-ae83-3a103d781494",
    "createdDate": "2023-04-11T12:20:00.000+02:00",
    "updatedDate": "2023-04-11T12:20:00.000+02:00",
    "version": 0
}
```

--------------------------------

### Retrieve Event Subscription Request

Source: https://developers.lexware.io/docs

Send a GET request to retrieve a specific event subscription by its ID.

```bash
curl https://api.lexware.io/v1/event-subscriptions/49aa2f76-c51a-4df3-ae83-3a103d781494
-X GET
-H "Authorization: Bearer {accessToken}"
-H "Accept: application/json"
```

--------------------------------

### Lexware Article Creation Response

Source: https://developers.lexware.io/docs

This is a sample successful response when creating an article. It includes the unique ID, resource URI, and timestamps for the newly created article.

```json
{
    "id": "f5d5e4c2-e20a-11ee-9cde-7789c0d1fa1c",
    "resourceUri": "https://api.lexware.io/v1/articles/f5d5e4c2-e20a-11ee-9cde-7789c0d1fa1c",
    "createdDate": "2024-03-14T14:58:10.320+01:00",
    "updatedDate": "2024-03-14T14:58:10.320+01:00",
    "version": 0
}


```

--------------------------------

### Create Dunning Response

Source: https://developers.lexware.io/docs

Sample successful response after creating a dunning. It includes the ID and resource URI of the newly created dunning.

```json
{
  "id": "d9066f04-8cc7-4616-93f8-ac9ecc8479c9",
  "resourceUri": "https://api.lexware.io/v1/dunnings/d9066f04-8cc7-4616-93f8-ac9ecc8479c9",
  "createdDate": "2023-07-17T18:32:07.480+02:00",
  "updatedDate": "2023-07-17T18:32:07.551+02:00",
  "version": 1
}
```

--------------------------------

### Create Dunning Request

Source: https://developers.lexware.io/docs

Use this sample request to create a dunning via the Lexware API. Ensure all required properties are included in the JSON body.

```json
{
  "archived": false,
  "voucherDate": "2023-07-22T00:00:00.000+02:00",
  "address": {
    "name": "Bike & Ride GmbH & Co. KG",
    "supplement": "Gebäude 10",
    "street": "Musterstraße 42",
    "city": "Freiburg",
    "zip": "79112",
    "countryCode": "DE"
  },
  "lineItems": [
    {
      "type": "custom",
      "name": "Energieriegel Testpaket",
      "quantity": 1,
      "unitName": "Stück",
      "unitPrice": {
        "currency": "EUR",
        "netAmount": 5,
        "taxRatePercentage": 0
      },
      "discountPercentage": 0
    },
    {
      "type": "text",
      "name": "Strukturieren Sie Ihre Belege durch Text-Elemente.",
      "description": "Das hilft beim Verständnis"
    }
  ],
  "totalPrice": {
    "currency": "EUR",
    "totalNetAmount": 15.0,
    "totalGrossAmount": 17.85,
    "totalTaxAmount": 2.85
  },
  "taxConditions": {
    "taxType": "net"
  },
  "title": "Mahnung",
  "introduction": "Wir bitten Sie, die nachfolgend aufgelisteten Lieferungen/Leistungen unverzüglich zu begleichen.",
  "remark": "Sollten Sie den offenen Betrag bereits beglichen haben, betrachten Sie dieses Schreiben als gegenstandslos."
}
```

--------------------------------

### Retrieve List of Countries

Source: https://developers.lexware.io/docs

Use this endpoint to get a list of currently known countries. Replace `{accessToken}` with your actual access token.

```bash
curl https://api.lexware.io/v1/countries
-X GET
-H "Authorization: Bearer {accessToken}"
-H "Accept: application/json"
```

--------------------------------

### Sample Recurring Templates Response

Source: https://developers.lexware.io/docs

This is an example of the JSON response when retrieving recurring templates. It contains an array of template objects, each with detailed information.

```json
{
    "content": [
        {
            "id": "cab021e5-91d3-4e93-a696-56b7f2417547",
            "organizationId": "a3d94eb4-98bc-429e-b7ad-17f1a8463af9",
            "title": "Rechnung",
            "createdDate": "2023-02-10T14:35:40.642+01:00",
            "updatedDate": "2023-02-10T14:36:49.741+01:00",
            "address": {
                "contactId": "464f4881-7a8c-4dc4-87de-7c6fd9a506b8",
                "name": "Bike & Ride GmbH & Co. KG"
            },
            "totalPrice": {
                "currency": "EUR",
                "totalNetAmount": 251.26,
                "totalGrossAmount": 299
            },
            "paymentConditions": {
                "paymentTermLabel": "10 Tage abzüglich 2 % Skonto",
                "paymentTermLabelTemplate": "{paymentRange} Tage abzüglich {discount} Skonto",
                "paymentTermDuration": 10,
                "paymentDiscountConditions": {
                    "discountPercentage": 2,
                    "discountRange": 10
                }
            },
            "recurringTemplateSettings": {
                "id": "615a8db3-bce1-4e11-8302-328fcbacd613",
                "startDate": "2023-04-01",
                "endDate": "2024-04-01",
                "finalize": false,
                "shippingType": "serviceperiod",
                "retroactiveInvoice": false,
                "executionInterval": "QUARTERLY",
                "nextExecutionDate": null,
                "lastExecutionDate": null,
                "lastExecutionFailed": false,
                "executionStatus": "PAUSED"
            }
        },
        {
            "id": "ac1d66a8-6d59-408b-9413-d56b1db7946f",
            "organizationId": "a3d94eb4-98bc-429e-b7ad-17f1a8463af9",
            "title": "Rechnung",
            "createdDate": "2023-02-10T14:29:03.114+01:00",
            "updatedDate": "2023-02-10T14:29:03.143+01:00",
            "address": {
                "contactId": "df315523-1e92-473a-9d00-052212da84f8",
                "name": "Haufe-Lexware GmbH & Co. KG"
            },
            "totalPrice": {
                "currency": "EUR",
                "totalNetAmount": 605.04,
                "totalGrossAmount": 720
            },
            "paymentConditions": {
                "paymentTermLabel": "Zahlbar sofort, rein netto",
                "paymentTermLabelTemplate": "Zahlbar sofort, rein netto",
                "paymentTermDuration": 0
            },
            "recurringTemplateSettings": {
                "id": "9c5b8bde-7d36-49e8-af5c-4fbe7dc9fa01",
                "startDate": "2023-03-01",
                "endDate": "2023-06-30",
                "finalize": true,
                "shippingType": "service",
                "retroactiveInvoice": false,
                "executionInterval": "MONTHLY",
                "nextExecutionDate": "2023-03-01",
                "lastExecutionDate": null,
                "lastExecutionFailed": false,
                "executionStatus": "ACTIVE"
            }
        }
    ],
    "first": true,
    "last": true,
    "totalPages": 1,
    "totalElements": 2,
    "numberOfElements": 2,
    "size": 25,
    "number": 0,
    "sort": [
        {
            "property": "createdDate",
            "direction": "DESC",
            "ignoreCase": false,
            "nullHandling": "NATIVE",
            "ascending": false
        }
    ]
}
```

--------------------------------

### Sample Contact Object with Roles

Source: https://developers.lexware.io/docs

This JSON object represents a sample contact with both customer and vendor roles, including company and address details. It demonstrates the structure for defining multiple roles and associated information.

```json
{
    "id": "be9475f4-ef80-442b-8ab9-3ab8b1a2aeb9",
    "organizationId": "aa93e8a8-2aa3-470b-b914-caad8a255dd8",
    "version": 1,
    "roles": {
        "customer": {
            "number": 10307
        },
        "vendor": {
            "number": 70303
        }
    },
    "company": {
        "name": "Testfirma",
        "taxNumber": "12345/12345",
        "vatRegistrationId": "DE123456789",
        "allowTaxFreeInvoices": true,
        "contactPersons": [
            {
                "salutation": "Herr",
                "firstName": "Max",
                "lastName": "Mustermann",
                "primary": true,
                "emailAddress": "contactpersonmail@lexware.de",
                "phoneNumber": "08000/11111"
            }
        ]
    },
    "addresses": {
        "billing": [
            {
                "supplement": "Rechnungsadressenzusatz",
                "street": "Hauptstr. 5",
                "zip": "12345",
                "city": "Musterort",
                "countryCode": "DE"
            }
        ],
        "shipping": [
            {
                "supplement": "Lieferadressenzusatz",
                "street": "Schulstr. 13",
                "zip": "76543",
                "city": "MUsterstadt",
                "countryCode": "DE"
            }
        ]
    },
    "xRechnung": {
        "buyerReference": "04011000-1234512345-35",
        "vendorNumberAtCustomer": "70123456"
    },
    "emailAddresses": {
        "business": [
            "business@lexware.de"
        ],
        "office": [
            "office@lexware.de"
        ],
        "private": [
            "private@lexware.de"
        ],
        "other": [
            "other@lexware.de"
        ]
    },
    "phoneNumbers": {
        "business": [
            "08000/1231"
        ],
        "office": [
            "08000/1232"
        ],
        "mobile": [
            "08000/1233"
        ],
        "private": [
            "08000/1234"
        ],
        "fax": [
            "08000/1235"
        ],
        "other": [
            "08000/1236"
        ]
    },
    "note": "Notizen",
    "archived": false
}
```

--------------------------------

### Sample Response for Retrieving Payment Information

Source: https://developers.lexware.io/docs

This JSON object shows a sample response when retrieving payment information for a voucher. It includes details such as open amount, currency, payment status, voucher type, and a list of payment items.

```json
{
  "openAmount": "1337.00",
  "currency": "EUR",
  "paymentStatus": "openRevenue",
  "voucherType": "salesinvoice",
  "voucherStatus": "open",
  "paymentItems": [
    {
      "paymentItemType": "manualPayment",
      "postingDate": "2023-11-04T00:00:00.000+01:00",
      "amount": 10.0,
      "currency": "EUR"
    },
    {
      "paymentItemType": "manualPayment",
      "postingDate": "2023-11-06T00:00:00.000+01:00",
      "amount": 39.99,
      "currency": "EUR"
    }
  ]
}
```

--------------------------------

### Render Dunning Document (PDF)

Source: https://developers.lexware.io/docs

This endpoint triggers the rendering of a dunning document as a PDF. The returned documentFileId is required to download the PDF.

```curl
curl https://api.lexware.io/v1/dunnings/e9066f04-8cc7-4616-93f8-ac9ecc8479c8/document
-X GET
-H "Authorization: Bearer {accessToken}"
-H "Accept: application/json"
```

--------------------------------

### Email Pattern Matching with Percentage

Source: https://developers.lexware.io/docs

Demonstrates email pattern matching using the percentage `%` for an arbitrary number of arbitrary characters.

```text
email=a%b@example will find a.b@example.com, a_b@example.com, azb@example.com, and anna.and.jacob@example.com
```

--------------------------------

### Download a Dunning File

Source: https://developers.lexware.io/docs

Downloads the dunning file as binary data. The `Content-Type` header specifies the file type, and `Content-Disposition` suggests a filename. Only PDF files are supported.

```APIDOC
## Download a Dunning File
`GET {resourceurl}/v1/dunnings/{id}/file`

### Description
Returns the file as binary data with HTTP response code `200`. The HTTP header fields _Content-Type_ specifies the file type (MIME type) and the _Content-Length_ the size of the file in bytes. A suggested file name is returned in the header _Content-Disposition_.
For a dunning, only PDF files are supported. As `Accept` header, `*/*` and `application/pdf` can be used. `Accept` headers with wildcards are also supported and will return the default representation.
If the dunning itself does not exist, the request will be rejected with `404 Not Found`.
Requests for other media types will generally be rejected with an HTTP status of `406 Not Acceptable`.
```

--------------------------------

### Down Payment Invoice JSON Example

Source: https://developers.lexware.io/docs

This JSON object represents a sample down payment invoice. Fields with no content are displayed with 'null' for demonstration purposes. All attributes are read-only via the API.

```json
{
  "id": "0333f0c7-2b89-4889-b64e-68b3ca3f167a",
  "organizationId": "aa93e8a8-2aa3-470b-b914-caad8a255dd8",
  "createdDate": "2023-01-20T10:26:40.956+01:00",
  "updatedDate": "2023-01-21T13:34:13.228+01:00",
  "version": 3,
  "language": "de",
  "archived": false,
  "voucherStatus": "open",
  "voucherNumber": "RE1129",
  "voucherDate": "2023-01-20T10:26:26.565+01:00",
  "dueDate": "2023-02-19T00:00:00.000+01:00",
  "address": {
    "name": "Bike & Ride GmbH & Co. KG",
    "supplement": "Gebäude 10",
    "street": "Musterstraße 42",
    "city": "Freiburg",
    "zip": "79112",
    "countryCode": "DE"
  },
  "electronicDocumentProfile":"NONE",
  "lineItems": [
    {
      "type": "custom",
      "name": "Pauschaler Abschlag",
      "quantity": 1,
      "unitPrice": {
        "currency": "EUR",
        "netAmount": 559.66,
        "grossAmount": 666,
        "taxRatePercentage": 19
      },
      "lineItemAmount": 666.00
    }
  ],
  "totalPrice": {
    "currency": "EUR",
    "totalNetAmount": 559.66,
    "totalGrossAmount": 666.00,
    "totalTaxAmount": 106.34
  },
  "taxAmounts": [
    {
      "taxRatePercentage": 19,
      "taxAmount": 106.34,
      "netAmount": 559.66
    }
  ],
  "taxConditions": {
    "taxType": "gross"
  },
  "paymentConditions": {
    "paymentTermLabel": "10 Tage - 3 %, 30 Tage netto",
    "paymentTermLabelTemplate": "{discountRange} Tage -{discount}, {paymentRange} Tage netto",
    "paymentTermDuration": 30,
    "paymentDiscountConditions": {
      "discountPercentage": 3,
      "discountRange": 10
    }
  },
  "shippingConditions": {
    "shippingType": "none"
  },
  "closingInvoiceId": null,
  "relatedVouchers": [],
  "printLayoutId": "28c212c4-b6dd-11ee-b80a-dbc65f4ceccf",
  "introduction": "Wie vereinbart, erlauben wir uns folgenden pauschalen Abschlag in Rechnung zu stellen.",
  "remark": "Vielen Dank für die gute Zusammenarbeit.",
  "files": {
    "documentFileId": "aa0388c5-20b5-49d7-96ce-0c08ac0482f4"
  },
  "title": "1. Abschlagsrechnung"
}
```

--------------------------------

### Get Order Confirmation Document Endpoint

Source: https://developers.lexware.io/docs

This endpoint is used to trigger the rendering of a PDF document for an order confirmation. The returned documentFileId can then be used to download the PDF via the Files Endpoint.

```HTTP
GET {resourceurl}/v1/order-confirmations/{id}/document
```

--------------------------------

### Create an Invoice Request

Source: https://developers.lexware.io/docs

Use this sample request to create a new invoice via the Lexware API. Ensure you replace `{accessToken}` with your valid access token and adjust the JSON payload as needed.

```curl
curl https://api.lexware.io/v1/invoices\
-X POST\
-H "Authorization: Bearer {accessToken}"\
-H "Content-Type: application/json"\
-H "Accept: application/json"\
-d '
{
 "archived": false,
  "voucherDate": "2023-02-22T00:00:00.000+01:00",
   "address": {
   "name": "Bike & Ride GmbH & Co. KG",
    "supplement": "Gebäude 10",
    "street": "Musterstraße 42",
    "city": "Freiburg",
    "zip": "79112",
    "countryCode": "DE"
  },
  "lineItems": [
    {
      "type": "custom",
      "name": "Energieriegel Testpaket",
      "quantity": 1,
      "unitName": "Stück",
      "unitPrice": {
        "currency": "EUR",
        "netAmount": 5,
        "taxRatePercentage": 0
      },
      "discountPercentage": 0
    },
    {
      "type": "text",
      "name": "Strukturieren Sie Ihre Belege durch Text-Elemente.",
      "description": "Das hilft beim Verständnis"
    }
  ],
  "totalPrice": {
    "currency": "EUR"
   },
  "taxConditions": {
    "taxType": "net"
  },
  "paymentConditions": {
    "paymentTermLabel": "10 Tage - 3 %, 30 Tage netto",
    "paymentTermDuration": 30,
    "paymentDiscountConditions": {
      "discountPercentage": 3,
      "discountRange": 10
    }
  },
  "shippingConditions": {
    "shippingDate": "2023-04-22T00:00:00.000+02:00",
    "shippingType": "delivery"
  },
  "title": "Rechnung",
  "introduction": "Ihre bestellten Positionen stellen wir Ihnen hiermit in Rechnung",
  "remark": "Vielen Dank für Ihren Einkauf"
}
'

```

--------------------------------

### Download Dunning File

Source: https://developers.lexware.io/docs

Download the binary PDF file of a dunning. The Content-Type header will specify the MIME type, and Content-Disposition will suggest a filename. Only PDF files are supported.

```curl
curl "https://api.lexware.io/v1/dunnings/{id}/file"
-X GET
-H "Accept: */*"
-H "Authorization: Bearer {accessToken}"
```

--------------------------------

### Retrieve a Contact with Lexware API

Source: https://developers.lexware.io/docs

Use this cURL command to send a GET request to retrieve a specific contact by its ID. Include your access token in the Authorization header and set the Accept header to application/json.

```curl
curl https://api.lexware.io/v1/contacts/e9066f04-8cc7-4616-93f8-ac9ecc8479c8
-X GET
-H "Authorization: Bearer {accessToken}"
-H "Accept: application/json"


```

```json
{
  "id": "e9066f04-8cc7-4616-93f8-ac9ecc8479c8",
  "organizationId": "aa93e8a8-2aa3-470b-b914-caad8a255dd8",
  "version": 0,
  "roles": {
    "customer": {
      "number": 10308
    }
  },
  "person": {
    "salutation": "Frau",
    "firstName": "Inge",
    "lastName": "Musterfrau"
  },
  "note": "Notizen",
  "archived": false
}

```