Beantwortet

Import Retouren: API / CSV oder XML?


Benutzerebene 2
Abzeichen
  • Bekannter Teilnehmer
  • 20 Antworten

Hallo Zusammen,

so wie es aussieht Xentral bietet keine Möglichkeit per API Retouren anzulegen...zumindest in der Doku habe ich weder in der alte noch in der REST API gefunden.

 

FRagen:

 

  1. Kann man per CSV/XML eine Anlegen?
  2. Wenn ja, welche wird empfohlen und warum?

Vielen Dank im Voraus!

icon

Beste Antwort von Christian H von digitalXL 10 February 2023, 09:12

Original anzeigen

8 Antworten

Benutzerebene 7
Abzeichen +3

@bik für die Anlage von Retouren gibt es einen API-Endpunkt - der ist aber leider noch nicht dokumentiert und veröffentlicht. Evtl. wird das noch nachgezogen. Ansonsten kannst du auch Retouren über das Übertragen Modul anlegen lassen. Allerdings hast du hier den Nachteil, dass in der Retoure keine Werte der Artikel erfasst sind und du somit bei der Weiterführung zur Gutschrift aus der Retoure die Beträge manuell nacherfassen musst. 

Benutzerebene 3
Abzeichen

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. :)

Benutzerebene 2
Abzeichen

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!

Benutzerebene 3
Abzeichen

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>

 

Benutzerebene 2
Abzeichen

@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!

Benutzerebene 3
Abzeichen

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

Benutzerebene 2
Abzeichen

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?

Benutzerebene 3
Abzeichen

@bik 

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

Antworten