Order Subtotal_items

Data structure of an subtotal items

FieldColumn TypeDescriptionExample
idStringOrder item's ID (ID of an order item's collection, including item_type, item_id..and so on)
系統自行創建訂單品項ID
5b2b64bd8d1db91156002687
item_typeStringOrder item type:
Product 商品
AddonProduct 加購品
Gift 贈品
CustomProduct 自訂商品
ProductSet 組合商品
Product
item_dataHashCartItem snapshot (when customer place order)
顧客下訂單時,在購物車內的品項資訊快照
item_data. selected_child_products.child_product_idStringProductSet子商品的商品ID

(等同於 child_products[].id)
61f0c202caa9cf001160b8be
item_data. selected_child_products.child_variation_idStringProductSet子商品的規格商品ID

(等同於 child_products[]. variation_id)
61f0c202caa9cf001160b8be
item_data. selected_child_products. quantityIntegerProductSet子商品的購買數量1
item_idStringID of Product/Addon Product/Gift
商品/加購品/贈品的ID
(Custom Product doesn't have a item_id)
(自訂商品沒有item_id)
5892d7339a76f01718000b53
item_variation_idString(To-Be-Deprecated)
規格商品ID請使用下方item_variation_key欄位
item_variation_keyStringVariation ID
規格商品的ID
5b2b5e4a4e22a6ff3200259d
item_priceMoneyItem Price
實際最終的結帳售價
{
"cents": 888,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$888",
"dollars": 888.0
}
object_data.priceMoneyPrice
原價格
--
若是組合商品,則是組合原價
{
"cents": 900,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$900",
"dollars": 900
}
object_data.price_saleMoneySale price
特價
--
若是組合商品,則是列表展示售價
{
"cents": 500,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$500",
"dollars": 500
}
object_data.costMoneyCost
成本價
{
"cents": 100,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$100",
"dollars": 100
}
item_pointsIntegerPoints used for single item
兌換商品所需點數
7
title_translationsTranslationProduct name
商品名稱
{ "en": "Sl Watch",
"zh-hant": "Sl 手錶" }
fields_translationsHashProduct variation combination

Containing the translation of the combination of variant type
{ "en": [
"Red",
"M" ],
"zh-hant": [
"紅",
"中" ] }
skuStringProduct SKU
商品貨號
sl_watch_red_m
is_preorderBooleanIs preorder
是否是預購商品
false
preorder_note_translationsTranslationPreorder product note
商品預購提示
{ "en": "Preorder product, shipping at 5/1", "zh-hant": "預購商品,5/1出貨" }
quantityIntegerOrder item quantity
商品數量
1
totalMoneyOrder item price multiplied by quantity
商品總價
order_discounted_priceMoneyDiscount amount for discounts of all products
該商品適用全單折扣之金額
(註:整筆訂單之折扣,會依金額比例分攤至不同的商品中)
discounted_priceMoneyDiscount amount for discounts of selected products
該商品適用指定商品折扣之金額
total_pointsIntegerTotal points cost on same product (item_points * quantity)

此商品的總點數
14
mediaMediaCover image of the order item
商品圖片
Please refer the JSON example below.
object_dataObjectProduct snapshot
商品快照
{
"location_id": "LU1234"
}
child_productsArray of objectThe products in a product set
組合商品內的商品
--
Appear only when item_type is productSet
只有item_type是組合商品才會出現
child_products[].idString子商品商品ID
child_products[].variation_idString子商品商品規格ID
child_products[].title_translationsTranslation子商品商品名稱
child_products[].fields_translationsHash子商品商品規格名稱
child_products[].priceMoney子商品商品原價
child_products[].price_saleMoney子商品商品特價
child_products[].skuString子商品商品sku
child_products[].weightNumber子商品商品重量

JSON example

{ "id":"5b2b64bd8d1db91156002687", "item_type":"Product", "item_data":{ "cart_item_id":"5daaf385e388091fa80f61b8", "promotion_id":null, "parent_item_ids":[ ], "triggering_item_id":"", "order_promotion_items":{ } }, "item_id":"5892d7339a76f01718000b53", "item_variation_id":"5b2b5e4a4e22a6ff3200259d", "item_price":{ "cents":5000, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"NT$5,000", "dollars":5000 }, "price":{ "cents":9999, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"NT$9,999", "dollars":9999 }, "cost":{ "cents":100, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"NT$100", "dollars":100 }, "title_translations":{ "en":"Sl Watch", "zh-hant":"Sl 手錶" }, "fields_translations":{ "en":[ "Red", "M" ], "zh-hant":[ "紅", "中" ] }, "sku":"sl_watch_red_m", "is_preorder":false, "preorder_note_translations": {}, "quantity":1, "total":{ "cents":5000, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"NT$5,000", "dollars":5000 }, "order_discounted_price":null, "discounted_price":{ "cents":180, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"NT$180", "dollars":180.0 }, "media":{ "images":{ "original":{ "width":2000.0, "height":682.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/original.jpg?1596080803" }, "large":{ "width":500.0, "height":171.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/large.jpg?1596080803" }, "xlarge":{ "width":1000.0, "height":341.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/xlarge.jpg?1596080803" }, "thumb":{ "width":200.0, "height":200.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/thumb.jpg?1596080803" }, "transparent_large":{ "width":500.0, "height":171.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/large.jpg?1596080803" }, "transparent_xlarge":{ "width":1000.0, "height":341.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/xlarge.jpg?1596080803" } }, "_id":"5f2242a478178f0030a06f53", "alt_translations":{ } } }, { "id":"5e09db82353de7001e4768b7", "item_type":"Gift", "item_data":{ "cart_item_id":"5e09db33a6d8840030c0ba78", "promotion_id":null, "parent_item_ids":[ "5e09db81353de7001e4768b0" ], "triggering_item_id":"" }, "item_id":"5de867efce10df0018d91781", "item_variation_id":"", "item_variation_key":"", "item_price":{ "cents":0, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"", "dollars":0.0 }, "price":{ "cents":0, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"", "dollars":0.0 }, "cost":{ "cents":10, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"NT$10", "dollars":10.0 }, "item_points":7, "title_translations":{ "zh-hant":"橘子" }, "fields_translations":{ }, "sku":"FRU008", "is_preorder":false, "preorder_note_translations": {}, "quantity":2, "total":{ "cents":0, "currency_symbol":"NT$", "currency_iso":"TWD", "label":"", "dollars":0.0 }, "order_discounted_price":null, "discounted_price":null, "total_points":14, "media":{ "images":{ "original":{ "width":2000.0, "height":682.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/original.jpg?1596080803" }, "large":{ "width":500.0, "height":171.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/large.jpg?1596080803" }, "xlarge":{ "width":1000.0, "height":341.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/xlarge.jpg?1596080803" }, "thumb":{ "width":200.0, "height":200.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/thumb.jpg?1596080803" }, "transparent_large":{ "width":500.0, "height":171.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/large.jpg?1596080803" }, "transparent_xlarge":{ "width":1000.0, "height":341.0, "url":"https://img.shoplineapp.com/media/image_clips/5f2242a478178f0030a06f53/xlarge.jpg?1596080803" } }, "_id":"5f2242a478178f0030a06f53", "alt_translations":{ } } }
{ "id": "64a76423899c0d0043179deb", "order_number": "20230707010227591", "system_order_number": "20230707010227591", "merchant_order_number": null, "status": "pending", "order_remarks": "", "order_payment": { "id": "64a76423899c0d0043179df5", "payment_method_id": "618b2a3c8c0af0004c214f98", "payment_type": "bank_transfer", "name_translations": { "en": "Bank Transfer", "zh-hant": "銀行轉帳/ATM", "zh-cn": "银行转账/ATM", "vi": "Chuyển khoản ngân hàng", "ms": "Bank Transfer", "ja": "Bank Transfer", "th": "การโอนเงิน", "id": "Bank Transfer", "de": "Bank Transfer", "fr": "Bank Transfer" }, "status": "pending", "payment_fee": { "cents": 120, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$120", "dollars": 120.0 }, "total": { "cents": 901, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$901", "dollars": 901.0 }, "paid_at": null, "updated_at": "2023-07-07T01:02:29.888+00:00", "created_at": "2023-07-07T01:02:27.708+00:00", "payment_data": {}, "last_four_digits": "", "ref_payment_id": null, "payment_slips_setting": { "enabled": true, "days_of_guest_view": 1 } }, "order_delivery": { "id": "64a76423899c0d0043179df6", "delivery_option_id": "62baf0e91e361e00419f540d", "platform": "store_pickup", "status": "pending", "delivery_status": "pending", "name_translations": { "en": "", "zh-hant": "門市取貨---三店", "zh-cn": "", "vi": "", "ms": "", "ja": "", "th": "", "id": "", "de": "", "fr": "" }, "total": { "cents": 10, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$10", "dollars": 10.0 }, "shipped_at": null, "arrived_at": null, "collected_at": null, "returned_at": null, "updated_at": "2023-07-07T01:02:27.720+00:00", "remark": null, "request_accepted_at": null, "request_authorized_at": null, "request_submitted_at": null, "requested_fmt_at": null, "require_expired_upload": false, "require_storeclosed_upload": false, "return_order_id": null, "store_closed_at": null, "storeclosed_upload_at": null, "exp_type": null, "delivery_type": "store_pickup", "requires_customer_address": false }, "delivery_address": { "country_code": "TW", "country": "台灣", "city": null, "state": null, "postcode": null, "address_1": null, "address_2": null, "key": null, "layer1": null, "layer2": null, "layer3": null, "district": null, "logistic_codes": [], "recipient_name": "tina.ho", "recipient_phone": "0955477211", "recipient_phone_country_code": null, "remarks": null }, "delivery_data": { "hk_sfplus_home_region": null, "location_code": null, "location_name": "台北十店", "location_short_name": null, "name_translations": null, "store_address": "台北十店", "url": null, "tracking_number": "", "scheduled_delivery_date": null, "time_slot_key": null, "time_slot_translations": {}, "instore_pickup": false, "target_channel_id": null, "store_address_detail": { "level_1": "", "level_2": "", "level_3": "" } }, "cart_attributes": { "affiliate_data": {}, "shop_session_id": "" }, "customer_id": "63edf433694ff56fab914428", "customer_name": "tina.ho", "customer_email": "tina.ho@shoplineapp.com", "customer_phone": "0955477211", "customer_phone_country_code": "", "customer_info": { "gender": "", "birthday": "1984-01-01", "birth_year": 1984, "birth_month": 1, "birth_day": 1, "custom_data": [ { "value": "", "name_translations": { "zh-hant": "嘎嘎嘎" }, "field_id": "64771ed566d440004c50f5ab" }, { "value": "", "name_translations": { "zh-hant": "哈哈哈" }, "field_id": "64771ed566d440004c50f5ac" }, { "value": "", "name_translations": { "zh-hant": "啦啦啦" }, "field_id": "64771ed566d440004c50f5ad" } ] }, "currency_iso": "TWD", "subtotal": { "cents": 871, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$871", "dollars": 871.0 }, "order_discount": { "cents": 100, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$100", "dollars": 100.0 }, "user_credit": { "cents": 0, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "", "dollars": 0.0 }, "total_tax_fee": { "cents": 0, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "", "dollars": 0.0 }, "total": { "cents": 901, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$901", "dollars": 901.0 }, "order_points": 0, "order_points_to_cash": { "cents": 0, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "", "dollars": 0.0 }, "invoice": { "tax_id": "", "mailing_address": "", "invoice_type": "0", "buyer_name": "", "carrier_type": "0", "carrier_number": "", "n_p_o_b_a_n": "", "invoice_tax_type": "", "invoice_number": "", "invoice_status": "", "invoice_date": null, "invoice_cancelled_at": null }, "invoices": [], "subtotal_items": [ { "id": "64a76423899c0d0043179df1", "item_type": "ProductSet", "item_data": { "cart_item_id": "1386962", "promotion_id": null, "parent_item_ids": [], "triggering_item_id": "", "order_promotion_items": { "order_discounted_price": "64a76423899c0d0043179df0" }, "order_discounted_price": { "cents": 100, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$100", "dollars": 100.0 }, "applied_order_promotion_discounts": [ { "promotion_id": "6418087dcb088900440e9c51", "discount": { "cents": 100, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$100", "dollars": 100.0 } } ], "is_exclude_promotion": false, "is_exclude_user_credit": false, "is_exclude_member_point": false, "has_exclude_promotion_tag": false, "custom_discounted_amount": { "cents": 0, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "", "dollars": 0.0 }, "custom_discounted_amount_items": [], "selected_child_products": [ { "child_product_id": "6423de89768beb004bbf3795", "child_variation_id": "", "quantity": 1, "stock_id": "6423de89768beb004bbf379a" }, { "child_product_id": "644bae338ed29e004cb87019", "child_variation_id": "", "quantity": 1, "stock_id": "644bae338ed29e004cb8702a" } ] }, "item_id": "64a7632e899c0d0046179cd5", "item_variation_id": "", "item_variation_key": "", "item_price": { "cents": 871, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$871", "dollars": 871.0 }, "price": { "cents": 500, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$500", "dollars": 500.0 }, "price_sale": { "cents": 399, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$399", "dollars": 399.0 }, "cost": { "cents": 0, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$0", "dollars": 0.0 }, "ref_data": null, "media": { "images": { "original": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" }, "favicon_small": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" }, "favicon": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" }, "favicon_large": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" }, "transparent_thumb": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" }, "transparent_large": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" }, "transparent_xlarge": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" }, "thumb": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" }, "source": { "width": 3360.0, "height": 1888.0, "url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/64a76304899c0d0046179cd4/original.jpg?1688691459" } }, "_id": "64a76304899c0d0046179cd4", "alt_translations": {}, "blurhash": "U8OVU%Dl8}oy~lsmeof*IWkBR.a#xsfja{ja" }, "product_subscription_id": null, "title_translations": { "zh-hant": "皮卡丘系列組合商品_折扣" }, "fields_translations": {}, "sku": "", "is_preorder": false, "preorder_note_translations": {}, "quantity": 1, "total": { "cents": 871, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$871", "dollars": 871.0 }, "order_discounted_price": { "cents": 100, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$100", "dollars": 100.0 }, "discounted_price": null, "created_by": "admin", "object_data": { "gender": "unisex", "age_group": "all_ages", "adult": "no", "condition": "new", "status": "active", "weight": 0.0, "barcode_type": "Code 128", "max_order_quantity": -1, "gtin": "89404668" }, "child_products": [ { "title_translations": { "en": "frozen pikachu", "zh-hant": "冷凍皮卡丘 (應稅-->免稅,經海關)" }, "weight": 0.0, "id": "6423de89768beb004bbf3795", "variation_id": null, "fields_translations": null, "price": { "cents": 888, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$888", "dollars": 888.0 }, "price_sale": { "cents": 0, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$0", "dollars": 0.0 }, "sku": "sku_frozen_pikachu" }, { "title_translations": { "zh-hant": "皮卡丘現貨1無限預購" }, "weight": 0.0, "id": "644bae338ed29e004cb87019", "variation_id": null, "fields_translations": null, "price": { "cents": 80, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$80", "dollars": 80.0 }, "price_sale": { "cents": 0, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$0", "dollars": 0.0 }, "sku": "sku_frozen_pikachu" } ] } ], "promotion_items": [ { "id": "64a76423899c0d0043179df0", "discountable_amount": null, "discounted_amount": { "cents": 100, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$100", "dollars": 100.0 }, "subtotal_after": { "cents": 771, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$771", "dollars": 771.0 }, "promotion": { "_id": "6418087dcb088900440e9c51", "addon_product_id": null, "available_channel_ids": [], "available_platforms": [ "ec", "retail" ], "banner_media_ids": [], "codes": [], "coupon_generated_by": null, "coupon_type": null, "created_at": "2023-03-20T07:17:17.211Z", "description_translations": {}, "discount_amount": { "cents": 100.0, "currency_iso": "TWD" }, "discount_on": "order", "discount_percentage": null, "discount_type": "amount", "discountable_category_ids": [], "discountable_product_ids": [], "discountable_quantity": null, "discounted_point": null, "discounted_price": null, "drew_coupon_count": 0, "end_at": null, "extended_promotion_id": null, "first_purchase_only": false, "for_affiliate_campaign": false, "is_accumulated": false, "max_use_count": null, "membership_tier_id": null, "merchant_id": "6152cd3b6ed8bb003a727922", "min_price_type": "after_discount", "multiple_code": false, "requires_membership": false, "seo_description_translations": {}, "seo_keywords": null, "seo_title_translations": {}, "show_coupon": false, "start_at": "2023-03-20T07:00:00.000Z", "status": "active", "term_translations": {}, "title_translations": { "zh-hant": "全店折扣--100" }, "updated_at": "2023-04-12T10:23:48.627Z", "use_count": 59, "user_max_use_count": 0, "whitelisted_tag_contents": [], "cart_tag_id": null, "cart_tag_translations": null, "coupon_code": "", "is_extend_promotion": false, "id": "6418087dcb088900440e9c51" }, "updated_at": "2023-07-07T01:02:27.559+00:00", "created_at": "2023-07-07T01:02:27.559+00:00", "item_data": null, "promotion_conditions_data": [ { "min_item_count": null, "min_price": { "cents": 750.0, "currency_iso": "TWD" }, "type": null, "whitelisted_product_ids": [], "whitelisted_category_ids": [], "blacklisted_product_ids": [], "id": "6418087dcb088900440e9c50" } ], "coupon_code": null } ], "custom_data": [], "custom_discount_items": [], "affiliate_data": {}, "ref_order_id": "", "ref_customer_id": "", "channel": {}, "parent_order_id": "", "child_order_ids": [], "split_at": null, "confirmed_at": null, "created_from": "shop", "created_by": "shop", "updated_at": "2023-07-07T01:02:34.179+00:00", "created_at": "2023-07-07T01:02:27.444+00:00", "skip_fulfillment": false, "utm_data": {}, "ga_tracked": false, "order_comments": [], "order_notes": [], "payment_slips": [], "order_source": { "id": "615588b64afb320046c9d1f7", "type": "storefront", "source_id": null, "name": null }, "tags": [], "inclusive_tax_info": {}, "cart_page_id": null, "is_guest_checkout": false, "applied_tax_info": { "sales": {}, "delivery": {} }, "default_warehouse_id": "6331527ca508a3001a3b225b", "return_from_order_id": null, "membership_tier_data": null, "product_subscription_period": null, "checkout_object_data": { "_id": "64a76423899c0d0043179dea", "number": "C20230707010227590", "current_total": { "cents": 901, "currency_symbol": "NT$", "currency_iso": "TWD", "label": "NT$901", "dollars": 901.0 }, "order_ids": [ "64a76423899c0d0043179deb" ] } }

FAQ

Question:
What does it mean for "snapshot"?

Answer:
The "snapshot" means we will keep the product info when customer place an order.
For example, if a customer add ProductA with price $30 in her cart and then create an order with order_id = 12345. After that, the shop staff modify the price of ProductA to $50. When you use Get Order API to get this order(order_id = 12345), the 'item_data' will still show ProductA with price $30.


Did this page help you?