# Returns

### Eingehende Sendungsretouren anzeigen

```javascript
GET /api/return/list?created_after_at={created_after_at}
```

**Properties**

created\_after\_at *<mark style="color:purple;">datetime</mark>*

Ein Zeitwert im Format JJJJ-MM-TT HH:MM:SS, wann die Meldung erstellt wurde. Mit diesem Parameter wird nach allen Rückgaben nach dem angegebenen Zeitstempel gefiltert.

{% hint style="info" %}
Es werden maximal 500 Einträge in aufsteigender Reihenfolge aufgelistet. Um mehr Einträge zu erhalten, erhöhe die created\_after\_at timestamp.
{% endhint %}

***

**Result**

JSON-Object mit den grundlegenden Daten der Rückgabe und der zurückgegebenen Artikel.

id *<mark style="color:purple;">integer</mark>*

Eine eindeutige Bezeichnung für die Rückgabe

timestamp *<mark style="color:purple;">object</mark>*

* date *<mark style="color:purple;">datetime</mark>*
  * Der Zeitstempel der Erstellung der Rückgabe
* timezone\_type *<mark style="color:purple;">integer</mark>*
  * Der jeweilige timezone\_type des Zeitstempels
* timezone *<mark style="color:purple;">string</mark>*
  * Die jeweilige Zeitzone des Zeitstempels

status *<mark style="color:purple;">string</mark>*

Die Art der Rücksendung. Mögliche Werte sind DHL Zurück für Rücksendung vom Spediteur und Rücksendung für Kundenretouren

reason *<mark style="color:purple;">string</mark>*

Ein Grundcode oder ein Textfeld, das den Grund für die Rückgabe enthält

remark *<mark style="color:purple;">string</mark>*

Eine optionale Bemerkung zur Rücksendung für den Kundenservice

order *<mark style="color:purple;">integer</mark>*

Die Shopify Order ID der entsprechenden Bestellung

items *<mark style="color:purple;">array|object</mark>*

* sku *<mark style="color:purple;">string</mark>*
  * Die SKU des zurückgegebenen Artikels
* remark *<mark style="color:purple;">string</mark>*
  * Zusätzliche Informationen für den Artikel, der vom Packstack-Lagerpersonal hinzugefügt wurde
* reason *<mark style="color:purple;">string</mark>*
  * Ein Grund für die Rücksendung des Artikels
* restocked *<mark style="color:purple;">bool</mark>*
  * Wenn der Artikel in den physischen Bestand aufgenommen wurde

```json
[
    {
        "id": 177,
        "timestamp": {
            "date": "2024-02-07 20:27:19.000000",
            "timezone_type": 3,
            "timezone": "Europe/Berlin"
        },
        "status": "DHL Zurück",
        "reason": "Keine Angabe",
        "remark": "",
        "order": 5544614920422,
        "items": [
            {
                "sku": "101/111",
                "remark": "",
                "reason": "poorQuality",
                "restocked": true
            }
        ]
    },
    {
        "id": 178,
        "timestamp": {
            "date": "2024-02-07 20:34:37.000000",
            "timezone_type": 3,
            "timezone": "Europe/Berlin"
        },
        "status": "DHL Zurück",
        "reason": "Keine Angabe",
        "remark": "",
        "order": 5544615313638,
        "items": [
            {
                "sku": "001-101",
                "remark": "",
                "reason": "accidentallyOrdered",
                "restocked": true
            }
        ]
    }
]
```

### Retouren-Ankündigung erfassen

```javascript
GET /api/return/create?order={orderId}&customerwish={customerWish}&trackingNr={trackingNr}&sendMail={sendMail}&lineItems=
```

**Properties**

order *<mark style="color:purple;">integer</mark>*

Die Shopify-Bestell-ID der ursprünglichen Bestellung

trackingNr *<mark style="color:purple;">string (optional)</mark>*

Eine vom ankündigen System generierte Tracking oder Referenznummer die als scanbarer Barcode der Rücksendung beigelegt wird. Dieser Wert wird nur gespeichert, falls kein DHL Retourenlabel aufgrund der Konfiguration zurückgegegeben wird.&#x20;

sendMail *<mark style="color:purple;">string (optional, default: true)</mark>*

Soll nach der Ankündigung der Retoure eine automatische E-Mail Benachrichtigung an den Endkunden mit dem Retourenschein oder dem Retourenlabel gesendet werden?

customerwish *<mark style="color:purple;">string (optional)</mark>*

Der Wunsch des Kunden der nach der Bearbeitung der Retoure entscheiden soll. Mögliche Werte sind:

* **resend** (Der Kunde möchte einen erneuten Versand des retournierten Artikels)
* **refund** (Der Kunde möchte eine Erstattung des retournierten Artikels)

lineItems *<mark style="color:purple;">array (optional)</mark>*

Ein multidimensionales assoziatives Array das die zu retournierenden Artikel enthält.

<pre><code><strong>{
</strong>  "LineItem ID von Shopify": {
    "quantity": Menge die retourniert wird,
    "reason": "Grund für die Rücksendung, die erlaubten Schlüssel werden vom Kunden in Packstack Connect konfiguriert"
  }
}
</code></pre>

Beispiel:

```
{
  "18243431956747": {
    "quantity": 2,
    "reason": "tooLate"
  },
  "18243431956750": {
    "quantity": 1,
    "reason": "poorQuality"
  }
}
```

***

**Result**

Wenn der Kunde konfiguriert hat das DHL-Retourenlabel erzeugt werden, wird ein Retourenlabel das alle notwendigen Informationen enthält als Base64 codierter String zurückgegeben.

Andernfalls wird ein Base64 codierter String des Retourenscheins zurückgegeben.

Es wird zusätzlich der Header X-Object-Id gesetzt, der die interne ID dieser Rücksendung ausgibt. Sollte ein Retourenlabel zurückgegeben werden, wird zusätzlich der Header X-TrackingNr mit der erzeugten Sendungsnummer auf dem Label gesendet.

```json
HTTP/1.1 200 OK
Content-Type: text/plain
Content-Length: 84231
X-Object-Id: 4711

JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlIC9DYXRhbG9nCi9QYWdl
cyAyIDAgUgovTGFuZyAoZW4tVVMpCj4+CmVuZG9iagoKMiAwIG9iago8PC9U
eXBlIC9QYWdlcwovQ291bnQgMQovS2lkcyBbMyAwIFJdCj4+CmVuZG9iagoK
...
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.packstack.de/api-schnittstelle/returns.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.