SAP integration
SAP integration uses standard means — no changes to the SAP core (little or no custom code). Orda is an external system reached through the client’s middleware or SAP Integration Suite (Cloud Integration).
| Source in SAP | How | When |
|---|---|---|
| S/4HANA outbound deliveries | OData API_OUTBOUND_DELIVERY_SRV (A_OutbDeliveryHeader, A_OutbDeliveryItem), scheduled iFlow |
main option for S/4HANA |
| S/4HANA sales orders | OData API_SALES_ORDER_SRV |
delivery planned per order, before a delivery exists |
| SAP ERP (ECC) / S/4 on-premise | DELVRY IDoc to CPI / PI/PO / other middleware |
IDocs already in use |
The middleware maps the data and calls POST /api/v1/orders/bulk with an Orda API key.
Flow (S/4HANA + Integration Suite)
Section titled “Flow (S/4HANA + Integration Suite)”- A timer iFlow (e.g. every 10 minutes) reads new/changed deliveries via OData (filtered by change date and shipping point).
- Mapping → batches of up to 1000 →
POST /orders/bulkwithIdempotency-Key= run id + batch number. - Row errors go to the CPI message log / an alert.
- Back: a separate HTTPS iFlow receives Orda webhooks (
order.delivered,order.failed,plan.approved), verifies the signature (Groovy, HMAC-SHA256) and updates the delivery in SAP — proof of delivery or a custom field, as agreed with the client’s SAP consultant.
Typical delivery mapping
Section titled “Typical delivery mapping”| Orda | S/4HANA OData (A_OutbDeliveryHeader) |
DELVRY IDoc |
|---|---|---|
externalId, number |
DeliveryDocument |
E1EDL20-VBELN |
deliveryDate |
DeliveryDate (or PlannedGoodsIssueDate) |
date from E1EDT13 |
customerExternalId |
ShipToParty |
partner WE in E1ADRM1 |
address |
ship-to address | E1ADRM1 / E1ADRE1 |
warehouseExternalId |
ShippingPoint |
E1EDL20-VSTEL |
weightKg |
HeaderGrossWeight + HeaderWeightUnit (to kg) |
E1EDL20-BTGEW + GEWEI |
volumeM3 |
HeaderVolume + HeaderVolumeUnit (to m³) |
E1EDL20-VOLUM + VOLEH |
Field names are standard; the client’s SAP consultant confirms them for the specific system. Load ship-to parties
into /customers first with externalId = business partner number.
Orda provides: the reference and openapi.json (importable into Integration Suite / API Management), this mapping, request examples, a sandbox and a Groovy signature check on request.