Zum Inhalt

Ingram Micro Supplier Connector

Der merchantCENTRAL Supplier Ingram Micro verbindet Business Central mit dem IT-Distributor Ingram Micro — vom Artikelstamm bis zur gebuchten Rechnung. Der Connector nutzt zwei Wege, und jeder trägt, wofür er gemacht ist:

  • Dateien für den Artikelstamm: Ingram stellt täglich eine Preisliste (rund 230.000 Artikel) und stündlich eine Verfügbarkeitsdatei bereit. Beide laufen über die zentrale merchantCENTRAL-Importpipeline in die Hub-Tabelle Lieferantendaten — beschränkt auf die Hersteller Ihrer Wahl.
  • Die Xvantage-API für die Belege: Bestellung, Auftragsnummer, bestätigte Preise und Mengen, Liefertermine, Sendungs- und Seriennummern und die Rechnung mit allen Zuschlägen.

Der Connector ist ein Add-on des merchantCENTRAL Hub: Die Lieferantendaten speisen Preisberechnung, Bestand und Artikelanlage, Sendungsnummern gehen an das zentrale Tracking, Rechnungen an den Rechnungsabgleich des Hubs.

Warum nicht alles über die API?

Ingram begrenzt die API auf 60 Aufrufe je Minute und liefert Preise in Paketen von höchstens 50 Artikeln. Den ganzen Katalog so abzufragen, dauerte über 4.600 Aufrufe — und Ingram untersagt, den Katalog zyklisch per API zu befüllen. Für den Vollbestand ist die Preisliste da; die API ergänzt gezielt über Katalog-Abonnements.

Funktionsübersicht

Feature Beschreibung
Preisliste und Verfügbarkeit Tägliche Preisliste und stündliche Verfügbarkeit per Datei; ausgelistete Artikel fallen auf Entwurf zurück
Herstellerauswahl Nur freigegebene Hersteller gelangen in die Lieferantendaten
Katalog-Abonnements Gezieltes Nachladen einzelner Hersteller, Kategorien oder Suchbegriffe über die API
Bestellung aus der Einkaufsbestellung Mit Preisprüfung gegen Ingrams Echtzeitpreis (Abweichung über 1 % wird vorab gezeigt)
Übertragung aus Trading Der Hub und merchantCENTRAL Trading können die Übertragung selbst auslösen
Schutz vor Doppelbestellung Vor jedem echten Senden fragt der Connector Ingram, ob die Bestellung dort schon liegt
Statusabgleich Per Aufgabenwarteschlange: Auftragsnummer, Mengen, Preise, Termine, Sendungs- und Seriennummern
Rechnungen Beträge, Fälligkeit und jeder Zuschlag — Fracht, Versicherung, Gebühren — als Artikel-Zu-/Abschläge
Streckengeschäft Sendungsverfolgung, Liefertermin und Seriennummern auch auf dem Verkaufsauftrag
Fremd aufgegebene Bestellungen Per Mail oder im Ingram-Portal bestellt? Der Abgleich findet und ordnet den Auftrag zu
Simulationsmodus Ab Werk aktiv: Bestellungen werden nur in Business Central erfasst, nichts geht an Ingram
Lizenz & Demo Tenant- und modulgebundene Lizenz mit kostenloser Demo (Modulcode INGRAM-MICRO)

Erste Schritte

  1. Stellen Sie sicher, dass der merchantCENTRAL Hub installiert und eingerichtet ist.
  2. Installieren Sie den Supplier Ingram Micro über AppSource.
  3. Aktivieren Sie den Lieferanten INGRAM-MICRO in der Lieferantenübersicht — ohne Lizenz startet dabei die kostenlose Demo-Registrierung.
  4. Fordern Sie bei Ingram Micro Ihre Xvantage-Zugangsdaten (Client-ID, Clientgeheimnis) an und notieren Sie Ihre Kundennummer.
  5. Führen Sie den Einrichtungsassistenten aus — die Schritte für Zugangsdaten und Importe lassen sich überspringen und später nachholen.
  6. Richten Sie Preisliste und Verfügbarkeit ein und wählen Sie die Hersteller aus.
  7. Prüfen Sie den Bestellablauf im Simulationsmodus, bevor Sie live gehen.

Seitenübersicht

Seite Beschreibung
Dashboard Importübersicht, Bestellungen und API, Lizenz
Einrichtung Verbindung, Einkauf, Automatisierung, Importdefinitionen, Herstellerauswahl
Einrichtungsassistent Geführte Ersteinrichtung in acht Schritten
Katalog-Abonnements Gezieltes Nachladen über die API
Bestellungen Übertragen, Simulation, vorhandene Aufträge zuordnen, Preisprüfung
Rechnungen Rechnungsimport, Zuschläge, Rechnungsabgleich
Seriennummern Gemeldete Seriennummern und ihre Zuweisung
Belegnavigation Von jedem Beleg zur Ingram-Bestellung und zurück
Automatische Verarbeitung Aufgabenwarteschlange, Nachlauf- und Suchzeitraum
Fehlerbehebung Häufige Meldungen und ihre Ursachen

Architektur

┌─────────────────────────────────────────────────────────┐
│                      Ingram Micro                        │
│                                                          │
│  Xvantage-API (OAuth2)          SFTP-Datenservice         │
│  ├── Katalog / Preis & Verf.    ├── Preisliste (täglich)  │
│  ├── Bestellung (v7)            └── Verfügbarkeit (stdl.) │
│  ├── Auftragssuche / -details                            │
│  └── Rechnungen                                          │
└────────────┬──────────────────────────┬─────────────────┘
             │ Bearer-Token +           │ Azure Function →
             │ Kundennr. / Ländercode   │ Azure Blob Storage
┌────────────┴──────────────────────────┴─────────────────┐
│            merchantCENTRAL Supplier Ingram Micro          │
└────────────────────────┬─────────────────────────────────┘
                         │ Events
┌────────────────────────┴─────────────────────────────────┐
│                  merchantCENTRAL Hub                      │
│   (Lieferantendaten, Preis, Bestand, Tracking, Abgleich)  │
└───────────────────────────────────────────────────────────┘

Der Status wird über die Aufgabenwarteschlange abgefragt. Business Central SaaS stellt einer Erweiterung keinen öffentlich erreichbaren Endpunkt bereit, über den Ingram Ereignisse zustellen könnte.

Voraussetzungen

  • Microsoft Dynamics 365 Business Central (Cloud, Version 28.x oder neuer)
  • merchantCENTRAL Hub ab Version 2.99, installiert und eingerichtet
  • Ingram-Micro-Kundenkonto mit Xvantage-API-Zugang (Client-ID, Clientgeheimnis) und Kundennummer
  • Für den Artikelstamm: das Ingram-Datenservice-Abo für Preisliste und Verfügbarkeit und die Bereitstellung der Dateien im Azure Blob Storage — die Einrichtung übernimmt ALTENBRAND
  • Ein Kreditor für Ingram Micro

Marken

Ingram Micro und Xvantage sind Marken der Ingram Micro Inc. Ihre Nennung erfolgt ausschließlich beschreibend als Hinweis auf die Bestimmung dieser Software. Der Connector ist ein unabhängiges Produkt der ALTENBRAND Datentechnik GmbH und steht in keiner Verbindung zu Ingram Micro; er ist von Ingram Micro weder autorisiert noch gesponsert.

Hilfe & Support