Salesforce -> XRechnung

Salesforce zu XRechnung — Behördenrechnungen aus dem CRM erstellen

Salesforce ist primär ein CRM, kein ERP — die Rechnungserstellung wird über Salesforce Billing, Revenue Cloud (vormals CPQ Plus) oder Drittanbieter wie Conga Composer, Apsona Forms oder S-Docs abgewickelt. Diese Tools decken B2B-Rechnungsformate solide ab, jedoch nicht die EN-16931-Pflichtfelder, die für deutsche Behördenrechnungen erforderlich sind. Die Folge: Salesforce-Anwender mit B2G-Geschäft sind gezwungen, Rechnungen entweder manuell in einem zweiten Tool zu erstellen, eine teure Custom-Integration zu beauftragen oder einen externen Konverter zu nutzen.

XRechnung-Bereit ergänzt Salesforce um die XRechnung-konforme Rechnungsausgabe — ohne Eingriff in die CRM-Konfiguration, ohne neues Salesforce-Modul, ohne AppExchange-Lizenz. Sie exportieren Rechnungsdaten aus Salesforce via REST-API, Bulk-Export-CSV oder PDF-Export aus Conga/Apsona/S-Docs, und unser Tool produziert die EN-16931-konforme XML-Datei mit allen CIUS-DE-Pflichtfeldern.

Der typische Anwendungsfall: ein US-Headquarter hat Salesforce als globales CRM standardisiert; die deutsche Tochtergesellschaft verkauft an Behördenkunden — vom Bundesamt für Sicherheit in der Informationstechnik (BSI) bis zur Stadt Hamburg. Eine Salesforce-Customization für deutsche XRechnung-Compliance würde die globale Struktur durchbrechen. XRechnung-Bereit bietet die deutsche Compliance-Schicht ohne Salesforce-Anpassung, integrierbar via Webhook oder REST-API in beliebige Salesforce-Workflows.

Der praktische XRechnung-Pfad

1

Quelle sichern

Nutzen Sie Salesforce als Ausgangspunkt und ziehen Sie fehlende Pflichtfelder frueh nach.

2

XML sauber strukturieren

Leitweg-ID, Steuerlogik, Referenzen und Summen muessen semantisch im richtigen Feld landen.

3

Validator vor Versand

Vor dem Versand an Behoerden sollte die Datei immer gegen aktuelle KoSIT-Regeln geprueft werden.

Worauf Sie achten sollten

Bei Salesforce entscheiden vor allem Exportformat, Leitweg-ID, Steuerkategorien, Summenlogik und KoSIT-Validierung dar?ber, ob die Datei vom Beh?rdenportal akzeptiert wird. Der systemspezifische Abschnitt unten zeigt, welche Felder und Workflows Sie vor der ersten produktiven XRechnung pr?fen sollten.

Was ist bei der Salesforce zu XRechnung Konvertierung besonders?

Salesforce-Rechnungen entstehen typischerweise über eines von vier Modulen, die jeweils unterschiedliche Datenstrukturen und Export-Mechanismen aufweisen. Salesforce Billing (Teil von Revenue Cloud, ehemals CPQ Plus) ist das Salesforce-eigene Subscription-Billing-Modul mit Rechnungsobjekt `Invoice__c` und Zeilen-Objekt `InvoiceLine__c`; Rechnungen können als PDF (über Visualforce-Templates) oder als JSON via REST-API abgefragt werden. Conga Composer / Conga CLM ist die am weitesten verbreitete Drittanbieter-Lösung für PDF-Generierung; Rechnungen werden über DOCX-Templates erzeugt und als PDF gespeichert. Apsona Forms und S-Docs sind weitere PDF-Generatoren mit ähnlicher Funktionsweise. Custom Apex/LWC-Lösungen schließlich werden in größeren Salesforce-Implementierungen häufig gewählt, wenn die Standard-Tools nicht ausreichen.

Für alle vier Pfade ist XRechnung-Bereit der gemeinsame Konverter. Die optimale Strategie hängt vom Volumen ab: für gelegentliche B2G-Rechnungen reicht der manuelle PDF-Upload aus Conga oder S-Docs; für regelmäßige B2G-Workflows empfehlen wir die API-Integration, bei der jede neu erstellte Salesforce-Invoice automatisch über einen Apex-Trigger oder einen Salesforce Flow an die XRechnung-Bereit-API übergeben wird.

Drei kritische Mapping-Punkte sind zu beachten. Erstens, die Leitweg-ID: Salesforce kennt das Konzept nicht nativ. Sie sollte als Custom Field auf dem Account-Objekt angelegt werden (Field-Name z.B. `Leitweg_ID__c`, Typ Text 50). Über die REST-API wird der Wert als BT-10 in die XRechnung gemappt. Zweitens, das Steuersatz-Mapping: Salesforce Billing nutzt `Tax Rate`-Objekte mit benutzerdefinierten Codes; XRechnung-Bereit mappt diese auf die EN-16931-Tax-Category-Codes (`S`, `Z`, `E`, `AE`). Wichtig für US-Headquarter-Implementierungen: Salesforce Billing ist primär für US-Sales-Tax konzipiert, deutsche Mehrwertsteuer-Logik (Steuersatz-Aggregation, Reverse Charge) muss explizit konfiguriert werden — XRechnung-Bereit ergänzt fehlende Aggregate (BG-23) automatisch. Drittens, die Multi-Currency-Behandlung: Salesforce speichert Rechnungen in der Mandanten-Currency; XRechnung erwartet EUR mit dokumentiertem Wechselkurs für Fremdwährungs-Rechnungen.

