Darstellung

Vertrieb (SAL) – Modulübersicht ​

Das Modul Vertrieb steuert den gesamten Order-to-Cash-Prozess in reybex: Kundenstamm, Angebote, Aufträge, Lieferscheine, Rechnungen, Preise, Retouren und vertriebsbezogene Auswertungen. Es baut auf Stammdaten (BAS) und Lager (INV) auf und interagiert mit Einkauf (PUR) bei Drop-Shipping und Beschaffungsanforderungen.

Rolle für Partner ​

Partner arbeiten in SAL typischerweise in diesen Rollen:

  1. Kunden & Kontakte synchronisieren – CRM-/Shop-Daten als reybex-Kunden anlegen
  2. Aufträge importieren – Shop-, Marktplatz- oder ERP-Bestellungen als SalesHead (Order) erfassen
  3. Belegkette steuern – Angebot → Auftrag → Lieferschein → Rechnung per API oder Folgedokument-Logik
  4. Preise pflegen – VK-Preislisten, Kundensonderpreise, Gruppenzuschläge
  5. Fulfillment anbinden – Tracking-Import, Versandstatus, Reservierungen mit INV
  6. FiBu & E-Rechnung – Rechnungslauf, Übergabe an Finanzbuchhaltung, XRechnung/ZUGFeRD

Ohne konsistente Vertriebsdaten sind weder Shop-Bestellimporte noch Lager-Reservierungen zuverlässig.

Architektur – wie SAL in reybex eingebunden ist ​

Kern-Domänen ​

→ Kern-Domänen Übersicht · Domain-Struktur

DomäneBedeutungPartner-Relevanz
CustomerDebitorSAL01, /api/customer
SalesHeadVertriebsbelegkopfZentraler Integrationspunkt
SalesItemBelegpositionArtikel, Reservierung, Lieferstatus

Transaktionen im Partner-Kontext ​

Stammdaten & Preise ​

CodeTransaktionPartner-RelevanzBusiness-DokuDefault-Rollen
SAL01KundenSehr hoch – DebitorKunden & KontakteROLE_CEO, ROLE_MANAGEMENT … +12
SAL04Kontakt PersonenHochKunden & KontakteROLE_CEO, ROLE_MANAGEMENT … +10
SAL06KundensonderpreiseSehr hochPreise & KonditionenROLE_CEO, ROLE_MANAGEMENT … +2
SAL07Kunden & Artikelgruppen ZuschlägeMittelPreise & KonditionenROLE_CEO, ROLE_MANAGEMENT … +2
SAL09VK PreislisteSehr hochPreise & KonditionenROLE_CEO, ROLE_MANAGEMENT … +3

Order-to-Cash – Belege ​

CodeTransaktionPartner-RelevanzBusiness-DokuDefault-Rollen
SAL05VertriebsbelegeHochAngeboteROLE_CEO, ROLE_MANAGEMENT … +7
SAL15AngeboteMittelAngeboteROLE_CEO, ROLE_MANAGEMENT … +8
SAL16AufträgeSehr hochAufträgeROLE_CEO, ROLE_MANAGEMENT … +9
–Order-to-CashSehr hochOrder-to-Cash—
–Shop-ImportSehr hochShop-Import—
SAL17LieferscheineSehr hochLieferscheineROLE_CEO, ROLE_MANAGEMENT … +7
SAL18RechnungenSehr hochRechnungenROLE_CEO, ROLE_MANAGEMENT … +11
–Auftrag → RechnungSehr hochAuftrag → Rechnung—

FiBu & E-Rechnung ​

CodeTransaktionPartner-RelevanzBusiness-DokuDefault-Rollen
SAL10RechnungslaufHochRechnungslauf & FiBuROLE_CEO, ROLE_MANAGEMENT … +3
SAL11Fibu-Übergabe (Vertrieb)HochRechnungslauf & FiBuROLE_CEO, ROLE_MANAGEMENT … +3
SAL13E-Rechnungs-IntegrationHochE-RechnungROLE_ADMIN, ROLE_WAREHOUSE_PEOPLE … (+1)

Sonderfälle & Service ​

CodeTransaktionPartner-RelevanzBusiness-DokuDefault-Rollen
SAL19Umlagerungs-AufträgeMittelUmlagerung & ImportROLE_CEO, ROLE_MANAGEMENT … +3
SAL20Retouren AbwicklungSehr hochRetourenROLE_CEO, ROLE_MANAGEMENT … +7
SAL31Tracking No. ImportSehr hochUmlagerung & ImportROLE_CEO, ROLE_MANAGEMENT … +6
SCH01Tankstellen-ImportNiedrigUmlagerung & ImportROLE_ADMIN, ROLE_WAREHOUSE_PEOPLE … (+1)
SAL14Support CockpitMittelService & SonderbelegeROLE_CEO, ROLE_MANAGEMENT … +27
SAL30Arbeitskarten (Service)MittelService & SonderbelegeROLE_CEO, ROLE_MANAGEMENT … +7
SAL32Material-KampagnenNiedrigService & SonderbelegeROLE_CEO, ROLE_MANAGEMENT … +3
SAL40Voraus- und EndrechnungMittelService & SonderbelegeROLE_CEO, ROLE_MANAGEMENT … +3
SAL41HausauflageNiedrigService & SonderbelegeROLE_CEO, ROLE_MANAGEMENT … +3
SAL42DruckversionenNiedrigService & SonderbelegeROLE_CEO, ROLE_MANAGEMENT … +7

Berichte & Auswertungen ​

