> For the complete documentation index, see [llms.txt](https://chekin.gitbook.io/chekin-public-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chekin.gitbook.io/chekin-public-api/api-reference/einvoicing/short-term-declarations/create-declaration.md).

# Create Short-Term Declaration

<mark style="color:green;">`POST`</mark> `/documents-v2/invoicing/short-term-declarations`

Creates a Short-Term Stay Declaration for a reservation, required by Greek law for STR bookings. Submitted directly to AADE using the supplier's stored credentials.

{% hint style="warning" %}
**AADE only.** This step replaces the invoice creation flow for the AADE provider.
{% endhint %}

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `JWT <token>`      |

**Body**

| Name             | Type | Description                                                          |
| ---------------- | ---- | -------------------------------------------------------------------- |
| `supplier_id`    | UUID | AADE supplier ID                                                     |
| `reservation_id` | UUID | Reservation ID                                                       |
| `action`         | enum | `create` — submit the declaration; `draft` — save without submitting |

**Example**

{% tabs %}
{% tab title="Request" %}

```json
{
  "supplier_id": "550e8400-e29b-41d4-a716-446655440002",
  "reservation_id": "550e8400-e29b-41d4-a716-446655440005",
  "action": "create"
}
```

{% endtab %}
{% endtabs %}

### What the system does automatically

* Reads the guest's details from the reservation (name, nationality, passport/document number, tax ID)
* Reads the stay dates (arrival, departure) and total agreed rent from invoice items
* Detects whether the guest is a foreigner (nationality ≠ `GR`)
* Splits declarations crossing calendar year boundaries into separate records per year
* Submits the declaration to AADE via the supplier's credentials

{% hint style="info" %}
Declarations are processed asynchronously.
{% endhint %}