Xentral-API

Hallo zusammen,viele von uns würden gern einfach in natürlicher Sprache Fragen an die eigenen Xentral-Daten stellen. Zum Beispiel "Welche Bestellungen sind heute offen?" oder "Wie ist der Lagerbestand für Artikel X?".Mit dem Model Context Protocol (MCP) geht das jetzt über KI-Clients wie Claude Desktop.Ich habe die Einrichtung einmal Schritt für Schritt aufgeschrieben, weil die Frage öfter aufkam.Was ist MCP, kurz gesagtMCP ist ein offener Standard, über den ein KI-Client Werkzeuge nutzen kann.Für Xentral heißt das: der Client liest über die Xentral-API deine Daten und beantwortet Fragen dazu. Rein lesend, es wird nichts verändert.VoraussetzungenEine Xentral-Instanz mit API-Zugang Ein Personal Access Token (im Xentral-Admin unter den API-Einstellungen erstellen) Node.js auf dem eigenen Rechner (https://nodejs.org/) Ein MCP-fähiger Client, zum Beispiel Claude DesktopSchritt für SchrittIm Xentral-Admin einen Personal Access Token anlegen und kopieren. Auf dem eigenen Rechner den Einricht

Hallo Community,für den Import von Kundengruppen-spezifischen Preisen wollte ich die Xentral-API benutzen. Grundsätzlich verstehe ich die Dokumentation des Endpunktes hier: https://developer.xentral.com/reference/postapi-v3-salesprices auch so, dass man die Gruppen entsprechend übergeben kann.Was für mich allerdings unklar ist, wo ich herausfinde welcher meiner Kundengruppen welche ID zugeordnet. In der Doku heißt es ja customerGroup Object, nur ist dieses leider nicht weiter dokumentiert und es gibt auch keinen eigenen Endpunkt dafür.Weiß jemand weiter?Viele Grüße!

Leider besteht die Xentral V2-API darauf, dass ein FreiFeld-Wert (value) kein Leerstring sein darf bei Artikel-Updates (PATCH). Dadurch ist es nicht möglich freeFields eines Artikels geziehlt zu leeren. Ich habe bereits versucht null und “ “ zu senden, aber auch das scheitert:{"type":"https:\/\/api.xentral.biz\/problems\/request-validation","title":"Request payload validation failed.","violations":[{"freeFields":[{"value":["Field value should not be null."]}]}]}{"type":"https:\/\/api.xentral.biz\/problems\/request-validation","title":"Request payload validation failed.","violations":[{"freeFields":[{"value":["Field value should be a non-empty string."]}]}]}Gibt es da eine undokumentierte Möglichkeit?Falls nein würde ich das als Bug einstufen. 

Hallo zusammen,wir setzen Xentral zusammen mit Shopify POS Pro in einer Kaffeerösterei ein und stehen aktuell vor einem Problem bei der Chargenverwaltung.Unser Produktionsprozess ist bereits vollständig in Xentral abgebildet:Eine Röstung ergibt eine Charge (z. B. 200 kg Espresso). Aus dieser Charge werden verschiedene Verkaufsartikel produziert (250 g Bohne, 500 g Bohne, 250 g gemahlen usw.). Die Stücklisten, Produktion und Chargenverwaltung in Xentral funktionieren einwandfrei.Das Problem entsteht ausschließlich beim Verkauf über Shopify POS.Im Ladengeschäft liegen häufig mehrere Chargen desselben Artikels gleichzeitig im Regal. Der Mitarbeiter entscheidet erst beim Griff ins Regal, welche Charge tatsächlich an den Kunden ausgegeben wird. Teilweise wünschen Kunden sogar ausdrücklich die frischeste Charge.Da Shopify POS standardmäßig keine Chargenerfassung unterstützt, wird beim Import nach Xentral lediglich der Artikel übergeben. Der Auftrag wird anschließend automatisch abgeschlossen

Bei der Abfrage an List storage items V2  ist uns aktuell aufgefallen, dass hier nicht immer alle Produktlagerbestände richtig wiedergegeben wurden. Wir haben die Daten einerseits verglichen mit View storage locations als auch mit den Lagerdaten aus dem Interface unter Lager > Lagerverwaltung > Lagerbestand. In beiden genannten Referenzen sind die Daten richtig. Ist euch denn ein Bug hier bekannt? Ich konnte im Forum dazu leider nichts finden. Danke für die Unterstützung

Moin Xentral-Community,wir haben uns ein eigenes Tool für das Thema Rechnungseingang und Freigabeprozess gebastelt, weil der Prozess in Xentral nicht effizient gelöst ist.Einziges Problem: Die Verbindlichkeiten landen in Xentral immer als Entwurf und müssen manuell freigegeben werden. Gibt es eine Möglichkeit, sie irgendwie direkt als “Freigegeben” zu importieren und den Prozess der Freigabe zu Automatisieren?Danke & Grüße,Torge

Ziel: Abrufen aller aktuell gültigen Einkaufspreise via /api/v1/purchasePricesDokumentation sagt:To filter by date, you may use something resembling the following:&filter[0][key]=date&filter[0][op]=greaterThan&filter[0][value]=2023-01-01T00:00:00+01:00 Also:/api/v1/purchasePrices?page[number]=1&page[size]=50&filter[0][key]=expiresAt&filter[0][op]=equals&filter[0][value]=Response:"Field `key` should one of `id,product,supplier,currency,fromQuantity,isValidAt`." Ok, dann also:/api/v1/purchasePrices?page[number]=1&page[size]=50&filter[0][key]=isValidAt&filter[0][op]=equals&filter[0][value]=2025-05-28T00%3A00%3A00%2B01%3A00Response:"Operator `equals` is not supported in filter key of type `custom`." Na gut, dann eben:/api/v1/purchasePrices?page[number]=1&page[size]=50&filter[0][key]=isValidAt&filter[0][op]=from&filter[0][value]=2025-05-28T00%3A00%3A00%2B01%3A00Ok. verstehe, “from” gibt es nicht, aber siehe da, es gibt viele weiter

Wir versenden in Xentral erstellte Purchase Orders (PO, Bestellungen) außerhalb Xentral.Leider scheint es jedoch keinen Endpoint zu geben, um eine PO per API auf Status “Versendet” zu setzen?Gibt es ggf. einen (nicht dokumentierten) Endpunkt hierfür? Wie lösen das andere? Wir müssen jedenfalls irgendwie in Xentral erkennen können, welche PO bereits versendet wurde und welche nicht. 

Hallo,ich entwickle eine externe Terminbuchungsseite für meinen Betrieb und möchte diese direkt mit dem Xentral-Kalender integrieren. Konkret brauche ich:Lesen – freie Zeitslots anzeigen (bereits gebuchte Termine aus Xentral als belegt markieren) Schreiben – nach Kundenbuchung automatisch einen neuen Kalendereintrag anlegen Löschen – bei Absage den Eintrag wieder entfernenWas ich bereits probiert habe:REST API v1 (/api/v1/...): In der OpenAPI-Spec ist der Tag "UI Calendar" deklariert, aber kein einziger Pfad ist damit verknüpft — die Endpunkte fehlen komplett Personal Access Token (Bearer Auth): Alle Anfragen an /v3/calendar/events und /index.php?module=kalender&action=data werden von der SSO-Middleware (Auth0) mit HTTP 302 abgefangen, bevor Sanctum den Token überhaupt prüfen kann ICS-Feed (/index.php?module=kalender&action=ics): Gibt HTTP 401 zurück, auch mit gültiger Session — kein dokumentiertes Auth-Format gefunden Auth0 ROPC Grant: Gibt access_denied zurück — vermutlich we

Hi Community, Ich stehe auf dem Schlauch. Shopware 6 hat eine Bestellung aus Österreich mit 19% Mwst richtig angenommen und es wurde an Xentral übermittelt.  Xentral hat aber der Steuersatz auf Ermäßigt 7% gestellt.  Wir verkaufen nichts mit ermäßigte Mwst.  Ich schaue in den Steuersätzen und es gibt keine Regeln für Österreich. Es scheint aber immer die Bestellungen aus diesem Land betroffen zu sein.  Woran könnte es liegen, dass wenn eine Bestellung aus Österreich kommt, dass Xentral es empfängt?  Danke im Voraus George  

Hi liebe Community kennt jemand jemanden von Xentral Vertrieb?Wir haben keinen Zugang ins System und benötigen dringend Support.  Danke für jede Hilfe. 

Weiß jemand, was man machen muss, damit man auf die V3 Endpoints zugreifen kann ? “This endpoint is only available if the feature flag core-api-v3 is enabled” Beste Grüße,Benjamin 

Hallo Community,wir haben aktuell folgendes Problem:Der Connector überträgt aus unserer Importvorlage (CSV) keine Eigenschaftsfelder mehr, sondern nur noch Freifelder. Außerdem gibt es im Connector keine entsprechende Gruppe für diese Felder, sodass wir die Eigenschaften künftig in Shopify manuell pflegen müssten.Gibt es hierfür eine bekannte Ursache oder eine mögliche Abhilfe?Vielen Dank vorab für eure Unterstützung.VGRalf 

I'm using the "Shipment Label Successfully Created" webhook to detect when an order has been fulfilled. However, it's only working partially. Sometimes, the webhook payload doesn't include the carrier information, which prevents us from properly updating the fulfillment status.Do you know why the carrier field might be empty in some cases?Here’s an example of the response we receive from the webhook: metadata.body_params.body: %{ "carrier" => "", "createdAt" => "2025-10-07T14:41:07+02:00", "deliveryNoteId" => 2014143, "salesOrderId" => 2075914, "shipmentId" => 2103036, ... } We’re trying to understand if there’s a specific reason why the carrier value is sometimes missing.

Ich verzweifle aktuell noch mit dem neuen Xentral Connector.Meine Probleme sind konkret:Wir nutzen für unseren Pfand das Shopify Plugin UpCharge Fees Addons Surcharge. Dieses generiert automatisch eine 14-stellige Artikelnummer für den Pfand, z. B. 5062201730642927. Der Connector erkennt diese Artikelnummer nicht und importiert den Auftrag deshalb nicht ins System. Auch der Support von Xendoit konnte bisher keinen Grund nennen, warum die Schnittstelle den Auftrag blockiert. Xentral Connector Fehlermeldung:  Xentral Artikelnummer:  Shopify Artikelnummer:  Mit der “alten” Schnittstelle war alles kein Problem!LGRalf

Endpoint        {{baseUrl}}/api/v1/warehouses/:warehouseId/storageLocations/:storageLocationId/items liefert nur “406 Not Acceptable” obwohl korrekte warehouseId und storageLocationId angegeben wird.Fehler in der API oder übersehe ich etwas? Beispiel: Response auf StoreLocationList: "data": [        {            "id": "3",            "warehouse": {                "id": "2"            },            "designation": "OEAGL1",            "description": "",            "project": null,            "sort": 0,            }        }    ],     <cut>    }}=> warehouseId = 2, storageLocationId = 3Request:{{baseUrl}}/api/v1/warehouses/2/storageLocations/3/items => “406 Not Acceptable” Was ist hier falsch?

