Import Retouren: API / CSV oder XML?

Hallo @bik ,

ich möchte dich informieren, dass wir den POST Retoure Endpunkt zu unserer Dokumentation hinzugefügt haben. Du findest ihn hier: https://github.com/xentral/api-spec-public/tree/main/xentral-api unter dem Namen "standard-xentral-api.postman_collection.json".

@Christian , vielen Dank für deine Hilfe. :)

Hi @chuck_aguilar,

vielen Dank dafür!

Können Sie bitte einen Beispiel geben wie man eine Retoure mit Bezug zu der ursprüngliche Order per POST anlegen kann?

Für folgende Felder einer retoure, fehlen uns richtige Feldnamen, die wir mit Daten füllen möchten:

• Sales order
• Internet
• Artikelpreis
• Grund der Retoure

Ich habe versucht <auftrag> xxxxxx</auftrag> einzufügen, aber leider erfolglos..

Vielen Dank im Voraus!

Hallo @bik

Es ist tatsächlich kein `POST` Endpunkt, sondern ein `GET` Endpunkt, der eine `POST` Funktion hat. 😅

Hier ist ein Beispiel mit einem `curl`

curl --location --request GET 'https://xxxxxxxx.xentral.biz/api/RetoureCreate' \
--header 'Content-Type: application/xml' \
--header 'Authorization: Bearer {token}' \
--data '<xml>
    <projekt>1</projekt>
    <status>freigegeben</status>
    <kundennummer>10012</kundennummer>
    <versandart>keinversand</versandart>
    <artikelliste>
        <position>
            <nummer>100002</nummer>
            <menge>1</menge>
            <grund>14 Tage Rückgaberecht</grund>
        </position>
    </artikelliste>
</xml>'

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <status>
        <action>RetoureCreate</action>
        <message>OK</message>
        <messageCode>1</messageCode>
    </status>
    <xml>
        <id>10</id>
        <belegnr>500008</belegnr>
    </xml>
</response>

Du kannst auch natürlich den Auftrag im Body geben: 

<xml>
    <projekt>1</projekt>
    <auftrag>200307</auftrag>
    <auftragid>492</auftragid>
    <status>freigegeben</status>
    <kundennummer>10012</kundennummer>
    <versandart>keinversand</versandart>
    <artikelliste>
        <position>
            <nummer>100002</nummer>
            <menge>1</menge>
            <grund>14 Tage Rückgaberecht</grund>
        </position>
    </artikelliste>
</xml>

@Christian @chuck_aguilar 

Hallo Zusammen,

erstmal vielen Dank für Info und Ergänzung.

Bestätige, kann erfolgreich eine Retoure mit Bezug zu Lieferschein oder/und Order anlegen.

Bin davon ausgegangen das wie üblich in anderen WMS, der Bezug wird ausreichen sein, eine Gutschrift zu erzeugen. Aber Step by Step :).

Case 1 (Preise fehlen):

Nun kann aus so einer Retoure keine Gutschrift erzeugt werden = die Preise müssen manuell eingegeben werden.

Was muss erfüllt sein um dies zu erreichen? Habt ihr eventuell ein Beispiel?

Case 2 (Automatische Einlagerung):

Besteht die Möglichkeit über diesen Endpoint oder anderen die erfasste Menge automatisch auf fest definierten Lagerplatz einzulagern? Wenn ja, habt ihr ggf. ein Beispiel?

Ziel ist das man auch eine Transaktion im System für Betriebsprüfer hat und der Bestand zur Verfügung steht.

Vielen dank im Voraus!

habe ich nicht richtige verstanden - es gibt schon GET mit https://{xentralId}.xentral.biz/api/creditNotes alles funktioniert  !

Was hat GET mit PUT/PATCH zu tun?

@bik 

es gibt hier verschiedene Sachen https://developer.xentral.com/reference/creditnotecreate