Logistics and warehouse on S/4HANA

Warranty check and claim on SAP S/4HANA

Looks up a serial number, shows the coverage from the warranty and the sale, decides the claim and creates the service order for the repair or replacement.

SCREENSDATA HANDLERSS/4HANA · READ IN PLACES01 Serial lookupS02 Coverage detailS03 Customer portalS04 Claim decisionS05 Service orderS06 Boarddh_warrantyWarrantyBGMK · BGMS (master warranties) ·EQUI.GWLENdh_customer_masterCustomer masterKNA1 · KNB1 · KNVVdh_sales_order_lineSales order lineVBAK · VBAP · VBEPdh_return_orderReturn orderVBAK · VBAP (VBTYP = 'H') · LIKP returnsdh_quotationQuotationVBAK · VBAP (VBTYP = 'B')WRITE BACK TO S/4HANAWarranty → BAPI_EQUI_CHANGE (warranty dates) · service order via BAPI_ALM_ORDER_MAINTAINReturn order → BAPI_CUSTOMERRETURN_CREATE · BAPI_SALESORDER_CHANGEQuotation → BAPI_QUOTATION_CREATEFROMDATA2 · BAPI_CUSTOMERQUOTATION_CHANGErows stay in S/4HANA · access rules applied at read time · each write acknowledged and logged
The screens of the app, the data handler behind each, and the S/4HANA object it reads in place. Writes below the line go through released interfaces with an acknowledgement.
5
objects read in place from S/4HANA
catalogue
6
screens on those rows
catalogue
5 days
to production-grade
estimate
3
objects written back
catalogue
0
rows copied to build it
product
What the app reads

The S/4HANA objects behind each handler

Tables are read in place through the SAP connector, using released read interfaces; changed rows arrive through change capture where the basis team allows it. The rows stay in SAP.

ObjectRead fromFields the app usesFreshness
WarrantyBGMK · BGMS (master warranties) · EQUI.GWLENEQUI.EQUNR (equipment) · EQUI.SERNR (serial) · EQUI.GWLDT (warranty start) · EQUI.GWLEN (warranty end)live; change capture where enabled
Customer masterKNA1 · KNB1 · KNVVKNA1.KUNNR (id) · KNA1.NAME1 (name) · KNA1.LAND1 (country) · KNVV.VKORG (sales org)live; change capture where enabled
Sales order lineVBAK · VBAP · VBEPVBAK.VBELN (number) · VBAP.POSNR (line) · VBAK.KUNNR (customer) · VBAP.MATNR (material)live; change capture where enabled
Return orderVBAK · VBAP (VBTYP = 'H') · LIKP returnsVBAK.VBELN (number) · VBAK.KUNNR (customer) · VBAP.MATNR (material) · VBAP.KWMENG (qty)live; change capture where enabled
QuotationVBAK · VBAP (VBTYP = 'B')VBAK.VBELN (number) · VBAK.KUNNR (customer) · VBAK.NETWR (value) · VBAK.BNDDT (valid to)live; change capture where enabled
The trigger

The start criterion in S/4HANA's own fields

In plain words: A service agent or a customer enters a serial number and a fault description on S01.

This app starts from a screen, so the first read happens when the instance opens; the criteria on the arrows use the fields above.

Start

A service agent or a customer enters a serial number and a fault description on S01. The instance then reads its rows from S/4HANA through the handlers above.

What the app writes back

Through released interfaces

Writes go through released BAPIs and IDocs. Each call returns a document number or an error message, and the app records both beside the decision.

ObjectWhat changesInterface
Warrantyclaim decision recorded against the warranty of the serial; a service order created through the service order interface for a covered repair or replacement, with fault, priority and engineerBAPI_EQUI_CHANGE (warranty dates) · service order via BAPI_ALM_ORDER_MAINTAIN
Return orderreturn order created with the serial and reason code when the unit comes backBAPI_CUSTOMERRETURN_CREATE · BAPI_SALESORDER_CHANGE
Quotationrepair quotation created for a chargeable fault and sent to the customer for acceptanceBAPI_QUOTATION_CREATEFROMDATA2 · BAPI_CUSTOMERQUOTATION_CHANGE
Acknowledged and logged

Each write stores the identifier S/4HANA returns beside the decision, the person and the time, so the log answers who changed what, and the reconciliation shows it arrived.

Access and prerequisites

What is in place before the first build

SAP roles are mapped to Lima access policies once. A buyer who sees purchasing organisation 1000 in SAP sees the same rows in the app.

  • An SAP user for the connector with read authorisation on the objects the app uses
  • The BAPIs the app writes with, enabled for that user
  • Network path to the application server (PrivateLink or VPN)
  • Change capture switched on for the objects that should refresh within minutes
Register the handlers5 objects from the catalog; each shows its rows at once.
Also on SAP ECC

The same app on SAP ECC

On SAP ECC the same objects live in the classic tables named beside each row; MATDOC becomes MKPF and MSEG, ACDOCA becomes BKPF and BSEG. The BAPIs are the same.

ObjectOn S/4HANAOn SAP ECC
WarrantyBGMK · BGMS (master warranties) · EQUI.GWLENsame tables
Customer masterKNA1 · KNB1 · KNVVsame tables
Sales order lineVBAK · VBAP · VBEPsame tables
Return orderVBAK · VBAP (VBTYP = 'H') · LIKP returnssame tables
QuotationVBAK · VBAP (VBTYP = 'B')KONV for conditions
Nearby

This app on other systems, and other apps on S/4HANA

Warranty check and claim on

Other apps on S/4HANA

Terms on this page

Serial numberThe identifier of one physical unit of a product; the equipment record in the ERP carries it.
Master warrantyThe warranty terms attached to the equipment record: start, end and the faults it covers.
Read in placeThe rows stay in S/4HANA; the handler sends the filter and the columns and S/4HANA returns the matching rows.
Questions

Does this app copy data out of S/4HANA?

The screens read through handlers that leave the rows in S/4HANA. History the app needs at scale is landed in the lake by the Backbone, which is the exception by design.

What does S/4HANA need to allow?

The prerequisites above: an integration identity with read rights on the objects listed and write rights on the interfaces named, connectivity, and the scopes agreed with the process owner.

Can I run it on SAP ECC as well?

Yes. The screens, criteria and roles stay; the handlers are re-bound to the other system's objects, listed above.

See this app on your data

Bring the process and the systems it touches. In the first session we register the data handlers, draw the levels or the lanes and run the first screen on your live rows.