Hallo,Hat jemand gerade Probleme mit O365 Emailkonten. Wir kriegen aktuell keine Mails verschickt.  Die Anbindung haben wir erneut verbunden und Xentral gibt eine Positive Rückmeldung zu der Verbindung aber Testmails gehen nicht raus.  Wir haben bei Microsoft nichts verändert und Authentifizierte SMTP ist aktiviert.  Danke im Voraus für jedem Rat. GrüßGeorge

Hallo zusammen, wir überlegen derzeit, N8N als Automatisierungsplattform in Kombination mit Xentral einzusetzen – insbesondere für folgende Anwendungsfälle:  Verbindung von Xentral mit digitalen Produkten (z. B. E-Learning / SaaS-Lösungen) Automatisierte Aboverwaltung: Erstellung, Verlängerung, Kündigung, Status-Updates Synchronisation von Kunden- und Vertragsdaten mit Drittplattformen (z. B. LMS, CIAM, Streamingserver) Automatische Erstellung und Anpassung von Angeboten, Rechnungen und Abos Automatisierte Kommunikation per E-Mail oder Webhooks an andere Systeme  Hat jemand aus der Community bereits konkrete Erfahrungen mit N8N in Verbindung mit Xentral gesammelt?Uns interessieren besonders:  Welche Aufgaben erledigt ihr automatisiert mit N8N? Welche Hürden oder Limitationen gab es bei der Integration? Nutzt ihr Webhooks, API-Schnittstellen oder eine Middleware? Welche Tipps würdet ihr für den Einstieg oder die Strukturierung der Flows geben?  Wir freuen uns auf jeden Erf

