Blog Post Series for SAP Self-Billing Cockpit

Clark_Huang · ‎2024 Aug 29

Background

This feature enable extension options in SAP Self-Billing Cockpit to give customers the flexibility to: Add custom fields to the Self-Billing with Automatic Posting (SBWAP) API and the Self-Billing with Invoice Creation (SBINV) API. Those custom fields will display in both the SBWAP and SBINV monitor.

Solution

Introduce new structures "additionalField" in SBWAP and SBINV API each leavel.

The example of of the transmission level:

        <tran:SelfBillingInvTransmissionMessage>
            <transmission>
                <transmissionId>100001</transmissionId>
                <senderId>EXAMPLESENDERID</senderId>
                <transmissionDate>20210802</transmissionDate>
                <additionalField>
                    <fieldName>transName</fieldName>
                    <fieldValue>transValue</fieldValue>
                </additionalField>

Billing document level:

                <billingDocument>
                    <headerActionCode>000</headerActionCode>
                    <externalBilling>EB09061042</externalBilling>
                    <isoCurrency>EUR</isoCurrency>
                    <customerVatNumber></customerVatNumber>
                    <supplierVatNumber></supplierVatNumber>
                    <netValue></netValue>
                    <grossAmount></grossAmount>
                    <taxAmount></taxAmount>
                    <surcharges></surcharges>
                    <cashDiscountAmount></cashDiscountAmount>
                    <fixedValueDate></fixedValueDate>
                    <documentDate>20210902</documentDate>
                    <additionalField>
                        <fieldName>docName</fieldName>
                        <fieldValue>docValue</fieldValue>
                    </additionalField>

Delivery Level:

                    <deliveryHeader>
                        <delivery>80000471</delivery>
                        <externalDeliveryNote></externalDeliveryNote>
                        <deliveryRelevanceDate></deliveryRelevanceDate>
                        <customerPlant>CP03</customerPlant>
                        <customerUnloadingPoint>UP03</customerUnloadingPoint>
                        <customerSupplier>SP03</customerSupplier>
                        <soldToParty>24100003</soldToParty>
                        <goodsReceiptDate></goodsReceiptDate>
                        <serviceRenderedDate></serviceRenderedDate>
                        <shippingDate></shippingDate>
                        <deliveryTaxAmount></deliveryTaxAmount>
                        <deliveryGrossAmount></deliveryGrossAmount>
                        <additionalField>
                            <fieldName>deliveryName</fieldName>
                            <fieldValue>deliveryValue</fieldValue>
                        </additionalField>

Item level:

                        <billingItem>
                            <itemActionCode>091</itemActionCode>
                            <quantity>3</quantity>
                            <isoUnitOfMeasure>EA</isoUnitOfMeasure>
                            <netValue>60</netValue>
                            <grossAmount></grossAmount>
                            <price>20</price>
                            <priceUnit>1</priceUnit>
                            <priceIsoUoM>PCE</priceIsoUoM>
                            <taxAmount>12.6</taxAmount>
                            <taxRate>21</taxRate>
                            <product></product>
                            <customerMaterial>8001</customerMaterial>
                            <newPrice></newPrice>
                            <newPriceUnit></newPriceUnit>
                            <priceDifference></priceDifference>
                            <priceValidFromDate></priceValidFromDate>
                            <additionalField>
                                <fieldName>itemName</fieldName>
                                <fieldValue>itemValue</fieldValue>
                            </additionalField>

There is one example in SBWAP monitor

Add custom field in transmission level

Field show in SBWAP monitor object page

Add custom fields in "sddocument" level. In this case , we add multiple custom fields.

The custom fields will show both in list page and object page

Add custom field in item level

The custom field will show in history page