Zum Inhalt

Ingram Micro Einrichtung

Die Seite Ingram Micro Einrichtung ist die einzige Einrichtungsseite des Connectors. Dieselben Abschnitte erscheinen auch auf der Lieferant-Karte des Hubs für den Lieferanten INGRAM-MICRO — unter Ingram-Micro-Einstellungen und Ingram Micro Importe.

Seite öffnen

API-Verbindung

Feld Beschreibung
Kundennummer Ihre Ingram-Kundennummer. Wird bei jeder Anfrage als Header IM-CustomerNumber gesendet.
Ländercode ISO-Code Ihrer Ingram-Niederlassung, z. B. DE (Header IM-CountryCode).
Sandbox verwenden Alle Aufrufe gehen an Ingrams Sandbox statt an das Live-System.

Authentifizierung

Client-ID und Clientgeheimnis klicken Sie an, um sie in einem verdeckten Dialog einzugeben. Beide liegen verschlüsselt im zentralen Credential Store des Hubs, nie in einem Tabellenfeld; angezeigt wird nur Konfiguriert oder Nicht konfiguriert. Bestätigen Sie den Dialog mit leerem Feld, bleibt der gespeicherte Wert unverändert.

Zugriffstoken zeigt, ob für diesen Mandanten ein gültiger Token zwischengespeichert ist: Gültig oder Keines - wird beim nächsten Aufruf angefordert. Der Connector fordert den Token selbst an und erneuert ihn, sobald er abgelaufen ist — auch für Benutzer, die die Einrichtung nur lesen dürfen.

Zugangsdaten je Mandant

Client-ID, Clientgeheimnis und Zugriffstoken gelten für den Mandanten, in dem Sie sie eingeben — wie Kundennummer und Ländercode. Mehrere Mandanten können so verschiedene Ingram-Konten nutzen. Beim Update auf Version 1.16 wurden die bis dahin datenbankweit gespeicherten Zugangsdaten in jeden Mandanten kopiert. Eine neue Client-ID oder ein neues Clientgeheimnis verwirft den gespeicherten Token; der nächste Aufruf fordert einen passenden an.

Aktion Beschreibung
Verbindung testen Meldet sich mit den Zugangsdaten bei Ingram an.
Zugriffstoken abrufen Fordert sofort einen neuen Token an (Ingram-Token gelten 24 Stunden).
Zugriffstoken löschen Verwirft den zwischengespeicherten Token; der nächste Aufruf fordert einen neuen an.
Trennen Löscht Client-ID, Clientgeheimnis und Token dieses Mandanten.

Einkauf

Den Kreditor, der Ingram Micro darstellt, pflegen Sie im Feld Kreditorennr. der Lieferant-Karte INGRAM-MICRO — nur dort; der Einrichtungsassistent schreibt ihn ebenfalls dorthin. Nur Einkaufsbestellungen an diesen Kreditor zeigen die Ingram-Aktionen, und ohne Kreditor laufen weder die Importe noch die Suche nach fremd aufgegebenen Bestellungen.

Feld Ab Werk Beschreibung
Simulationsmodus an Bestellungen werden nur in Business Central unter einer SIM--Nummer erfasst — siehe Bestellungen.
Einkaufsbestellung automatisch aktualisieren an Ingram-Auftragsnummer, Rechnungs- und Lieferscheinnummer auf die Bestellung.
Zeilenbeträge automatisch korrigieren an EK-Preis einer Zeile folgt Ingrams bestätigtem Preis.
Bestellmengen automatisch aktualisieren an Bestätigte Mengen auf die Zeilen; gelieferte oder berechnete Zeilen werden nur gemeldet.
Seriennummern automatisch zuweisen an Siehe Seriennummern.
Versandkosten automatisch hinzufügen an Fracht und Zuschläge als Artikel-Zu-/Abschläge — siehe Rechnungen.
Zu-/Abschlagsartikel Versand / Versicherung / Sonstiges – Auf welchen Zu-/Abschlag Fracht, Transportversicherung und alle übrigen Zuschläge gebucht werden.
Zugesagtes Wareneingangsdatum autom. aktualisieren aus Ingrams Liefertermin auf die Einkaufszeilen.
Lieferdatum im Verkauf autom. aktualisieren aus Ingrams Liefertermin auf die Zeilen des Streckenauftrags.
Wareneingang autom. buchen aus Bucht den Wareneingang für die gemeldeten Liefermengen — nur im Hintergrundlauf.
Rechnung automatisch buchen aus Bucht die Einkaufsrechnung, sobald Ingrams Rechnung zur Bestellung passt.
Benachrichtigungs-E-Mail / Verarbeitungsbenachrichtigung senden – / an Nach jedem Abgleichslauf eine Zusammenfassung per E-Mail.

Buchen lässt sich nicht zurücknehmen

Wareneingang autom. buchen und Rechnung automatisch buchen sind ab Werk aus. Schalten Sie sie erst ein, wenn Sie einige Wochen beobachtet haben, dass Mengen, Zuschläge und Beträge sauber ankommen.

Automatisierung