Hallo zusammen,ich versuche gerade, per API-Request einen einzelnen Kunden anhand seiner E-Mail-Adresse zu finden.Auf dieser Seite: https://developer.xentral.com/reference/customerlistv2? erscheint jedoch, sobald ich im Filter „E-Mail“ auswähle, im Request-Fenster immer nur ?filter=undefined.Ich habe bereits mehrere Versuche unternommen, aber es gelingt mir nicht, einen Kunden gezielt per E-Mail abzufragen.Hat jemand von euch dafür eine funktionierende Lösung oder ein Beispiel?

I'm looking for a way to detect the status of a batch in the multi-order picking module. Specifically, I'd like to know if there is either an API endpoint or a webhook that can provide the current status of an order or batch (e.g., whether it is offen, in Bearbeitung, or abgeschlossen). I have checked the salesOrders view in the API documentation but couldn't find the batch status information there.

Hallo zusammen,ich hätte mal wieder eine Frage in die Runde:Gibt es eine Möglichkeit, wie man Statusmeldungen eines 3PL (Third Party Logistics Providers), die bereits im 3PL-System vorhanden sind und theoretisch per API übertragen werden könnten, in unserem System sinnvoll abbilden kann?Hier ein paar Gedanken, wie das eventuell technisch gelöst werden könnte: Lieferschein aktualisieren: Idee war, den jeweiligen Status (z. B. „gepickt“, „gepackt“) in ein freies Feld am Lieferschein zu schreiben. Meines Wissens nach ist der Lieferschein im Standard aber schreibgeschützt, daher vermutlich nicht direkt per API änderbar. Protokolleintrag erzeugen: Das wäre aus meiner Sicht die transparenteste und sauberste Lösung, da alle Statusschritte nachvollziehbar fortgeschrieben würden. Ich habe aber bisher keinen passenden API-Endpunkt gefunden – vermute also, dass das aktuell nicht möglich ist. Tags automatisch setzen: Denkbar wäre, bestimmte Tags durch den 3PL automatisch setzen zu lassen. So k