Für eine vollintegrierte Lösung empfehlen wir den Webhook-Pattern: ein Salesforce Flow oder Apex-Trigger feuert bei `Invoice__c` Status-Änderung auf `Posted` einen REST-Call gegen `https://xrechnung-bereit.de/api/convert` mit JSON-Payload (Account-Daten, Invoice-Header, Line-Items). Innerhalb von 1-2 Sekunden erhalten Sie die XRechnung-XML zurück, die direkt in Salesforce als Attachment gespeichert oder per E-Mail an den Behördenkunden versendet werden kann. Dieser Workflow benötigt typischerweise 4-8 Stunden Salesforce-Customization-Arbeit und läuft danach vollautomatisch.

Pflichtfelder vor Versand pruefen

Leitweg-ID, Rechnungsnummer, Bestellreferenz, Leistungszeitraum, Steuercodes, Zahlungsziel und Summenlogik muessen vor dem Versand strukturiert vorhanden sein.

KoSIT-Validierung einplanen

Eine optisch korrekte Rechnung kann technisch trotzdem scheitern. Der Validatorlauf reduziert Ruecklaeufer bei Behoerdenportalen und macht Fehler frueh sichtbar.

Gast-Test ohne Projektstart

Fuer einzelne Behoerdenrechnungen reicht der manuelle Upload. Fuer wiederkehrende Mandanten oder ERP-Prozesse laesst sich der Ablauf spaeter standardisieren.

Haeufige Fragen

Welches Salesforce-Modul brauche ich (Billing, Revenue Cloud, Drittanbieter)?
Sie brauchen kein zusätzliches Salesforce-Modul für die Konvertierung — XRechnung-Bereit funktioniert mit jedem bestehenden Salesforce-Setup. Der Workflow hängt von Ihrem aktuellen Tool ab: Mit Salesforce Billing (Revenue Cloud) nutzen Sie die REST-API für Echtzeit-Konvertierung. Mit Conga Composer, Apsona oder S-Docs nutzen Sie den manuellen PDF-Upload oder ergänzen einen Conga-Workflow um den XRechnung-Bereit-Schritt. Mit Custom-Apex-Implementierungen ergänzen Sie den Trigger oder Flow um den XRechnung-Bereit-API-Call. Wenn Sie noch keine Rechnungslösung in Salesforce haben und nur gelegentlich B2G-Rechnungen schreiben, ist der einfachste Pfad: Rechnung in einem externen Tool (z.B. ein einfaches Word-Template) erstellen, als PDF speichern, in XRechnung-Bereit hochladen. Die Salesforce-Integration kann später erfolgen.
Wie exportiere ich Rechnungsdaten aus Salesforce für XRechnung-Bereit?
Drei Wege, abhängig von Volumen und Automatisierungsbedarf. Erstens, manuell über PDF-Export: Aus Conga, Apsona oder S-Docs exportieren Sie die Rechnung als PDF und laden sie in XRechnung-Bereit hoch — OCR-gestützte Erkennung extrahiert die strukturellen Felder. Zweitens, via REST-API: Sie rufen die Salesforce REST-API für das Rechnungsobjekt auf (z.B. `GET /services/data/v60.0/sobjects/Invoice__c/{Id}`), erhalten die Rechnungsdaten als JSON und übergeben sie an XRechnung-Bereit's `/api/convert`-Endpoint. Drittens, via Salesforce Flow oder Apex-Trigger: bei Status-Änderung der Rechnung wird automatisch ein HTTP-Callout an XRechnung-Bereit ausgelöst; die Antwort wird als Attachment auf dem Rechnungsobjekt gespeichert. Für Power Automate / MuleSoft-basierte Integrationen ist auch ein Iterationsmuster über Salesforce Bulk API möglich, das mehrere Rechnungen parallel konvertiert.
Ist eine API-Integration mit Salesforce möglich?
Ja, vollständig. XRechnung-Bereit bietet eine REST-API, die aus Salesforce über Apex (HttpCallout), Salesforce Flow (HTTP-Action), MuleSoft, Power Automate oder externe Middleware (z.B. Workato, Zapier) angesprochen werden kann. Die typische Integration besteht aus zwei Schritten: erstens, ein Salesforce Flow oder Apex-Trigger, der bei einem definierten Ereignis (z.B. Invoice-Status-Wechsel auf `Posted`) feuert; zweitens, ein HTTP-Callout an `https://xrechnung-bereit.de/api/convert` mit Bearer-Authentication und JSON-Payload (Header-Daten, Line-Items, Custom-Fields wie Leitweg-ID). Die Antwort enthält die XRechnung-XML als Base64-encoded String, die als Attachment auf dem Salesforce-Rechnungsobjekt gespeichert oder per E-Mail an den Behördenkunden versendet werden kann. Implementierungsaufwand: 4-8 Beratungsstunden für eine Standard-Integration, je nach Salesforce-Komplexität.