Logo- und Mikro-Einrichtung

Diese Seite richtet sich an Geschäfts- und Betriebsnutzer. Technische Architektur steht in docs/ERP_INTEGRATION.md.

Ablauf

1. Unter Dashboard → Buchhaltungsintegrationen Logo oder Mikro anlegen, Aktiv setzen und Safe-Write-Modus wählen (Standard: nur manuelles CSV).
2. Unter Dashboard → ERP-Produktzuordnungen SKU → ERP-Artikel, Einheit und MwSt. vervollständigen.
3. Kunden brauchen Cari-/Kontocode oder Steuernummer; bei Auftragserstellung erscheint ein Job in der ERP-Auftragswarteschlange.
4. CSV aus Warteschlange oder Auftragsdetail laden und ins ERP importieren. Auto-Dispatch erst nach stabilem Prozess aktivieren.

Pfade: /dashboard/accounting · /dashboard/integration-mapping?provider=logo bzw. provider=mikro · /dashboard/integration-outbox.

Gemeinsame Vorbereitung

Im ERP klären

• Wie Aufträge entstehen: manuelles CSV, Importordner, Stored Procedure / lokaler Agent.
• Ob Convord-Produkt-/Varianten-SKUs mit ERP-Artikelcodes übereinstimmen (oder Mapping-Tabelle).
• Wie Kunden im ERP gefunden werden (<strong>Cari-Code</strong> bevorzugt; sonst Steuernummer).

Produkt- und Varianten-SKUs in Convord

Erfassen Sie für jedes Produkt eine SKU. Bei Gewichten/Varianten erhält jede Variante eine eigene SKU.

Mapping-Panel

Verwalten Sie das aktive Mapping-Set unter ERP-Produktzuordnungen. Für CSV aus der Warteschlange ist ein Mapping-Snapshot nötig.

Safe Write und Automatisierung

Safe-Write-Modus: nur manuelles CSV, nur Importordner oder nur Procedure. Auto-ERP-Dispatch ist standardmäßig aus; erst nach ca. 20 erfolgreichen Transfers einschalten.

Logo — Nutzersicht

Convord schreibt den Auftrag zuerst in die Outbox-Warteschlange. Klassischer REST-Verbindungstest für Logo entfällt; direkter Logo-REST-Push ist in Produktion deaktiviert.

Im Dashboard

1. Buchhaltungsintegrationen → Logo → Einrichtung / Einstellungen.
2. Optional API-Endpoint/Key für Bridge; für den Betrieb Safe-Write setzen und Integration Aktiv schalten.
3. SKU-Mapping unter ERP-Produktzuordnungen (provider=logo) abschließen.
4. Testauftrag → CSV aus Warteschlange oder Auftragsdetail.

Mikro — Nutzersicht

Übliches Modell: CSV in einen Importordner. Alternative: Bridge für Stammdaten und optionaler lokaler ERP-Agent. Auftrags-Push läuft über die Outbox.

Im Dashboard

1. Buchhaltungsintegrationen → Mikro → Einstellungen.
2. Transport wählen: Datei (Importpfad + Präfix) oder Bridge (URL).
3. Im Dateimodus beschreibbaren Importpfad setzen und Verbindung testen; im Bridge-Modus Health-Check und Sync nutzen.
4. Mapping-Panel (provider=mikro) + Testauftrag → Warteschlange / CSV.

Manuelles CSV (empfohlener Start)

Standard- und Fallback-Weg:

• CSV aus der ERP-Auftragswarteschlange laden (Mapping-Snapshot erforderlich).
• Alternativ Logo-/Mikro-CSV aus dem Auftragsdetail (/dashboard/orders/{id}/erp-manual-export/logo oder .../mikro).
• Produktnamenspalten (PRODUCT_NAME / UrunAdi) erleichtern die Excel-Prüfung.

Logo-Spalten: ORDER_NO;STOCK_CODE;PRODUCT_NAME;QTY;UNIT;UNIT_PRICE
Mikro-Spalten: BelgeNo;StokKodu;UrunAdi;Miktar;Birim
Format: UTF-8 (BOM), Trennzeichen ;.

Checkliste (Kurz)