Jarltech Einrichtung
Die Einrichtungsseite konfiguriert die API-Verbindung, Bestellstandards, Automatisierung und Lizenzierung des Jarltech Supplier Connectors.
Seite öffnen
- Über die Suche: Jarltech API Setup
- Über das Dashboard → Einrichtung
Felder
Allgemein
| Feld |
Beschreibung |
| Kunden-ID |
Ihre 7-stellige Jarltech-Kundennummer. Erhalten Sie von Jarltech bei Vertragsabschluss. |
| Sprachcode |
Sprachcode für API-Antworten: de (Deutsch), en (Englisch) oder fr (Französisch). Beeinflusst Artikelbeschreibungen bei der Synchronisation. |
| Kreditornr. |
Der in Business Central zugeordnete Kreditor für Jarltech (z. B. 21002). |
Verbindung
| Feld |
Beschreibung |
| Preview-Server verwenden |
Wenn aktiviert, werden alle API-Aufrufe an den Jarltech-Testserver gesendet. Ideal für die Ersteinrichtung und Tests. |
| Basis-URL Live |
API-Endpunkt für den Live-Betrieb. Standardmäßig vorausgefüllt. |
| Basis-URL Preview |
API-Endpunkt für den Testbetrieb. Standardmäßig vorausgefüllt. |
OAuth2-Authentifizierung
| Feld |
Beschreibung |
| Client-ID |
Die OAuth2 Client-ID, die Sie von Jarltech erhalten haben. Wird verschlüsselt gespeichert. |
| Client-Geheimnis |
Das OAuth2 Client-Geheimnis. Wird verschlüsselt im Credential Store gespeichert und nicht angezeigt. |
| Token-Status |
Zeigt den aktuellen Status des Access Tokens: Gültig (grün), Abgelaufen (rot), Nicht angefordert (grau). |
| Token läuft ab am |
Zeitpunkt, zu dem das aktuelle Access Token abläuft. |
Bestellstandards
| Feld |
Beschreibung |
| Standard-Versandart |
Standard-Versandart für neue Bestellungen (z. B. UPS, DHL). |
| Standard-Zahlungsart |
Zahlungsart lt. Jarltech-Vertrag. Wird von Jarltech vorgegeben und kann nicht geändert werden. |
| Standard-Lieferschein-Layout |
Standard-Lieferschein-Layout für Bestellungen. |
| Bestellsplitting erlauben |
Wenn aktiviert, darf Jarltech Bestellungen in mehrere Lieferungen aufteilen. |
Automatische Synchronisation
| Feld |
Beschreibung |
| Auto-Sync aktivieren |
Aktiviert die automatische Synchronisation offener Bestellungen über die Job Queue. |
| Sync-Intervall (Minuten) |
Zeitintervall zwischen den automatischen Synchronisationsläufen. Standard: 60 Minuten. |
| Letzte Synchronisation |
Zeitpunkt der letzten erfolgreichen Synchronisation. |
| Job-Queue-Status |
Zeigt den aktuellen Status des Job-Queue-Eintrags: Aktiv (grün), Angehalten (gelb), Fehler (rot). |
Einkaufsbestellungs-Einstellungen
| Feld |
Beschreibung |
| EK-Bestellung auto. aktualisieren |
Einkaufsbestellungen werden automatisch mit Lieferdaten von Jarltech aktualisiert (Mengen, Tracking). |
| Seriennr. auto. zuweisen |
Seriennummern aus Jarltech-Lieferdaten werden automatisch den EK-Bestellzeilen zugewiesen. |
| Versandkosten auto. hinzufügen |
Versand- und Versicherungskosten werden automatisch als Artikelzuschlagszeilen hinzugefügt. |
| Wareneingang auto. buchen |
Wareneingang wird automatisch gebucht, sobald eine Bestellung vollständig geliefert ist. |
Verkaufsauftrags-Einstellungen
| Feld |
Beschreibung |
| VK-Lieferdatum auto. aktualisieren |
Das voraussichtliche Lieferdatum wird automatisch im verknüpften Verkaufsauftrag aktualisiert. |
Simulation und Test
| Feld |
Beschreibung |
| Simulationsmodus |
Im Simulationsmodus werden Bestellungen nicht an die Jarltech-API gesendet. Stattdessen wird eine E-Mail mit den Bestelldetails zur Überprüfung versendet. Deaktivieren Sie diesen Modus für den Echtbetrieb. |
| Benachrichtigungs-E-Mail |
E-Mail-Adresse für Simulations-E-Mails und Prozessbenachrichtigungen. |
| Prozessbenachrichtigung senden |
Sendet eine E-Mail-Benachrichtigung, 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 |
Aktueller Lizenzstatus: Aktiv (grün), Demo (gelb), Nicht registriert (rot). |
| Demo-Ablaufdatum |
Ablaufdatum der Demo-Lizenz (nur bei Demo-Status sichtbar). |
| Verbleibende Demo-Tage |
Verbleibende Tage der Demo-Periode. |
| Lizenziert seit |
Datum der ersten Lizenzierung (nur bei Active-Status sichtbar). |
Aktionen
Verarbeitung
| Aktion |
Beschreibung |
| Access Token anfordern |
Fordert ein neues OAuth2 Access Token von der Jarltech-API an. |
| Verbindung testen |
Testet die API-Verbindung mit den aktuellen Zugangsdaten. |
| Alle offenen Bestellungen aktualisieren |
Aktualisiert den Status aller offenen Bestellungen von der API. |
| Job Queue erstellen/aktualisieren |
Erstellt oder aktualisiert den Job-Queue-Eintrag für die automatische Synchronisation. |
| Alle Bestellungen jetzt verarbeiten |
Verarbeitet alle offenen Bestellungen sofort (manueller Sofortlauf). |
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 Jarltech-Kundennummer im Feld Kunden-ID.
- Kreditor zuordnen — Wählen Sie den passenden BC-Kreditor im Feld Kreditornr..
- Preview-Server aktivieren — Aktivieren Sie Preview-Server verwenden für den Testbetrieb.
- OAuth2-Zugangsdaten eingeben — Tragen Sie Client-ID und Client-Geheimnis ein.
- Token anfordern — Klicken Sie auf Access Token anfordern. Der Token-Status sollte auf Gültig wechseln.
- Verbindung testen — Klicken Sie auf Verbindung testen und prüfen Sie die Erfolgsmeldung.
- Simulationsmodus konfigurieren — Geben Sie eine Benachrichtigungs-E-Mail ein und lassen Sie den Simulationsmodus zunächst aktiviert.
- Automatisierung einrichten — Aktivieren Sie Auto-Sync aktivieren und setzen Sie das gewünschte Intervall.
- Job Queue erstellen — Klicken Sie auf Job Queue erstellen/aktualisieren.
- Live schalten — Nach erfolgreichen Tests: Simulationsmodus deaktivieren und Preview-Server verwenden deaktivieren.
Tipps
Simulationsmodus
Lassen Sie den Simulationsmodus während der Ersteinrichtung immer aktiviert. Deaktivieren Sie ihn erst, wenn alle Tests erfolgreich waren und Sie bereit für den Echtbetrieb sind.
Token-Verwaltung
Access Tokens werden automatisch erneuert. Sie müssen manuell nur dann eingreifen, wenn sich Ihre API-Zugangsdaten ändern.
Preview-Server
Der Jarltech-Preview-Server verwendet dieselben Zugangsdaten wie der Live-Server, verarbeitet aber keine echten Bestellungen.