Skip to content

電商附加資訊對照表 ​


目錄 ​


一、怎麼看這份對照表 ​

電商附加資訊是平台提供、但不屬於訂單本身的金額拆解與對帳資料:商品折扣、優惠券、蝦幣折抵、佣金與手續費、預計撥款金額、付款方式與包裹編號等。系統在抓單時一併取回,讓您對帳時不必再回平台後台一張張查。

同一份欄位在三個地方看得到,欄位名稱與說明都以本頁為準:

在哪裡看說明
訂單詳情的「電商附加資訊」分頁倉庫端與貨主後台都有,唯讀;切到分頁時才載入。頂端的摘要卡依平台而定(見各平台一節);下方依所有平台共用的分類排列(訂單金額、賣家結算、付款、稅與發票、對帳鍵、成本),平台沒有的分類不顯示。滑過欄位名稱旁的 ⓘ 可看欄位說明、取自平台哪支 API 與回傳欄位
Partners API2026-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_feeAMS 佣金
蝦皮聯盟行銷(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.idShopify 訂單 ID
Shopify 訂單 ID(GID,例:gid://shopify/Order/123),對應 Shopify 後台與 API。
id
訂單明細(GraphQL Admin API orders)
訂單抓進 Vanta 時即有值。
order.nameShopify 訂單編號
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.idShopify 出貨 ID
Shopify 出貨(fulfillment)ID。
fulfillments[].id
訂單出貨(GraphQL Admin API orders)
只反映最後一次抓單時的狀態。定時抓單只抓 Shopify 未出貨的訂單,出貨後要等平台通知訂單異動才會更新。
fulfillments.nameShopify 出貨名稱
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_idShopify 出貨單 ID
Shopify 出貨單(fulfillment order)ID。
fulfillmentOrders.nodes[].id
訂單出貨(GraphQL Admin API orders)
訂單抓進 Vanta 時即有值。
fulfillments.fulfillment_order_statusShopify 出貨單狀態
各 Shopify 出貨單的狀態原始值(例:OPEN、CLOSED)。
fulfillmentOrders.nodes[].status
訂單出貨(GraphQL Admin API orders)
訂單抓進 Vanta 時即有值;只反映最後一次抓單時的狀態。
refunds.idShopify 退款 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.idShopline 訂單 ID
Shopline 訂單 ID(平台內部識別碼,與訂單編號不同)。
id
訂單明細(search)
同本類說明
order.order_numberShopline 訂單編號
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.idWooCommerce 訂單 ID
WooCommerce 訂單 ID(WooCommerce 文件:Unique identifier for the resource;平台內部識別碼,與訂單編號不同)。
id
訂單明細(orders)
同本類說明
order.numberWooCommerce 訂單編號
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.idBVSHOP 訂單 ID
訂單 ID(BVSHOP 平台內部編號,回寫物流單號時用)。
id
訂單明細(orders)
訂單抓進 Vanta 時即有值。
order.uidBVSHOP 訂單編號
訂單編號(即 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_idFreeStore 訂單編號
FreeStore 訂單編號(FreeStore 文件:訂單編號,10 碼數字);與 Vanta 的訂單編號相同。
order_id
訂單明細(orders)
訂單抓進 Vanta 時即有值。
order.bb_idBuy Button 編號
FreeStore 回傳的 Buy Button 專屬編號原始值(FreeStore 文件:Buy Button 專屬編號)。
bb_id
訂單明細(orders)
訂單抓進 Vanta 時即有值。
order.tracking_number包裹追蹤碼
包裹追蹤碼(FreeStore 文件:包裹追蹤碼)。
tracking_number
訂單明細(orders)
出貨後回傳追蹤碼給 FreeStore 才有值。
order.utm_sourceUTM 來源
導購網址的 utm_source(FreeStore 文件:網址帶參數 ?utm_source=OOOOO 導購的訂單)。
utm_source
訂單明細(orders)
只有從帶 UTM 參數的網址導購的訂單才有值。
order.utm_mediumUTM 媒介
導購網址的 utm_medium(FreeStore 文件:utm_medium)。
utm_medium
訂單明細(orders)
只有從帶 UTM 參數的網址導購的訂單才有值。
order.utm_campaignUTM 活動
導購網址的 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_discountVIP 折扣
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.idCyberbiz 訂單 ID
Cyberbiz 訂單 ID,對應 Cyberbiz API。
id
訂單資訊(orders)
訂單抓進 Vanta 時即有值。
order.order_numberCyberbiz 訂單編號
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_idPOS 店家 ID
POS 銷售員所屬店家 ID。
pos_info.pos_shop_id
訂單資訊(orders)
POS 訂單才有值。
order.pos_idPOS 機 ID
訂單銷售使用的 POS 機 ID。
pos_info.pos_id
訂單資訊(orders)
POS 訂單才有值。
order.pos_namePOS 機名稱
訂單銷售使用的 POS 機名稱。
pos_info.pos_name
訂單資訊(orders)
POS 訂單才有值。
order.pos_infoPOS 相關資訊
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.idEasyStore 訂單 ID
EasyStore 平台內部的訂單識別碼(EasyStore 文件:The unique identifier for the order),與訂單編號不同。
id
訂單明細(orders.json)
訂單抓進 Vanta 時即有值。
order.order_numberEasyStore 訂單編號
顯示給顧客的訂單編號(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_number1shop 訂單號碼
訂單號碼(即 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_coupangDiscountCoupang 支援折扣
各品項由 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_invoiceAmountToCoupangCoupang 請款金額
向 Coupang 開立(請款)的金額。Coupang 文件未說明與品項金額的關係,照原值存。
extraProperties.invoiceAmountInfo.invoiceAmountToCoupang
訂單明細(ordersheets)
Coupang 回傳發票金額資訊(extraProperties.invoiceAmountInfo)時才有值。
order.invoiceAmountInfo_currency發票金額幣別
發票金額的幣別代碼。
extraProperties.invoiceAmountInfo.currency
訂單明細(ordersheets)
Coupang 回傳發票金額資訊(extraProperties.invoiceAmountInfo)時才有值。

對帳鍵 ​

欄位中文名對應Coupang 酷澎欄位何時才有值
order.orderIdCoupang 訂單編號
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.OpenPointAmountOPENPOINT 折抵
消費者 OPENPOINT 折抵金額(Yahoo 文件原文),每品項一列,名稱為商品編號;文件未說明由誰負擔。
Products[].OpenPointAmount(label: Products[].Id)
待出貨訂單查詢(GetPreparingOrders)
訂單抓進 Vanta 時即有值。

對帳鍵 ​

訂單抓進 Vanta 時即有值。

欄位中文名對應Yahoo SCM欄位何時才有值
order.OrderCodeYahoo 訂單編號
訂單編號(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.orderNoMo店+ 訂單編號
訂單編號(即 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.IdPChome 訂單編號
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.completeOrderNomomo 訂單編號
訂單編號(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 的訂單附加資料都改不到它。


最後更新 2026-11-07 21:46