← ZORT integration

Reading a marketplace order's money

An order from Shopee, Lazada, or TikTok Shop carries more discount fields than a direct sale, and they are not interchangeable. Confusing them is how a payout reconciliation ends up off by the subsidy.

Who funded the discount

The buyer sees discount, which already includes both sellerdiscount and platformdiscount. What you actually bear is your share less whatever the marketplace hands back. The reference gives the arithmetic:

discountamount = discount - voucheramount
discountamount = sellerdiscount + platformdiscount - voucheramount

So platformdiscount is money the buyer saved that you did not lose, and voucheramount is money coming to you. Booking either as your own discount understates your margin.

Pretax variants

Most money fields have _pretax and _vat siblings, like sellerdiscount_pretax and shippingamount_vat. Use them instead of deriving the split yourself, because vattype changes how the totals were computed:

• 1 no VAT
• 2 VAT excluded from the amounts
• 3 VAT included in the amounts

Identifying the channel

integrationName names the channel and integrationShop the specific shop. Both appear only on orders from an integrated channel. Shopee and TikTok orders also carry integrationCustomerId and integrationCustomer, the buyer's marketplace identity, which is often all you get. Marketplace buyers rarely surface a real email or phone.

That is also why marketplace buyers make poor contact assets. There is no durable person to track, so promote a contact only when someone recurs or opens a dispute.

COD

isCOD marks cash on delivery, which is the dominant payment method across much of Southeast Asia. Note that it is a response field only. GetOrders has no COD filter, so you cannot build a COD queue directly through the API; you filter on payment status and read isCOD per order.

Which way data flows

The reference documents data moving marketplace to ZORT to Open API. Orders, prices, and discounts arrive and you read them. Do not assume the reverse holds unless an endpoint says so, as zort_ready_to_ship does when it reports trying to mark the order ready in the marketplace.