Jarltech Einrichtung
Die Einrichtungsseite (Jarltech API Setup) konfiguriert die API-Verbindung, Bestellstandards, Automatisierung und Lizenzierung des Jarltech Supplier Connectors.
Seite öffnen
- Über die Suche: Jarltech API Setup
- Über das Dashboard → Setup
Geführte Einrichtung empfohlen
Für die Ersteinrichtung nutzen Sie am besten den Setup Wizard (über Unterstützte Einrichtung → „AD merchantCENTRAL – Einrichtung" → Jarltech Setup Wizard oder über das Dashboard). Diese Seite dient als vollständige Feldreferenz.
Reihenfolge: Hub zuerst
Der Setup Wizard prüft beim Öffnen, ob der merchantCENTRAL Hub eingerichtet ist, und leitet andernfalls zur Hub-Einrichtung weiter. So ist sichergestellt, dass die Plattform vor dem Connector konfiguriert ist.
Felder
Allgemein
| Feld |
Beschreibung |
| Kunden-ID |
Ihre 7-stellige Jarltech-Kundennummer (von Jarltech bei Vertragsabschluss). |
| Sprachcode |
Sprachcode für API-Antworten: de, en oder fr. Beeinflusst u. a. Artikelbeschreibungen bei der Synchronisation. |
| Kreditornr. |
Der in Business Central zugeordnete Kreditor für Jarltech. |
Verbindung
| Feld |
Beschreibung |
| Preview-Server verwenden |
Sendet alle API-Aufrufe an den Jarltech-Testserver. Ideal für Ersteinrichtung und Tests. |
| Basis-URL Live |
API-Endpunkt für den Live-Betrieb (Standard: https://www.jarltech.com). |
| Basis-URL Preview |
API-Endpunkt für den Testbetrieb (Standard: https://shop.preview.jarltech.de). |
| SAS Function URL |
Azure-Function-URL für den Legacy-Dateidownload (nur bei Source-Typ Azure Blob). Leer = eingebauter Standard. Siehe Azure Blob Storage einrichten. |
OAuth2-Authentifizierung
| Feld |
Beschreibung |
| Client-ID |
OAuth2 Client-ID von Jarltech. Zum Eingeben/Ändern auf das Feld klicken. Verschlüsselt gespeichert. |
| Client-Geheimnis |
OAuth2 Client-Geheimnis. Verschlüsselt im Credential Store gespeichert und nicht angezeigt. |
| Token-Status |
Status des Access Tokens: Gültig (grün) oder Abgelaufen/ungültig (rot). |
| Token läuft ab am |
Ablaufzeitpunkt des aktuellen Access Tokens. |
Token-Verwaltung
Das Access Token wird bei Bedarf automatisch erneuert. Manuelles Eingreifen ist nur nötig, wenn sich Ihre Zugangsdaten ändern.
Bestellstandards
| Feld |
Beschreibung |
| Standard-Versandart |
Standard-Versandart für neue Bestellungen (Standard, Express, Express Saver, Forwarding Company, Saturday Express, Direct Delivery, UPS Next Day, Pickup, Pickup VAT Free). |
| Standard-Zahlungsart |
Von Jarltech laut Vertrag vorgegeben. Schreibgeschützt und wird beim Bestellen nicht gesendet. |
| Standard-Lieferschein-Layout |
Lieferschein-Layout (Customer, Jarltech, Jarltech Gulf, Neutral). |
| Bestellsplitting erlauben |
Erlaubt Jarltech, Bestellungen in mehrere Lieferungen aufzuteilen. |
Automatische Synchronisation
| Feld |
Beschreibung |
| Auto-Sync aktivieren |
Aktiviert die automatische Synchronisation offener Bestellungen über die Job Queue. |
| Sync-Intervall (Minuten) |
Intervall zwischen Synchronisationsläufen (Standard 60, mindestens 5). |
| Letzte Synchronisation |
Zeitpunkt der letzten Synchronisation. |
| Job-Queue-Status |
Status des Job-Queue-Eintrags: Aktiv oder Nicht aktiv. |
Einkaufsbestellungs-Einstellungen
| Feld |
Beschreibung |
| EK-Bestellung auto. aktualisieren |
Setzt Lieferanten-Rechnungsnr., Lieferscheinnr., Buchungsdatum und Lieferadresse automatisch. |
| Seriennr. auto. zuweisen |
Weist Seriennummern aus den Jarltech-Lieferdaten automatisch zu. |
| Versandkosten auto. hinzufügen |
Fügt Versand-/Versicherungskosten als Artikelzuschlagszeilen hinzu. |
| Wareneingang auto. buchen |
Bucht den Wareneingang automatisch, sobald vollständig geliefert (Status Supplied). Standard: deaktiviert. |
Verkaufsauftrags-Einstellungen
| Feld |
Beschreibung |
| VK-Lieferdatum auto. aktualisieren |
Aktualisiert das voraussichtliche Versanddatum im verknüpften Verkaufsauftrag. |
Simulation und Test
| Feld |
Beschreibung |
| Simulationsmodus |
Bestellungen werden nicht an die API gesendet, sondern per E-Mail simuliert. Für den Echtbetrieb deaktivieren. |
| Benachrichtigungs-E-Mail |
E-Mail-Adresse für Simulations- und Prozessbenachrichtigungen. |
| Prozessbenachrichtigung senden |
Sendet eine E-Mail, wenn der Auto-Sync-Job Bestellungen verarbeitet hat. |
Artikelzuschläge
| Feld |
Beschreibung |
| Versandkosten-Zuschlagsnr. |
Artikelzuschlagsnummer für Versandkosten. |
| Versicherungskosten-Zuschlagsnr. |
Artikelzuschlagsnummer für Versicherungskosten. |
Lizenz
| Feld |
Beschreibung |
| Lizenzstatus |
Aktiv, Demo oder Nicht registriert. |
| Demo-Ablaufdatum |
Ablaufdatum der Demo-Lizenz (nur im Demo-Status). |
| Verbleibende Demo-Tage |
Verbleibende Tage der Demo-Periode. |
| Lizenziert seit |
Datum der ersten Lizenzierung (nur im Active-Status). |
Aktionen
Verarbeitung
| Aktion |
Beschreibung |
| Access Token anfordern |
Fordert ein neues OAuth2 Access Token an. |
| Verbindung testen |
Testet die API-Verbindung mit den aktuellen Zugangsdaten. |
| Alle offenen Bestellungen aktualisieren |
Aktualisiert den Status aller offenen Bestellungen. |
| Job Queue erstellen/aktualisieren |
Legt den Job-Queue-Eintrag für die automatische Synchronisation an oder aktualisiert ihn. |
| Alle Bestellungen jetzt verarbeiten |
Verarbeitet alle offenen Bestellungen sofort. |
Navigation
| Aktion |
Beschreibung |
| Jarltech Bestellungen |
Öffnet die Bestellliste. |
| Demo registrieren |
Startet die kostenlose 30-Tage-Demo-Registrierung. |
| Lizenz aktualisieren |
Aktualisiert den Lizenzstatus vom Lizenzserver. |
Ersteinrichtung Schritt für Schritt
- Kundennummer eintragen — Ihre 7-stellige Kundennummer im Feld Kunden-ID.
- Kreditor zuordnen — passenden BC-Kreditor im Feld Kreditornr. wählen.
- Preview-Server aktivieren — Preview-Server verwenden für den Testbetrieb aktivieren.
- OAuth2-Zugangsdaten eingeben — Client-ID und Client-Geheimnis eintragen.
- Token anfordern — Access Token anfordern; der Token-Status sollte auf Gültig wechseln.
- Verbindung testen — Verbindung testen und Erfolgsmeldung prüfen.
- Simulationsmodus konfigurieren — Benachrichtigungs-E-Mail eingeben, Simulationsmodus zunächst aktiviert lassen.
- Datenimport einrichten (optional) — siehe Datenimport und Azure Blob Storage einrichten.
- Automatisierung einrichten — Auto-Sync aktivieren und Intervall setzen, dann Job Queue erstellen/aktualisieren.
- Live schalten — nach erfolgreichen Tests Simulationsmodus und Preview-Server verwenden deaktivieren.
Tipps
Simulationsmodus
Lassen Sie den Simulationsmodus während der Ersteinrichtung aktiviert. Deaktivieren Sie ihn erst nach erfolgreichen Tests.
Preview-Server
Der Jarltech-Preview-Server verwendet dieselben Zugangsdaten wie der Live-Server, verarbeitet aber keine echten Bestellungen.
Verwandte Themen