電商附加資訊對照表
目錄
- 一、怎麼看這份對照表
- 二、蝦皮 Shopee
- 三、91APP
- 四、Shopify
- 五、Shopline
- 六、WooCommerce
- 七、Liteshop
- 八、BVSHOP
- 九、FreeStore
- 十、Cyberbiz
- 十一、EasyStore
- 十二、1shop
- 十三、Coupang 酷澎
- 十四、露天
- 十五、Yahoo SCM
- 十六、Mo店+
- 十七、PChome
- 十八、東森購物
- 十九、momo
- 二十、常見問題
- 二十一、相關功能
一、怎麼看這份對照表
電商附加資訊是平台提供、但不屬於訂單本身的金額拆解與對帳資料:商品折扣、優惠券、蝦幣折抵、佣金與手續費、預計撥款金額、付款方式與包裹編號等。系統在抓單時一併取回,讓您對帳時不必再回平台後台一張張查。
同一份欄位在三個地方看得到,欄位名稱與說明都以本頁為準:
| 在哪裡看 | 說明 |
|---|---|
| 訂單詳情的「電商附加資訊」分頁 | 倉庫端與貨主後台都有,唯讀;切到分頁時才載入。頂端的摘要卡依平台而定(見各平台一節);下方依所有平台共用的分類排列(訂單金額、賣家結算、付款、稅與發票、對帳鍵、成本),平台沒有的分類不顯示。滑過欄位名稱旁的 ⓘ 可看欄位說明、取自平台哪支 API 與回傳欄位 |
| Partners API | 2026-09 起各版本的單筆訂單查詢(GET /orders/{id})與訂單建立/出貨/取消 Webhook 會帶 platform_detail;訂單列表不帶 |
| 本頁 | 每個平台一節,列出欄位、名稱、平台原始欄位與何時才有值 |
資料怎麼更新:
- 跟著抓單循環更新:每次抓單都會重取平台資料,內容有變才寫入,同時更新訂單的最後更新時間;不會重建商品明細、出貨單或動到庫存,所以已在作業中的訂單也照常更新。
- 平台不提供附加資訊或還沒取得時,分頁顯示「無平台資料」,Partners API 回
null;下一次抓單取得後會補上。 - 已去識別化的訂單不再更新。
- 金額一律是固定兩位小數,正負號照平台原值(見各平台說明)。
- 只有本頁列出的平台有這個分頁;其他平台的訂單、手動建立或匯入的訂單、複製出來的訂單都不會出現。
二、蝦皮 Shopee
蝦皮的欄位分在 訂單金額、賣家結算、付款、對帳鍵 四類;蝦皮沒有稅與發票、成本類欄位。金額與結算欄位取自蝦皮的撥款明細(escrow),付款與對帳欄位取自訂單明細,每個欄位的來源 API 見下表「對應蝦皮欄位」欄。
- 只在訂單「待出貨」期間更新:系統只抓蝦皮「待出貨」的訂單,訂單出貨後蝦皮撥款時的最終結算不會回寫,所以收入與費用是蝦皮在出貨前給的預估值,可能與實際撥款不同。
- 正負號:訂單金額的折抵類金額是正數;其中「買家付款明細(買家端視角,折抵為負數)」是買家視角,折抵類金額是負數,畫面上預設收合。
- 運費:「買家付款明細(買家端視角,折抵為負數)」的「運費」會在建單時寫入訂單的運費;建單當下沒取到時,之後第一次取到且訂單運費仍為空才補上,不會覆蓋已有的運費。
- 撥款時間不提供:蝦皮只在撥款後才有撥款時間,屬出貨後的結算資料,目前不在範圍內。
訂單金額
蝦皮回傳訂單收入明細(escrow)後才有值;出貨前為蝦皮的預估值,撥款後的最終結算不回寫。
| 欄位 | 中文名 | 對應蝦皮欄位 | 何時才有值 |
|---|---|---|---|
| 商品金額 | |||
order_income.order_original_price | 商品原價總計 商品原價總計(折扣前)。 | order_income.order_original_price撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.seller_discount | 賣家商品折扣 賣家提供的商品折扣金額。 | order_income.seller_discount撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.shopee_discount | 蝦皮補貼折扣 蝦皮補貼的商品折扣金額。 | order_income.shopee_discount撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.order_discounted_price | 商品折後金額 商品折後金額總計(套用賣家與蝦皮商品折扣後,不含優惠券與運費)。 | order_income.order_discounted_price撥款明細( get_escrow_detail_batch) | 同本類說明 |
| 優惠與折抵 | |||
order_income.voucher_from_seller | 賣家優惠券 賣家優惠券折抵金額(正數)。 | order_income.voucher_from_seller撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.voucher_from_shopee | 蝦皮優惠券 蝦皮優惠券折抵金額(正數)。 | order_income.voucher_from_shopee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.coins | 蝦幣折抵 買家使用蝦幣折抵的金額(正數)。 | order_income.coins撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.seller_coin_cash_back | 賣家蝦幣回饋 賣家提供的蝦幣回饋金額。 | order_income.seller_coin_cash_back撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.credit_card_promotion | 信用卡活動折抵 銀行信用卡活動折抵金額。 | order_income.credit_card_promotion撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.seller_voucher_code | 賣家優惠代碼 買家使用的賣場優惠代碼。 | order_income.seller_voucher_code撥款明細( get_escrow_detail_batch) | 買家使用賣場優惠代碼時才有值。 |
order_income.order_seller_discount | 賣家訂單折扣 訂單層級的賣家折扣金額(舊版 WMS「賣家折扣」取此欄)。 | order_income.order_seller_discount撥款明細( get_escrow_detail_batch) | 同本類說明 |
| 運費 | |||
order_income.buyer_paid_shipping_fee | 買家支付運費 買家支付的運費。 | order_income.buyer_paid_shipping_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.buyer_total_amount | 買家實付總額 買家實付總額。 | order_income.buyer_total_amount撥款明細( get_escrow_detail_batch) | 同本類說明 |
| 買家付款明細(買家端視角,折抵為負數) | |||
buyer_payment_info.shipping_fee | 運費 買家結帳時支付的運費;建單時也寫入訂單的運費欄位。 | buyer_payment_info.shipping_fee撥款明細( get_escrow_detail_batch) | 蝦皮回傳訂單收入明細(escrow)後才有值。 |
buyer_payment_info.seller_voucher | 賣場優惠券折抵 買家端看到的賣場優惠券折抵(負數)。 | buyer_payment_info.seller_voucher撥款明細( get_escrow_detail_batch) | 蝦皮回傳訂單收入明細(escrow)後才有值。 |
buyer_payment_info.shopee_voucher | 蝦皮優惠券折抵 買家端看到的蝦皮優惠券折抵(負數)。 | buyer_payment_info.shopee_voucher撥款明細( get_escrow_detail_batch) | 蝦皮回傳訂單收入明細(escrow)後才有值。 |
buyer_payment_info.shopee_coins_redeemed | 蝦幣折抵 買家端看到的蝦幣折抵(負數)。 | buyer_payment_info.shopee_coins_redeemed撥款明細( get_escrow_detail_batch) | 蝦皮回傳訂單收入明細(escrow)後才有值。 |
賣家結算
蝦皮回傳訂單收入明細(escrow)後才有值;出貨前為蝦皮的預估值,撥款後的最終結算不回寫。
| 欄位 | 中文名 | 對應蝦皮欄位 | 何時才有值 |
|---|---|---|---|
| 平台費用(從撥款扣除) | |||
order_income.commission_fee | 佣金 蝦皮收取的佣金。 | order_income.commission_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.seller_transaction_fee | 成交手續費 向賣家收取的成交手續費。 | order_income.seller_transaction_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.credit_card_transaction_fee | 信用卡交易手續費 信用卡交易手續費。 | order_income.credit_card_transaction_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.service_fee | 其他服務費 其他服務費(例:免運或蝦幣回饋計畫的服務費)。 | order_income.service_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.order_ams_commission_fee | AMS 佣金 蝦皮聯盟行銷(AMS)佣金。 | order_income.order_ams_commission_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.buyer_transaction_fee | 買家交易手續費 向買家收取的交易手續費。 | order_income.buyer_transaction_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
| 運費結算 | |||
order_income.shopee_shipping_rebate | 蝦皮運費補貼 蝦皮補貼的運費。 | order_income.shopee_shipping_rebate撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.seller_shipping_discount | 賣家運費折扣 賣家提供的運費折扣。 | order_income.seller_shipping_discount撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.final_shipping_fee | 賣家負擔運費 賣家最終負擔的運費。 | order_income.final_shipping_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.reverse_shipping_fee | 退貨運費 退貨運費。 | order_income.reverse_shipping_fee撥款明細( get_escrow_detail_batch) | 同本類說明 |
order_income.escrow_amount | 預計撥款金額 蝦皮預計撥款給賣家的金額(扣除各項費用後)。 | order_income.escrow_amount撥款明細( get_escrow_detail_batch) | 同本類說明 |
付款
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應蝦皮欄位 | 何時才有值 |
|---|---|---|---|
order_detail.payment_method | 付款方式 蝦皮回傳的付款方式原始值(例:Cash on Delivery、Credit Card)。 | payment_method訂單明細( get_order_detail) | 同本類說明 |
order_detail.pay_time | 付款時間 買家付款時間。 | pay_time訂單明細( get_order_detail) | 買家完成付款後才有值;貨到付款訂單在買家取貨前為空。 |
order_detail.cod | 貨到付款 是否為貨到付款訂單。 | cod訂單明細( get_order_detail) | 同本類說明 |
對帳鍵
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應蝦皮欄位 | 何時才有值 |
|---|---|---|---|
order_detail.order_sn | 蝦皮訂單編號 蝦皮訂單編號,對帳時用來對應蝦皮後台。 | order_sn訂單明細( get_order_detail) | 同本類說明 |
order_detail.package_number | 包裹編號 蝦皮包裹編號。 | package_list[].package_number訂單明細( get_order_detail) | 蝦皮配好物流後才有值;一張訂單拆成多個包裹時依包裹順序列出。 |
order_detail.group_shipment_id | 合併出貨編號 蝦皮合併出貨編號。 | package_list[].group_shipment_id訂單明細( get_order_detail) | 只有蝦皮合併出貨的包裹才有值。 |
order_detail.shipping_carrier | 物流商 蝦皮指派的物流商名稱。 | shipping_carrier訂單明細( get_order_detail) | 蝦皮配好物流後才有值。 |
三、91APP
91APP 的欄位分在 訂單金額、付款、稅與發票、對帳鍵、成本 五類;91APP 沒有賣家結算類欄位。頂端摘要卡是實付金額與付款方式。除了發票載具,所有欄位都取自 91APP 的訂單查詢(SalesOrder/Get)。
- 91APP 的一張訂單由多個子單組成:Vanta 的一張訂單對應 91APP 的一張主單(TM),主單下每個商品是一個子單(TS)。子單層的金額(實付金額、商品總價、各項折扣、成本)是這張訂單在 Vanta 內各子單的加總,與訂單總額採同一組子單;子單編號、配送編號、課稅別等文字欄位列出所有子單去重後的值。
- 單價不提供:子單的單價(
Price、Cost)加總起來沒有意義,不列入;請看商品總價與總成本。 - 運費:「運費」會在建單時寫入訂單的運費;之前就已抓進來的訂單,第一次取得附加資訊且訂單運費仍為空時才補上,不會覆蓋已有的運費。
- 發票統編與抬頭寫進訂單本身:統編與抬頭取自 91APP 的未開立發票訂單查詢(
NotIssueInvoiceSalesOrder/Get),寫進訂單的買受人統編與名稱(只補仍為空的欄位;兩者都有時買受人類型設為公司),不出現在這個分頁。載具類型與號碼則列在稅與發票。 - 發票資料查詢失敗不影響建單:訂單照常建立,載具欄位先留空,下一次抓單時補上;取得後不再重查。
- 欄位語意以 91APP 原值為準:91APP 文件只提供回應範例、沒有欄位說明,系統照原值存,不另推導(例:課稅別、分期設定的值域)。
訂單金額
訂單抓進 Vanta 時即有值;子單層金額為這張訂單在 Vanta 內各子單的加總。
| 欄位 | 中文名 | 對應91APP欄位 | 何時才有值 |
|---|---|---|---|
| 商品金額 | |||
sales_order.TotalPrice | 商品總價 各子單 TotalPrice 加總(91APP 文件未說明欄位語意,照原值加總)。 | Data.List[].TotalPrice訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
sales_order.TotalDiscount | 折扣總計 各子單 TotalDiscount 加總(91APP 文件未說明欄位語意,照原值加總)。 | Data.List[].TotalDiscount訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
sales_order.PromotionDiscount | 活動折扣 各子單 PromotionDiscount 加總(91APP 文件未說明欄位語意,照原值加總)。 | Data.List[].PromotionDiscount訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
sales_order.ECouponDiscount | 優惠券折抵 各子單 ECouponDiscount 加總(91APP 文件未說明欄位語意,照原值加總)。 | Data.List[].ECouponDiscount訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
sales_order.LoyaltyPointDiscount | 點數折抵 各子單 LoyaltyPointDiscount 加總(91APP 文件未說明欄位語意,照原值加總)。 | Data.List[].LoyaltyPointDiscount訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
sales_order.AdditionalDiscount | 其他折扣 各子單 AdditionalDiscount 加總(91APP 文件未說明欄位語意,照原值加總)。 | Data.List[].AdditionalDiscount訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
| 運費 | |||
sales_order.TMShippingFee | 運費 母單運費(91APP 回傳的 TMShippingFee 原值);建單時也寫入訂單的運費欄位。 | Data.List[].TMShippingFee訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
sales_order.TMShippingFeeTotalDicount | 運費折扣 母單運費折扣(91APP 回傳的 TMShippingFeeTotalDicount 原值,欄位名照 91APP 拼寫)。 | Data.List[].TMShippingFeeTotalDicount訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
sales_order.TotalPayment | 實付金額 各子單 TotalPayment 加總(91APP 文件未說明欄位語意,照原值加總)。不含母單運費。 | Data.List[].TotalPayment訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
付款
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應91APP欄位 | 何時才有值 |
|---|---|---|---|
sales_order.OrderPayType | 付款方式 91APP 回傳的付款方式原始值(例:CreditCardOnce、StorePay、ATM)。 | Data.List[].OrderPayType訂單查詢( Get) | 同本類說明 |
sales_order.PayTypeDetailsPayType | 付款明細類型 各子單付款明細(PayTypeDetails)的付款類型,去重後列出。 | Data.List[].PayTypeDetails[].PayType訂單查詢( Get) | 同本類說明 |
sales_order.InstallmentDef | 分期設定 91APP 回傳的分期設定原始值(文件未說明值域)。 | Data.List[].InstallmentDef訂單查詢( Get) | 91APP 有回傳分期資訊時才有值。 |
稅與發票
課稅別在訂單抓進 Vanta 時即有值;載具取自 91APP 未開立發票訂單 API,查詢失敗時下一次抓單補上。
| 欄位 | 中文名 | 對應91APP欄位 | 何時才有值 |
|---|---|---|---|
sales_order.TaxTypeDef | 課稅別 各子單的課稅別原始值(例:Taxable;文件未說明值域),去重後列出。 | Data.List[].TaxTypeDef訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
invoice.CarrierType | 載具類型 91APP 回傳的發票載具類型原始值(文件未說明值域)。 | Data.List[].CarrierType未開立發票訂單查詢( Get) | 91APP 未開立發票訂單 API 回應後才有值;查詢失敗時下一次抓單補上,已取得後不再重查。 |
invoice.CarrierCode | 載具號碼 發票載具號碼;訂單去識別化時清除。 | Data.List[].CarrierCode未開立發票訂單查詢( Get) | 91APP 未開立發票訂單 API 回應後才有值;查詢失敗時下一次抓單補上,已取得後不再重查。 |
對帳鍵
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應91APP欄位 | 何時才有值 |
|---|---|---|---|
sales_order.TGCode | 購物車編號 91APP 購物車編號。 | Data.List[].TGCode訂單查詢( Get) | 同本類說明 |
sales_order.TMCode | 主單編號 91APP 主單編號,對帳時用來對應 91APP 後台。 | Data.List[].TMCode訂單查詢( Get) | 同本類說明 |
sales_order.TSCode | 子單編號 這張訂單在 Vanta 內各子單的 91APP 訂單編號。 | Data.List[].TSCode訂單查詢( Get) | 同本類說明 |
sales_order.ShippingOrderCode | 配送編號 91APP 配送編號,去重後列出。 | Data.List[].ShippingOrderCode訂單查詢( Get) | 91APP 建立配送單後才有值。 |
sales_order.OrderSource | 訂單來源 91APP 回傳的訂單來源原始值(例:官網(Mobile))。 | Data.List[].OrderSource訂單查詢( Get) | 同本類說明 |
sales_order.OrderReceiverStoreName | 取貨門市 取貨門市名稱。 | Data.List[].OrderReceiverStoreName訂單查詢( Get) | 超商取貨訂單才有值。 |
sales_order.PayTypeDetailsOrderCode | 付款單號 各子單付款明細(PayTypeDetails)的 OrderCode,去重後列出(文件未說明欄位語意)。 | Data.List[].PayTypeDetails[].OrderCode訂單查詢( Get) | 91APP 付款明細有付款單號時才有值。 |
成本
訂單抓進 Vanta 時即有值;為這張訂單在 Vanta 內各子單的加總。
| 欄位 | 中文名 | 對應91APP欄位 | 何時才有值 |
|---|---|---|---|
sales_order.TotalCost | 總成本 各子單 TotalCost 加總(91APP 文件未說明欄位語意,照原值加總)。 | Data.List[].TotalCost訂單查詢( Get) | 訂單抓進 Vanta 時即有值。 |
四、Shopify
Shopify 的欄位六類都有:訂單金額、賣家結算、付款、稅與發票、對帳鍵、成本。全部取自抓單的同一支 Shopify 訂單 API,頂端摘要卡是「訂單總金額」、「付款狀態」與「付款閘道」。
- 金額是商店幣別:Shopify 同時提供商店幣別與買家結帳幣別,這裡一律存商店幣別。
- 跟著抓單更新:系統只匯入 Shopify「已付款、未出貨」的訂單,每次抓到時一併更新;訂單在 Shopify 出貨後就不再抓,之後的退款與出貨資料不會補上。
- 運費:「運費總額」也是訂單的運費;Shopify 文件沒說明它是否已扣運費折扣。扣除運費折扣後的金額看「運送方式折後價合計」(舊版 WMS 的運費算法)。
- 賣家結算只有交易手續費:只有 Shopify Payments 交易有手續費;Shopify Payments 的撥款淨額與撥款批次要另外查詢,目前不提供。
- 成本:每個品項都在 Shopify 設定了單位成本才會算出合計;任一品項沒有成本就留空,不會只加部分品項。成本取的是抓單當下 Shopify 上的設定,不是下單當時的成本。
- 多筆值的欄位:交易、稅項、出貨、退款類欄位一筆訂單可能有多個值,依 Shopify 的順序列出;缺值的位置顯示 -,所以同一組欄位(例如交易的付款閘道與處理時間)筆數相同,同一位置是同一筆。「稅項稅額」在欄位名稱下方每個稅項各一列,左邊是稅項名稱(沒有時顯示「第 n 項」)、右邊是稅額。
- 合計欄位的上限:抓單只取每張訂單前 50 個品項、前 5 個運送方式與前 20 筆交易;品項或運送方式超過、或交易達 20 筆時,對應的合計欄位留空,不會只加部分。
- 不提供退貨資料:Shopify 的退貨(returns)需要另外授權,目前不在範圍內。
訂單金額
| 欄位 | 中文名 | 對應Shopify欄位 | 何時才有值 |
|---|---|---|---|
| 商品金額 | |||
order.original_total_sum | 商品原價合計 各品項 originalTotalSet(建單時的總價,不含折扣)加總,含不需出貨的品項;Shopify 訂單沒有折扣前的品項合計欄位。訂單超過 50 個品項(抓單只取前 50 個)時為空。 | lineItems.nodes[].originalTotalSet.shopMoney.amount訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
order.total_discounts | 折扣總額 訂單折扣總額(退貨前)。 | totalDiscountsSet.shopMoney.amount訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.discount_codes | 折扣碼 訂單使用的折扣碼。 | discountCodes訂單明細( GraphQL Admin API orders) | 買家使用折扣碼時才有值;一張訂單可套用多個折扣碼。 |
transactions.store_credit_amount_sum | 購物金折抵合計 各筆付款閘道為 shopify_store_credit、狀態成功的直接扣款(SALE)與授權後請款(CAPTURE)交易 amountSet 加總;只有授權(AUTHORIZATION)還沒請款的不算。Shopify 訂單沒有購物金合計欄位。訂單有 20 筆以上交易(抓單只取前 20 筆)時為空。 | transactions[].amountSet.shopMoney.amount訂單交易( GraphQL Admin API orders) | 買家使用 Shopify 購物金時才有值。 |
| 運費 | |||
order.total_shipping_price | 運費總額 Shopify 訂單的運費總額(totalShippingPriceSet)。Shopify 文件沒有說明是否已扣除運費折扣;舊版 WMS 的運費取各運送方式的折後價加總,確定已扣運費折扣的金額請看「運送方式折後價合計」(shipping_lines_discounted_price_sum)。訂單的運費欄位也取此值。 | totalShippingPriceSet.shopMoney.amount訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.shipping_lines_discounted_price_sum | 運送方式折後價合計 各運送方式 discountedPriceSet(Shopify 文件:套用折扣後的運費)加總,即舊版 WMS 的運費算法;與「運費總額」的差別是這欄確定已扣運費折扣。訂單超過 5 個運送方式(抓單只取前 5 個)時為空。 | shippingLines.nodes[].discountedPriceSet.shopMoney.amount訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.total_price | 訂單總金額 訂單總金額(退貨前)。 | totalPriceSet.shopMoney.amount訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
賣家結算
只有以 Shopify Payments 付款的交易才有手續費;其他金流為空。
| 欄位 | 中文名 | 對應Shopify欄位 | 何時才有值 |
|---|---|---|---|
transactions.fees_sum | 交易手續費合計 各筆交易各項手續費 fees.amount 加總;只有 Shopify Payments 的交易有手續費,Shopify 訂單沒有手續費合計欄位。撥款淨額不在此欄。手續費幣別與商店幣別不同、或訂單有 20 筆以上交易時為空。 | transactions[].fees[].amount.amount訂單交易( GraphQL Admin API orders) | 只有以 Shopify Payments 付款的交易才有值。 |
付款
| 欄位 | 中文名 | 對應Shopify欄位 | 何時才有值 |
|---|---|---|---|
order.payment_gateway_names | 付款閘道 訂單使用的所有付款閘道名稱,照 Shopify 原值(商家可自訂,例:shopify_payments、貨到付款)。 | paymentGatewayNames訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.display_financial_status | 付款狀態 Shopify 後台顯示的付款狀態原始值(例:PAID、PENDING、PARTIALLY_REFUNDED)。 | displayFinancialStatus訂單明細( GraphQL Admin API orders) | 只反映最後一次抓單時的狀態;定時抓單只抓 Shopify 已付款、未出貨的訂單,之後的退款、出貨要等平台通知訂單異動才會更新這欄。 |
order.currency_code | 商店幣別 下單當時的商店幣別。 | currencyCode訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
transactions.gateway | 交易付款閘道 各筆交易的付款閘道。 | transactions[].gateway訂單交易( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值,只反映最後一次抓單時的交易;依 Shopify 交易順序列出,缺值的位置存 null,各欄筆數相同、同一位置是同一筆交易。 |
transactions.kind | 交易類型 各筆交易的類型原始值(例:SALE、AUTHORIZATION、CAPTURE、REFUND)。 | transactions[].kind訂單交易( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值,只反映最後一次抓單時的交易;依 Shopify 交易順序列出,缺值的位置存 null,各欄筆數相同、同一位置是同一筆交易。 |
transactions.status | 交易狀態 各筆交易的狀態原始值(例:SUCCESS、PENDING、FAILURE)。 | transactions[].status訂單交易( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值,只反映最後一次抓單時的交易;依 Shopify 交易順序列出,缺值的位置存 null,各欄筆數相同、同一位置是同一筆交易。 |
transactions.processed_at | 交易處理時間 各筆交易的處理時間(ISO 8601,照 Shopify 原值)。 | transactions[].processedAt訂單交易( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值,只反映最後一次抓單時的交易;依 Shopify 交易順序列出,缺值的位置存 null,各欄筆數相同、同一位置是同一筆交易。 |
稅與發票
| 欄位 | 中文名 | 對應Shopify欄位 | 何時才有值 |
|---|---|---|---|
order.taxes_included | 價格含稅 商品小計是否已含稅。 | taxesIncluded訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.total_tax | 稅額總計 訂單稅額總計(退貨前)。 | totalTaxSet.shopMoney.amount訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.tax_lines_rate_percentage | 稅率(%) 各稅項的稅率(百分比,照 Shopify 原值)。 | taxLines[].ratePercentage訂單明細( GraphQL Admin API orders) | 訂單有稅項時才有值;依稅項順序列出,沒有值的位置為 null,筆數與稅項數相同。 |
order.tax_lines_price | 稅項稅額 各稅項的名稱(taxLines 每筆的 title;沒有名稱時顯示「第 n 項」)與稅額(折扣後、退貨前),依稅項順序逐筆列出;缺值或無法解析的稅額為 null。 | taxLines[].priceSet.shopMoney.amount(label: taxLines[].title)訂單明細( GraphQL Admin API orders) | 訂單有稅項時才有值;依稅項順序列出,筆數與稅項數相同。 |
對帳鍵
| 欄位 | 中文名 | 對應Shopify欄位 | 何時才有值 |
|---|---|---|---|
order.id | Shopify 訂單 ID Shopify 訂單 ID(GID,例:gid://shopify/Order/123),對應 Shopify 後台與 API。 | id訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.name | Shopify 訂單編號 Shopify 訂單編號(例:#1001)。 | name訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.source_name | 訂單來源 訂單來源名稱(例:web、pos,或第三方 App 的名稱)。 | sourceName訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
order.source_identifier | 來源訂單識別碼 POS 或第三方的訂單識別碼。 | sourceIdentifier訂單明細( GraphQL Admin API orders) | 由 POS 或第三方建立的訂單才有值。 |
order.po_number | 採購單號 訂單的採購單(PO)號碼。 | poNumber訂單明細( GraphQL Admin API orders) | 訂單有採購單號時才有值。 |
order.total_refunded | 退款總額 Shopify 訂單的退款總額(totalRefundedSet)。 | totalRefundedSet.shopMoney.amount訂單明細( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值;只反映最後一次抓單時的退款。定時抓單只抓 Shopify 未出貨的訂單,之後的退款(含出貨後)要等平台通知訂單異動才會更新。 |
transactions.id | 交易 ID 各筆交易的 Shopify 交易 ID。 | transactions[].id訂單交易( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值,只反映最後一次抓單時的交易;依 Shopify 交易順序列出,缺值的位置存 null,各欄筆數相同、同一位置是同一筆交易。 |
fulfillments.id | Shopify 出貨 ID Shopify 出貨(fulfillment)ID。 | fulfillments[].id訂單出貨( GraphQL Admin API orders) | 只反映最後一次抓單時的狀態。定時抓單只抓 Shopify 未出貨的訂單,出貨後要等平台通知訂單異動才會更新。 |
fulfillments.name | Shopify 出貨名稱 Shopify 出貨的識別名稱(例:#1001-F1)。 | fulfillments[].name訂單出貨( GraphQL Admin API orders) | 只反映最後一次抓單時的狀態。定時抓單只抓 Shopify 未出貨的訂單,出貨後要等平台通知訂單異動才會更新。 |
fulfillments.tracking_number | 物流追蹤號碼 出貨的物流追蹤號碼。 | fulfillments[].trackingInfo[].number訂單出貨( GraphQL Admin API orders) | 只反映最後一次抓單時的狀態。定時抓單只抓 Shopify 未出貨的訂單,出貨後要等平台通知訂單異動才會更新。 |
fulfillments.tracking_company | 物流公司 出貨的物流公司名稱。 | fulfillments[].trackingInfo[].company訂單出貨( GraphQL Admin API orders) | 只反映最後一次抓單時的狀態。定時抓單只抓 Shopify 未出貨的訂單,出貨後要等平台通知訂單異動才會更新。 |
fulfillments.fulfillment_order_id | Shopify 出貨單 ID Shopify 出貨單(fulfillment order)ID。 | fulfillmentOrders.nodes[].id訂單出貨( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值。 |
fulfillments.fulfillment_order_status | Shopify 出貨單狀態 各 Shopify 出貨單的狀態原始值(例:OPEN、CLOSED)。 | fulfillmentOrders.nodes[].status訂單出貨( GraphQL Admin API orders) | 訂單抓進 Vanta 時即有值;只反映最後一次抓單時的狀態。 |
refunds.id | Shopify 退款 ID Shopify 退款 ID。 | refunds[].id訂單退款( GraphQL Admin API orders) | 只反映最後一次抓單時的狀態;抓單時已有退款才有值。定時抓單只抓 Shopify 未出貨的訂單,之後的退款(含出貨後)要等平台通知訂單異動才會更新。 |
refunds.created_at | 退款建立時間 各筆退款的建立時間(ISO 8601,照 Shopify 原值),缺值的位置存 null。 | refunds[].createdAt訂單退款( GraphQL Admin API orders) | 只反映最後一次抓單時的狀態;抓單時已有退款才有值。定時抓單只抓 Shopify 未出貨的訂單,之後的退款(含出貨後)要等平台通知訂單異動才會更新。 |
成本
每個品項都在 Shopify 設定了單位成本才有值。
| 欄位 | 中文名 | 對應Shopify欄位 | 何時才有值 |
|---|---|---|---|
order.unit_cost_sum | 商品成本合計 各品項 inventoryItem.unitCost(商店幣別)乘以訂購數量後加總。unitCost 是抓單當下 Shopify 上設定的成本,不是下單當時的成本;商家改了成本,下一次抓到這張單時會跟著變。 | lineItems.nodes[].variant.inventoryItem.unitCost.amount訂單明細( GraphQL Admin API orders) | 每個品項都在 Shopify 設定了單位成本才有值;任一品項沒有成本、或訂單超過 50 個品項時為空。 |
五、Shopline
Shopline 的欄位分在 訂單金額、賣家結算、付款、稅與發票、對帳鍵、成本 六類,全部取自抓單本身的訂單明細,不另打其他 API。頂端摘要卡是訂單總額、付款方式與付款狀態。
- 只在訂單待出貨期間更新:系統只抓 Shopline 待出貨的訂單,抓到時一併更新;訂單出貨或取消後 Shopline 端的變動不會回寫。
- 賣家結算只有付款手續費:Shopline 是自架商店,沒有平台佣金與撥款資料;「付款手續費」是向買家加收、已含在訂單總額內的費用。
- 多筆金額依 Shopline 順序列出:「優惠活動折抵」與「品項成本」在欄位名稱下方每筆各一列,左邊是優惠活動名稱或 SKU(沒有時顯示「第 n 項」)、右邊是金額。「自訂折扣」Shopline 沒有提供名稱,每筆一個金額、以逗號分隔。
- 運費:「運費」會在建單時寫入訂單的運費;之後第一次取到且訂單運費仍為空時才補上,不會覆蓋已有的運費。
- 公司發票的統編與抬頭寫進訂單的發票資訊:買家在 Shopline 填了統編與抬頭時,系統寫進訂單的買受人統編與名稱(只補仍為空的欄位,倉管已填的不覆寫;兩者都有時買受人類型設為公司),不另列在這個分頁。
- 載具號碼是個資:「載具號碼」在訂單去識別化時清除。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。
| 欄位 | 中文名 | 對應Shopline欄位 | 何時才有值 |
|---|---|---|---|
order.subtotal | 商品小計 訂單所有品項的價格總計(Shopline 文件:Price total for all order items)。 | subtotal.dollars訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
order.order_discount | 訂單折扣 訂單折扣金額。 | order_discount.dollars訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
order.promotion_items | 優惠活動折抵 各優惠活動的名稱(promotion 的繁體中文標題 title_translations.zh-hant;沒有繁中標題時顯示「第 n 項」)與折抵金額(promotion_items 每筆的 discounted_amount)。 | promotion_items[].discounted_amount.dollars(label: promotion_items[].promotion.title_translations.zh-hant)訂單明細( search) | 訂單套用優惠活動時才有值;依 Shopline 回傳的優惠活動順序列出。 |
order.custom_discount_items | 自訂折扣 各筆自訂折扣的金額(custom_discount_items 每筆的 total;Shopline 文件:Order Custom Discount Item Data),依 Shopline 回傳順序列出、不帶名稱(文件沒有名稱欄位),只能依順序對應;沒有值的位置為 null。 | custom_discount_items[].total.dollars訂單明細( search) | 訂單有自訂折扣時才有值(常見於 POS 訂單);依 Shopline 回傳順序列出。 |
order.user_credit | 購物金折抵 訂單使用的顧客購物金。 | user_credit.dollars訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
order.order_points_to_cash | 點數折抵 會員點數折抵的金額。 | order_points_to_cash.dollars訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
order.applied_member_point_redeem_to_cash | 會員點數兌現折抵 會員點數折抵金額(applied_member_point_redeem_to_cash 原值;Shopline 文件未說明與 order_points_to_cash 的差別)。 | applied_member_point_redeem_to_cash.dollars訂單明細( search) | Shopline 有回傳時才有值;此欄位只出現在 Shopline 文件的回應範例,未列在欄位說明表。 |
| 運費 | |||
order_delivery.total | 運費 運費;建單時也寫入訂單的運費欄位。 | order_delivery.total.dollars訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
order.total | 訂單總額 訂單最終總額,含付款手續費與運費(Shopline 文件:Final price total, which includes payment fee and delivery fee)。 | total.dollars訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
賣家結算
訂單抓進 Vanta 時即有值。Shopline 只提供付款手續費,不提供平台費用與撥款資料。
| 欄位 | 中文名 | 對應Shopline欄位 | 何時才有值 |
|---|---|---|---|
order_payment.payment_fee | 付款手續費 付款方式加收的手續費(買家附加費,已含在訂單總額內)。 | order_payment.payment_fee.dollars訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
付款
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應Shopline欄位 | 何時才有值 |
|---|---|---|---|
order.currency_iso | 幣別 訂單幣別(ISO-4217,例:TWD)。 | currency_iso訂單明細( search) | 同本類說明 |
order_payment.payment_type | 付款方式 Shopline 回傳的付款方式原始值(例:tw_711_b2c_pay、shopline_payment、bank_transfer)。 | order_payment.payment_type訂單明細( search) | 同本類說明 |
order_payment.status | 付款狀態 Shopline 回傳的付款狀態原始值(例:pending、completed;Shopline 文件未列出完整值域)。 | order_payment.status訂單明細( search) | 同本類說明 |
order_payment.paid_at | 付款時間 付款完成時間。 | order_payment.paid_at訂單明細( search) | 買家完成付款後才有值;貨到付款訂單在買家取貨前為空。 |
稅與發票
訂單抓進 Vanta 時即有值;發票號碼在 Shopline 開立發票後才有。
| 欄位 | 中文名 | 對應Shopline欄位 | 何時才有值 |
|---|---|---|---|
order.total_tax_fee | 稅額總計 訂單稅額總計(Shopline 文件:Total Tax Fee)。 | total_tax_fee.dollars訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
order.invoices | 所有發票號碼 這張訂單開立過的所有發票號碼(含作廢;Shopline 文件:All invoices issued for the order)。 | invoices[].invoice_number訂單明細( search) | Shopline 開立發票後才有值;含已作廢的發票,依 Shopline 回傳順序列出。 |
invoice.carrier_type | 載具類型 Shopline 回傳的發票載具類型原始值(Shopline 文件未說明各值的意義)。 | invoice.carrier_type訂單明細( search) | 訂單抓進 Vanta 時即有值。 |
invoice.carrier_number | 載具號碼 發票載具號碼(例:手機條碼)。 | invoice.carrier_number訂單明細( search) | 買家選擇載具時才有值;訂單去識別化時清除。 |
invoice.invoice_number | 發票號碼 目前的發票號碼。 | invoice.invoice_number訂單明細( search) | Shopline 開立發票後才有值。 |
inclusive_tax_info.fee | 內含稅額 內含稅額(Shopline 文件:Included tax info)。 | inclusive_tax_info.fee.dollars訂單明細( search) | 訂單套用內含稅設定時才有值。 |
inclusive_tax_info.rate | 內含稅率 內含稅率原始值。 | inclusive_tax_info.rate訂單明細( search) | 訂單套用內含稅設定時才有值。 |
對帳鍵
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應Shopline欄位 | 何時才有值 |
|---|---|---|---|
order.id | Shopline 訂單 ID Shopline 訂單 ID(平台內部識別碼,與訂單編號不同)。 | id訂單明細( search) | 同本類說明 |
order.order_number | Shopline 訂單編號 Shopline 訂單編號;商家有自訂編號時為自訂編號,否則為系統產生的編號。 | order_number訂單明細( search) | 同本類說明 |
order.parent_order_id | 母訂單 ID 拆單後的母訂單 ID。 | parent_order_id訂單明細( search) | 只有拆單產生的子訂單才有值。 |
order.child_order_ids | 子訂單 ID 拆單後的子訂單 ID。 | child_order_ids訂單明細( search) | 只有被拆單的母訂單才有值。 |
order.created_by | 建立管道 建立訂單的管道原始值(例:shop、admin、pos、openapi)。 | created_by訂單明細( search) | 同本類說明 |
delivery_data.tracking_number | 配送單號 Shopline 第三方物流的配送單號。 | delivery_data.tracking_number訂單明細( search) | Shopline 配好物流後才有值。 |
order_source.type | 訂單來源 訂單來源類型原始值(例:storefront、FB、LINE、實體店)。 | order_source.type訂單明細( search) | 店家啟用 Shopline 訂單來源功能時才有值。 |
order_source.id | 訂單來源 ID 訂單來源 ID。 | order_source.id訂單明細( search) | 店家啟用 Shopline 訂單來源功能時才有值。 |
成本
訂單抓進 Vanta 時即有值;成本是商家在 Shopline 商品設定的值,沒設定時為 0。
| 欄位 | 中文名 | 對應Shopline欄位 | 何時才有值 |
|---|---|---|---|
subtotal_items.cost | 品項成本 各品項的成本,每筆帶該品項的 SKU,依 Shopline 訂單品項順序列出(Shopline 文件未說明是單件成本或整列成本)。 | subtotal_items[].cost.dollars(label: subtotal_items[].sku)訂單明細( search) | 同本類說明 |
六、WooCommerce
WooCommerce 的欄位分在 訂單金額、付款、稅與發票、對帳鍵 四類,全部取自抓單本身的訂單明細,不另打其他 API。WooCommerce 沒有賣家結算與成本資料,這兩類不顯示。頂端摘要卡是訂單總額、付款方式與訂單狀態。
- 只在訂單處理中期間更新:系統只抓 WooCommerce 處理中(processing)的訂單,抓到時一併更新;訂單完成或取消後 WooCommerce 端的變動不會回寫。
- 商品小計(加總)是系統加總的值:WooCommerce 訂單沒有商品合計欄位,系統把各品項折扣前的小計加總。
- 多筆金額依 WooCommerce 順序列出:「優惠券折抵」「稅額」「運費稅額」在欄位名稱下方每筆各一列,左邊是優惠券代碼或稅率名稱(沒有時顯示「第 n 項」)、右邊是金額。「稅率代碼」依稅率順序以逗號分隔,同一位置對應同一個稅率。
- 運費:「運費」同時寫入訂單的運費,每次抓單都會依 WooCommerce 的值更新。
- 付款方式存平台原值:「付款方式 ID」是付款外掛的代碼,「付款方式」是商店設定的顯示文字,兩者都照 WooCommerce 回傳的值顯示。
- 沒有統編、載具與發票號碼:WooCommerce 公版沒有這些欄位,發票外掛寫在自訂欄位裡的資料不會出現在這個分頁。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。
| 欄位 | 中文名 | 對應WooCommerce欄位 | 何時才有值 |
|---|---|---|---|
order.line_items_subtotal_sum | 商品小計(加總) 各品項 subtotal 加總(WooCommerce 文件:Line subtotal (before discounts),品項折扣前的小計);WooCommerce 訂單沒有折扣前的商品合計欄位。 | line_items[].subtotal訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
order.discount_total | 折扣總額 訂單的折扣總額(WooCommerce 文件:Total discount amount for the order)。 | discount_total訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.coupon_lines_discount | 優惠券折抵 各優惠券的代碼(coupon_lines 每筆的 code;WooCommerce 文件:Coupon code;沒有代碼時顯示「第 n 項」)與折抵金額(WooCommerce 文件:Discount total)。 | coupon_lines[].discount(label: coupon_lines[].code)訂單明細( orders) | 買家使用優惠券時才有值;依 WooCommerce 回傳順序列出。 |
| 運費 | |||
order.shipping_total | 運費 訂單的運費總額(WooCommerce 文件:Total shipping amount for the order);也寫入訂單的運費欄位。 | shipping_total訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.total | 訂單總額 訂單總額(WooCommerce 文件:Grand total)。 | total訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
付款
訂單抓進 Vanta 時即有值;付款時間在買家完成線上付款後才有。
| 欄位 | 中文名 | 對應WooCommerce欄位 | 何時才有值 |
|---|---|---|---|
order.payment_method | 付款方式 ID WooCommerce 回傳的付款方式 ID 原始值(WooCommerce 文件:Payment method ID;例:cod、bacs、ry_ecpay_credit)。 | payment_method訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.payment_method_title | 付款方式 WooCommerce 回傳的付款方式名稱原始值(WooCommerce 文件:Payment method title;商店設定的顯示文字)。 | payment_method_title訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.status | 訂單狀態 WooCommerce 回傳的訂單狀態原始值(WooCommerce 文件:Order status,值為 pending、processing、on-hold、completed、cancelled、refunded、failed、trash)。 | status訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.date_paid | 付款時間 付款時間(WooCommerce 文件:The date the order was paid, as GMT);沒有 GMT 值時改取站台時區的 date_paid。 | date_paid_gmt訂單明細( orders) | 買家完成線上付款後才有值;貨到付款訂單在出貨前為空。 |
order.currency | 幣別 訂單幣別(WooCommerce 文件:Currency the order was created with, in ISO format;例:TWD)。 | currency訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
稅與發票
訂單抓進 Vanta 時即有值;稅額明細只有商店啟用稅金設定時才有。WooCommerce 沒有統編、載具與發票號碼欄位。
| 欄位 | 中文名 | 對應WooCommerce欄位 | 何時才有值 |
|---|---|---|---|
order.prices_include_tax | 價格含稅 結帳時價格是否含稅(WooCommerce 文件:True the prices included tax during checkout)。 | prices_include_tax訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.total_tax | 稅額總計 訂單所有稅額的總和(WooCommerce 文件:Sum of all taxes)。 | total_tax訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.tax_lines_rate_code | 稅率代碼 各稅率的代碼(WooCommerce 文件:Tax rate code)。 | tax_lines[].rate_code訂單明細( orders) | 商店啟用稅金設定、訂單有計稅時才有值;依 WooCommerce 回傳順序列出,沒有值的位置為 null,筆數與稅率數相同。 |
order.tax_lines_tax_total | 稅額 各稅率的名稱(tax_lines 每筆的 label;WooCommerce 文件:Tax rate label;沒有名稱時顯示「第 n 項」)與稅額,不含運費稅額(WooCommerce 文件:Tax total (not including shipping taxes))。 | tax_lines[].tax_total(label: tax_lines[].label)訂單明細( orders) | 商店啟用稅金設定、訂單有計稅時才有值;依 WooCommerce 回傳順序列出。 |
order.tax_lines_shipping_tax_total | 運費稅額 各稅率的名稱(tax_lines 每筆的 label;沒有名稱時顯示「第 n 項」)與運費稅額(WooCommerce 文件:Shipping tax total)。 | tax_lines[].shipping_tax_total(label: tax_lines[].label)訂單明細( orders) | 商店啟用稅金設定、訂單有計稅時才有值;依 WooCommerce 回傳順序列出。 |
對帳鍵
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應WooCommerce欄位 | 何時才有值 |
|---|---|---|---|
order.id | WooCommerce 訂單 ID WooCommerce 訂單 ID(WooCommerce 文件:Unique identifier for the resource;平台內部識別碼,與訂單編號不同)。 | id訂單明細( orders) | 同本類說明 |
order.number | WooCommerce 訂單編號 WooCommerce 訂單編號(WooCommerce 文件:Order number)。 | number訂單明細( orders) | 同本類說明 |
order.transaction_id | 交易編號 付款的交易編號(WooCommerce 文件:Unique transaction ID)。 | transaction_id訂單明細( orders) | 付款外掛有回寫交易編號時才有值。 |
order.created_via | 建立來源 訂單建立來源的原始值(WooCommerce 文件:Shows where the order was created;例:checkout、admin、rest-api)。 | created_via訂單明細( orders) | 同本類說明 |
七、Liteshop
Liteshop 的欄位分在 訂單金額、賣家結算、付款、稅與發票、對帳鍵、成本 六類。頂端摘要卡是訂單總額、金流手續費與付款方式。所有欄位都取自 Liteshop 的訂單資料,與訂單本身同一份回應,不另外查詢。
- 賣家結算只有金流手續費:「金流手續費」是金額,「金流手續費率 (%)」是費率(%,Liteshop 四捨五入為整數);Liteshop 不提供平台抽成與撥款金額。
- 折扣與退貨單逐筆列出:「折扣明細」與「退貨單退款」在欄位名稱下方每筆各一列,左邊是折扣名稱或退貨單編號、右邊是金額或退款金額。
- 發票統編與買受人寫進訂單本身:發票有統編與買受人姓名時,寫進訂單的買受人統編與名稱,買受人類型設為公司(只補三個欄位都還是空的訂單,不覆蓋已填的資料),不出現在這個分頁。發票號碼、狀態、開立日期與載具列在稅與發票。
- 退貨單不一定取得:Liteshop 只在單筆訂單查詢回傳退貨單;Vanta 定期抓單用的是訂單列表,只有 Liteshop 通知訂單異動、Vanta 重新查詢該筆訂單時才會取得。
- 商品成本逐品項列出、僅供參考:「商品成本」在欄位名稱下方每個品項各一列,左邊是 SKU、右邊是成本;品項沒有成本顯示「-」,沒有名稱或 SKU 時顯示「第 n 項」,SKU 太長時以「…」截斷、滑過可看完整。Liteshop 文件註明商品成本不保證維持,系統照原值存。
訂單金額
訂單抓進 Vanta 時即有值;退款只在 Liteshop 通知訂單異動、Vanta 重新查詢該筆訂單時取得。
| 欄位 | 中文名 | 對應Liteshop欄位 | 何時才有值 |
|---|---|---|---|
order.subtotal | 小計 小計 (折扣前)。 | subtotal訂單資料( orders) | 訂單抓進 Vanta 時即有值。 |
| 折扣 | |||
order.order_discount | 訂單折扣總額 訂單折扣總額。 | order_discount訂單資料( orders) | 訂單抓進 Vanta 時即有值。 |
order.discounts | 折扣明細 套用的各筆折扣,每筆是折扣名稱(discounts 的 title)與折扣金額(discounts 的 amount;Liteshop 文件:折扣金額)。 | discounts[].amount(label: discounts[].title)訂單資料( orders) | 訂單套用折扣時才有值;依 Liteshop 回傳的折扣順序列出。 |
| 運送 | |||
order.shipping_fee | 運費 運費。 | shipping_fee訂單資料( orders) | 訂單抓進 Vanta 時即有值。 |
order.price | 訂單總額 訂單總額 (含運費),實際請款金額。 | price訂單資料( orders) | 訂單抓進 Vanta 時即有值。 |
| 退款 | |||
return_orders.returned_prices | 退貨單退款 各退貨單的退貨單編號(name)與退款金額(returned_price),依 Liteshop 回傳順序列出。 | return_orders[].returned_price(label: return_orders[].name)訂單詳細資訊( {order_name}) | 只有單筆訂單查詢回傳,Liteshop 通知訂單異動、Vanta 重新查詢該筆訂單時取得;訂單有退貨單時才有值。 |
賣家結算
訂單抓進 Vanta 時即有值;只有金流手續費,Liteshop 不提供平台抽成與撥款金額。
| 欄位 | 中文名 | 對應Liteshop欄位 | 何時才有值 |
|---|---|---|---|
order.payment_charge | 金流手續費 金流手續費(金額;費率見付款方式的 extra_charge)。 | payment_charge訂單資料( orders) | 訂單抓進 Vanta 時即有值。 |
payment.extra_charge | 金流手續費率 (%) 金流手續費率 (%),四捨五入為整數;手續費金額見訂單的 payment_charge。 | payment.extra_charge付款方式( orders) | 訂單抓進 Vanta 時即有值。 |
付款
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應Liteshop欄位 | 何時才有值 |
|---|---|---|---|
order.payment_status | 付款狀態 付款狀態原始值(waiting、confirming、paid、cod、refunded)。 | payment_status訂單資料( orders) | 同本類說明 |
order.paid_time | 付款時間 付款時間。 | paid_time訂單資料( orders) | 訂單付款後才有值;貨到付款的訂單出貨前多半沒有值。 |
order.payment_detail_subtypes | 交易子類型 交易紀錄(payment_detail)每筆的交易子類型原始值(例:credit)。 | payment_detail[].subtype訂單資料( orders) | Liteshop 有交易紀錄時才有值。 |
order.payment_detail_credit_last_four | 信用卡後四碼 交易紀錄(payment_detail)每筆的信用卡後四碼。 | payment_detail[].credit_last_four訂單資料( orders) | 信用卡付款且 Liteshop 有交易紀錄時才有值;訂單去識別化時清除。 |
payment.title | 付款方式 付款方式中文顯示名稱。 | payment.title付款方式( orders) | 同本類說明 |
payment.code | 付款方式代碼 付款方式代碼原始值(例:Credit、ATM、CVS COD、Offline COD)。 | payment.code付款方式( orders) | 同本類說明 |
稅與發票
Liteshop 開立發票後才有值。
| 欄位 | 中文名 | 對應Liteshop欄位 | 何時才有值 |
|---|---|---|---|
order.invoice_number | 發票號碼 發票號碼。 | invoice.number訂單資料( orders) | 同本類說明 |
order.invoice_status | 發票狀態 發票狀態原始值(new、issuing、waiting、done、cancel_pending、allowance_pending、canceled、allowance)。 | invoice.status訂單資料( orders) | 同本類說明 |
order.invoice_issued_at | 開立日期 開立日期 (YYYY-MM-DD),照 Liteshop 原值存。 | invoice.issued_at訂單資料( orders) | 同本類說明 |
order.invoice_carrier_type | 載具類型 載具類型原始值(invoice.carrierType,例:cellphone 手機條碼)。 | invoice.carrierType訂單資料( orders) | 同本類說明 |
order.invoice_carrier_id | 載具編號 載具編號(invoice.carrierId);訂單去識別化時清除。 | invoice.carrierId訂單資料( orders) | 同本類說明 |
對帳鍵
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應Liteshop欄位 | 何時才有值 |
|---|---|---|---|
order.name | 訂單編號 訂單編號,對帳時用來對應 Liteshop 後台。 | name訂單資料( orders) | 同本類說明 |
order.parent_order_name | 母訂單編號 母訂單編號 (由拆單產生的子訂單才有值)。 | parent_order_name訂單資料( orders) | 只有拆單產生的子訂單才有值。 |
成本
訂單抓進 Vanta 時即有值;Liteshop 文件註明商品成本不保證維持。
| 欄位 | 中文名 | 對應Liteshop欄位 | 何時才有值 |
|---|---|---|---|
order.item_costs | 商品成本 各品項的商品成本,每筆帶該品項的 SKU,依 Liteshop 訂單品項順序列出(Liteshop 文件:商品成本,不保證維持,串接方請勿依賴;未說明是單件成本或整列成本)。 | order_items[].cost(label: order_items[].sku)訂單資料( orders) | 訂單抓進 Vanta 時即有值。 |
八、BVSHOP
BVSHOP 的欄位分在 訂單金額、賣家結算、付款、稅與發票、對帳鍵 五類,全部取自抓單本身的訂單明細,不另打其他 API;BVSHOP 沒有成本類欄位。頂端摘要卡是訂單總額、付款方式與付款狀態。
- 只在 BVSHOP 端未出貨期間更新:系統只抓 BVSHOP 未出貨的訂單(已付款,或未付款的貨到付款單),抓到時一併更新;BVSHOP 端出貨或取消後的變動不會回寫,所以貨到付款單的付款時間、出貨後才開的發票都不會出現。
- 賣家結算只有手續費:BVSHOP 不提供平台佣金與撥款資料;「手續費」已含在訂單總額內(訂單總額=商品金額+運費+手續費)。
- 商品小計加總:BVSHOP 沒有商品合計欄位,「商品小計加總」是各品項小計(單價 × 數量)的加總;組合商品的金額掛在母項、子品為 0,不會重複計算。
- 狀態類欄位照 BVSHOP 原始值顯示:「付款狀態」「發票開立狀態」「訂單來源」是數字代碼,各值意義見下表說明。
- 運費:訂單的運費在建單與每次重新同步時就由 BVSHOP 的運費寫入,這裡的「運費」是同一筆原始值。
- 公司發票的統編與抬頭寫進訂單的發票資訊:BVSHOP 訂單有統一編號與發票抬頭時,系統寫進訂單的買受人統編與名稱(只補仍為空的欄位,倉管已填的不覆寫;兩者都有時買受人類型設為公司),不另列在這個分頁。
- 載具號碼是個資:「發票載具/捐贈碼」在訂單去識別化時清除。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。
| 欄位 | 中文名 | 對應BVSHOP欄位 | 何時才有值 |
|---|---|---|---|
order.orderItems_totalPrice_sum | 商品小計加總 各品項小計加總(BVSHOP 文件:小計 = price × quantity);BVSHOP 訂單沒有商品合計欄位。組合商品的金額掛在母項、子品為 0,不重複計算;不含後台或 POS 開單加入的自訂金額項目(customizeItems)。 | orderItems[].totalPrice訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
order.discountPrice | 折扣金額 折扣金額(BVSHOP 文件未說明與其他折扣欄位的關係)。 | discountPrice訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.saleDiscountPrice | 活動折扣 活動折扣金額。 | saleDiscountPrice訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.couponDiscountPrice | 優惠碼折扣 優惠碼折扣金額。 | couponDiscountPrice訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.pointDiscountPrice | 購物金折抵 購物金折抵金額。 | pointDiscountPrice訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
| 運費 | |||
order.shippingFee | 運費 運費。 | shippingFee訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.totalPrice | 訂單總額 訂單總額=商品金額(已扣折扣)+運費+手續費。 | totalPrice訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
賣家結算
訂單抓進 Vanta 時即有值。BVSHOP 只提供訂單手續費,不提供平台費用與撥款資料。
| 欄位 | 中文名 | 對應BVSHOP欄位 | 何時才有值 |
|---|---|---|---|
order.fee | 手續費 手續費;BVSHOP 文件的訂單總額公式把它算在訂單總額內(訂單總額=商品金額+運費+手續費)。 | fee訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
付款
訂單抓進 Vanta 時即有值;付款時間在訂單付款後才有。
| 欄位 | 中文名 | 對應BVSHOP欄位 | 何時才有值 |
|---|---|---|---|
order.paymentMethod | 付款方式 付款方式(商家在 BVSHOP 設定的付款方式名稱,例:綠界|信用卡)。 | paymentMethod訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.paymentStatus | 付款狀態 付款狀態原始值:1=未付款、2=已付款、-1=已退款、-4=已逾期(BVSHOP 訂單狀態規則)。 | paymentStatus訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.paidAt | 付款時間 付款時間。 | paidAt訂單明細( orders) | 訂單付款後才有值;系統只抓 BVSHOP 未出貨的單,貨到付款單到貨後才付款,所以不會有值。 |
order.isCod | 貨到付款 是否為貨到付款。 | isCod訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
稅與發票
訂單抓進 Vanta 時即有值;發票號碼與開立時間在 BVSHOP 開立發票後才有。
| 欄位 | 中文名 | 對應BVSHOP欄位 | 何時才有值 |
|---|---|---|---|
order.invoice_no | 發票號碼 發票號碼;尚未開立為空。 | invoice.no訂單明細( orders) | BVSHOP 開立發票後才有值;系統只抓 BVSHOP 未出貨的單,出貨後才開的發票不會進來。 |
order.invoice_date | 發票開立時間 發票開立時間;尚未開立為空。 | invoice.date訂單明細( orders) | BVSHOP 開立發票後才有值;系統只抓 BVSHOP 未出貨的單,出貨後才開的發票不會進來。 |
order.invoice_status | 發票開立狀態 發票開立狀態原始值:0=未開立、1=已開立、2=已作廢。 | invoice.status訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.invoice_carrier | 發票載具/捐贈碼 依發票類型而定:自然人憑證為自然人憑證條碼、手機條碼為手機條碼、捐贈發票為捐贈碼、公司戶發票為統一編號;無資料時為空。 | invoice.carrier訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
對帳鍵
訂單抓進 Vanta 時即有值;物流追蹤碼與分單託運碼在建立託運單後才有。
| 欄位 | 中文名 | 對應BVSHOP欄位 | 何時才有值 |
|---|---|---|---|
order.id | BVSHOP 訂單 ID 訂單 ID(BVSHOP 平台內部編號,回寫物流單號時用)。 | id訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.uid | BVSHOP 訂單編號 訂單編號(即 Vanta 的訂單編號)。 | uid訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.logisticTraceCode | 物流追蹤碼 物流追蹤碼。 | logisticTraceCode訂單明細( orders) | 建立託運單後才有值。 |
order.shippings_shippingCode | 分單託運碼 分單託運碼(shippings 每筆的 shippingCode);一張訂單可能有多張分單託運單(拆包裹)。 | shippings[].shippingCode訂單明細( orders) | 訂單拆成多個包裹時才有值;依 BVSHOP 回傳順序列出。 |
order.orderSource | 訂單來源 訂單來源原始值:0=官網、1=後台手開、2=POS 門市開立、3=API 開立。 | orderSource訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.inventoryPosStoreId | 扣庫存門市 ID 這張訂單實際扣庫存的門市 ID;扣網店庫存時為空。 | inventoryPosStoreId訂單明細( orders) | 訂單扣門市庫存時才有值;扣網店庫存時為空。 |
九、FreeStore
FreeStore 的欄位分在 訂單金額、付款、稅與發票、對帳鍵 四類,全部取自抓單本身的訂單明細,不另打其他 API。FreeStore 沒有賣家結算資料;成本只在 FreeStore 的商品資料裡、訂單上沒有,所以成本也不顯示。頂端摘要卡是訂單總金額、付款方式與付款狀態。
- 建單後只在 FreeStore 通知訂單狀態異動時更新:系統抓到待處理、等待出貨的訂單建單後,會把 FreeStore 的訂單狀態改成處理中,之後輪詢就不再抓這張單;FreeStore 推送訂單狀態異動通知時,系統會重新讀取這張單並更新附加資訊。
- 小計項目逐筆列出:「小計項目」在欄位名稱下方每筆各一列,左邊是 FreeStore 的項目名稱(例:商品小計、優惠券(A1234)、折抵運費(促銷活動))、右邊是金額,順序與 FreeStore 相同;同一類項目可能出現多筆(例:運費與折抵運費),都照列。
- 付款時間以台灣時間解讀:FreeStore 回傳的時間不帶時區,系統當成台灣時間;尚未付款時 FreeStore 回傳的空值(0000-00-00)顯示為空。
- 運費:「運費」同時寫入訂單的運費。
- 付款方式存平台原值:「付款方式代號」是 FreeStore 的付款方式代號,「付款方式」是 FreeStore 的付款方式說明,兩者都照 FreeStore 回傳的值顯示。
- 統編與發票抬頭寫在訂單的發票資訊:買家要開三聯式發票時,FreeStore 的開立統編與發票抬頭會補進訂單的買受人統編與名稱(訂單上已有值就不覆寫),不在這個分頁顯示。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。
| 欄位 | 中文名 | 對應FreeStore欄位 | 何時才有值 |
|---|---|---|---|
order.order_subtotals | 小計項目 訂單小計項目,每筆是項目名稱(order_subtotals 的 name,FreeStore 的顯示名稱,例:商品小計、優惠券(A1234)、折抵運費(促銷活動))與小計金額(order_subtotals 的 value);依 FreeStore 回傳順序列出、不去重。文件列的項目類型(code)為 sub_total、shipping、reward、coupon、site_discount、promotion,回應也可能出現其他類型(例:cod、total)並照存。 | order_subtotals[].value(label: order_subtotals[].name)訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.shipping_fee | 運費 運費(FreeStore 文件:運費);也寫入訂單的運費欄位。 | shipping_fee訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.total | 訂單總金額 訂單總金額(FreeStore 文件:訂單總金額)。 | total訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
付款
訂單抓進 Vanta 時即有值;付款時間在買家付款後才有。
| 欄位 | 中文名 | 對應FreeStore欄位 | 何時才有值 |
|---|---|---|---|
order.payment_code | 付款方式代號 FreeStore 回傳的付款方式代號原始值(FreeStore 文件:付款方式代號;例:allpay_credit、allpay_c2c、cod)。 | payment_code訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.payment_method | 付款方式 FreeStore 回傳的付款方式說明原始值(FreeStore 文件:付款方式說明)。 | payment_method訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.payment_status | 付款狀態 FreeStore 回傳的付款狀態原始值(FreeStore 文件:PAID=已付款、UNPAID=尚未付款)。 | payment_status訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.payment_time | 付款時間 付款時間(FreeStore 文件:付款時間);FreeStore 的時間不帶時區,以台灣時間解讀。 | payment_time訂單明細( orders) | 買家付款後才有值;貨到付款訂單在出貨前為空。 |
order.currency_code | 幣別 訂單幣別(FreeStore 文件:幣別;例:TWD)。 | currency_code訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
稅與發票
FreeStore 開立發票後才有發票號碼;載具與愛心碼只在買家結帳時有填才有值。開立統編與發票抬頭寫在訂單的發票資訊,不在這裡。
| 欄位 | 中文名 | 對應FreeStore欄位 | 何時才有值 |
|---|---|---|---|
order.invoice_number | 發票號碼 發票號碼(FreeStore 文件:發票號碼)。 | invoice_number訂單明細( orders) | FreeStore 開立發票後才有值。 |
order.invoice_carrier_num | 載具編號 載具編號(FreeStore 文件:載具編號)。 | invoice_carrier_num訂單明細( orders) | 買家結帳時有填載具才有值。 |
order.invoice_lovecode | 捐贈愛心碼 捐贈愛心碼(FreeStore 文件:捐贈愛心碼)。 | invoice_lovecode訂單明細( orders) | 買家結帳時選擇捐贈發票才有值。 |
對帳鍵
訂單抓進 Vanta 時即有值;包裹追蹤碼在出貨回傳追蹤碼後才有,UTM 只有從帶參數的網址導購的訂單才有。
| 欄位 | 中文名 | 對應FreeStore欄位 | 何時才有值 |
|---|---|---|---|
order.order_id | FreeStore 訂單編號 FreeStore 訂單編號(FreeStore 文件:訂單編號,10 碼數字);與 Vanta 的訂單編號相同。 | order_id訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.bb_id | Buy Button 編號 FreeStore 回傳的 Buy Button 專屬編號原始值(FreeStore 文件:Buy Button 專屬編號)。 | bb_id訂單明細( orders) | 訂單抓進 Vanta 時即有值。 |
order.tracking_number | 包裹追蹤碼 包裹追蹤碼(FreeStore 文件:包裹追蹤碼)。 | tracking_number訂單明細( orders) | 出貨後回傳追蹤碼給 FreeStore 才有值。 |
order.utm_source | UTM 來源 導購網址的 utm_source(FreeStore 文件:網址帶參數 ?utm_source=OOOOO 導購的訂單)。 | utm_source訂單明細( orders) | 只有從帶 UTM 參數的網址導購的訂單才有值。 |
order.utm_medium | UTM 媒介 導購網址的 utm_medium(FreeStore 文件:utm_medium)。 | utm_medium訂單明細( orders) | 只有從帶 UTM 參數的網址導購的訂單才有值。 |
order.utm_campaign | UTM 活動 導購網址的 utm_campaign(FreeStore 文件:utm_campaign)。 | utm_campaign訂單明細( orders) | 只有從帶 UTM 參數的網址導購的訂單才有值。 |
十、Cyberbiz
Cyberbiz 的欄位分在 訂單金額、付款、稅與發票、對帳鍵、成本 五類;Cyberbiz 沒有賣家結算欄位。全部取自抓單的同一支 Cyberbiz 訂單 API(GET /v1/orders),頂端摘要卡是「訂單總金額」、「付款方式」與「付款狀態」。
- 金額是新台幣:Cyberbiz 訂單沒有幣別欄位,一律以新台幣存。
- 跟著抓單更新:系統只匯入 Cyberbiz「開立中、已付款或貨到付款、未出貨」的訂單,每次抓到時一併更新;訂單在 Cyberbiz 出貨或取消後就不再更新,之後才產生的發票與配送單號不會補上。
- 運費:「運費」會在建單時寫入訂單的運費;功能上線前已匯入的訂單,在第一次取到附加資訊時補上。只寫仍為空的運費,不會覆蓋已有的值。
- 發票統編與抬頭寫在訂單上:Cyberbiz 發票的統編與抬頭不在本頁,會寫進訂單的發票資訊(買受人統編、名稱),只補仍為空的欄位,不覆蓋已填的值;兩者都有時買受人類型設為公司。
- 多筆值的欄位:優惠券、多付款方式、品項、配送類欄位一筆訂單可能有多個值,依 Cyberbiz 的順序列出。「優惠券折扣」、「多付款方式」與「商品成本」在欄位名稱下方每筆各一列,左邊是優惠券名稱、付款名稱或品項 SKU(品項沒有 SKU 時用品項名稱)、右邊是金額,缺值顯示 -;其他多值欄位依同樣順序列出,沒有值的位置顯示 -。
- 文件沒說明的欄位照原值存:「第三方折扣」、「POS 相關資訊」Cyberbiz 文件沒有說明語意,「商品成本」沒說明是單位成本還是小計,都照平台原值存、不另推算。
- 個資:「手機條碼載具」與「發票捐贈碼」在訂單去識別化時清除。
訂單金額
| 欄位 | 中文名 | 對應Cyberbiz欄位 | 何時才有值 |
|---|---|---|---|
| 商品金額 | |||
prices.total_line_items_price | 商品總金額 商品總金額。 | prices.total_line_items_price訂單價格資訊( orders) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
prices.special_collection_discount | 行銷活動折扣 行銷活動折扣。 | prices.discounts.special_collection_discount訂單價格資訊( orders) | 訂單抓進 Vanta 時即有值。 |
prices.vip_discount | VIP 折扣 VIP 折扣。 | prices.discounts.vip_discount訂單價格資訊( orders) | 訂單抓進 Vanta 時即有值。 |
prices.shop_discount_name | 全館活動名稱 全館活動名稱。 | prices.discounts.shop_discount.name訂單價格資訊( orders) | 訂單套用全館活動時才有值。 |
prices.shop_discount_amount | 全館活動折扣 全館活動折扣。 | prices.discounts.shop_discount.amount訂單價格資訊( orders) | 訂單套用全館活動時才有值。 |
prices.coupon_discounts_code | 優惠券代碼 各優惠券代碼,依優惠券明細順序列出,與「優惠券折扣」逐筆對應;沒有代碼的優惠券為 null。 | prices.discounts.coupon_discounts[].code訂單價格資訊( orders) | 買家使用優惠券時才有值;一張訂單可使用多張。 |
prices.coupon_discounts_amount | 優惠券折扣 各優惠券的折扣,每筆是優惠券名稱(coupon_discounts 的 name)與折扣金額(coupon_discounts 的 amount),依優惠券明細順序列出。 | prices.discounts.coupon_discounts[].amount(label: prices.discounts.coupon_discounts[].name)訂單價格資訊( orders) | 買家使用優惠券時才有值;一張訂單可使用多張。 |
prices.bonus_consumed | 紅利折扣 紅利折扣。 | prices.discounts.bonus_consumed訂單價格資訊( orders) | 訂單抓進 Vanta 時即有值。 |
prices.price_discount | 店長折扣 店長折扣。 | prices.discounts.price_discount訂單價格資訊( orders) | 訂單抓進 Vanta 時即有值。 |
prices.third_party_discount | 第三方折扣 Cyberbiz 文件只寫「third party discount」,未說明折扣來源與由誰負擔;照原值存。 | prices.discounts.third_party_discount訂單價格資訊( orders) | 訂單抓進 Vanta 時即有值。 |
| 運費 | |||
prices.shipping_rate_price | 運費 運費。訂單的運費也取此值。 | prices.shipping_rate_price訂單價格資訊( orders) | 訂單抓進 Vanta 時即有值。 |
prices.total_price | 訂單總金額 訂單總金額。 | prices.total_price訂單價格資訊( orders) | 訂單抓進 Vanta 時即有值。 |
付款
| 欄位 | 中文名 | 對應Cyberbiz欄位 | 何時才有值 |
|---|---|---|---|
payment.payment_name | 付款方式 付款方式,照 Cyberbiz 原值。 | payment_name訂單付款資訊( orders) | 訂單抓進 Vanta 時即有值。 |
payment.payment_method | 付款方式名稱 付款方式名稱,照 Cyberbiz 原值。 | payment_method訂單付款資訊( orders) | 訂單抓進 Vanta 時即有值。 |
payment.multiple_payment_infos_amount | 多付款方式 多付款方式的各筆付款,每筆是付款名稱(multiple_payment_infos 的 name)與付款金額(multiple_payment_infos 的 amount),依付款資訊順序列出。 | multiple_payment_infos[].amount(label: multiple_payment_infos[].name)訂單付款資訊( orders) | 訂單以多種付款方式付款時才有值。 |
payment.financial_status | 付款狀態 付款狀態原始值(例:paid、cod)。 | statuses.financial_status訂單付款資訊( orders) | 訂單抓進 Vanta 時即有值。 |
稅與發票
| 欄位 | 中文名 | 對應Cyberbiz欄位 | 何時才有值 |
|---|---|---|---|
order.invoice_no | 電子發票號碼 電子發票號碼。 | einvoice.invoice_no訂單資訊( orders) | Cyberbiz 開立發票後才有值。 |
order.invoice_status | 發票狀態 發票狀態,照 Cyberbiz 原值。 | einvoice.invoice_status訂單資訊( orders) | Cyberbiz 開立發票後才有值。 |
order.paper_invoice_no | 紙本發票號碼 紙本發票號碼。 | paper_invoice_no訂單資訊( orders) | 開立紙本發票時才有值。 |
order.phone_barcode | 手機條碼載具 手機條碼載具號碼。訂單去識別化時清除。 | einvoice.phone_barcode訂單資訊( orders) | 買家以手機條碼載具索取發票時才有值。 |
order.love_code | 發票捐贈碼 發票捐贈碼。訂單去識別化時清除。 | einvoice.love_code訂單資訊( orders) | 買家捐贈發票時才有值。 |
order.line_items_tax_type_id | 商品課稅類別 各品項的商品課稅類別(inclusive_tax:應稅;zero_tax:零稅率;exclusive_tax:免稅),依品項順序列出,沒有值的品項為 null。 | line_items[].tax_type_id訂單資訊( orders) | 訂單抓進 Vanta 時即有值。 |
對帳鍵
| 欄位 | 中文名 | 對應Cyberbiz欄位 | 何時才有值 |
|---|---|---|---|
order.id | Cyberbiz 訂單 ID Cyberbiz 訂單 ID,對應 Cyberbiz API。 | id訂單資訊( orders) | 訂單抓進 Vanta 時即有值。 |
order.order_number | Cyberbiz 訂單編號 Cyberbiz 訂單編號。 | order_number訂單資訊( orders) | 訂單抓進 Vanta 時即有值。 |
order.tracking_number | 配送單號 各配送資訊的配送單號,依配送順序列出。 | fulfillments[].tracking_number訂單資訊( orders) | Cyberbiz 建立配送資訊後才有值;一張訂單可有多筆配送。 |
order.transaction_number | 第三方交易編號 第三方交易編號。 | transaction_number訂單資訊( orders) | 訂單抓進 Vanta 時即有值。 |
order.merchant_trade_no | 第三方串接編號 第三方串接編號。 | merchant_trade_no訂單資訊( orders) | 訂單抓進 Vanta 時即有值。 |
order.from_device | 訂單來源 訂單來源,照 Cyberbiz 原值。 | from_device訂單資訊( orders) | 訂單抓進 Vanta 時即有值。 |
order.pos_shop_id | POS 店家 ID POS 銷售員所屬店家 ID。 | pos_info.pos_shop_id訂單資訊( orders) | POS 訂單才有值。 |
order.pos_id | POS 機 ID 訂單銷售使用的 POS 機 ID。 | pos_info.pos_id訂單資訊( orders) | POS 訂單才有值。 |
order.pos_name | POS 機名稱 訂單銷售使用的 POS 機名稱。 | pos_info.pos_name訂單資訊( orders) | POS 訂單才有值。 |
order.pos_info | POS 相關資訊 Cyberbiz 文件只寫「Pos 相關資訊」,未說明內容;照原值存。 | pos_info.pos_info訂單資訊( orders) | POS 訂單才有值。 |
order.branch_store_no | 自取門市編號 自取門市編號。 | branch_store.store_no訂單資訊( orders) | 買家選擇門市自取時才有值。 |
order.branch_store_name | 自取門市名稱 自取門市名稱。 | branch_store.name訂單資訊( orders) | 買家選擇門市自取時才有值。 |
成本
商家在 Cyberbiz 設定了商品成本才有值。
| 欄位 | 中文名 | 對應Cyberbiz欄位 | 何時才有值 |
|---|---|---|---|
order.line_items_cost | 商品成本 各品項的成本,每筆是品項 SKU(沒有 SKU 時用品項名稱)與成本(line_items 的 cost),依品項順序列出。Cyberbiz 文件未說明是單位成本還是小計,照原值存。 | line_items[].cost(label: line_items[].sku)訂單資訊( orders) | 同本類說明 |
十一、EasyStore
EasyStore 的欄位分在 訂單金額、賣家結算、付款、稅與發票、對帳鍵 五類,全部取自抓單本身的訂單明細,不另打其他 API;EasyStore 沒有成本欄位。頂端摘要卡是訂單總額、付款狀態與交易手續費總計。
- 只在訂單待出貨期間更新:系統只抓 EasyStore 已付款或貨到付款、尚未出貨的訂單,抓到時一併更新;訂單出貨或取消後 EasyStore 端的變動不會回寫。
- 賣家結算只有交易手續費總計:「交易手續費總計」照 EasyStore 原值存,EasyStore 文件沒有說明這筆費用由買家或賣家負擔。
- 交易、稅項、折扣碼每筆一列:「交易」「稅項」「折扣碼」依 EasyStore 回傳順序列出名稱與金額;失敗的交易也會列出,請對照「交易狀態」。
- 運費:「運費」與訂單本身的運費取自同一個 EasyStore 欄位。
- 發票:EasyStore 沒有發票欄位,稅與發票只有含稅標記、稅額與稅項。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。
| 欄位 | 中文名 | 對應EasyStore欄位 | 何時才有值 |
|---|---|---|---|
order.total_line_item_price | 品項合計 訂單所有品項的價格總計(EasyStore 文件:The total price of all line items in the order);實錄資料中為品項折扣前的定價合計。 | total_line_item_price訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.subtotal_price | 商品小計 EasyStore 文件寫為折扣與稅前的品項價格總計(The total price of all items before discounts and taxes);但實錄資料中已扣除品項折扣(等於各品項折後金額合計),與「品項合計」不同。 | subtotal_price訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
order.total_discount | 折扣總額 訂單套用的折扣總額(EasyStore 文件:The total amount of discounts applied to the order)。 | total_discount訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.discount_codes | 折扣碼 訂單套用的各折扣碼與其金額(EasyStore 文件:The list of discount codes applied to the order),依 EasyStore 回傳順序列出。 | discount_codes[].amount(label: discount_codes[].code)訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.total_credit_used | 購物金折抵 訂單使用的購物金總額(EasyStore 文件:The total amount of credit used for the order)。 | total_credit_used訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
| 運費 | |||
order.total_shipping_fee | 運費 訂單的運費總計(EasyStore 文件:The total shipping fee for the order);訂單的運費也取自此欄。 | total_shipping_fee訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.total_price | 訂單總額 訂單最終總額(EasyStore 文件:The final total price of the order)。 | total_price訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
賣家結算
訂單抓進 Vanta 時即有值。EasyStore 只提供交易手續費總計,不提供平台費用與撥款資料。
| 欄位 | 中文名 | 對應EasyStore欄位 | 何時才有值 |
|---|---|---|---|
order.total_transaction_fee | 交易手續費總計 訂單的交易手續費總計(EasyStore 文件:The total transaction fee for the order);文件未說明由買家或賣家負擔。 | total_transaction_fee訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
付款
訂單抓進 Vanta 時即有值;交易紀錄只反映最後一次抓單時的內容。
| 欄位 | 中文名 | 對應EasyStore欄位 | 何時才有值 |
|---|---|---|---|
order.financial_status | 付款狀態 訂單的付款狀態原始值(EasyStore 文件:The financial status of the order;例:paid、unpaid、partially_paid)。 | financial_status訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.currency_code | 幣別 訂單成立時的幣別代碼(EasyStore 文件:The currency code in which the order was placed)。 | currency_code訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.cod_type | 貨到付款類型 貨到付款類型原始值(EasyStore 文件:0 表示不是貨到付款訂單、1 表示貨到付款訂單;其他值文件未定義)。 | cod_type訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.transactions_amount | 交易 各筆交易的付款閘道原始值(例:cod、linepay、bank-transfer)與金額,依 EasyStore 交易順序列出;失敗的交易也會列出,請對照交易狀態。 | transactions[].amount(label: transactions[].gateway)訂單明細( orders.json) | 只反映最後一次抓單時的交易;依 EasyStore 交易順序列出,失敗的交易也會列出。 |
order.transactions_status | 交易狀態 各筆交易的狀態原始值(例:pending、success、failed);文件未列出所有可能值。 | transactions[].status訂單明細( orders.json) | 只反映最後一次抓單時的交易;依 EasyStore 交易順序列出。 |
稅與發票
訂單抓進 Vanta 時即有值。EasyStore 沒有發票欄位。
| 欄位 | 中文名 | 對應EasyStore欄位 | 何時才有值 |
|---|---|---|---|
order.taxes_included | 價格含稅 品項價格是否含稅(EasyStore 文件:Indicates if taxes are included in the line items price)。 | taxes_included訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.total_tax | 稅額總計 訂單的稅額總計(EasyStore 文件:The total tax amount for the order)。 | total_tax訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.tax_line_price | 稅項 各稅項的名稱(例:GST)與稅額(EasyStore 文件:The tax line details for the order),依 EasyStore 順序列出。 | tax_line[].price(label: tax_line[].name)訂單明細( orders.json) | 訂單有稅項時才有值。 |
order.tax_line_rate | 稅率 各稅項的稅率原始值,依 EasyStore 順序列出;文件未說明單位。 | tax_line[].rate訂單明細( orders.json) | 訂單有稅項時才有值。 |
對帳鍵
訂單抓進 Vanta 時即有值;出貨紀錄在 EasyStore 建立出貨後才有。
| 欄位 | 中文名 | 對應EasyStore欄位 | 何時才有值 |
|---|---|---|---|
order.id | EasyStore 訂單 ID EasyStore 平台內部的訂單識別碼(EasyStore 文件:The unique identifier for the order),與訂單編號不同。 | id訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.order_number | EasyStore 訂單編號 顯示給顧客的訂單編號(EasyStore 文件:The order number displayed to the customer)。 | order_number訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.source_type | 訂單來源 建立訂單的來源原始值(EasyStore 文件:The source where the order was created;例:online_store、admin_panel)。 | source_type訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.transactions_id | 交易 ID 各筆交易的 EasyStore 交易識別碼,依 EasyStore 交易順序列出。 | transactions[].id訂單明細( orders.json) | 訂單抓進 Vanta 時即有值。 |
order.fulfillments_id | 出貨 ID 各筆出貨的 EasyStore 出貨識別碼(EasyStore 文件:The list of fulfillments associated with the order),依 EasyStore 順序列出。 | fulfillments[].id訂單明細( orders.json) | EasyStore 建立出貨後才有值。 |
order.fulfillments_tracking_number | 物流單號 各筆出貨的物流單號,依 EasyStore 順序列出。 | fulfillments[].tracking_number訂單明細( orders.json) | EasyStore 建立出貨並填了物流單號後才有值。 |
order.fulfillments_tracking_company | 物流商 各筆出貨的物流商名稱,依 EasyStore 順序列出。 | fulfillments[].tracking_company訂單明細( orders.json) | EasyStore 建立出貨並填了物流商後才有值。 |
十二、1shop
1shop 的欄位分在 訂單金額、付款、稅與發票、對帳鍵 四類,全部取自抓單本身的訂單明細,不另打其他 API;1shop 沒有賣家結算與成本類欄位。頂端摘要卡是總金額、付款方式與付款狀態。
- 只在 1shop 端未出貨期間更新:系統只抓 1shop 等待確認或已確認、已付款或貨到付款、尚未出貨的訂單,抓到時一併更新;1shop 端出貨或取消後的變動不會回寫,所以貨到付款單的付款日期、出貨後才開的發票與退款都不會出現。
- 金流費用放在訂單金額:1shop 文件把它列在購物車金額內,未說明由買家加收或從賣家款項扣除,所以照文件歸在訂單金額、不列入賣家結算。
- 狀態類欄位照 1shop 原始值顯示:「付款方式」「付款狀態」「課稅別」是 1shop 的代碼,各值意義見下表說明。
- 一張訂單可有多張發票:發票欄位依 1shop 回傳順序每張一個值,同一個位置是同一張發票。
- 運費:訂單的運費在建單與每次重新同步時就由 1shop 的物流費用寫入,這裡的「物流費用」是同一筆原始值。
- 公司發票的統編與抬頭寫進訂單的發票資訊:1shop 發票資料有統編與發票抬頭時,系統取第一張兩者都有的發票,寫進訂單的買受人統編與名稱(只補仍為空的欄位,倉管已填的不覆寫;兩者都有時買受人類型設為公司),不另列在這個分頁。
- 載具號碼是個資:「發票載具」在訂單去識別化時清除。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。
| 欄位 | 中文名 | 對應1shop欄位 | 何時才有值 |
|---|---|---|---|
order.sub_total | 購物車小計 購物車小計,包含所有 single 單個產品、bundle 組合、charge 費用。 | cart.sub_total訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
order.payment_fee | 金流費用 金流費用;1shop 文件把它列在購物車金額內,未說明由買家加收或從賣家款項扣除。 | cart.payment_fee訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
| 運費 | |||
order.logistic_fee | 物流費用 物流費用。 | cart.logistic_fee訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
| 退款 | |||
order.refund | 退款金額 退款金額。 | cart.refund訂單明細( {order_number}) | 退款後才有金額;系統只抓 1shop 未出貨的單,出貨後的退款不會進來。 |
order.total_price | 總金額 總金額(1shop 文件未說明計算方式)。 | cart.total_price訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
付款
訂單抓進 Vanta 時即有值;付款日期在訂單付款後才有。
| 欄位 | 中文名 | 對應1shop欄位 | 何時才有值 |
|---|---|---|---|
order.payment | 付款方式 付款方式原始值:atm=ATM轉帳、cod=貨到付款、credit=信用卡、credit3/credit6/credit12/credit24=信用卡分 3/6/12/24 期、regular=定期定額、paypal=PayPal、code=超商代碼、vacc=虛擬帳戶、c2c=超商取貨時付款、linepay=LINE Pay、icash=icash Pay、applepay=Apple Pay、nocard3/nocard6/nocard12/nocard24=無卡分期 3/6/12/24 期、nopay=不需付款。 | order.payment訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
order.payment_status | 付款狀態 付款狀態原始值:pending=等待付款、need_confirm=待確認付款、paid=已付款、cod=貨到付款、refunded=已退款。 | order.payment_status訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
order.payment_date | 付款日期 付款日期;照 1shop 原字串存(例:2022-04-19 18:47:35),1shop 文件未註明時區。 | order.payment_date訂單明細( {order_number}) | 訂單付款後才有值;系統只抓 1shop 未出貨的單,貨到付款單到貨後才付款,所以不會有值。 |
稅與發票
1shop 建立發票資料後才有值;發票號碼在發票開立後才有。
| 欄位 | 中文名 | 對應1shop欄位 | 何時才有值 |
|---|---|---|---|
order.receipt_tax_type | 課稅別 課稅別原始值:1=應稅、2=零稅率、3=免稅、4=混合應稅與免稅;每張發票一個值,依 1shop 回傳順序列出。 | receipt[].tax_type訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
order.receipt_carruer_num | 發票載具 手機條碼或自然人憑證(個人發票才有);每張發票一個值,依 1shop 回傳順序列出。1shop 欄位名原文為 carruer_num。 | receipt[].carruer_num訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
order.receipt_invoice_number | 發票號碼 發票號碼;每張發票一個值,依 1shop 回傳順序列出。 | receipt[].invoice_number訂單明細( {order_number}) | 發票開立後才有值;系統只抓 1shop 未出貨的單,出貨後才開的發票不會進來。 |
對帳鍵
訂單抓進 Vanta 時即有值;第三方金流單號在訂單付款後才有。
| 欄位 | 中文名 | 對應1shop欄位 | 何時才有值 |
|---|---|---|---|
order.order_number | 1shop 訂單號碼 訂單號碼(即 Vanta 的訂單編號)。 | order.order_number訂單明細( {order_number}) | 訂單抓進 Vanta 時即有值。 |
order.payment_third_party_no | 第三方金流單號 付款成功第三方單號,例如綠界號碼。 | order.payment_third_party_no訂單明細( {order_number}) | 訂單付款成功後才有值。 |
十三、Coupang 酷澎
Coupang 的欄位分在 訂單金額、付款、稅與發票、對帳鍵 四類;Coupang 台灣沒有賣家結算與成本欄位(賣家結算 API 在台灣不提供,佣金與撥款請看 Coupang Wing 後台的報表)。全部取自抓單的同一支 Coupang 訂單 API(ordersheets),頂端摘要卡是「付款時間」、「貨到付款」與「發票類型」。
- 沒有訂單總額:Coupang 不提供訂單層的總額,訂單金額依品項與出貨箱逐筆列出,系統不另行加總。
- 跟著抓單更新:系統輪詢只抓 Coupang「付款完成」狀態的訂單,每次抓到時一併更新;訂單在 Coupang 接單、進入出貨流程後就不再被輪詢抓到,之後才上傳的運單號碼不會由輪詢補上。拆成多個出貨箱的訂單逐箱確認出貨,某一輪只抓到部分出貨箱時,附加資訊維持上一次抓到全部出貨箱時的內容。
- 品項與出貨箱:一張 Coupang 訂單可拆成多個出貨箱。品項金額每筆左邊是品項的選項 ID(vendorItemId),照 Coupang 回傳的品項列出(含已取消的品項);「運費」、「偏遠地區運費」與「貨到付款運費」每筆左邊是出貨箱 ID;「出貨箱 ID」與「運單號碼」依出貨箱順序列出,沒有值的位置顯示 -。
- 運費:訂單本身的運費照原本規則取第一箱的運費,本頁的運費只是逐箱列出原始值、不會改寫訂單。
- 發票資訊照原值存:稅與發票的欄位取自 Coupang 訂單的附加屬性(extraProperties),照原值存;Coupang 文件沒說明兩個請款金額與品項金額的關係,不另推算。
- 個資:「發票適用值」在訂單去識別化時清除。
訂單金額
訂單抓進 Vanta 時即有值。Coupang 沒有訂單層的總額欄位,金額依品項與出貨箱逐筆列出。
| 欄位 | 中文名 | 對應Coupang 酷澎欄位 | 何時才有值 |
|---|---|---|---|
| 商品金額 | |||
order.orderItems_salesPrice | 品項單價 各品項的單件商品價格,每筆是品項的選項 ID(vendorItemId)與單價,依出貨箱與品項順序列出。 | orderItems[].salesPrice(label: orderItems[].vendorItemId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.orderItems_orderPrice | 品項付款金額 各品項的付款價格(Coupang 文件:salesPrice × shippingCount),每筆是品項的選項 ID(vendorItemId)與金額,依出貨箱與品項順序列出。 | orderItems[].orderPrice(label: orderItems[].vendorItemId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
order.orderItems_discountPrice | 品項總折扣 各品項的總折扣價格(Coupang 文件:instantCouponDiscount + downloadableCouponDiscount + coupangDiscount),每筆是品項的選項 ID(vendorItemId)與金額。 | orderItems[].discountPrice(label: orderItems[].vendorItemId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.orderItems_instantCouponDiscount | 即時折扣優惠券 各品項的即時折扣優惠券折扣金額,每筆是品項的選項 ID(vendorItemId)與金額。 | orderItems[].instantCouponDiscount(label: orderItems[].vendorItemId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.orderItems_downloadableCouponDiscount | 下載優惠券 各品項的下載優惠券折扣金額,每筆是品項的選項 ID(vendorItemId)與金額。 | orderItems[].downloadableCouponDiscount(label: orderItems[].vendorItemId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.orderItems_coupangDiscount | Coupang 支援折扣 各品項由 Coupang 支援的購物車/分類優惠券等折扣金額,每筆是品項的選項 ID(vendorItemId)與金額。 | orderItems[].coupangDiscount(label: orderItems[].vendorItemId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
| 運費 | |||
order.shippingPrice | 運費 各出貨箱的運費,每筆是出貨箱 ID(shipmentBoxId)與金額。訂單的運費取第一箱的值。 | shippingPrice(label: shipmentBoxId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.remotePrice | 偏遠地區運費 各出貨箱的偏遠地區(山區、離島)運費,每筆是出貨箱 ID(shipmentBoxId)與金額。 | remotePrice(label: shipmentBoxId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.codDeliveryFee | 貨到付款運費 各出貨箱的貨到付款(COD)運費,每筆是出貨箱 ID(shipmentBoxId)與金額。 | codDeliveryFee(label: shipmentBoxId)訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
付款
| 欄位 | 中文名 | 對應Coupang 酷澎欄位 | 何時才有值 |
|---|---|---|---|
order.paidAt | 付款時間 付款時間。 | paidAt訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.isCod | 貨到付款 訂單是否為貨到付款(COD)。 | isCod訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.currencyCode | 幣別 幣別代碼(ISO-4217,三碼大寫)。Coupang 每個金額物件各帶幣別,這裡取第一箱運費的幣別。 | shippingPrice.currencyCode訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
稅與發票
訂單抓進 Vanta 時即有值;Coupang 只在支援發票的市場回傳發票資訊。
| 欄位 | 中文名 | 對應Coupang 酷澎欄位 | 何時才有值 |
|---|---|---|---|
order.taxReceiptInfo_receiptOption | 發票選項 發票(收據)選項,Coupang 原始值(PAPER、E-GUI)。 | extraProperties.taxReceiptInfo.receiptOption訂單明細( ordersheets) | Coupang 回傳發票資訊(extraProperties.taxReceiptInfo)時才有值。 |
order.taxReceiptInfo_appliedType | 發票類型 發票適用類型,Coupang 原始值(PERSONAL_COUPANG_MEMBER_CARRIER、PERSONAL_MOBILE_BARCODE_CARRIER、DONATION、BUSINESS)。 | extraProperties.taxReceiptInfo.appliedType訂單明細( ordersheets) | Coupang 回傳發票資訊(extraProperties.taxReceiptInfo)時才有值。 |
order.taxReceiptInfo_appliedValue | 發票適用值 發票適用值(Coupang 文件:整合收據號碼/資訊),照原值存。訂單去識別化時清除。 | extraProperties.taxReceiptInfo.appliedValue訂單明細( ordersheets) | Coupang 回傳發票資訊、且發票適用類型帶有值時才有值。 |
order.invoiceAmountInfo_invoiceAmountToBuyer | 買家請款金額 向買家開立(請款)的金額。Coupang 文件未說明與品項金額的關係,照原值存。 | extraProperties.invoiceAmountInfo.invoiceAmountToBuyer訂單明細( ordersheets) | Coupang 回傳發票金額資訊(extraProperties.invoiceAmountInfo)時才有值。 |
order.invoiceAmountInfo_invoiceAmountToCoupang | Coupang 請款金額 向 Coupang 開立(請款)的金額。Coupang 文件未說明與品項金額的關係,照原值存。 | extraProperties.invoiceAmountInfo.invoiceAmountToCoupang訂單明細( ordersheets) | Coupang 回傳發票金額資訊(extraProperties.invoiceAmountInfo)時才有值。 |
order.invoiceAmountInfo_currency | 發票金額幣別 發票金額的幣別代碼。 | extraProperties.invoiceAmountInfo.currency訂單明細( ordersheets) | Coupang 回傳發票金額資訊(extraProperties.invoiceAmountInfo)時才有值。 |
對帳鍵
| 欄位 | 中文名 | 對應Coupang 酷澎欄位 | 何時才有值 |
|---|---|---|---|
order.orderId | Coupang 訂單編號 Coupang 訂單編號,即 Vanta 的訂單編號。 | orderId訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.shipmentBoxId | 出貨箱 ID 各出貨箱的出貨編號(shipmentBoxId),依出貨箱順序列出;即出貨單的平台出貨編號。 | shipmentBoxId訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
order.invoiceNumber | 運單號碼 各出貨箱的運單號碼,依出貨箱順序列出,沒有值的箱為 null。 | invoiceNumber訂單明細( ordersheets) | 出貨箱上傳運單號碼後才有值。 |
order.refer | 付款位置 付款位置,Coupang 原始值(例:아이폰앱、안드로이드앱、PC웹)。 | refer訂單明細( ordersheets) | 訂單抓進 Vanta 時即有值。 |
十四、露天
露天的欄位分在 訂單金額、賣家結算、付款、對帳鍵 四類,全部取自抓單本身的訂單明細,不另打其他 API。露天的訂單明細沒有發票資料,也沒有成本欄位,所以稅與發票與成本不顯示。頂端摘要卡是結帳總金額、賣家實收金額與付款狀態。
- 只在訂單待確認、待出貨期間更新:系統每次抓單都會重新讀取建立 7 天內、待確認或待出貨的露天訂單並一併更新;訂單出貨或取消後露天端的變動不會回寫。
- 品項金額每個品項一列:「商品原價」「商品活動價格」在欄位名稱下方每個品項各一列,左邊是商品名稱與規格名稱、右邊是單價(不是乘上數量的小計),順序與露天相同。
- 賣家實收金額照露天原值:「賣家實收金額」是露天回傳的賣家實收金額,露天文件沒有說明是否已扣除手續費,也沒有手續費欄位。
- 運費:「買家實付運費」與訂單本身的運費取自同一個露天欄位。
- 付款方式與狀態存平台原值:「付款方式代碼」「付款狀態」照露天回傳的代碼顯示(例:PP_CRD、Paid、Transfer)。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。
| 欄位 | 中文名 | 對應露天欄位 | 何時才有值 |
|---|---|---|---|
| 商品金額 | |||
order.item_list_original_price | 商品原價 各品項的商品原價(露天文件:商品原價),標籤為商品名稱與規格名稱,依露天回傳順序列出;為單價,數量見訂單品項。 | item_list[].original_price(label: item_list[].item_name)訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.item_list_discount_price | 商品活動價格 各品項的商品活動價格(露天文件:商品有參與折扣活動顯示折扣後商品價格,未參與時等同商品原價),標籤為商品名稱與規格名稱,依露天回傳順序列出;為單價。 | item_list[].discount_price(label: item_list[].item_name)訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.item_amount | 商品金額小計 訂單商品金額小計(露天文件:訂單商品金額小計)。 | checkout_info.item_amount訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
order.coupon_from_ruten | 露天折扣碼折抵 露天折扣碼折抵金額(露天文件:露天折扣碼折抵金額,0 代表未使用)。 | checkout_info.coupon_from_ruten訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.coupon_from_seller | 賣家折扣碼折抵 賣家折扣碼折抵金額(露天文件:賣場折扣碼折抵金額,0 代表未使用)。 | checkout_info.coupon_from_seller訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.rpoint | 露幣折抵 露幣折抵金額(露天文件:露幣折抵金額)。 | checkout_info.rpoint訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
| 運費 | |||
order.original_shipping_fee | 原始運費 原始運費(露天文件:原始運費)。 | checkout_info.original_shipping_fee訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.buyer_paid_shipping_fee | 買家實付運費 買家實際支付運費(露天文件:買家實際支付運費);訂單的運費也取自此欄。 | checkout_info.buyer_paid_shipping_fee訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.total_amount | 結帳總金額 結帳總金額(露天文件:買家有修改訂單金額時為修改後的結帳金額;未修改時為訂單商品金額小計 − 露天/賣家折扣碼折抵金額 + 買家實際支付運費 − 露幣折抵金額)。 | checkout_info.total_amount訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
賣家結算
訂單抓進 Vanta 時即有值;撥款時間在露天撥款後才有。露天文件沒有手續費或佣金欄位。
| 欄位 | 中文名 | 對應露天欄位 | 何時才有值 |
|---|---|---|---|
order.order_income | 賣家實收金額 賣家實收金額(露天文件:賣家實收金額);文件未說明是否已扣除手續費。 | checkout_info.order_income訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.transfer_time | 撥款時間 撥款時間(露天文件:露天支援金流為撥款時間;賣家自有金流此欄為空)。 | payment_info.transfer_time訂單明細( detail) | 露天撥款後才有值;賣家自有金流的訂單一律為空。 |
付款
訂單抓進 Vanta 時即有值;付款時間在買家付款後才有。
| 欄位 | 中文名 | 對應露天欄位 | 何時才有值 |
|---|---|---|---|
order.pay_way | 付款方式代碼 露天回傳的付款方式代碼原始值(露天文件:付款方式代碼,代碼說明見附錄「付款方式對照表」;例:PP_CRD、FAMI_COD)。 | payment_info.pay_way訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.pay_status | 付款狀態 露天回傳的付款狀態原始值(露天文件:露天支援金流為 Unpaid 尚未付款、Paid 已付款、Transfer 已撥款、Delay 延遲撥款、Pause 暫停撥款、PauseRefund 暫停撥款結案退款;賣家自有金流為 PaymentUnnotified 尚未通知付款、PaymentNotified 已通知付款)。 | payment_info.pay_status訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.pay_time | 付款時間 付款時間(露天文件:露天支援金流為付款成功時間;賣家自有金流此欄為空)。 | payment_info.pay_time訂單明細( detail) | 買家付款後才有值;賣家自有金流的訂單一律為空。 |
對帳鍵
訂單抓進 Vanta 時即有值;物流追蹤碼在出貨後才有,取貨門市只有超商取貨或 i郵箱訂單才有。
| 欄位 | 中文名 | 對應露天欄位 | 何時才有值 |
|---|---|---|---|
order.order_id | 露天訂單編號 露天訂單編號(露天文件:訂單編號),同時是 Vanta 的訂單編號。 | order_info.order_id訂單明細( detail) | 訂單抓進 Vanta 時即有值。 |
order.package_info_tracking_number | 物流追蹤碼 各包裹的出貨單號/物流追蹤碼(露天文件:出貨單號 / 物流追蹤碼),依露天回傳順序列出。 | shipping_info.package_info[].tracking_number訂單明細( detail) | 出貨後才有值。 |
order.receiver_store_name | 取貨門市 收件人取貨超商門市/i郵箱名稱(露天文件:收件人取貨超商門市/i郵箱名稱)。 | shipping_info.receiver_info.receiver_store_name訂單明細( detail) | 超商取貨或 i郵箱訂單才有值。 |
十五、Yahoo SCM
Yahoo SCM 的欄位分在 訂單金額、對帳鍵、成本 三類,全部取自抓單本身的待出貨訂單查詢,不另打其他 API;Yahoo SCM 沒有賣家結算、付款與發票欄位。頂端摘要卡是訂單編號與購物車序號。
- 只在訂單待出貨期間更新:系統只抓 Yahoo SCM 待出貨的訂單,抓到時一併更新;訂單出貨或取消後 Yahoo 端的變動不會回寫。
- 金額都是逐品項:售價、建議售價、各項折抵與成本都是每個品項一列,名稱是 Yahoo 的商品編號;Yahoo 沒有訂單總額與運費欄位。
- 折抵照原值存:折價券、促銷折價、購物金、超贈點、福利金、OPENPOINT 各項折抵照 Yahoo 原值列出,Yahoo 文件沒有說明由誰負擔。
- 成本:「商品成本小計」照 Yahoo 原值存,Yahoo 文件沒有說明是否等於 Yahoo 應付給您的金額。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。Yahoo SCM 只提供逐品項的售價與折抵,不提供運費與訂單總額。
| 欄位 | 中文名 | 對應Yahoo SCM欄位 | 何時才有值 |
|---|---|---|---|
order.ProductPrice | 商品售價 商品售價(Yahoo 文件原文),依 Yahoo 回傳順序每品項一列,名稱為商品編號。 | Products[].ProductPrice(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
order.RetailPrice | 商品建議售價 商品建議售價(Yahoo 文件原文),依 Yahoo 回傳順序每品項一列,名稱為商品編號。 | Products[].RetailPrice(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
| 優惠與折抵 | |||
order.CouponAmount | 折價券折抵 折價券活動折抵金額(Yahoo 文件原文),每品項一列,名稱為商品編號;文件未說明由誰負擔。 | Products[].CouponAmount(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
order.ActivityAmount | 促銷折價折抵 促銷折價活動折抵金額(Yahoo 文件原文),每品項一列,名稱為商品編號;文件未說明由誰負擔。 | Products[].ActivityAmount(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
order.RedeemAmout | 購物金折抵 消費者 Yahoo 購物金折抵金額(Yahoo 文件原文,欄位名照 Yahoo 拼字 RedeemAmout),每品項一列,名稱為商品編號;文件未說明由誰負擔。 | Products[].RedeemAmout(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
order.RewardAmount | 超贈點折抵 消費者 Yahoo 超贈點折抵金額(Yahoo 文件原文),每品項一列,名稱為商品編號;文件未說明由誰負擔。 | Products[].RewardAmount(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
order.WelfareAmount | 福利金折抵 消費者 Yahoo 福利金折抵金額(Yahoo 文件原文;文件註明目前已無此折抵活動),每品項一列,名稱為商品編號;文件未說明由誰負擔。 | Products[].WelfareAmount(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
order.OpenPointAmount | OPENPOINT 折抵 消費者 OPENPOINT 折抵金額(Yahoo 文件原文),每品項一列,名稱為商品編號;文件未說明由誰負擔。 | Products[].OpenPointAmount(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
對帳鍵
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應Yahoo SCM欄位 | 何時才有值 |
|---|---|---|---|
order.OrderCode | Yahoo 訂單編號 訂單編號(Yahoo 文件原文);Vanta 的訂單編號也取自此欄。 | OrderInfo.OrderCode待出貨訂單查詢( GetPreparingOrders) | 同本類說明 |
order.ExternOrderkey | 購物車序號 購物車序號(Yahoo 文件原文)。 | OrderInfo.ExternOrderkey待出貨訂單查詢( GetPreparingOrders) | 同本類說明 |
成本
訂單抓進 Vanta 時即有值;成本是 Yahoo SCM 回傳的商品成本。
| 欄位 | 中文名 | 對應Yahoo SCM欄位 | 何時才有值 |
|---|---|---|---|
order.Cost | 商品成本 商品成本(Yahoo 文件原文),每品項一列,名稱為商品編號。 | Products[].Cost(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
order.Subtotal | 商品成本小計 商品成本小計(Yahoo 文件原文),每品項一列,名稱為商品編號;文件未說明是否等於 Yahoo 應付給賣家的金額。 | Products[].Subtotal(label: Products[].Id)待出貨訂單查詢( GetPreparingOrders) | 訂單抓進 Vanta 時即有值。 |
十六、Mo店+
Mo店+ 的欄位分在 訂單金額、付款、稅與發票、對帳鍵 四類;Mo店+ 的 API 沒有賣家結算與成本欄位(結算請看 Mo店+ 廠商後台的報表)。全部取自抓單的同一支 Mo店+ 訂單查詢 API(OrderQuery),頂端摘要卡是「訂單品項狀態」與「發票號碼」。
- 一張訂單是多個商品列:Mo店+ 把訂單拆成商品列,運費也是其中一列(商品屬性為「運費」)。「商品列訂單金額」每筆左邊是商品原廠編號,不含運費列;運費列的金額另列在「運費列金額」。其他逐列欄位(品項狀態、應稅/未稅、發票、配送單號)依 Mo店+ 回傳順序列出、包含運費列,和「訂單品項流水號」同一個位置對應同一列,沒有值的位置顯示 -。
- 金額照原值存:Mo店+ 文件沒寫明商品列的訂單金額是單價還是小計,也沒有折扣與訂單總額欄位,系統不另行推算或加總。
- 運費:訂單本身的運費照原本規則取運費列的金額,本頁只是列出原始值、不會改寫訂單。
- 品項狀態照原值存:「訂單品項狀態」是 Mo店+ 的原始文字(例:訂單接獲(未付款)),系統不另推導付款狀態。
- 公司發票:買家填的發票開立統編與公司名稱寫進訂單的發票資訊(只補空欄,倉管已填的不覆寫),不列在本頁。
- 跟著抓單更新:系統只抓 Mo店+「未出貨」的訂單,出貨後才有的配送單號或發票多半不會進來。
- 個資:「訂購人姓名」Mo店+ 只在宅配且未出貨時顯示、其他情況是遮罩值,訂單去識別化時清除。
訂單金額
訂單抓進 Vanta 時即有值。Mo店+ 沒有折扣與訂單總額欄位,金額依商品列逐筆列出。
| 欄位 | 中文名 | 對應Mo店+欄位 | 何時才有值 |
|---|---|---|---|
| 商品金額 | |||
order.listItem_orderAmount | 商品列訂單金額 各商品列的訂單金額,每筆是商品原廠編號(entpGoodsNo)與金額,依 Mo店+ 回傳順序列出,不含商品屬性(goodsType)為「運費」的那一列。Mo店+ 文件未寫明是單價或小計,文件範例只在第一品項有金額。 | listItem[].orderAmount(label: listItem[].entpGoodsNo)訂單查詢( OrderQuery) | 訂單抓進 Vanta 時即有值。 |
| 運費 | |||
order.shipping_orderAmount | 運費列金額 商品屬性(goodsType)為「運費」那一列的訂單金額。訂單的運費取這個值。 | listItem[].orderAmount訂單查詢( OrderQuery) | Mo店+ 訂單有運費列時才有值。 |
付款
| 欄位 | 中文名 | 對應Mo店+欄位 | 何時才有值 |
|---|---|---|---|
order.listItem_itemStatus | 訂單品項狀態 訂單品項狀態原始值(例:訂單接獲(未付款)、出貨通知(已付款));每列一個值,依 Mo店+ 回傳順序列出、與訂單品項流水號同位置(含運費列)。 | listItem[].itemStatus訂單查詢( OrderQuery) | 訂單抓進 Vanta 時即有值。 |
稅與發票
訂單抓進 Vanta 時即有值;發票號碼、發票日期與開立發票金額在發票開立後才有。
| 欄位 | 中文名 | 對應Mo店+欄位 | 何時才有值 |
|---|---|---|---|
order.listItem_taxable | 應稅/未稅 應稅/未稅原始值:true=應稅、false=免稅;每列一個值,與訂單品項流水號同位置(含運費列)。 | listItem[].taxable訂單查詢( OrderQuery) | 訂單抓進 Vanta 時即有值。 |
order.listItem_invoiceAmount | 開立發票金額 開立發票金額;每列一個值,與訂單品項流水號同位置(含運費列)。 | listItem[].invoiceAmount訂單查詢( OrderQuery) | 發票開立後才有值。 |
order.listItem_invoiceNo | 發票號碼 發票號碼;每列一個值,與訂單品項流水號同位置(含運費列)。 | listItem[].invoiceNo訂單查詢( OrderQuery) | 發票開立後才有值。 |
order.listItem_invoiceDate | 發票日期 發票日期,照 Mo店+ 原字串存(Mo店+ 文件未寫格式與時區);每列一個值,與訂單品項流水號同位置(含運費列)。 | listItem[].invoiceDate訂單查詢( OrderQuery) | 發票開立後才有值。 |
對帳鍵
| 欄位 | 中文名 | 對應Mo店+欄位 | 何時才有值 |
|---|---|---|---|
order.orderNo | Mo店+ 訂單編號 訂單編號(即 Vanta 的訂單編號)。 | orderNo訂單查詢( OrderQuery) | 訂單抓進 Vanta 時即有值。 |
order.listItem_orderSeq | 訂單品項流水號 訂單品項流水號(例:001),依 Mo店+ 回傳順序列出(含運費列);訂單編號加上流水號即 Mo店+ 的 18 碼訂單編號-流水碼。 | listItem[].orderSeq訂單查詢( OrderQuery) | 訂單抓進 Vanta 時即有值。 |
order.listItem_deliveryNo | 配送單號 配送單號;每列一個值,與訂單品項流水號同位置(含運費列)。 | listItem[].deliveryNo訂單查詢( OrderQuery) | 出貨並有配送單號後才有值;系統只抓 Mo店+ 未出貨的單,出貨後才有的配送單號多半不會進來。 |
order.purchaser_name | 訂購人姓名 訂購人姓名,取第一列的值(訂購人是訂單層資料,Mo店+ 文件放在每一列上)。 | listItem[].customerName訂單查詢( OrderQuery) | Mo店+ 只在訂單為宅配且未出貨時顯示,否則遮罩(例:謝○佑);訂單去識別化時清除。 |
十七、PChome
PChome 的欄位分在 賣家結算、對帳鍵、成本 三類,全部取自抓單本身的訂單明細,不另打其他 API。PChome 是供應商轉單,訂單明細只有商品成本、沒有售價,也沒有付款與發票資料,所以訂單金額、付款、稅與發票不顯示。頂端摘要卡是成本小計與物流出貨單號。
- 只在 PChome 確認出貨前更新:系統每次定期抓單都會重新讀取轉單日 7 天內、PChome 還沒確認出貨的訂單並一併更新;PChome 確認出貨(或標記不出貨)後的變動不會回寫。
- 立帳日多半為空:「立帳日」是 PChome 確認出貨後才給的日期,而確認出貨的訂單定期抓單不再讀取,所以這欄通常沒有值;照 PChome 回傳的日期字串顯示(例:2015/01/15)。
- 成本照 PChome 原值:每張 PChome 訂單只有一個品項,「商品單位成本」是該品項的單位成本,「成本小計」是 PChome 回傳的成本小計(單位成本 × 下訂數量);PChome 文件沒有說明成本小計是否就是應付廠商的金額。
- 訂購人是個資:「訂購人姓名」「訂購人電話」由系統解密 PChome 的加密欄位後儲存,電話沒有時改取手機;訂單去識別化時一併清空,之後重新抓單也不會補回。
賣家結算
PChome 確認出貨後才有立帳日;Vanta 定期抓單不再讀取 PChome 已確認出貨的訂單,所以這欄多半為空。PChome 轉單 API 沒有手續費或佣金欄位。
| 欄位 | 中文名 | 對應PChome欄位 | 何時才有值 |
|---|---|---|---|
order.ShipDate | 立帳日 出貨確認日(PChome 文件:出貨確認日(立帳日)),照 PChome 回傳的日期字串存(例:2015/01/15)。 | ShipDate訂單明細( order) | PChome 確認出貨後才有值;Vanta 定期抓單不再讀取 PChome 已確認出貨的訂單,所以多半為空。 |
對帳鍵
訂單抓進 Vanta 時即有值;物流出貨單號在出貨回寫 PChome 後才有。
| 欄位 | 中文名 | 對應PChome欄位 | 何時才有值 |
|---|---|---|---|
order.Id | PChome 訂單編號 PChome 訂單編號(PChome 文件:訂單編號,例:20150114090784-01),同時是 Vanta 的訂單編號。 | Id訂單明細( order) | 訂單抓進 Vanta 時即有值。 |
order.ShipInfoShipId | 物流出貨單號 物流出貨單號(PChome 文件:物流出貨單號;廠商自行出貨時為 SP 或 sp)。 | ShipInfo.ShipId訂單明細( order) | 出貨回寫 PChome 後才有值。 |
order.purchaser_name | 訂購人姓名 訂購人姓名(PChome 文件:訂購人的姓名,需加密傳輸;備註:訂購人姓氏為明碼),Vanta 解密後儲存。訂單去識別化時清空。 | Buyer.Name訂單明細( order) | 訂單抓進 Vanta 時即有值。 |
order.purchaser_phone | 訂購人電話 訂購人電話,沒有電話時改取手機(PChome 文件:訂購人的 Tel 電話、Mobile 手機,需加密傳輸),Vanta 解密後儲存。訂單去識別化時清空。 | Buyer.Tel訂單明細( order) | 訂單抓進 Vanta 時即有值。 |
成本
訂單抓進 Vanta 時即有值。PChome 轉單只提供成本,沒有售價。
| 欄位 | 中文名 | 對應PChome欄位 | 何時才有值 |
|---|---|---|---|
order.ProdCost | 商品單位成本 商品單位成本(PChome 文件:商品資訊的單位成本);每張 PChome 訂單只有一個品項,數量見訂單品項。 | Prod.Cost訂單明細( order) | 訂單抓進 Vanta 時即有值。 |
order.TotalCost | 成本小計 成本小計(PChome 文件:成本小計 = 商品單位成本 * 下訂數量);文件未說明是否等於應付廠商的金額。 | TotalCost訂單明細( order) | 訂單抓進 Vanta 時即有值。 |
十八、東森購物
東森購物的欄位分在 訂單金額、對帳鍵、成本 三類,全部取自抓單本身的出貨管理查詢,不另打其他 API;東森沒有賣家結算、付款與發票欄位。頂端摘要卡是東森訂單編號與商品售價加總。
- 只在訂單待出貨期間更新:系統只抓東森「出貨指示」狀態的訂單,抓到時一併更新;訂單出貨或取消後東森端的變動不會回寫。
- 金額都是逐品項:商品售價與成本是每個品項一列,名稱是東森的訂單項次;東森沒有運費、折扣與訂單總額欄位。
- 「商品售價加總」由 Vanta 計算:各品項商品售價 × 數量的加總,與訂單總額同算法。東森文件沒有寫商品售價是單價還是小計,Vanta 抓單把它當單價。
- 成本:照東森原值存,東森文件沒有寫是單件或整列,也沒有寫與商品成本價、佣金的關係。
- 對帳鍵:配送單號、通路名稱、配送店號取這張訂單第一個品項的值;配送店號實際是取貨門市代號,與訂單上的取貨門市相同。
訂單金額
訂單抓進 Vanta 時即有值,之後隨抓單更新。東森只提供逐品項的商品售價,不提供運費、折扣與訂單總額;加總由 Vanta 依品項計算。
| 欄位 | 中文名 | 對應東森購物欄位 | 何時才有值 |
|---|---|---|---|
order.price | 商品售價 商品售價(東森文件原文),依東森回傳順序每品項一列,名稱為訂單項次(itemID);文件未寫是單價或小計,Vanta 抓單把它當單價乘以數量計算訂單總額。 | data[].price(label: data[].itemID)出貨管理查詢( Search) | 訂單抓進 Vanta 時即有值。 |
order.price_total | 商品售價加總 各品項 price × qty 的加總(Vanta 計算,與抓單寫入的訂單總額同算法);東森沒有訂單總額欄位,price 是單價或小計文件未寫。 | data[].price × data[].qty出貨管理查詢( Search) | 訂單抓進 Vanta 時即有值。 |
對帳鍵
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應東森購物欄位 | 何時才有值 |
|---|---|---|---|
order.orderID | 東森訂單編號 訂單編號(東森文件原文);Vanta 的訂單編號也取自此欄。 | data[].orderID出貨管理查詢( Search) | 同本類說明 |
order.itemID | 訂單項次 訂單項次(東森文件原文),依東森回傳順序每品項一筆;出貨回拋東森時以它逐項回報。 | data[].itemID出貨管理查詢( Search) | 同本類說明 |
order.deliveryOrderID | 配送單號 配送單號(東森文件原文),取這張訂單第一個品項列的值;店配訂單的寄件單號也取自此欄。 | data[].deliveryOrderID出貨管理查詢( Search) | 同本類說明 |
order.chName | 通路名稱 通路名稱(東森文件原文),取這張訂單第一個品項列的值。 | data[].chName出貨管理查詢( Search) | 同本類說明 |
order.storeName | 配送店號 配送店號(東森文件原文),取這張訂單第一個品項列的值;Vanta 訂單的取貨門市代號也取自此欄。 | data[].storeName出貨管理查詢( Search) | 同本類說明 |
成本
訂單抓進 Vanta 時即有值;成本是東森回傳的值。
| 欄位 | 中文名 | 對應東森購物欄位 | 何時才有值 |
|---|---|---|---|
order.cost | 成本 成本(東森文件原文),每品項一列,名稱為訂單項次(itemID);文件未寫是單件或整列,也未寫與商品層成本價、佣金的關係。 | data[].cost(label: data[].itemID)出貨管理查詢( Search) | 訂單抓進 Vanta 時即有值。 |
十九、momo
momo 的欄位分在 訂單金額、稅與發票、對帳鍵、成本 四類,全部取自抓單本身的未出貨訂單查詢(廠商配送、超商、第三方物流三支),不另打其他 API;momo 沒有賣家結算與付款類欄位。頂端摘要卡是售價加總與發票號碼。
- 只在 momo 端未出貨期間更新:系統只抓 momo 未出貨的訂單,抓到時一併更新;出貨後的變動不會回寫。一張訂單有部分子單先出貨時,分頁保留出貨前最後一次抓到的全部子單資料,不會只剩未出貨的子單。
- 一張訂單可由多筆 momo 子單組成:momo 會把同一張母單拆成多筆子單,系統把同一母單的子單合成一張訂單。售價、進價依 momo 回傳順序每筆子單一列、標示子單的訂單編號;發票、訂單編號、配送單號、取貨門市每筆子單一個值,同一個位置是同一筆子單。
- 售價與進價照 momo 原值:momo 文件只寫「售價(含稅)」「進價(含稅)」,沒寫是單價或小計。「售價加總」是各子單售價乘以數量的加總,和訂單總金額同一套算法。
- 發票由 momo 開立:發票號碼與日期照 momo 給的原值顯示,開立前為空。
- 配送單號與取貨門市只在部分訂單有:配送單號只有廠商配送單、取貨門市只有超商取貨單有。
- 訂購人姓名是個資:「訂購人姓名」在訂單去識別化時清除;超商與第三方物流單 momo 只給遮罩後的姓名。momo 沒有提供訂購人電話。
訂單金額
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應momo欄位 | 何時才有值 |
|---|---|---|---|
order.salePrice | 售價(含稅) 各子單的售價(含稅),每筆帶該子單的訂單編號(completeOrderNo),依 momo 回傳順序列出;momo 文件未寫明是單價或小計。 | dataList[].salePrice(label: dataList[].completeOrderNo)未出貨訂單查詢( OrderServlet.do) | 同本類說明 |
order.salePrice_sum | 售價加總 各子單售價(含稅) salePrice 乘以數量 syslast 的加總,與 Vanta 訂單總金額同一套算法(以 salePrice 為單價)。 | dataList[].salePrice未出貨訂單查詢( OrderServlet.do) | 同本類說明 |
稅與發票
momo 開立發票後才有值。
| 欄位 | 中文名 | 對應momo欄位 | 何時才有值 |
|---|---|---|---|
order.invoiceNo | 發票號碼 發票號碼;每筆子單一個值,依 momo 回傳順序列出。發票由 momo 開立。 | dataList[].invoiceNo未出貨訂單查詢( OrderServlet.do) | 同本類說明 |
order.invoiceDate | 發票日期 發票日期;照 momo 原字串存(例:2026/02/10),每筆子單一個值,依 momo 回傳順序列出。 | dataList[].invoiceDate未出貨訂單查詢( OrderServlet.do) | 同本類說明 |
對帳鍵
訂單抓進 Vanta 時即有值;配送單號只有廠商配送單、取貨門市只有超商取貨單。
| 欄位 | 中文名 | 對應momo欄位 | 何時才有值 |
|---|---|---|---|
order.completeOrderNo | momo 訂單編號 訂單編號(momo 的子單編號);每筆子單一個值,依 momo 回傳順序列出。 | dataList[].completeOrderNo未出貨訂單查詢( OrderServlet.do) | 訂單抓進 Vanta 時即有值。 |
order.slipNo | 配送單號 配送單號;每筆子單一個值,依 momo 回傳順序列出。 | dataList[].slipNo未出貨訂單查詢( OrderServlet.do) | 只有廠商配送單有此欄位。 |
order.storeIdName | 取貨門市 取貨門市;每筆子單一個值,依 momo 回傳順序列出。 | dataList[].storeIdName未出貨訂單查詢( OrderServlet.do) | 只有超商取貨單有此欄位。 |
order.purchaser_name | 訂購人姓名 訂購人姓名;取第一筆子單的 custNameMask(超商與第三方物流的遮罩值),沒有才取 custName(廠商配送)。訂單去識別化時清除。 | dataList[].custNameMask未出貨訂單查詢( OrderServlet.do) | 訂單抓進 Vanta 時即有值。 |
成本
訂單抓進 Vanta 時即有值。
| 欄位 | 中文名 | 對應momo欄位 | 何時才有值 |
|---|---|---|---|
order.buyPrice | 進價(含稅) 各子單的進價(含稅),每筆帶該子單的訂單編號(completeOrderNo),依 momo 回傳順序列出;momo 文件未寫明是單價或小計。 | dataList[].buyPrice(label: dataList[].completeOrderNo)未出貨訂單查詢( OrderServlet.do) | 同本類說明 |
二十、常見問題
▪ 分頁顯示「無平台資料」?
代表這張單還沒取到平台的附加資訊,常見原因:抓單當下蝦皮的收入明細 API 沒有回應(訂單照常建立,下一次抓單會補上)、或這張單在功能上線前就已出貨(系統只抓待出貨的蝦皮、Shopline、FreeStore、EasyStore、Yahoo SCM、出貨指示狀態的東森購物、付款完成的 Coupang、待確認或待出貨的露天、尚未確認出貨的 PChome、未出貨的 BVSHOP、1shop 與 momo、處理中的 WooCommerce 訂單,已出貨的不會再補)。
▪ 「預計撥款金額」和蝦皮後台的實際撥款金額不同?
這裡是蝦皮在出貨前給的預估值。訂單出貨後的退款、調整與最終結算不會回寫,對帳請以蝦皮的撥款資料為準。
▪ 複製出來的訂單看得到附加資訊嗎?
看不到。複製的訂單已與平台脫鉤,不會帶附加資訊,也不會出現這個分頁;原單的附加資訊不受影響。
▪ 可以透過 API 修改附加資訊嗎?
不行。附加資訊只由抓單寫入,Partners API 的訂單建立、修改與 App 的訂單附加資料都改不到它。