Bestellungen (API-Funktionen, Preview)
Die Liste ITscope-Bestellungen zeigt jede Einkaufsbestellung, die der Connector an ITscope übergeben hat — als Warenkorb oder als verbindliche Bestellung —, mit ihrem Stand bei ITscope.
Preview — API-Vertrag erforderlich
Die Bestellfunktionen laufen über die ITscope-REST-API und setzen einen kostenpflichtigen API-Vertrag mit ITscope voraus (HTTP Basic mit Account-ID und API-Schlüssel). Sie sind als Preview gekennzeichnet und standardmäßig ausgeschaltet — der Katalogimport funktioniert vollständig ohne sie. Freischalten: ITscope-Einstellungen → API-Funktionen (Preview).
Seite öffnen
- Dashboard → Bestellungen
- Suche: ITscope-Bestellungen
- Aus jedem Beleg, der zu einer ITscope-Bestellung gehört — Einkaufsbestellung, Verkaufsauftrag, gebuchte Lieferung oder Rechnung, Kreditorenposten: Aktion ITscope-Bestellung (siehe Belegnavigation)
Wie eine ITscope-Bestellung entsteht
Eine ITscope-Bestellung entsteht, wenn die merchantCENTRAL-Beschaffung — etwa AD merchantCENTRAL Trading aus einem Verkaufsauftrag im Streckengeschäft — eine Einkaufsbestellung bei einem Kreditor anlegt, dem in der Kreditorenzuordnung ein ITscope-Distributor aktiv zugeordnet ist, oder wenn jemand sie auf der Einkaufsbestellung von Hand anlegt. Eine Bestellung liegt dabei immer vollständig bei einem Distributor. Ohne eingeschaltete API-Funktionen, ohne Lizenz oder bei ausgeschaltetem Modul entsteht nichts.
Der Bestellmodus in den ITscope-Einstellungen entscheidet, wie weit der Connector geht:
| Bestellmodus | Was passiert |
|---|---|
| Nur Warenkorb vorbereiten (Standard) | Der Connector legt im Hintergrund einen Warenkorb in ITscope an — mit ITscope-Produktnummer, Distributor, Menge und der Bestellnummer als Kommentar. Bestellt wird anschließend von Hand in ITscope. Das funktioniert bei jedem Distributor |
| Verbindlich bestellen | Die Bestellung wird als Sendebereit vorgemerkt. Ein Mensch sendet sie hier mit Bestellung senden — nach einer Rückfrage — als OpenTrans-2.1-Auftrag über ITscope an den Distributor. Der Distributor muss Sie dafür freigeschaltet haben |
Der verbindliche Auftrag enthält Ihre Account-ID als Käufer, den Distributor als Lieferanten, die Lieferadresse der Bestellung (im Streckengeschäft die des Endkunden, sonst Ihre Firmenadresse) und je Position die Distributor-Artikelnummer, die ITscope-Produktnummer, Menge und Einkaufspreis. Die Antworten des Distributors holt danach der Belegrücklauf ab.
Erst im Test-Bestellmodus
Mit Test-Bestellmodus (Standard an) gehen verbindliche Aufträge an ITscopes eigenen Test-Distributor 10000735, der automatisch antwortet — kein Distributor sieht den Auftrag, keine Ware wird bestellt. Das Test-Antwortmuster §C3A1I2 bestellt drei Auftragsbestätigungen, ein Lieferavis und zwei Rechnungen. Testbestellungen berühren nie die Einkaufsbestellung, den Verkaufsauftrag oder eine Buchung; die Spalte Als Test gesendet kennzeichnet sie. Der Testmodus wirkt nur auf verbindliche Bestellungen — ein Warenkorb bestellt ohnehin nichts, bis jemand in ITscope bestellt.
Von Hand anlegen
Nicht jede Einkaufsbestellung entsteht über die merchantCENTRAL-Beschaffung; eine von Hand erfasste sieht der automatische Weg nie. Für sie steht auf der Einkaufsbestellung in der Aktionsgruppe ITscope die Aktion ITscope-Bestellung anlegen — bei eingeschalteten API-Funktionen, solange die Bestellung noch keine ITscope-Bestellung hat und ihr Kreditor einem aktiven ITscope-Distributor zugeordnet ist. Sie geht denselben Weg wie die automatische Anlage:
- Im Modus Nur Warenkorb vorbereiten legt sie den Warenkorb sofort an und meldet Warenkorb-ID und die Zahl der übertragenen Positionen. Scheitert der Warenkorb, steht der Grund in der Meldung und an der Bestellung (Warenkorb fehlgeschlagen).
- Im Modus Verbindlich bestellen merkt sie die Bestellung als Sendebereit vor und stellt dann dieselbe Rückfrage wie Bestellung senden. Wer verneint, findet die Bestellung sendebereit in dieser Liste.
Felder
| Feld | Bedeutung |
|---|---|
| Einkaufsbestellnr. | Die Business Central-Einkaufsbestellung, zu der die ITscope-Bestellung gehört |
| Verkaufsauftragsnr. | Der verknüpfte Verkaufsauftrag im Streckengeschäft |
| Status | Der Stand bei ITscope — siehe Status |
| Warenkorb-ID | Der vorbereitete ITscope-Warenkorb |
| Deal-ID | Der ITscope-Vorgang, sobald bestellt ist |
| Eigene Bestellnr. | Unsere Bestellnummer, wie ITscope sie kennt — nach ihr sucht die Statusabfrage, und jedes Antwortdokument nennt sie |
| ITscope-Deal-Bestellnr. | Die Bestellnummer, die ITscope für den Vorgang vergeben hat — gefüllt bei Bestellungen, die nicht über den Connector gesendet wurden |
| Distributor-Bestellnr. | Die Auftragsnummer aus der Auftragsbestätigung des Distributors — die Nummer für Rückfragen zur Lieferung. Sie erreicht die Bestellung als Kreditorenbestellnr., sofern das Feld dort noch leer ist |
| Distributor-ID | Der ITscope-Distributor, an den die Bestellung ging |
| Als Test gesendet | Die Bestellung ging an den Test-Distributor; es wurde keine Ware bestellt |
| Warenkorb erstellt am | Wann der Warenkorb vorbereitet bzw. die Bestellung vorgemerkt wurde |
| Letzte Statusprüfung | Wann der Deal-Status zuletzt abgefragt wurde |
| Fehlermeldung | Die letzte Fehlermeldung, falls vorhanden — bei einem API-Fehler mit Statuscode und der Antwort von ITscope |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Bestelldokument herunterladen | Erzeugt den OpenTrans-Auftrag zu dieser Bestellung und lädt ihn als XML herunter, ohne etwas zu senden. Funktioniert auch ohne API-Zugang — zum Prüfen, was übertragen würde |
| Bestellung senden | Sendet die Bestellung verbindlich an ITscope. Nur im Modus Verbindlich bestellen aktiv; die Rückfrage sagt, ob die Bestellung an den echten oder den Test-Distributor geht |
| Warenkorb vorbereiten | Legt den Warenkorb jetzt an — für Bestellungen im Status Warenkorb ausstehend oder Warenkorb fehlgeschlagen, etwa nachdem die Zugangsdaten korrigiert wurden |
| Deal-Status aktualisieren | Fragt bei ITscope nach, was mit der Bestellung geschehen ist, und legt die Antwort bei den Belegdokumenten ab |
| Belegdokumente | Öffnet die Belegdokumente dieser Bestellung |
| Belege jetzt synchronisieren | Holt Deal-Status, Auftragsbestätigungen, Lieferavise und Rechnungen dieser Bestellung ab, verarbeitet sie und führt die Belegautomatik aus — derselbe Durchgang wie der Belegrücklauf, auf Knopfdruck. Korrekturen und Probleme stehen danach im Aktivitätsprotokoll |
| Einkaufsbestellung, Verkaufsauftrag | Öffnen die verknüpften Business Central-Belege |
| ITscope-Rechnungen, Seriennummern | Öffnen die Rechnungen und Seriennummern dieser Bestellung |
Die Bestellkarte
Ein Klick auf eine Zeile öffnet die Karte ITscope-Bestellung — dieselbe Karte, die ITscope-Bestellung auf den Business Central-Belegen öffnet.
| Bereich | Inhalt |
|---|---|
| Allgemein | Einkaufsbestellnr., Verkaufsauftragsnr., Status, Distributor-ID, Distributor-Bestellnr. und Als Test gesendet |
| ITscope | Eigene Bestellnr., ITscope-Deal-Bestellnr., Warenkorb-ID und Deal-ID |
| Fortschritt | Warenkorb erstellt am, Gesendet am, Letzte Statusprüfung und Letztes Dokument am; Belegrücklauf abgeschlossen, sobald die Bestellung fakturiert, jedes Dokument verarbeitet und jede Rechnung abgeglichen ist; Letzter Wareneingangshinweis — was der letzte Lauf zum Wareneingang gemeldet hat; Fehlermeldung |
| Zeilen | Je Position, was Auftragsbestätigung und Lieferavis gemeldet haben: PUID, Lieferanten-PID, bestätigte Menge, bestätigter Einzelpreis, zugesagtes Lieferdatum und versandte Menge |
| Pakete (Infobox) | Die Pakete aus den Lieferavisen mit Sendungsverfolgungsnr., Spediteursname und Versanddatum/-zeit. Ein Klick auf die Nummer öffnet die Sendungsverfolgung des Spediteurs |
Die Karte bietet Bestellung senden, Warenkorb vorbereiten, Deal-Status aktualisieren und Belege jetzt synchronisieren wie die Liste — Bestellung senden mit derselben Rückfrage — und führt zu allen verknüpften Belegen: Einkaufsbestellung, Verkaufsauftrag, gebuchte Einkaufslieferungen und -rechnungen, ITscope-Rechnungen, Seriennummern, Belegdokumente und Paket verfolgen (siehe Belegnavigation).
Status
| Status | Bedeutung |
|---|---|
| Warenkorb ausstehend | Warenkorb-Modus: vorgemerkt; der Warenkorb wird gleich im Hintergrund angelegt. Bleibt der Status stehen, legt Warenkorb vorbereiten ihn von Hand an |
| Warenkorb vorbereitet | Der Warenkorb liegt in ITscope und wartet darauf, dass dort bestellt wird |
| Warenkorb fehlgeschlagen | Der Warenkorb konnte nicht angelegt werden; der Grund steht in Fehlermeldung. Warenkorb vorbereiten versucht es erneut |
| Sendebereit | Verbindlicher Auftrag vorgemerkt, wartet auf Bestellung senden |
| Bestellung gesendet | An ITscope übermittelt |
| Bestellung fehlgeschlagen | Nicht angekommen: von ITscope abgelehnt, der Auftrag ließ sich gar nicht erst erzeugen (etwa ohne passendes Angebot oder mit zu langer Nummer), oder ein unbestätigtes Senden kam nachweislich nicht an. Der Grund steht in Fehlermeldung; die Bestellung kann erneut gesendet werden |
| Senden unbestätigt | Gesendet, aber ohne Antwort von ITscope |
| Bestätigt | Auftragsbestätigung verarbeitet |
| Abweichung erkannt | Die Auftragsbestätigung weicht von der Bestellung ab und ließ sich nicht automatisch korrigieren. Abweichungen aus der Rechnung stehen nur im Aktivitätsprotokoll |
| Teilweise versandt / Versandt | Lieferavis verarbeitet — für einen Teil bzw. die ganze Bestellung |
| Fakturiert | Rechnung verarbeitet |
| Storniert | Vom Distributor storniert |
Senden unbestätigt
Die Bestellung ging hinaus, aber ITscope hat nicht geantwortet — ob sie angekommen ist, weiß der Connector nicht. Solange die Bestellung so steht, lässt der Connector kein zweites Senden zu. Der Belegrücklauf — oder Deal-Status aktualisieren — klärt den Status: Kennt ITscope den Vorgang, geht die Bestellung auf Bestellung gesendet; kennt ITscope zehn Minuten nach dem Senden keinen, auf Bestellung fehlgeschlagen, und sie kann erneut gesendet werden. Bleibt der Status stehen, prüfen Sie in ITscope, ob die Bestellung angekommen ist.
Verfügbarkeit prüfen
ITscope-Verfügbarkeit prüfen auf der Einkaufsbestellung fragt ITscope, was die Distributoren heute von den Produkten der Bestellung haben — vor dem Bestellen oder wenn ein Liefertermin wackelt. Die Aktion steht in der Aktionsgruppe ITscope, sobald die Bestellung eine ITscope-Bestellung hat oder eine bekommen kann.
Gefragt wird für jede Artikelzeile mit noch zu liefernder Menge, und zwar nach dem ITscope-Produkt des Angebots, aus dem die Zeile bestellt wird — demselben, das Warenkorb und verbindliche Bestellung verwenden. Ein Aufruf beantwortet bis zu 50 Produkte; eine gewöhnliche Bestellung kostet also einen API-Aufruf (Kategorie Produktdaten in der API-Nutzung).
Die Seite ITscope-Verfügbarkeit zeigt je Zeile die Angebote aller Distributoren:
| Feld | Bedeutung |
|---|---|
| Artikelnr., Beschreibung | Die Bestellzeile |
| Menge | Die noch zu liefernde Menge in der Basiseinheit — der Einheit, in der die Distributoren ihren Bestand zählen und in der auch der Warenkorb bestellt |
| Distributor, Bestellt bei | Wer das Angebot macht. Der Distributor, bei dem die Zeile bestellt wird, steht zuerst und fett |
| Bestand | Was der Distributor auf Lager meldet — rot, wenn es die Menge nicht deckt |
| Zulauf, Verfügbar ab | Was zum Distributor unterwegs ist, und ab wann er das Produkt erwartet, sofern er ein Datum nennt |
| Bestandsstatus | Der Status in den Worten des Distributors |
| Einkaufspreis, Währungscode | Der aktuelle Preis des Distributors |
| Artikelnr. des Distributors | Seine eigene Artikelnummer für das Produkt |
| Bestand aktualisiert am | Wann der Distributor seinen Bestand zuletzt an ITscope gemeldet hat |
| Hinweis | Warum eine Zeile kein Angebot zeigt |
Eine Zeile ohne Angebot verschwindet nicht, sondern sagt, warum: Für diesen Artikel ist kein ITscope-Angebot bekannt — zu Artikel und Kreditor der Zeile gibt es in den Lieferantendaten kein ITscope-Angebot —, oder ITscope führt für dieses Produkt derzeit kein Angebot.
Nichts wird gespeichert
Bestände ändern sich stündlich. Die Antwort wird deshalb nur angezeigt, nicht gespeichert — jede Prüfung fragt neu. Die Prüfung setzt eingeschaltete API-Funktionen mit Account-ID und API-Schlüssel voraus.
Auf den Business Central-Belegen
Sobald es zu einem Beleg einen ITscope-Vorgang gibt, zeigt die Infobox ITscope-Bestellung den Stand — Status, Distributor-ID, Bestellnummern, Testkennzeichen, den Zeitpunkt des letzten Dokuments und eine Fehlermeldung —, und die Aktionsgruppe ITscope führt zur ITscope-Bestellung. Welche Aktionen auf welchem Beleg stehen, zeigt die Belegnavigation.
Der Connector schreibt die Nummern des Distributors in die Standardfelder der Einkaufsbestellung — Kreditorenbestellnr., Kreditorenlieferungsnr. und Kreditorenrechnungsnr. —, und das Buchen trägt sie auf die gebuchten Belege weiter. Welche Felder wann geschrieben werden, steht unter Belegautomatik.
401, 403 oder 503 von der API
401 heißt, die Zugangsdaten wurden abgelehnt — bei ITscope meist kein Tippfehler, sondern ein fehlender API-Vertrag. 403 heißt, die Anmeldung stimmt, der Aufruf ist aber nicht erlaubt: Das gebuchte Paket umfasst die Funktion nicht, oder das Kontingent ist aufgebraucht. 503 heißt, es kamen zu viele Anfragen pro Minute — eine Minute warten. Die Fehlermeldung an der Bestellung nennt Statuscode und Antwort.