Hallo zusammen,
wir binden die JTL-Wawi über die REST-API (Version 2.2.2, App-Registrierung, nur lesend) an ein eigenes Auswertungs-Tool an. Dabei sind folgende Fragen aufgekommen:
1. Zeitzone in Listen-Endpunkten
Listen wie GET /v2/sales-orders liefern Zeitfelder (z. B. salesOrderDate, Änderungszeit) in Ortszeit der Wawi, aber mit dem Zusatz „+00:00“ bzw. „Z“. Detail-Endpunkte und Lieferscheine liefern denselben Zeitpunkt mit dem richtigen Versatz („+01:00“). Ist das ein bekannter Fehler? Können wir uns darauf verlassen, dass Listen immer Ortszeit liefern?
2. Filter auf Auftragsnummer werden ignoriert
Auf GET /v2/sales-orders haben die Parameter salesOrderNumber und externalSalesOrderNumber keine Wirkung, es kommt die ungefilterte Liste. Ist das ein Fehler oder Absicht? Wie findet man offiziell einen Auftrag über seine (externe) Nummer? Wir gehen derzeit über /v2/delivery-notes?salesOrderNumber=.
3. Externe Belege (XRE/XRK, z. B. von Amazon)
Wie kommt man lesend an das PDF eines XRE- oder XRK-Belegs? Es gibt keinen GET dafür. POST …/output/pdf erwartet die ID einer Wawi-Rechnung, und externalInvoiceDocumentId ist bei XRE-Belegen leer.
5. Nebenwirkung von output/pdf
Setzt POST …/output/pdf für eine Rechnung ein Druckdatum oder markiert sie als gedruckt? Wir wollen ausschließlich lesen und nichts am Beleg verändern.
6. Fehler 500 bei internen Endpunkten
/v2/internals/salesinvoices und /v2/internals/invoicecorrections antworten mit HTTP 500, auch mit Datumsbereich und companyId. Gibt es dafür Pflichtparameter, oder ist das ein Fehler?
7. Zeitpunkt der Übergabe an JTL-Fulfillment Network
Gibt es in der REST-API ein Feld, wann ein Auftrag an den Fulfiller im FFN übergeben wurde? Wir finden nur das Datum des Lieferscheins und verwenden es ersatzweise. Falls das nur über die FFN-Merchant-API geht: Wie bekommt man als Händler Zugang dazu?
Danke vorab!
wir binden die JTL-Wawi über die REST-API (Version 2.2.2, App-Registrierung, nur lesend) an ein eigenes Auswertungs-Tool an. Dabei sind folgende Fragen aufgekommen:
1. Zeitzone in Listen-Endpunkten
Listen wie GET /v2/sales-orders liefern Zeitfelder (z. B. salesOrderDate, Änderungszeit) in Ortszeit der Wawi, aber mit dem Zusatz „+00:00“ bzw. „Z“. Detail-Endpunkte und Lieferscheine liefern denselben Zeitpunkt mit dem richtigen Versatz („+01:00“). Ist das ein bekannter Fehler? Können wir uns darauf verlassen, dass Listen immer Ortszeit liefern?
2. Filter auf Auftragsnummer werden ignoriert
Auf GET /v2/sales-orders haben die Parameter salesOrderNumber und externalSalesOrderNumber keine Wirkung, es kommt die ungefilterte Liste. Ist das ein Fehler oder Absicht? Wie findet man offiziell einen Auftrag über seine (externe) Nummer? Wir gehen derzeit über /v2/delivery-notes?salesOrderNumber=.
3. Externe Belege (XRE/XRK, z. B. von Amazon)
- GET /v2/sales-invoices enthält keine externen Belege. Ist das so gewollt?
- GET /v2/marketplace/orders/external-documents liefert bei uns nur wenige Belege (nur OTTO). Was ist der vorgesehene Umfang dieses Endpunkts?
- Vollständig bekommen wir externe Belege nur über GET /v2/internals/externaldocuments, und auch dort nur mit fromDate, toDate und companyId. Ohne diese Parameter kommen immer 0 Einträge. Ist /v2/internals/* für Drittanwendungen freigegeben und stabil, oder ist ein öffentlicher Endpunkt geplant?
Wie kommt man lesend an das PDF eines XRE- oder XRK-Belegs? Es gibt keinen GET dafür. POST …/output/pdf erwartet die ID einer Wawi-Rechnung, und externalInvoiceDocumentId ist bei XRE-Belegen leer.
5. Nebenwirkung von output/pdf
Setzt POST …/output/pdf für eine Rechnung ein Druckdatum oder markiert sie als gedruckt? Wir wollen ausschließlich lesen und nichts am Beleg verändern.
6. Fehler 500 bei internen Endpunkten
/v2/internals/salesinvoices und /v2/internals/invoicecorrections antworten mit HTTP 500, auch mit Datumsbereich und companyId. Gibt es dafür Pflichtparameter, oder ist das ein Fehler?
7. Zeitpunkt der Übergabe an JTL-Fulfillment Network
Gibt es in der REST-API ein Feld, wann ein Auftrag an den Fulfiller im FFN übergeben wurde? Wir finden nur das Datum des Lieferscheins und verwenden es ersatzweise. Falls das nur über die FFN-Merchant-API geht: Wie bekommt man als Händler Zugang dazu?
Danke vorab!