Hallo zusammen,folgendes möchte ich umsetzen.Ich möchte, dass beim Übergang eines Auftrags in den Versand automatisch ein Kommissionierschein als CSV-Datei erzeugt wird. Diese CSV soll die Artikelnummern, Bezeichnungen, Mengen und Lagerplätze enthalten – und automatisch per E-Mail oder später per FTP versendet werden.Hat jemand eine Idee wie, ich das umsetze. Vielen Dank

HI hat einer einen tip wie ich ggf Alle sales order per APi abrunfen kann die keine Rechnung haben. HIntergrund ist das ich für eine Reporting die rechnungszeilen abrufe. Das klappt auch alles so weit. Jetzt soll zusätzlich noch gezeigt werdn was noch offen also noch nicht final berechnet ist aber schon in Aufträgen ist endweder freigegeben oder auch schon in der logistik aber noch nicht versandt.  

Hallo zusammen,eBay hat kürzlich die Funktion für Streichpreise (z. B. UVP oder ehemaliger Preis) freigeschaltet. Voraussetzung ist laut eBay ein Top-Shop-Abonnement. Mehr dazu hier: https://community.ebay.de/t5/eBay-Mitteilungen/Mehr-Sichtbarkeit-mehr-Verk%C3%A4ufe-Streichpreise-mit-UVP-%C3%BCber-die/ba-p/4958255Jetzt stellt sich die Frage bevor wir unseren Shop upgraden auf TOP-Shop:Unterstützt die aktuelle eBay-Integration in Xentral bereits diese neue Funktion zur Übermittlung von Streichpreisen?Und falls nein:Ist eine Erweiterung/Anpassung geplant?Hat jemand von euch das schon getestet oder weiß mehr?Danke vorab für jede Rückmeldung!Viele GrüßeSany

HI , frage : kann ich mit den API entpunkt hier auch abgänge buchen also zum beispiel über eine negative zahl bei der Menge ? Add item to Storage Location posthttps://{xentralId}.xentral.biz/api/v1/warehouses/{warehouseId}/storageLocations/{storageLocationId}/itemsich würde gerne Lagerbewegungen die beime 3PL gemacht werden auch in Xentral automatisch abbilden. Also zum beispiel das Umbuchen von einem Lager zu einem anderen Lager. Beispiel Sperrlager bestände. Ich habe keinen anderen weg gefunden . wenn ich also mit 2 api calls mache einmal mit einem Abgang auf Lager Normal uind einem zugang auf Lager Sperr dann würde ich es ja darüber machen können . oder gibt es eine andere Lösung dafür. DAnke Ingo