Ansicht
Dokumentation
CRMXIF_INVOICE_SAVE - Externe Schnittstelle Rechnung
General Data in Customer Master SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3upDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Der Funktionsbaustein definiert die Schnittstelle des CRM Online für den Fakturabeleg für externe Systeme.
Die Schnittstelle ist als Adapter der CRM-Middleware realisiert (XIF) und stellt eine IDOC-Verarbeitung und eine Verarbeitung für XML/ SOAP-Calls zur Verfügung. Der entsprechende IDOC Nachrichtentyp ist:
CRMXIF_INVOICE_SAVE_M
Innerhalb der CRM Billing Engine (CRM-Transaktion BEA_DL_01) können Faktura-Vorräte (im CRM-System vorhandene Verkaufsaufträge), fakturiert werden. Die dabei erstellte(n) Rechnunge(n) werden mit Hilfe der CRM-Middleware und der externen Fakturaschnittstelle (XIF) an Fremdsysteme über IDocs- oder SOAP/XML-Format versendet.
Der CRM-Ausgangsfunktionsbaustein (IDocs: CRMXIF_INVOICE_IDOC_SEND; SOAP/XML: CRMXIF_INVOICE_XML_SEND) versendet dabei die Rechnung in Form eines komplexen Datentyps der Struktur CRMXIF_IV_BD, der die externe Schnittstelle repräsentiert. Es werden immer alle Daten verschickt, die zur Rechnung gehören, aber keine Deltainformationen.
Die externe Schnittstelle hat eine tief geschachtelte Struktur, in der Kindsegmente in hierarchischer Beziehung zu ihren Vatersegmenten stehen bzw. wiederum als Vatersegmente fungieren können.
Im wesentlichen besteht die Schnittstelle aus einem Header mit den tabellenartigen Kindsegment-Komponenten Partner, Tax, Text und Item. Die Komponente Item beinhaltet ihrerseits wiederum die tabellenartigen Kindsegment-Komponenten Partner, Steuern, Texte und Konditionen:
Header
*********|________Partner (Tabelle)
*********|________Tax (Tabelle)
*********|________Text (Tabelle)
*********|________Item (Tabelle)
**************************|________Partner (Tabelle)
**************************|________Tax (Tabelle)
**************************|________Text (Tabelle)
**************************|________Condition (Tabelle)
Für einen Überblick wird die Hierachiedarstellung dieser Struktur empfohlen (Transaktion SE12, Hierarchiedarstellung).
Beispiel
Header
Auf Headerebene werden allgemeine Informationen zum Faktura-Beleg wie z.B.
- die von der Billing Engine vergebene Nummer der erstellten Rechnung (HEADNO_EXT 0090000476), Fakturaart (BILL_TYPE F2 für Rechnung, G2 für Gutschrift, R2für Lastschrift),
- Beleg-Währung, die beim Erstellen des Auftrages vergeben wird (DOC_CURRENCY DEM); ISO-Code der Währung (DOC_CURRENCY_ISO DEM),
- Referenzwährung der zuständigen Organisationseinheit, zu der Umrechnungskurse im System gepflegt sind (REF_CURRENCY EUR),
- Gesamt-Nettobetrag aller Positionen und Mengen ohne Steuern (NET_VALUE 80000.0000)
- Gesamt-Steuerbetrag aller Positionen (z.B. ergibt sich bei 16 % Mehrwertsteuer TAX_VALUE 12800.0000)
- Faktura-Datum (BILL_DATE 20010809)
- Regulierer (interne oder externe Identifikationsnummer aus dem CRM Business-Partner-Stammsatz PAYER 0000000236) oder Versandbedingungen der bestellten Produkte (z.B. werden die bestellten Güter mit dem Schiff vom Hafen Hamburg aus geliefert: INCOTERMS1 FOB free on board -, INCOTERMS2 ab Hamburg') versendet.
Item
Auf Item-Ebene werden Informationen zum bestellten Produkt versendet, wie z.B
- die im CRM Produkt-Stammsatz vergebene Identifikationsnummer (PRODUCT_ID Bagger-001)
- Produkt-Kurztext (PRODUCT_DESCR S-Bagger)
- Global Trade Item Number (GTIN), die das Produkt weltweit eindeutig identifiziert (PRODUCT_GTIN 12340000000002)
- Partner-Produkt-Info, mit der der Auftraggeber das Produkt eindeutig identifiziert (PRODUCT_PARTNER Schaufel-Bagger-004)
- bestellte Menge des Produktes (QUANTITY 1)
- Mengeneinheit, in der das Produkt verkauft wird (QTY_UNIT ST)
- zugehörige ISO-Code-Mengeneinheit (QTY_UNIT_ISO PCE)
- die zugehörige Nummer des CRM-Auftrages (SRC_HEADNO0005006070)
- Bestellnummer des Auftraggebers (PO_NUMBER_SOLD1000045623)
- Positionsnummer im CRM-Auftrag (SRC_ITEMNO0000000010')
- Positionsnummer beim Auftraggeber (PO_NUMBER_EXT040)
- Nettobetrag des Produktes mal Anzahl des bestellten Produktes (NET_VALUE80000.0000) Steuerbetrag mal Anzahl des bestellten Produktes (TAX_VALUE 12800.0000)
- Gesamtbetrag (GROSS_VALUE 92800.0000)
- oder das steuerliches Empfangsland (TAX_DEST_COUNTRYAUS, das steuerliche Abgangsland kann dem Feld COUNTRY, das in der Steuerkomponente an der Faktura-Position enthalten ist, entnommen werden)
Partner
Die sowohl zum Header als auch zu den Faktura-Items gehörenden Partnerkomponenten enthalten verschiedene Funktionen eines Geschäftspartners, wie z.B. 'Rechnungsempfänger', 'Regulierer' auf Faktura-Kopfebene und 'Auftraggeber' , 'Warenempfänger' auf Fakturapositionsebene.Über die Transaktion SPRO -> CRM -> Grundfunktionen -> Partnerschema können Sie die von SAP ausgelieferte Partnerfunktionen in den Partnerschemata Verkauf, Faktura (Kopf), Fakturavorrat und Fakturaposition bei Bedarf auch ändern. Alle hier gepflegten Partnerfunktionen werden innerhalb der Partner-Komponenten mit der Rechnung versendet. Beachten Sie dabei, daß die Partnerschemata 'Verkauf' und 'Fakturavorrat' alle Partnerfunktionen, die für die Partnerschemata 'Faktura' und 'Fakturaposition' gepflegt sind, enthalten müssen.
Alle im System verfügbaren Partnerfunktionen können Sie über Transaktion SPRO -> CRM -> Grundfunktionen -> Partnerfunktionen definiereneinsehen. Für jeden Funktionstyp ist dabei eine eindeutige ID hinterlegt, z.B. 00000001 für Auftraggeber, <LB 00000002 für Warenempfänger, 00000003 für Rechnungsempfänger und 00000004 für Regulierer. Genau diese ID ist in der Partnerkomponente hinterlegt (PARTNER_FCT00000004).
Zu einem Partner werden alle relevanten Address- und Kommunikationsdaten mitversendet. Ausserdem werden, falls vorhanden, weltweit eindeutige Identifikationsdaten wie z.B. Dun&Bradstreet-Nummern (BU_ID_NUMBER2345654334) mitversendet.
Text
Texte wie Fakturainformation oder Geschäftspartnerinformation können sowohl zum Faktura-Kopf als auch zu Faktura-Positionen während einer Fakturierung hinterlegt werden (Transaktion BEA_DL_01 -> Fakturavorrat anzeigen -> Sammelfaktura im Dialog -> z.B. Kopfdetail -> Texte) . Diese Textinformationen werden mit der Rechnung versendet.
Tax
Tax-Komponenten sowohl zum Faktura-Kopf als auch zu Faktura-Positionen enthalten alle Steuerwerte (z.B. AMOUNT 16.0000, CURRENCYUNIT%) zu Steuerelementen (TAXTYPE MWST). Steuerinformationen werden innerhalb der Transaction Tax Engine (TTE), die zusammen mit dem IPC innerhalb einer gemeinsamen JAVA-Komponente integriert ist, während einer Fakturierung dynamisch ermittelt. Diese Steuerinformationen werden von der Billing Engine gelesen und über die externe Schnittstelle versendet.
Condition
Konditionen zu Faktura-Positionen enthalten z.B. die im CRM-System verwendeten Konditionsarten wie Preise (COND_TYPE0PR0), Zuschläge, Abschläge, Steuern oder Frachten und die dazugehörigen Beträge.
Hinweise
Felderweiterungen bzw. Änderungen von Feldinhalten können modifikationsfrei vorgenommen werden:Erweiterungen
Weiterführende Informationen
Weitere Informationen zur Integration von CRM und zu den externen Schnittstellen werden im Service Marketplace unter dem Alias CRM-CI zur Verfügung gestellt.
Parameter
DATARETURN
Ausnahmen
Funktionsgruppe
CRMXIF_INVOICE_GENCPI1466 during Backup PERFORM Short Reference
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 11673 Date: 20240523 Time: 122936 sap01-206 ( 156 ms )
