商店迁移数据代码库
已于 May 09, 2024 打印了此页面。若要查看当前版本,请访问 https://help.shopify.com/zh-CN/partners/building-stores-for-merchants/data-dictionary。
商店迁移数据代码库包含有关 REST Admin API Customer
、Order
和 Product
的信息。对于在向 Shopify 迁移商店方面拥有丰富经验的合作伙伴数,据代码库是的一个补充参考。
备注:数据代码库中的信息已针对 Shopify API 版本 2022-01 进行验证。有关最新信息和示例,请参阅 REST Admin API 参考文档。
Customer
资源属性
下表列出了一些有关 REST Admin API 属性的有用信息 Customer
资源。
属性 | 值 | 描述 | 数据类型 | 字段长度 | 字段访问权限 | 关键必填字段 |
---|---|---|---|---|---|---|
accepts_marketing | 默认值:0 | 客户是否同意接收营销材料。 | 布尔 | tinyint(1) | Y | |
accepts_marketing_ updated_at |
客户同意或反对通过电子邮件接收营销材料时采用 ISO 8601 格式的日期和时间。 | Datetime | 地址 | 与客户关联的地址列表。 | [{ Address }] | |
货币 | 采用 ISO 4217 格式的三个字母代码,表示客户在支付上一个订单时使用的货币。 | 字符串 | 商店货币 | 只读 | ||
创建时间 | 默认值:NULL | 将客户添加到商店时采用 ISO 8601 格式的日期和时间。 | Datetime | Datetime | 只读 | |
default_address | 客户的默认地址。 | { Address } | ||||
默认值:NULL | 客户的唯一电子邮件地址。 | 字符串 | varchar(255) | |||
first_name | 默认值:NULL | 客户的名字。 | 字符串 | varchar(255) | ||
id | 默认值:NULL | 全球唯一标识符。(此值自动递增。) | 整数 | bigint (20) | Y | |
last_name | 默认值:NULL | 客户的姓氏。 | 字符串 | varchar(255) | ||
last_order_id | 默认值:NULL | 客户最后一个订单的 ID。 | 整数 | bigint (20) | 只读 | |
last_order_name | 默认值:NULL | 客户最后一个订单的名称。 | 字符串 | 只读 | ||
元字段 | 默认值:NULL | 按命名空间和属于资源的密钥返回元字段。 | { Metafield } | |||
marketing_opt_ in_level |
|
客户同意通过电子邮件接收营销材料时所给予的营销订阅加入等级(如 M3 最佳做法指南所述)。 | 字符串,enum | |||
multipass_identifier | 默认值:NULL | 使用 Multipass 登录的客户的唯一标识符。 | 字符串 | varchar(255) | ||
注意 | 默认值:NULL | 有关客户的备注。 | 字符串 | mediumtext | ||
orders_count | 默认值:0 | 客户使用期内在商店中所下的订单数。 | 整数 | int(11) | 只读 | |
电话 | 默认值:NULL | 此客户的唯一(跨商店)电话号码(E.164 格式)。 | 字符串 | varchar(255) | ||
sms_marketing_ consent |
默认值:NULL | 客户电话号码的当前短信营销状态。 | 字符串 | |||
状态 |
|
客户账户在商店中的状态。 | 字符串,enum | varchar(255) | 只读 | |
标签 | 默认值:NULL | 已为客户添加最多 250 个标签的逗号分隔列表。 | 字符串 | 每个标签 255 字符 | ||
tax_exempt | 默认值:0 | 客户的订单是否免税。 | 布尔 | tinyint(1) | Y | |
tax_exemptions | 请参阅客户资源 ,了解完整的值列表。 | 应用于客户的免税列表。 | 字符串 | |||
total_spent | 默认值:0 | 客户一生中在订单上支出的总额。以商店货币列出。如果使用多币种,则显示的金额将采用默认货币,无汇率。 | 数字 | decimal(21,3) | 只读 | |
updated_at | 上次更新客户的日期和时间。基于 Shop 的时区。 | Datetime | Datetime | 只读 | ||
verified_email | 默认值:1 | 客户是否已验证其电子邮件地址。如果客户是通过 Shopify 后台或 API 创建的,则默认为 true。 | 布尔 | tinyint(1) | 只读 |
CustomerAddress
资源属性
下表列出了一些有关 REST Admin API CustomerAddress
资源属性的有用信息资源。此资源没有关键必填字段。
属性 | 值 | 描述 | 数据类型 | 字段长度 | 字段访问权限 |
---|---|---|---|---|---|
address1 | 默认值:NULL | 客户的邮寄地址。每个客户账户为 100。 | 字符串 | varchar(255) | |
address2 | 默认值:NULL | 客户邮寄地址的其他字段。 | 字符串 | varchar(255) | |
city | 默认值:NULL | 客户的城市、城镇或村。 | 字符串 | varchar(255) | |
company | 默认值:NULL | 客户的公司。 | 字符串 | varchar(255) | |
国家/地区 | 默认值:NULL | 客户所在的国家/地区。 | 字符串 | varchar(255) | |
first_name | 默认值:NULL | 客户的名字。 | 字符串 | varchar(255) | |
country_code | 与客户的国家/地区对应的两个字母的国家/地区代码。 | 字符串 | 只读 | ||
country_name | 客户的常态化国家/地区名称。 | 字符串 | |||
last_name | 默认值:NULL | 客户的姓氏。 | 字符串 | varchar(255) | |
姓名 | 客户的名字和姓氏。 | 字符串 | |||
电话 | 默认值:NULL | 客户在此地址的电话号码。 | 字符串 | varchar(255) | |
province | 默认值:NULL | 客户的区域名称。通常是省、州或县。 | 字符串 | varchar(255) | |
province_code | 客户区域两个字母的代码。 | 字符串 | 只读 | ||
邮编 | 默认值:NULL | 客户的邮政编码,也称为邮政编码、电子邮编等。 | 字符串 | varchar(255) |
Order
资源属性
下表列出了一些有关 REST Admin API 属性的有用信息 Order
资源。
属性 | 值 | 描述 | 数据类型 | 字段长度 | 字段访问权限 | 关键必填字段 |
---|---|---|---|---|---|---|
app_id | 默认值:NULL | 创建订单的应用的 ID。 | 整数 | bigint (20) | 只读 | |
billing_address | 默认值:NULL | 与付款方式关联的邮寄地址。此地址是一个可选字段,对于不需要付款方式的订单,此字段不可用。 | 整数 | bigint (20) | ||
browser_ip | 客户下单时使用的浏览器的 IP 地址。支持 IPv4 和 IPv6 。 | string | varchar(255) | 只读 | ||
buyer_accepts_marketing | 默认值:0 | 客户是否同意接收来自商店的电子邮件更新。 | 布尔值 | tinyint(1) | ||
cancel_reason |
|
取消订单的原因。 | string | varchar(255) | ||
cancelled_at | 默认值:NULL | 取消订单的日期和时间。如果未取消订单,则返回 null。 | date | Datetime | 只读 | |
cart_token | 默认值:NULL | 引用与订单关联的购物车时的唯一值。 | string | varchar(255) | 只读 | |
checkout_token | 默认值:NULL | 引用与订单关联的结账时的唯一值。 | string | varchar(64) | 只读 | |
client_details |
|
客户下单时使用的浏览器的相关信息: accept_language:浏览器理解的语言和区域设置。 browser_height:浏览器屏幕高度,以像素为单位(如果可用)。 browser_ip:浏览器 IP 地址。 browser_width:浏览器屏幕宽度,以像素为单位。(如果可用) session_hash:会话的哈希值。 user_agent:浏览客户端的详细信息,包括软件和操作版本。 |
对象 | 只读 | ||
closed_at | 默认值:NULL | 订单关闭的日期和时间(ISO 8601 格式)。如果订单未关闭,则返回 null。 | date | Datetime | 只读 | |
创建时间 | 默认值:NULL | 在 Shopify 中创建订单时自动更新的日期和时间(ISO 8601 格式)。无法更改此属性的值。 | date | datetime(6) | 只读 | |
货币 | 默认值:NULL | 商店币种的三个字母代码(ISO 4217 格式)。 | string | char(3) | ||
current_subtotal_price | 以商店币种表示的订单的当前小计价格。此字段的值反映订单编辑、退货和退款。 | string | varchar(255) | 只读 | ||
current_subtotal_price_set | 订单的当前小计价格(以商店和展示的货币计算)。与此字段关联的金额反映了订单编辑、退货和退款。 | 对象 | 只读 | |||
current_total_discounts | 当前以商店币种计算的订单总折扣。此字段的值反映订单编辑、退货和退款。 | string | varchar(255) | 只读 | ||
current_total_discounts_set | 以商店和展示货币计算的当前订单总折扣。与此字段关联的金额值反映订单编辑、退货和退款。 | 对象 | 只读 | |||
current_total_duties_set | 以商店和展示货币计算的对订单收取的当前总关税。与此字段关联的金额值反映订单编辑、退货和退款。 | 对象 | 只读 | |||
current_total_price | 订单的当前总价格(以商店币种表示)。此字段的值反映了订单编辑、退货和退款。 | string | varchar(255) | 只读 | ||
current_total_price_set | 以商店和展示货币计算的当前订单总价格。与此字段关联的金额值反映订单编辑、退货和退款。 | 对象 | 只读 | |||
current_total_tax | 以商店币种表示的对订单收取的当前总税费。此字段的值反映订单编辑、退货和退款。 | string | varchar(255) | 只读 | ||
current_total_tax_set | 以商店和展示货币计算的对订单收取的当前总税费。与此字段关联的金额值反映订单编辑、退货和退款。 | 对象 | 只读 | |||
customer | 默认值:NULL | 关于客户的信息。订单中可能没有客户,应用不应取决于客户对象的成立。如果订单是通过 Shopify POS 创建的,此值可能为空 | 整数 | bigint (20) | ||
customer_locale | 默认值:NULL | 两个字母或三个字母的语言代码,后跟区域修饰符。 | string | varchar(255) | 只读 | |
discount_applications | 叠加折扣申请的排序列表。 此 discount_applications 包括 3 种类型:discount_code、manual 和 script。所有这 3 种类型都拥有相同的结构,并且具有一些类型特定的属性。 |
阵列 | 只读 | |||
discount_codes | 应用于订单的折扣列表。 | 阵列 | ||||
客户的电子邮件地址 | varchar(255) | |||||
estimated_taxes | 订单的税费是否估算。从客户下单到订单发货之间,许多因素可能发生变化,这可能会影响税费的计算。完成订单税费后,此属性返回 false,且不会执行任何更改。 | 布尔值 | tinyint(1) | |||
financial_status |
|
与订单关联的付款状态。只能在创建订单时设置。 | string | varchar(255) | 只读 | |
fulfillment_status |
|
有关已发货的订单项的订单状态。 | string | varchar(255) | ||
发货 | 与订单关联的一系列订单 | 阵列 | ||||
id | 默认值:NULL | 订单 ID,用于 API 目的。这不同于 order_number 属性(这是店主和客户使用的 ID)。 | 整数 | bigint (20) | 只读 | |
landing_site | 默认值:NULL | 客户进入商店时登陆页面的 URL。 | string | varchar(4096) | 只读 | |
line_items | 订单项对象列表,每个对象都包含订单中商品的信息 | 阵列 | Y | |||
location_id | 默认值:NULL | 处理订单实际位置的 ID。如果您需要针对订单引用位置,请使用 FulfillmentOrder 资源。 | 整数 | bigint (20) | ||
姓名 | 默认值:NULL | 订单名称,通过将 order_number 属性与商家通用设置中设置的订单前缀和后缀组合生成。这不同于 ID 属性,它是 API 使用的订单的 ID。此字段还可以由 API 设置为任何字符串值。 | string | varchar(255) | ||
注意 | 默认值:NULL | 店主可以附加到订单的可选备注。 | string | |||
note_attributes | 默认值:NULL | 添加到订单中的额外信息。显示在订单详细信息页面的“其他详细信息”部分中。每个数组条目必须包含哈希值及名称和值键。 | string | |||
number | 默认值:NULL | 订单在商店订单计数中的位置。数字是顺序的,从 1 开始。 | 整数 | int(11) | 只读 | |
order_number | 订单在商店订单计数中的位置(从 1001 开始)。订单号是顺序的。 | 整数 | bigint (20) | 只读 | ||
order_status_url | 指向订单状态网页的 URL(如果适用)。 | string | varchar(255) | 只读 | ||
original_total_duties_set | 以商店和展示货币计算的对订单收取的原始总关税。 | 对象 | 只读 | |||
payment_gateway_names | 默认值:NULL | 用于订单的支付网关列表。 |
varchar(255) | 只读 | ||
payment_terms | 默认值:NULL | 处理付款的条款和条件。 | 对象 | bigint (20) | 只读 | |
电话 | 默认值:NULL | 接收短信通知的客户电话号码。 | string | varchar(255) | ||
presentment_currency | 默认值:NULL | 用于为客户显示价格的显示币种。 | string | char(3) | ||
processed_at | 默认值:NULL | 处理订单的日期和时间(ISO 8601 格式)。此值是显示在您的订单上并且用于分析报告的日期。如果您要从应用或其他平台导入订单,您可以将订单 processed_at 设置为过去的日期和时间,以匹配创建原始订单的时间。 | date | datetime(6) | ||
processing_method |
|
付款的处理方式 | string | varchar(255) | 只读 | |
referring_site | 默认值:NULL | 客户在其中点击链接转到您商店的网站。 | string | varchar(4096) | ||
退款 | 应用于订单的退款列表 | 阵列 | 只读 | |||
shipping_address | 默认值:NULL | 订单收货的邮寄地址。此地址可选,对不需要发货的订单不可用 | 整数 | bigint (20) | ||
shipping_lines | 一组对象,每个对象都详细说明了使用的发货方式。 | 阵列 | ||||
source_name | 默认值:NULL | 生成订单的来源。只能在创建订单期间设置,之后不可再写入设置。Shopify 渠道的值受保护,无法由其他 API 客户端分配:Web、pos、shopify_draft_order、iPhone 和 Android。可以为通过 API 创建的订单分配您所选择的任何其他字符串。如果未指定,系统会为新订单分配应用 ID 的值。 | string | varchar(255) | ||
subtotal_price | 应用折扣后但在扣除运费、关税、税费和小费之前以商店币种表示的订单价格。 | 整数 | bigint (20) | |||
subtotal_price_set | 应用折扣后(但在扣除运费、关税、税费和小费之前)以商店和展示货币计算的订单小计。 | 对象 | ||||
标签 | 附加到订单的标签,格式为以逗号分隔的值字符串。标签是额外的简短描述符,通常用于筛选和搜索。每个标签的长度限制为 40 个字符。 | string | varchar(4096) | |||
tax_lines | 一组税务订单对象,每个对象都详细说明了适用于订单的税费。每个对象具有以下属性: 通过 API 创建订单时,可以在订单或订单项目上指定税行,但不能同时在两者上指定。订单上指定的税行会拆分为已创建订单中的应纳税订单项目。 |
阵列 | ||||
taxes_included |
|
税费是否包含在订单小计中。 | 布尔值 | tinyint(1) | ||
test |
|
这是不是测试订单。 | 布尔值 | tinyint(1) | 只读 | |
token | 默认值:NULL | 引用订单时的唯一值。 | string | varchar(32) | 只读 | |
total_discounts | 默认值:0 | 应用于以商店币种表示的订单价格的总折扣。 | string | decimal(21,3) | ||
total_discounts_set | 应用于以商店和展示货币计算的订单价格的总折扣。 | 对象 | ||||
total_line_items_price | 默认值:0 | 以商店币种计算的所有订单项目价格的总额。 | string | decimal(21,3) | ||
total_line_items_price_set | 以商店和展示货币计算的所有订单项目价格的总额。 | 对象 | ||||
total_outstanding | 默认值:0 | 以商店币种计算的订单的未结总额。 | string | decimal(21,3) | ||
total_price | 默认值:0 | 以商店币种计算的所有订单项目的价格、折扣、运费、税费和小费的总额。必须为正数。 | string | decimal(21,3) | ||
total_price_set | 以商店和展示货币计算的订单总价格。 | 对象 | ||||
total_shipping_price_set | 以商店和展示货币计算的订单的总运费(不包括折扣和退货)。如果 taxes_included 设置为 true,则 total_shipping_price_set 包含税费。 | 对象 | ||||
total_tax | 默认值:0 | 以商店币种计算的应用于订单的所有税费总额。必须为正数。 | string | decimal(21,3) | ||
total_tax_set | 应用于以商店和展示货币计算的订单总税费。 | 对象 | ||||
total_tip_received | 以商店币种计算的订单中的所有小费总额。 | 整数 | bigint (20) | 只读 | ||
total_weight | 默认值:0 | 所有订单项目的总重量(以克为单位)。由于已从订单中删除项目,因此不会调整总重量。 | 整数 | bigint(20) 未分配 | ||
updated_at | 上次修改订单的日期和时间(ISO 8601 格式)。 | date | datetime(6) | 只读 | ||
user_id | 默认值:NULL | 登录 Shopify POS 并处理订单的用户 ID(如果适用)。 | 整数 | bigint (20) |
Product
资源属性
下表列出了一些有关 REST Admin API 属性的有用信息 Product
资源。
属性 | 值 | 描述 | 数据类型 | 字段长度 | 字段访问权限 | 关键必填字段 |
---|---|---|---|---|---|---|
body_html | 默认值:NULL | 产品描述。支持 HTML 格式设置。 | string | mediumtext | ||
创建时间 | 默认值:NULL | 订单创建的日期和时间(ISO 8601 格式)。 | date | Datetime | 只读 | |
handle | 默认值:NULL | string | varchar(255) | |||
id | 默认值:NULL | 一个未签名的 64 位整数,用作产品的唯一标识符。每个 ID 在 Shopify 系统内都是唯一的。没有两种产品具有相同的 ID,即使它们来自不同的商店。 | 整数 | bigint (20) | 只读 | Y |
图片 | 产品图片对象的列表,每个对象代表与产品关联的图片。 | [{ product_image }] | ||||
选项 | 自定义产品属性。例如,尺寸、颜色和材质。每个产品最多有 3 个选项,每个选项值最多为 255 个字符。产品多属性由选项值组合构成。在没有值的情况下无法创建选项。若要创建新选项,还需要创建具有相关选项值的多属性。 | 阵列 | ||||
product_type | 默认值:NULL | 用于筛选和搜索产品的产品的分类。 | string | varchar(255) | ||
published_at | 默认值:NULL | 产品发布日期和时间(ISO 8601 格式)。可以设置为 null 以从在线商店渠道取消发布产品。 | date | Datetime | ||
published_scope |
|
产品是否已发布到 POS 渠道。 | string | |||
状态 |
|
产品的状态。 | string | varchar(32) | ||
标签 | 一串以逗号分隔的标签,用于筛选和搜索。产品最多可以有 250 个标签。每个标签最多包含 255 个字符。 | string | ||||
template_suffix | 默认值:NULL | 用于产品页面的 Liquid 模板的后缀。如果指定了此属性,则产品页面将使用名为“product.suffix.liquid”的模板,其中“suffix”是此属性的值。如果此属性为“”或 null,则产品页面使用默认模板“product.liquid”。 | string | varchar(255) | ||
title | 默认值:NULL | 产品名称 | string | varchar(255) | ||
updated_at | 默认值:NULL | 上次修改产品的时间(ISO 8601 格式)。产品 updated_at 的值可能出于不同原因而发生变化。例如,如果为已设置库存跟踪的产品下单,则库存调整计数为更新。 | date | Datetime | 只读 | |
多属性 | 一组产品多属性,每个代表了不同版本的产品。位置属性为只读。多属性的位置以列出的顺序表示。 | 阵列 | ||||
厂商 | 默认值:NULL | 产品厂商的名称。 | string | varchar(255) |
ProductImage
资源属性
下表列出了一些有关 REST Admin API ProductImage
资源属性的有用信息资源。此资源没有只读或关键必填字段。
属性 | 值 | 描述 | 数据类型 | 字段长度 |
---|---|---|---|---|
创建时间 | 默认值:NULL | 创建产品图片的日期和时间。API 返回此值(ISO 8601 格式)。 | date | Datetime |
height | 默认值:NULL | 上传时确定的图片高度尺寸。 | smallint(4) 未签名 | |
id | 默认值:NULL | 产品图片的唯一数字标识符。(auto_increment) | 整数 | bigint (20) |
position | 默认值:0 | 产品图片在列表中的顺序。第一张产品图片位于位置 1,是产品的“主”图片。 | smallint(5) 未签名 | |
product_id | 默认值:NULL | 与图片关联的产品的 ID。 | bigint (20) | |
src | 指定产品图片的位置。此参数支持可用于检索图片的修改副本的 URL 筛选器。例如,将 _small 添加到文件名中,以检索分辨率为 100 x 100 像素的图片的缩放副本(例如,ipod-nano_small.png),或添加 _2048x2048 以检索分辨率为 2048 x 2048 像素的图片副本(例如,ipod-nano_2048x2048.png)。 | |||
updated_at | 默认值:NULL | 上次修改产品图片的日期和时间。API 以 ISO 8601 格式返回此值。 | date | Datetime |
variant_ids | 与图片关联的多种 ID 数组。 | |||
width | 默认值:NULL | 上传时确定的图片宽度尺寸。 | smallint(4) 未签名 |
ProductVariant
资源属性
下表列出了一些有关 REST Admin API ProductVariant
资源属性的有用信息资源。此资源没有关键必填字段。
属性 | 值 | 描述 | 数据类型 | 字段长度 | 字段访问权限 |
---|---|---|---|---|---|
条码 | 默认值:NULL | 产品的条码、UPC 或 ISBN 编号。 | varchar(255) | ||
compare_at_price | 默认值:NULL | 调整或促销前产品的原始价格。 | decimal(20,2) | ||
创建时间 | 默认值:NULL | 创建产品多属性时采用 ISO 8601 格式的日期和时间。 | date | Datetime | |
fulfillment_service |
|
与产品多属性关联的发货服务。 | varchar(255) | ||
grams | 产品多属性的重量,以克为单位。 | ||||
id | 默认值:NULL | 产品多属性的唯一数字识别码。此值自动递增。 | bigint (20) | ||
image_id | 默认值:NULL | 产品图片的唯一数字识别码。图片必须与多属性与同一产品关联。 | bigint (20) | ||
inventory_item_id | 库存商品的唯一标识符,在库存 API 中用于查询库存信息。 | ||||
inventory_management |
|
用于跟踪产品多属性的库存商品数量的发货服务。 | varchar(255) | ||
inventory_policy |
|
客户是否可以在缺货时订购产品多属性。 | varchar(40) | ||
inventory_quantity | 默认值:1 | 所有位置的库存总量。若要调整特定位置的库存,请使用 InventoryLevel 资源。 | int(11) | 只读 | |
option | 店主用于定义产品多属性的自定义属性。您可以为产品多属性定义三个选项:选项1、选项2、选项3。默认值:默认标题。标题字段是选项1、选项2 和选项3 字段的串联。更新选项字段会更新标题字段。 | ||||
position | 默认值:0 | 产品多属性列表中产品多属性的顺序。列表中的第一个位置为 1。多属性的位置以列出的顺序表示。 | smallint(5) 未签名 | 只读 | |
presentment_prices | 以商店各种已启用的显示币种来计算的多属性的显示价格和原价的列表。每个价格对象具有以下属性: -currency_code:商店中一种已启用的显示币种的三个字母代码(ISO 4217 格式)。 -amount:以显示价格计算的多属性的价格或原价。 需要标头 'X-Shopify-Api-Features':“include-presentment-prices”。 |
只读 | |||
price | 默认值:0 | 产品多属性的价格。 | decimal(20,2) | ||
product_id | 默认值:NULL | 产品的唯一数字标识符。 | bigint (20) | ||
requires_shipping | 默认值:1 | 此属性已弃用。请改用 InventoryItem 资源上的 “requires_shipping”属性。 | 布尔值 | tinyint(1) | |
sku | 商店中产品多属性的唯一标识符。必须满足要求才能连接到 FulfillmentService。 | varchar(255) | |||
tax_code | 此参数仅适用于安装了 Avalara AvaTax 应用的商店。为产品多属性指定 Avalara 税务代码。 | ||||
taxable | 默认值:1 | 在销售产品多属性时是否收税。 | 布尔值 | tinyint(1) | |
title | 产品多属性的标题。标题字段是选项1、选项2 和选项3 字段的串联。您只能使用选项字段更新标题。 | varchar(255) | 只读 | ||
updated_at | 默认值:NULL | 上次修改产品多属性的日期和时间。以 ISO 8601 格式返回。 | date | Datetime | |
weight | 使用 weight_unit 指定的单位系统表示的产品多属性的重量。 | ||||
weight_unit |
|
适用于产品多属性重量的计量单位。如果您未指定商店 weight_unit 的值,则采用商店的默认计量单位。 | varchar(2) |