Lieferanten (PUR01)

Transaktion: PUR01 Lieferanten
UI-Pfad: /suppliers

Business-Zweck

Lieferanten in reybex sind Kontakte (Customer) mit dem Kontakttyp Vendor (ContactType.type = 2). PUR01 ist die zentrale Pflegemaske für Einkaufsbeziehungen – Adressen, Zahlungsbedingungen, Währung, Einkaufsabteilung, Standardrabatte und lieferantenspezifische Texte.

Partner nutzen PUR01 bzw. die Customer-API, um:

• Lieferanten aus ERP/Beschaffungssystem anzulegen oder zu aktualisieren
• Vendor-Nummern (customerNo) als stabile Referenz für Bestellungen zu etablieren
• Einkaufsdefaults (Währung, Zahlungsbedingung, Versand, Fracht) für automatische PO-Befüllung bereitzustellen

Kernbegriffe

Begriff	Bedeutung
Customer (Vendor)	Stammsatz Lieferant; technisch identisch mit Kunde, aber ContactType = Vendor
customerNo	Externe Lieferantennummer (Partner-Referenz)
isVendor	Flag in API-Requests zur Unterscheidung Kunde/Lieferant
paymcond	Zahlungsbedingung (wird auf PurHead übernommen)
purDepartment	Einkaufsabteilung / Buyer
CustomerPurText	Lieferantenspezifische Belegtexte pro PurDocType

Fachlicher Lebenszyklus

1. Anlage – manuell in /suppliers oder per Customer-API mit isVendor: true
2. Pflege – Adressen, Bankverbindungen, Rabatte, Einkaufstexte
3. Nutzung – Referenz in PurHead (PUR02), PurPrice (PUR03), VerificationHead (PUR04)
4. Sperre/Löschung – isDelete; Löschung nur ohne harte Referenzen auf offene Belege

Partner-Szenarien

Initialer Lieferanten-Load

Großer Erstimport über Customer-API oder Data-Export/Import. Jeder Vendor benötigt mindestens customerNo, Name und Kontakttyp Vendor.

Delta-Sync

Periodisches Update von Adressen, Zahlungsbedingungen und Einkaufsabteilung. Bestehende customerNo als Upsert-Schlüssel verwenden.

Vendor für automatische Bestellung

Bei POST /api/purHead/createPurchase wird der Lieferant über vendorNo (= customerNo) aufgelöst. Fehlender Vendor → vendor.not.found.

Relevante Felder (Auszug)

Feld	Bedeutung
customerNo	Lieferantennummer (Pflicht für API-Lookups)
name	Firmenname
currency	Standardwährung für Einkaufsbelege
paymcond	Zahlungsbedingung
language	Belegssprache
purDepartment	Einkaufsabteilung
profitCenter	Profit Center
freight / shipping / packaging	Logistik-Defaults
discountType (1–3)	Kopfrabatte für neue Bestellungen
lowerDeliveryTolerance / upperDeliveryTolerance	Liefer-Toleranz (falls nicht am PurPrice)

Auswirkungen im ERP

Aktion	Auswirkung
Neuer Vendor	Verfügbar in PUR02, PUR03, PUR04
Änderung Zahlungsbedingung	Neue PurHead-Belege übernehmen Default
Vendor-Texte	Automatische Befüllung PurHeadText bei Neuanlage
Löschung (isDelete)	Vendor nicht mehr auswählbar

Voraussetzungen

• Prüftabellen: Währung, Zahlungsbedingung, Land (Prüftabellen)
• Partner-User mit Recht PUR01
• Authentifizierter API-Zugriff

Typische Fehlerquellen

• Falsche ContactType – Kunde statt Vendor → Bestell-API findet Lieferant nicht
• Doppelte customerNo – Validierung schlägt fehl
• Fehlende Währung – createPurchase benötigt gültige Währung am Beleg

Weiterlesen

• Technisch: Material API (Customer-Endpunkte), PurHead API
• Bestellungen: Bestellungen (PUR02)
• Einkaufspreise: Einkaufsinfosätze (PUR03)