# Nachbuchungs API - Dokumentation

Die Nachbuchung-API wird zum Aufruf der Nachbuchungen genutzt. Hierfür muss folgender Parameter an den API-Aufruf angehangen werden: 

| API | Parameter |
| :--- | :--- |
| Nachbuchungen | `get-bookingrequests` |

**Beispiel:** `https://www.domain.de/api/ACCESS-TOKEN/publisher/ID/get-bookingrequests.csv`

---

## Nachbuchungs-API Filter

Für die Bookingrequest-API gibt es zusätzliche Parameter, die abgefragt werden können. Nachfolgend eine Aufstellung aller Parameter:

| Parameter | Wert | Beschreibung | Beispiel |
| :--- | :--- | :--- | :--- |
| `date_from` | Startdatum | Definierung des Startdatums | `date_from=01.01.1909` |
| `date_to` | Enddatum | Definierung des Enddatums | `date_to=19.12.1909` |
| `status` | Status-Wert | Alle Nachbuchungen, welche unter dem entsprechenden Status hinterlegt sind. Mehrfachnennung möglich. | `status=0` |

> **Folgende Statusanfragen sind möglich:**
> * `canceled`: gibt abgelehnte Nachbuchungen aus
> * `0`: gibt bestätigte Nachbuchungen aus, die in die Transaktionen überführt wurden
> * `open`: gibt nicht bearbeitete Nachbuchungen aus

---

## Definition der Felder in der Nachbuchungs-API

Die Spaltennamen der heruntergeladenen Nachbuchungen beinhalten folgende Parameter:

| Parameter | Beschreibung |
| :--- | :--- |
| `timestamp` | Zeitpunkt der Nachbuchung. |
| `ordertoken` | Bestellnummer der Nachbuchung. |
| `trigger_id` | Trigger ID, welche der Nachbuchung zugeordnet wird. |
| `subid` | Subid, welche bei der Transaktion übermittelt wurde. |
| `turnover` | Provisionsrelevanter Bestellwert. |
| `status` | Status der Nachbuchung. |
| `cancel_reason` | Ablehnungsgrund der Nachbuchung. |