Zum Inhalt springen

SAP-Sammelbuchung

Für Campingplätze, deren Buchhaltung in SAP läuft, übergibt dieser Adapter pro Tag eine konsolidierte Sammelbuchung — die Tageserlöse nach GL-Konto gruppiert — direkt an SAP. Keine CSV-Exporte, keine manuellen Buchungen.

  • Tägliche Sammelbuchung um 02:00 Uhr (konfigurierbar) per Celery Beat
  • Aggregiert Kasse, Zahlungen und Rechnungen des Tages zu ausgeglichenen Soll-/Haben-Zeilen
  • Idempotent — (tenant, journal_date) ist eindeutig, erneute Läufe buchen also nicht doppelt
  • Storno einer gebuchten Sammelbuchung mit einem Klick (die SAP-Stornobelegnummer wird festgehalten)
  • Vollständiges Protokoll jedes Buchungs- und Stornovorgangs samt SAP-seitiger Belegnummer

Unterstützt SAP Business One Service Layer und SAP S/4HANA OData im selben Adapter — die Variante wählen Sie auf der Einstellungskarte.

SAP-Integrationen sind kundenspezifisch: Jeder Campingplatz, der SAP einsetzt, hat seine eigene SAP-Umgebung mit eigenen Benutzern, GL-Konten und Regeln. CampOne kann hier keine Sandbox vorbereiten.

Sie benötigen:

  • Für B1 (Service Layer): Instance-URL (üblicherweise https://<host>:50000/b1s/v1/), Name der Mandanten-DB, einen Service-Layer-Integrationsbenutzer mit Rechten zum Buchen von JournalEntries und zum Aufruf der Aktion Cancel.
  • Für S/4HANA: die Tenant-Basis-URL, einen Communication-Arrangement-Benutzer für SAP_COM_0002 / API_JOURNALENTRYBULKCREATE_REQUE_SRV mit S_DEVELOP und Buchungsrechten auf dem Ziel-Hauptbuch.
  • Eine Zuordnung der GL-Konten — welcher CampOne-Erlöstyp wird auf welches SAP-Konto gebucht.

Falls Sie noch keinen SAP-Partner haben, gehen Sie üblicherweise so vor:

  • E-Mail an partner@sap.com, um sich als ISV bei SAP PartnerEdge anzumelden
  • Oder direkt einen Schweizer B1-Partner ansprechen: Versino Schweiz (+41 56 418 32 99 · sapsupport@versino.ch) oder MTF B1 Consulting (+41 52 632 33 88)

Einstellungen → Integrationen → Anbieter-Adapter → SAP:

FeldBeschreibung
VarianteBusiness One oder S/4HANA
UmgebungTest / Production
Instance URLDer SAP-Endpoint
Mandanten-DB(nur B1) — z. B. SBO_DEMO_CH
Benutzername / PasswortZugangsdaten des Integrationsbenutzers
Zuordnung GL-KontenJSON: {"booking_revenue": "4001", "pos_revenue": "4002", "vat_collected": "2200", …}
Standard-KostenstelleOptional — wird bei Setzung auf jede Zeile angewendet

Klicken Sie auf Speichern und dann auf Verbindung prüfen. Der Test ruft die günstigste Operation ohne Nebenwirkung auf (whoami / Login) — ein grünes Symbol bestätigt die Verbindung.

Einmal pro Tag (Vorgabe: 02:00 Uhr Serverzeit) für jeden aktivierten Mandanten:

  1. Die Zeilen aus POSTransaction, Payment und Invoice des Vortags werden nach (revenue_type, vat_rate) aggregiert.
  2. Es entsteht eine ausgeglichene Sammelbuchung: Kasse und Forderungen im Soll, Erlöse und Mehrwertsteuer im Haben.
  3. Der Beleg wird nach SAP gebucht. Die zurückgelieferte Belegnummer landet in einer SAPJournalDoc-Zeile.
  4. Hatte der Tag keine abschliessbaren Vorgänge, wird der Lauf still übersprungen.

Die Einstellungskarte zeigt die Tabelle Gebuchte Sammelbuchungen — Datum, SAP-Belegnummer, Summe, Status — mit einer Storno-Schaltfläche pro Zeile.

Klicken Sie bei einer gebuchten Sammelbuchung auf Storno, geben Sie einen Grund ein und bestätigen Sie. CampOne ruft Cancel (B1) bzw. das Pendant in S/4HANA auf, hält die Stornobelegnummer fest und markiert den Originalbeleg als storniert. Der Stornogrund erscheint im Audit-Trail.

  • Jeder SAP-Kunde hat eine eigene Service-Layer-URL und Mandanten-DB — eine gemeinsame Sandbox können wir nicht ausliefern.
  • Das OData-Payload für S/4HANA ist nach öffentlicher Dokumentation umgesetzt; vor dem Live-Gang des ersten S/4HANA-Kunden sollte ein Probelauf gegen seine Sandbox die Übereinstimmung mit seiner Communication-Arrangement bestätigen.
  • Kassen-Positionen werden in einer Zeile (pos_revenue, normaler MWST-Satz) zusammengefasst. Eine feinere MWST-Aufschlüsselung pro Position ist ein Roadmap-Punkt.
  • TLS mit privaten Zertifizierungsstellen kommt später — aktuell erwartet der Adapter, dass der SAP-Endpoint eine im System-Trust-Store bekannte CA verwendet.