Jarltech Automatische Verarbeitung
Der Jarltech-Connector kann offene Bestellungen und die Artikelsynchronisation zeitgesteuert über die BC Job Queue verarbeiten.
Übersicht
Es gibt zwei eigenständige Hintergrund-Pipelines:
| Pipeline | Codeunit | Zweck |
|---|---|---|
| Auto-Sync Bestellungen | ALN MCJ Job Runner |
Offene Bestellungen aktualisieren und verarbeiten |
| Artikel-Sync (mehrsprachig) | ALN MCJ Item Sync Runner |
Beschreibungen, Mindestbestellmenge und Lieferantenverknüpfung pflegen |
Datenimport separat
Der Preis-/Lagerimport ist nicht Teil dieser Bestell-Pipeline. Er wird über das Dashboard → Execute Import bzw. die zentrale Importpipeline des Hubs ausgeführt. Siehe Datenimport (Preise & Lager).
Job Queue einrichten
Auto-Sync der Bestellungen
Über die Einrichtung → Job Queue erstellen/aktualisieren.
| Einstellung | Wert |
|---|---|
| Objekttyp / -ID | Codeunit ALN MCJ Job Runner |
| Wiederkehrender Auftrag | Ja |
| Lauftage | Montag–Freitag |
| Laufzeitfenster | 06:00–20:00 Uhr |
| Minuten zwischen Ausführungen | Sync-Intervall (Minuten) aus der Einrichtung (Standard 60) |
| Max. Versuche / Wiederholdelay | 3 / 60 Sekunden |
Artikel-Synchronisation
Über die Artikelsynchronisation → Create Job Queue Entry.
| Einstellung | Wert |
|---|---|
| Objekttyp / -ID | Codeunit ALN MCJ Item Sync Runner |
| Wiederkehrender Auftrag | Ja |
| Lauftage | Montag–Freitag |
| Laufzeitfenster | 06:00–22:00 Uhr |
| Minuten zwischen Ausführungen | 60 |
Bei Installation angehalten
Beide Job-Queue-Einträge werden bei der Installation angehalten (On Hold) angelegt. Aktivieren Sie sie über das Setup bzw. die Item Sync Queue, sobald Ihre Konfiguration steht.
Ablauf des Bestell-Auto-Syncs
Der Job verarbeitet alle Bestellungen mit verknüpfter Einkaufsbestellung (außer stornierten). Je Bestellung läuft folgende Reihenfolge:
- Bestelldaten aktualisieren — Status, Positionen, Lieferungen und Tracking von der API abrufen; Sendungsnummer an den Hub melden.
- Rechnungen synchronisieren — neue Rechnungen aus den Lieferungen importieren.
- Einkaufsbestellung aktualisieren — Lieferanten-Rechnungsnr., Lieferscheinnr., Buchungsdatum und Lieferadresse setzen.
- Seriennummern zuweisen — aus den Rechnungszeilen auf die Reservierungsposten.
- Versand-/Versicherungskosten — als Artikelzuschläge hinzufügen und verteilen.
- Verkaufsauftrag aktualisieren — voraussichtliches Versanddatum setzen.
- Wareneingang buchen — wenn vollständig geliefert (Supplied) und Auto Post Receipt aktiv.
Jede Bestellung wird einzeln und transaktionssicher verarbeitet. Schalter wie EK-Bestellung auto. aktualisieren, Seriennr. auto. zuweisen, Versandkosten auto. hinzufügen und Wareneingang auto. buchen steuern, welche Schritte ausgeführt werden.
Monitoring
Die Connection & Sync-FactBox auf dem Dashboard zeigt:
| Anzeige | Bedeutung |
|---|---|
| API Status | Verbindungsstatus zur Jarltech-API |
| Last Sync / Next Sync | Letzte und nächste Synchronisation |
| Mode | Live oder Simulation |
| Pending Syncs | Offene Artikel-Synchronisationen |
| Errors (24h) | Synchronisationsfehler der letzten 24 Stunden |
Fehlerbehandlung
| Szenario | Verhalten |
|---|---|
| API nicht erreichbar | Job endet mit Fehler, nächster Lauf nach Intervall |
| Token abgelaufen | Automatische Token-Erneuerung, dann Wiederholung |
| Einzelne Bestellung fehlerhaft | Fehler wird gezählt/protokolliert, andere Bestellungen laufen weiter |
Bei aktivierter Prozessbenachrichtigung und gepflegter Benachrichtigungs-E-Mail erhalten Sie nach dem Lauf eine Zusammenfassung (nur bei Änderungen oder Fehlern).
Konfigurationsempfehlungen
| Feld | Empfehlung |
|---|---|
| Auto-Sync aktivieren | Für den Produktivbetrieb aktivieren |
| Sync-Intervall (Minuten) | 60 Minuten (Standard), bei hohem Volumen ggf. kürzer |
| EK-Bestellung auto. aktualisieren | Empfohlen: aktivieren |
| Seriennr. auto. zuweisen | Empfohlen: aktivieren (bei seriennummernpflichtigen Artikeln) |
| Versandkosten auto. hinzufügen | Empfohlen: aktivieren (Zuschlagsnummern im Setup pflegen) |
| Wareneingang auto. buchen | Nur aktivieren, wenn kein manueller Wareneingangsprozess gewünscht ist |
Tipps
Erstkonfiguration
Lassen Sie den Simulationsmodus während der Erstkonfiguration aktiviert.
Berechtigungen
Der Benutzer, der die Job Queue ausführt, benötigt Schreibrechte auf die Jarltech-Objekte (PermissionSet ALN MCJ User oder ALN MCJ Admin). Empfohlen: ein dedizierter Service-Account.
Lizenz-Gate
Die Hintergrund-Läufe prüfen, ob der Connector aktiviert und für das Modul JARLTECH lizenziert ist. Ohne gültige Lizenz wird die automatische Verarbeitung übersprungen.