OIX · phase 1 · tips to courier

Tips to courier — the whole handoff

Hybris asks OIX for the courier nickname when a parent order completes, then posts the paid tip back to OIX. OIX decides whether that record belongs in the database or the error stream — and if it belongs, which system actually pays the courier.

Phase 1 scope: parent order only 5 rejection conditions 4 prefix routes 100% to courier · salary-counted

Flow

Sixteen steps across four phases. Click any node for its rules, inputs and failure behaviour.

OIX is the middleman; Hybris never reads courier master data.

Happy path: nickname → tip paid → validated → all waybills ended → eligible handler → LF/LP salary run.

01 Request nickname
02 Tip intake
03 Courier assignment
04 Routing & reporting

Evaluate a payload

Flip each rule and watch the verdict change. Passing records fall through to the assignment engine.

Nothing leaves this page — the logic is modelled client-side.

Tip transaction · POST /tips

V1pass

Request is processable

For any reason the record cannot be processed, it must not be written.

V2pass

Unique transaction code present

No unique code means duplicates cannot be caught — reject it.

V3pass

Order resolves to a parent

Order number must resolve in OIX, add-on numbers to their parent.

V4pass

Amount above zero

Hybris returning 0 or a negative amount is a rejection, not a free tip.

V5pass

Payment date/time valid

Properly formatted and plausible — malformed or unexpected values are rejected.

Insert to database

All five conditions pass. The record is written and the assignment engine takes over.

record written

          

Assignment engine

runs
AssigneeLF-4821
RouteTM salary report
Courier sees it15-min poll popup

Assigned. Tip is 100% to the courier but counts toward salary, so MPF and tax apply.

Where the tip goes

One prefix decides the destination, the payment mechanism and the reporting cadence.

PrefixDestinationWhat happens
LF / LP TM salary reportsalary Included in the monthly salary report to TM. Sent on the 1st day of the month for every record with an assignee starting LF or LP. 100% goes to the courier, but it is salary — MPF and tax are expected.
ODS ODS systempayment T… ODS creates a payment starting with prefix T. Tips records form an independent report sent with the regular Monday and Thursday noon approval email to finance and logistics; after each send the records go to SAP the same day. No frontend display on the ODS portal.
EDS EDS systemadjustment Sent to EDS, which adds the tip to the adjustment rate and the related reports. EDS owns payout from that point.
anything else Outstanding tipsno assignee No assignment, assignee stays null. Surfaces in the weekly outstanding tips report so someone can resolve the courier.
Weekly · Monday 10:00

Outstanding tips report

Every record from the past 7 days where assignee = null. The follow-up queue for tips that could not be attributed.

Monthly · 1st day

TM salary report

All records of the month where assignee ≠ null and starts with LF or LP. This is the payout list for the salary run.

Mon & Thu · 12:00

Finance & logistics approval

ODS tips travel in the independent report attached to the regular approval email. SAP receives the records the same day, after the send.

Every 15 minutes

Shipment app poll

Configurable interval. When new tips exist, the app pops a notification with customer name, amount and payment time.

Courier totals

Today, past 7 days and this month — plus a past-7-days breakdown on the courier side.

Money treatment

100% of the tip goes to the courier, but it is counted toward salary: MPF and tax apply.

Retention

Housekeeping is undefined. Technical team monitors volume and archives when needed; otherwise records stay live forever.

Nickname field

One field on SSO with no language constraints. That is expected, not an omission.