Feld Ab Werk Beschreibung
Auto-Sync-Aufgabe – Zustand des Aufgabenwarteschlangenpostens.
Automatische Synchronisierung aktivieren aus Schaltet den Abgleich der Bestellungen ein.
Synch.-Intervall (Minuten) 60 Abstand der Läufe, mindestens 5.
Nachlaufzeitraum (Tage) 60 Wie lange nach dem Versand ein Auftrag noch abgefragt wird, solange etwas offen ist.
Suchzeitraum (Tage) 90 Wie weit zurück der Lauf nach Bestellungen sucht, die außerhalb des Connectors aufgegeben wurden.
Preislisten-Batchgröße 50 Artikel je Preis-&-Verfügbarkeits-Aufruf der API, höchstens 50.
Bestandsmengen-Obergrenze 0 Höchste Menge aus der Verfügbarkeitsdatei. Ingram meldet für viele Artikel pauschal 10.000; 0 = keine Obergrenze.

Aufgabenwarteschlange anlegen/aktualisieren legt den Posten an oder passt ihn an das Intervall an; ist die automatische Synchronisierung aus, wird er angehalten. Katalog-Abonnements öffnet die Katalog-Abonnements.

Importdefinitionen

Zwei Abschnitte, je einer pro Datei:

Abschnitt Code Inhalt Bereitstellung durch Ingram
Preisliste (Artikelstamm) INGRAM-PRICELIST Artikel mit Hersteller, Herstellerartikelnr., EAN, Beschreibung, Einkaufspreis, UVP täglich gegen 06:00
Verfügbarkeit (stündlich) INGRAM-AVAILABILITY Bestand je Ingram-Artikelnummer stündlich gegen xx:04
Feld / Aktion Beschreibung
Aktiv Nur aktive Importe laufen mit.
Quelltyp Fest: Azure Blob Storage über die zentrale OAuth2-Verbindung des Hubs.
Quell-URL Adresse der bereitgestellten Datei im Blob Storage.
Authentifizierung Zeigt, ob die zentrale Speicherverbindung in der merchantCENTRAL-Einrichtung konfiguriert ist; ein Klick öffnet sie.
Status Ergebnis des letzten Laufs.
Verbindung testen Lädt die Datei probeweise.
Import jetzt ausführen Startet den Import sofort — über den Hub, mit Lizenzprüfung und einer Zeile im Importprotokoll wie bei einem geplanten Lauf.
Hersteller analysieren Nur Preisliste: liest die Datei und trägt alle Hersteller in die Herstellerauswahl ein, ohne einen Artikel zu importieren.

Preisliste: Artikel in der Datei sind danach aktiv; Artikel, die Ingram nicht mehr führt, fallen auf Entwurf zurück. Eine leere oder abgeschnittene Datei gilt als gescheiterter Lauf — dann wird nichts auf Entwurf gesetzt.

Verfügbarkeit: Aktualisiert nur Artikel, die die Preisliste bereits geliefert hat. Die Datei ist ein Vollabzug: Ein Artikel, der darin fehlt, bekommt die Menge 0. Trifft die Datei keinen bekannten Artikel, gilt der Lauf als gescheitert.

Wer stellt die Dateien bereit?

Sie selbst. Ingram legt die Dateien auf seinem SFTP-Server ab; von dort bringen Sie sie in Ihren eigenen Azure Blob Storage — etwa mit einer eigenen Azure Function, die die Dateien abholt, entpackt und ablegt. Das Abo der Dateien beantragen Sie bei Ingram mit Ihrer Kundennummer. ALTENBRAND richtet weder den Blob Storage noch die Abholung ein; der Connector liest die Dateien nur von der Quell-URL.

Neben den beiden Dateien legt der Connector zwei Importdefinitionen für die API an, die in der Lieferanten-Einrichtung des Hubs stehen: INGRAM-CATALOG für die Katalog-Abonnements und INGRAM-STOCK für die Bestandsaktualisierung verknüpfter Artikel. Import ausführen auf dem Dashboard arbeitet alle aktiven Definitionen in dieser Reihenfolge ab: Preisliste, Verfügbarkeit, Katalog-Abonnements, Bestand.

Herstellerauswahl

Ingram führt über 200 Hersteller. Damit Ihre Lieferantendaten nicht mit Artikeln volllaufen, die Sie nie verkaufen:

  1. Preisliste (Artikelstamm) → Hersteller analysieren.
  2. Hub-Lieferant-Karte → Herstellerauswahl → die gewünschten Hersteller freigeben (siehe Hersteller-Auswahl).
  3. Preisliste → Aktiv setzen und Import jetzt ausführen.

Die Auswahl gilt für beide Wege: Auch Katalog-Abonnements übernehmen nur Artikel freigegebener Hersteller.

Berechtigungen

Berechtigungssatz Umfang
Ingram Micro Admin Vollzugriff: Einrichtung, Katalog-Abonnements, Importe und alle Belege. Schließt Ingram Micro Benutzer und den Hub-Satz merchantCENTRAL Admin ein.
Ingram Micro Benutzer Tägliche Arbeit: Bestellungen übertragen und verfolgen, Rechnungen und Seriennummern lesen, Katalog-Abonnements ansehen. Schließt den Hub-Satz merchantCENTRAL User ein. Die Einrichtung ist für ihn nur lesbar — einen abgelaufenen Zugriffstoken erneuert der Connector trotzdem.

Katalogimporte ausführen ist Admin-Arbeit: Der Hub-Benutzersatz darf die Lieferantendaten, in die sie schreiben, nur lesen.

Lizenz

Die Infobox Lizenz zeigt den Stand des Moduls INGRAM-MICRO und fragt beim Öffnen der Seite den Lizenzserver ab. Eine Lizenz oder laufende Demo ist auch in einer Sandbox nötig — siehe Lizenzierung.