Introduction

Datasources and destinations

Fields listing for TikTok Shop

Order ID
TikTok Shop order ID.
Field IDorder/id
TypeTEXT
Data Typedimension
Buyer Message
The note from the buyer.
Field IDorder/buyer_message
TypeTEXT
Data Typedimension
Cancellation Initiator
Cancellation request initiator. Available values: SELLER, BUYER, SYSTEM.
Field IDorder/cancellation_initiator
TypeTEXT
Data Typedimension
Shipping Provider ID
The ID of the current shipping provider.
Field IDorder/shipping_provider_id
TypeTEXT
Data Typedimension
Create Time
The date and time that the order was created. Unix timestamp.
Field IDorder/create_time
TypeYEAR_MONTH_DAY
Data Typedimension
Shipping Provider
The name of the current shipping provider.
Field IDorder/shipping_provider
TypeTEXT
Data Typedimension
Payment Currency
Currency for payment.
Field IDorder/payment_currency
TypeTEXT
Data Typedimension
Payment Sub Total
Buyer paid sub-total of all the SKUs in the order. For the US market, pre-tax total amount.
Field IDorder/payment_sub_total
TypeNUMBER
Data Typemetric
Payment Shipping Fee
Buyer paid shipping fee. For the US market, pre-tax total amount.
Field IDorder/payment_shipping_fee
TypeNUMBER
Data Typemetric
Payment Seller Discount
Product discount by seller.
Field IDorder/payment_seller_discount
TypeNUMBER
Data Typemetric
Payment Platform Discount
Product discount by platform.
Field IDorder/payment_platform_discount
TypeNUMBER
Data Typemetric
Payment Total Amount
Buyer paid total payment.
Field IDorder/payment_total_amount
TypeNUMBER
Data Typemetric
Payment Original Total Product Price
Total original price of the products (VAT included for cross-border shops). US: pre-tax.
Field IDorder/payment_original_total_product_price
TypeNUMBER
Data Typemetric
Payment Original Shipping Fee
Shipping fee before discount.
Field IDorder/payment_original_shipping_fee
TypeNUMBER
Data Typemetric
Payment Shipping Fee Seller Discount
Shipping fee discount provided by seller not co-funded.
Field IDorder/payment_shipping_fee_seller_discount
TypeNUMBER
Data Typemetric
Payment Shipping Fee Platform Discount
Shipping fee discount provided by platform.
Field IDorder/payment_shipping_fee_platform_discount
TypeNUMBER
Data Typemetric
Payment Shipping Fee Cofunded Discount
Seller shipping fee discount eligible for co-funded reimbursement.
Field IDorder/payment_shipping_fee_cofunded_discount
TypeNUMBER
Data Typemetric
Payment Tax
Buyer paid total taxes for the order.
Field IDorder/payment_tax
TypeNUMBER
Data Typemetric
Payment Small Order Fee
Small order fee (TH market only).
Field IDorder/payment_small_order_fee
TypeNUMBER
Data Typemetric
Payment Shipping Fee Tax
The tax on the shipping price.
Field IDorder/payment_shipping_fee_tax
TypeNUMBER
Data Typemetric
Payment Product Tax
The tax on the total item price.
Field IDorder/payment_product_tax
TypeNUMBER
Data Typemetric
Payment Retail Delivery Fee
Retail delivery fee (RDF). US only.
Field IDorder/payment_retail_delivery_fee
TypeNUMBER
Data Typemetric
Payment Buyer Service Fee
Service fee applied from the fifth order onwards. Indonesia only.
Field IDorder/payment_buyer_service_fee
TypeNUMBER
Data Typemetric
Payment Handling Fee
Fee to cover additional processing/handling costs. Indonesia only.
Field IDorder/payment_handling_fee
TypeNUMBER
Data Typemetric
Payment Shipping Insurance Fee
Insurance cost against loss or damage during transit. Indonesia only.
Field IDorder/payment_shipping_insurance_fee
TypeNUMBER
Data Typemetric
Payment Item Insurance Fee
Post-purchase product insurance cost. US and Indonesia.
Field IDorder/payment_item_insurance_fee
TypeNUMBER
Data Typemetric
Recipient Full Address
Complete recipient address information.
Field IDorder/recipient_address_full_address
TypeTEXT
Data Typedimension
Recipient Phone Number
Recipient telephone number (may be desensitized with platform logistics).
Field IDorder/recipient_address_phone_number
TypeTEXT
Data Typedimension
Recipient Name
Recipient name (may be desensitized with platform logistics).
Field IDorder/recipient_address_name
TypeTEXT
Data Typedimension
Recipient First Name
Recipient first name (US, UK, JP only).
Field IDorder/recipient_address_first_name
TypeTEXT
Data Typedimension
Recipient Last Name
Recipient last name (US, UK, JP only).
Field IDorder/recipient_address_last_name
TypeTEXT
Data Typedimension
Recipient First Name (Local Script)
Recipient first name in katakana (JP only).
Field IDorder/recipient_address_first_name_local_script
TypeTEXT
Data Typedimension
Recipient Last Name (Local Script)
Recipient last name in katakana (JP only).
Field IDorder/recipient_address_last_name_local_script
TypeTEXT
Data Typedimension
Recipient Address Detail
Full recipient detailed address.
Field IDorder/recipient_address_address_detail
TypeTEXT
Data Typedimension
Recipient Address Line 1
The first line of the street address.
Field IDorder/recipient_address_address_line1
TypeTEXT
Data Typedimension
Recipient Address Line 2
The second line of the street address.
Field IDorder/recipient_address_address_line2
TypeTEXT
Data Typedimension
Recipient Address Line 3
The third line of the street address (usually BR).
Field IDorder/recipient_address_address_line3
TypeTEXT
Data Typedimension
Recipient Address Line 4
The fourth line of the street address (usually BR).
Field IDorder/recipient_address_address_line4
TypeTEXT
Data Typedimension
Delivery Prefs Drop-off Location
Drop-off location selected by the recipient (US only).
Field IDorder/recipient_address_delivery_preferences_drop_off_location
TypeTEXT
Data Typedimension
Postal Code
Postal/ZIP code for shipping.
Field IDorder/recipient_address_postal_code
TypeTEXT
Data Typedimension
Region Code
Region code.
Field IDorder/recipient_address_region_code
TypeTEXT
Data Typedimension
Post Town
Post town of the address (UK only).
Field IDorder/recipient_address_post_town
TypeTEXT
Data Typedimension
Status
Specific order status.
Field IDorder/status
TypeTEXT
Data Typedimension
Fulfillment Type
Fulfillment type for the order.
Field IDorder/fulfillment_type
TypeTEXT
Data Typedimension
Delivery Type
Indicates PUDO vs home delivery.
Field IDorder/delivery_type
TypeTEXT
Data Typedimension
Paid Time
The date and time that the order was paid. Unix timestamp.
Field IDorder/paid_time
TypeYEAR_MONTH_DAY
Data Typedimension
RTS SLA Time
Latest shipping time specified by the platform. Unix timestamp.
Field IDorder/rts_sla_time
TypeYEAR_MONTH_DAY
Data Typedimension
TTS SLA Time
Latest collection time specified by the platform. Unix timestamp.
Field IDorder/tts_sla_time
TypeYEAR_MONTH_DAY
Data Typedimension
Cancel Reason
Cancellation reason.
Field IDorder/cancel_reason
TypeTEXT
Data Typedimension
Update Time
Time of order status change. Unix timestamp.
Field IDorder/update_time
TypeYEAR_MONTH_DAY
Data Typedimension
Payment Method Name
Payment method name for display.
Field IDorder/payment_method_name
TypeTEXT
Data Typedimension
RTS Time
Time seller shipped the order. Unix timestamp.
Field IDorder/rts_time
TypeYEAR_MONTH_DAY
Data Typedimension
Tracking Number
Tracking number. Available after shipment.
Field IDorder/tracking_number
TypeTEXT
Data Typedimension
Split/Combine Tag
Indicates whether the order is combined or split.
Field IDorder/split_or_combine_tag
TypeTEXT
Data Typedimension
Has Updated Recipient Address
Whether the recipient address has been updated.
Field IDorder/has_updated_recipient_address
TypeBOOLEAN
Data Typedimension
Cancel Order SLA Time
Automatic cancellation time set by the platform. Unix timestamp.
Field IDorder/cancel_order_sla_time
TypeYEAR_MONTH_DAY
Data Typedimension
Warehouse ID
Seller warehouse ID.
Field IDorder/warehouse_id
TypeTEXT
Data Typedimension
Request Cancel Time
Buyer request cancellation time. Unix timestamp.
Field IDorder/request_cancel_time
TypeYEAR_MONTH_DAY
Data Typedimension
Shipping Type
Delivery method: TIKTOK or SELLER.
Field IDorder/shipping_type
TypeTEXT
Data Typedimension
Buyer User ID
Buyer user ID.
Field IDorder/user_id
TypeTEXT
Data Typedimension
Seller Note
Seller note from Seller Center.
Field IDorder/seller_note
TypeTEXT
Data Typedimension
Delivery SLA Time
Order should arrive by this date to be on-time. Unix timestamp.
Field IDorder/delivery_sla_time
TypeYEAR_MONTH_DAY
Data Typedimension
Is COD
Whether the order is Cash on Delivery.
Field IDorder/is_cod
TypeBOOLEAN
Data Typedimension
Delivery Option ID
Mapped to seller logistics template ID.
Field IDorder/delivery_option_id
TypeTEXT
Data Typedimension
Cancel Time
Time status updated to CANCELLED. Unix timestamp.
Field IDorder/cancel_time
TypeYEAR_MONTH_DAY
Data Typedimension
Need Upload Invoice
Whether an invoice needs to be uploaded and status (BR only).
Field IDorder/need_upload_invoice
TypeTEXT
Data Typedimension
Delivery Option Name
Delivery option name for display.
Field IDorder/delivery_option_name
TypeTEXT
Data Typedimension
CPF
Invoice number used to issue an invoice (BR only).
Field IDorder/cpf
TypeTEXT
Data Typedimension
Buyer Email
Anonymized buyer email.
Field IDorder/buyer_email
TypeTEXT
Data Typedimension
Delivery Due Time
Auto-cancel if not DELIVERED by this time. Unix timestamp.
Field IDorder/delivery_due_time
TypeYEAR_MONTH_DAY
Data Typedimension
Is Sample Order
Whether the order is a sample order.
Field IDorder/is_sample_order
TypeBOOLEAN
Data Typedimension
Shipping Due Time
Auto-cancel if not AWAITING_COLLECTION by this time. Unix timestamp.
Field IDorder/shipping_due_time
TypeYEAR_MONTH_DAY
Data Typedimension
Collection Due Time
Auto-cancel if not IN_TRANSIT by this time. Unix timestamp.
Field IDorder/collection_due_time
TypeYEAR_MONTH_DAY
Data Typedimension
Required Delivery Time
Order should be delivered before this time. Unix timestamp.
Field IDorder/delivery_option_required_delivery_time
TypeYEAR_MONTH_DAY
Data Typedimension
Is On-Hold Order
Whether the order is or will be ON_HOLD.
Field IDorder/is_on_hold_order
TypeBOOLEAN
Data Typedimension
Delivery Time
Time status changed to DELIVERED. Unix timestamp.
Field IDorder/delivery_time
TypeYEAR_MONTH_DAY
Data Typedimension
Is Replacement Order
Whether this is a replacement order.
Field IDorder/is_replacement_order
TypeBOOLEAN
Data Typedimension
Collection Time
Time status updated to IN_TRANSIT. Unix timestamp.
Field IDorder/collection_time
TypeYEAR_MONTH_DAY
Data Typedimension
Replaced Order ID
Order ID that is being replaced (if applicable).
Field IDorder/replaced_order_id
TypeTEXT
Data Typedimension
Buyer Requested Cancel
Whether the buyer has a pending cancellation request.
Field IDorder/is_buyer_request_cancel
TypeBOOLEAN
Data Typedimension
Pick-up Cut-off Time
Latest pick-up time to avoid LDR (SEA regions). Unix timestamp.
Field IDorder/pick_up_cut_off_time
TypeYEAR_MONTH_DAY
Data Typedimension
Fast Dispatch SLA Time
Latest collection time to gain NDD incentives (TH, PH). Unix timestamp.
Field IDorder/fast_dispatch_sla_time
TypeYEAR_MONTH_DAY
Data Typedimension
Commerce Platform
Platform where the order was placed (e.g., TIKTOK_SHOP, TOKOPEDIA).
Field IDorder/commerce_platform
TypeTEXT
Data Typedimension
Order Type
Order type (e.g., ZERO_LOTTERY, PRE_ORDER, MADE_TO_ORDER, BACK_ORDER).
Field IDorder/order_type
TypeTEXT
Data Typedimension
Release Date
Date handling starts (PRE_ORDER). Unix timestamp.
Field IDorder/release_date
TypeYEAR_MONTH_DAY
Data Typedimension
Handling Duration Days
Number of days for handling (MADE_TO_ORDER/BACK_ORDER).
Field IDorder/handling_duration_days
TypeTEXT
Data Typedimension
Handling Duration Type
CALENDAR_DAY or BUSINESS_DAY. Default BUSINESS_DAY.
Field IDorder/handling_duration_type
TypeTEXT
Data Typedimension
Auto Combine Group ID
Identifier to combine orders from the same customer during LIVE.
Field IDorder/auto_combine_group_id
TypeTEXT
Data Typedimension
CPF Name
Name belonging to the CPF number (BR market).
Field IDorder/cpf_name
TypeTEXT
Data Typedimension
Is Exchange Order
TRUE if this is an exchange order (US/UK).
Field IDorder/is_exchange_order
TypeBOOLEAN
Data Typedimension
Exchange Source Order ID
Original order ID for the exchange order (US/UK).
Field IDorder/exchange_source_order_id
TypeTEXT
Data Typedimension
Consultation ID
ID for corresponding ePharmacy consultation, if initiated.
Field IDorder/consultation_id
TypeTEXT
Data Typedimension
Fast Delivery Program
Badge indicating fast delivery program (e.g., 3_DAY_DELIVERY). US only.
Field IDorder/fast_delivery_program
TypeTEXT
Data Typedimension
Fulfillment Priority Level
Priority value to prioritize shipping (SEA).
Field IDorder/fulfillment_priority_level
TypeNUMBER
Data Typedimension
Recommended Shipping Time
Recommended time to ship based on LSP service type (SEA). Unix timestamp.
Field IDorder/recommended_shipping_time
TypeYEAR_MONTH_DAY
Data Typedimension
Year
Year such as 2017.
Field ID_NORMALIZED_DATE_FIELD_YEAR
TypeYEAR
Data Typedimension
Year Quarter
Year and quarter.
Field ID_NORMALIZED_DATE_FIELD_YEAR_QUARTER
TypeYEAR_QUARTER
Data Typedimension
Year month
Year and month.
Field ID_NORMALIZED_DATE_FIELD_YEAR_MONTH
TypeYEAR_MONTH
Data Typedimension
Year week
Year and week.
Field ID_NORMALIZED_DATE_FIELD_YEAR_WEEK
TypeYEAR_WEEK
Data Typedimension
Date
Year, month, and day.
Field ID_NORMALIZED_DATE_FIELD_YEAR_MONTH_DAY
TypeYEAR_MONTH_DAY
Data Typedimension
Year month day hour
Year, month, day, and hour.
Field ID_NORMALIZED_DATE_FIELD_YEAR_MONTH_DAY_HOUR
TypeYEAR_MONTH_DAY_HOUR
Data Typedimension
Quarter of the year
Quarter of the year
Field ID_NORMALIZED_DATE_FIELD_QUARTER
TypeQUARTER
Data Typedimension
Month of the year
Month of the year
Field ID_NORMALIZED_DATE_FIELD_MONTH
TypeMONTH
Data Typedimension
Week of the year
Week of the year
Field ID_NORMALIZED_DATE_FIELD_WEEK
TypeWEEK
Data Typedimension
Week of the year (start Sunday)
Week of the year
Field ID_NORMALIZED_DATE_FIELD_WEEK_START_SUNDAY
TypeWEEK
Data Typedimension
Month and day
Month and day
Field ID_NORMALIZED_DATE_FIELD_MONTH_DAY
TypeMONTH_DAY
Data Typedimension
Day of the week
Week of the year
Field ID_NORMALIZED_DATE_FIELD_DAY_OF_WEEK
TypeDAY_OF_WEEK
Data Typedimension
Day of the month
Day of the year
Field ID_NORMALIZED_DATE_FIELD_DAY
TypeDAY
Data Typedimension
Hour of the day
Hour of the day
Field ID_NORMALIZED_DATE_FIELD_HOUR
TypeHOUR
Data Typedimension
Extracted Date
The date where the extraction take times.
Field ID_catchr_date_extract
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Platform Name
Return the platform name
Field ID_catchr_platform_name
TypeTEXT
Data Typedimension