CodeTransaktionPartner-RelevanzBusiness-DokuDefault-Rollen
SAL50KundenumsätzeMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +6
SAL52VertriebsauswertungenHochVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +4
SAL53Nachkalkulation letz. VKMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +3
SAL54Nachkalkulation ØVKMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +3
SAL55Renner/Penner Liste KundenMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +6
SAL56Renner/Penner Liste ArtikelMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +6
SAL57Kundenumsatz 12 MonateMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +8
SAL58Artikel Absatz 12 MonateMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +8
SAL59KundendeckungsbeitragMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +3
SAL60RückstandslisteSehr hochVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +7
SAL61Artikelumsätze-/margenHochVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +3
SAL63GeschäftsentwicklungMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +3
SAL64Vertreter UmsatzMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +3
SAL65Kunden & ArtikelumsatzMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +6
SAL68KundenbindungNiedrigVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +3
SAL69Coupon/Gutschein VerwaltungMittelService & SonderbelegeROLE_CEO, ROLE_MANAGEMENT … +3
SAL79Diesel RückvergütungNiedrigVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +3
SAL80VerkaufsberichteMittelVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +6
SAL90Prod. Job ÜbersichtNiedrigVertriebsberichteROLE_CEO, ROLE_MANAGEMENT … +4

Belegketten-Tabelle (DocType-Kette) ​

Die erlaubten Folgebelege werden über SalesHeadDocRule gesteuert – nicht hardcodieren, sondern mandantenspezifisch aus Konfiguration/Onboarding.

Von (DocType)Nach (DocType)Typische TransaktionAPI
Angebot (isOffer)Auftrag (isOrder)SAL15 → SAL16createProposalFromSalesHead, UI
AuftragLieferschein (isDelnote)SAL16 → SAL17referencingDocuments
AuftragRechnung (isInvoice)SAL16 → SAL18referencingDocuments
LieferscheinRechnungSAL17 → SAL18referencingDocuments, createInvoicesFromDelNotes
RechnungGutschrift (isCreditnote)SAL18 → GutschriftcreateCreditNotes
AuftragRetoureSAL16 → SAL20Return Head API

→ Details: Kern-Domänen – SalesHeadDocRule, Order-to-Cash

Integrations-Playbook ​

Schritt-für-Schritt-Anleitung für neue Shop-/ERP-Anbindungen. Vollständige Phasenbeschreibung mit JSON-Beispielen: Order-to-Cash (Gesamtflow).

Playbook – Kurzform ​

PhaseZielPrimäre APIsModule
0 – KickoffDocTypes, Nummernkreise, DocRules klärenGET /api/salesHead/docTypesSAL Konfig
1 – StammdatenKunde, Artikel, Preise/api/customer/, BAS, /api/salesHead/getSalesPriceBAS, SAL01, SAL09
2 – ImportAufträge mit IdempotenzPOST /api/salesHead/, marktplaceOrderIdSAL16
3 – ExportOffene Orders für WMSGET /api/salesHead/connectorConnector
4 – FulfillmentPick, Pack, TrackingINV06, updateShipping, validateShipmentINV, SMP
5 – BelegeLS + REreferencingDocuments oder Connector-KombiSAL17/18
6 – AbschlussFiBu + E-RechnungtransferInvoicesToFinance, getXInvoiceXmlFIN, SAL13
7 – MonitoringRückstand, StatusgetOpenOrders, listBacklog, /status/{id}SAL60

Connector vs. Direkt-API ​

MusterWannDoku
Connector (Poll + Ack)Eigener Shop, WMS mit PullShop-Import & Connector
Direkt-APIERP steuert jeden Schritt einzeln—
OMPStandard-MarktplätzeOMP-Modul

Typische Integrations-Reihenfolge ​

  1. Artikelstamm (BAS02) – verkaufbare Materialien mit Preisen und Lagerbezug
  2. Kunden (SAL01) – Debitoren mit Adresse, Zahlungsbedingung, USt-ID
  3. Preise (SAL06/SAL09) – VK-Preisliste und ggf. Kundensonderpreise
  4. Bestand (INV03/04) – Verfügbarkeit für ATP-Prüfung vor Auftragsimport
  5. Aufträge (SAL16) – POST /api/salesHead/ oder POST /api/salesHead/connector
  6. Fulfillment – Kommissionierung (INV06), Lieferschein (SAL17), Tracking (SAL31)
  7. Rechnung (SAL18) – Folgedokument oder Rechnungslauf (SAL10)
  8. FiBu (SAL11) – POST /api/salesHead/transferInvoicesToFinance
  9. E-Rechnung (SAL13) – XRechnung-XML abrufen und versenden

Abhängigkeiten zu anderen Modulen ​

SAL-ThemaWird benötigt von / liefert anHinweis
Material (BAS02)SAL-PositionenmatCode / Material-ID in SalesItem
StockList (INV)Auftrags-ATP, ReservierungGET /api/salesHead/getStockData
Kommissionierung (INV06)Lieferschein-ErzeugungPick vor Versand
Wareneingang (INV02)Drop-Shipping-RückflussPUR → WE → Bestand
Einkauf (PUR)Beschaffung aus AuftragSalesItem.createPurchaseRequest
Finanzbuchhaltung (FIN)Rechnungsübergabe SAL11FinHead aus Rechnung

Technische Integration ​

Alle API-Details: API

Mandantenbezug

Alle SAL-Operationen laufen mandanten-isoliert. DocType-IDs, Nummernkreise und Preislisten sind mandantenspezifisch – siehe Authentifizierung.

Weiterlesen ​

Nur für reybex-Partner. Nicht für Endkunden bestimmt.

Edit Systems GmbH (reybex)