SHOPIFY帮助指南
订单CSV列说明
订单CSV文件列的说明。
Shopify Plus
Transporter应用程序仅适用于Shopify Plus商店的Shopify App商店。
要使用Transporter应用程序将订单导入Shopify,您需要一个仅包含此记录类型的CSV文件。
相关主题
- CSV示例文件
- 列描述
- 备注
CSV示例文件
下载示例订单CSV文件:orders.csv。
您可以使用Transporter命令行工具生成此CSV文件,也可以按照下面描述的格式自行创建。
列描述
下表描述了CSV文件的列标题:
栏 | 描述 |
---|---|
名称 | 您在Shopify管理员和客户中看到的订单的标识符在其发票上看到。 此标识符在您的商店中必须是唯一的。 例如,#1001,1001-A和SH1001。 此列是必需的。 |
电子邮件 | 客户的电子邮件地址。 |
财务状况 | 与订单关联的付款状态。 有效值: 待处理 - 付款待处理。 在这种状态下付款可能会失败。 再次检查以确认付款是否已成功支付。 授权 - 付款已获得授权。 部分付款 - 订单已部分支付。 已付款 - 付款已付款。 部分退款 - 付款已部分退还。 退款 - 付款已退还。 无效 - 付款已无效。 |
履行状况 | 订单在履行订单项方面的状态。 有效值: 已履行 - 订单中的每个订单项均已完成。 null - 订单中的所有订单项均未得到满足。 部分 - 已完成订单中的至少一个订单项。 重新进货 - 订单中的每个订单项都已重新进货并且订单已取消。 |
货币 | 用于付款的货币的三字母代码(ISO 4217格式)。 例如,美元或欧元。 |
取消原因 | 订单被取消的原因。 有效值: 客户 - 客户取消订单。 欺诈 - 订单是欺诈性的。 库存 - 订单中的商品不在库存中。 拒绝 - 付款遭拒。 其他 - 不在此列表中的原因。 |
取消时间 | 订单取消时的日期和时间(ISO 8601格式)。 |
关闭时间 | 订单关闭时的日期和时间(ISO 8601格式)。 |
提醒 | 订单附带的可选说明。 客户可以查看此注释。 例如,“客户改变了主意。” |
标签 | 一串逗号分隔的标记,用于过滤和搜索。 每个以逗号分隔的标记最多可包含255个字符。 例如,“已审核,已包装,已送达”。 |
电话号码 | 客户的唯一电话号码([E.164](https://en.wikipedia.org/wiki/E.164)格式)。 电话号码可以使用不同的格式进行格式化,但每种格式必须代表可以从世界上任何地方拨打的号码。 以下格式均有效: 6135551212 16135551212 (613)555-1212 +1 613-555-1212 |
推荐网站 | 客户点击链接到他们商店的链接的网站。 例如,“http://www.anexample.com” |
处理时间 | 订单最初在其他平台中创建时的日期和时间(ISO 8601格式)。 此值显示在Shopify管理员的订单中,它是分析报告中使用的日期。 如果未指定此列的值,则此值将设置为导入订单的日期和时间。 |
来源名称 | 订单的来源(例如,平台的名称)。 导入后无法编辑此值。 例如,Transporter。 |
总重量 | 以克为单位的所有订单项权重的总和。 例如,11.94 |
总税收 | 当任何税收作为订单的一部分收取时(例如,当税价1列中有值)时,此列是必需的。 适用于订单的所有税(总价1,......,运费税1)的总和(必须是正数)。 如果您未包含此列的值,则订单中的总价值不会包含任何税费。 |
运输公司 | 业务名称(如果存在与发货地址相关联)。 |
运输名称 | 与送货地址关联的人员的全名。 |
运输电话 | 与送货地址关联的电话号码(E.164格式)。 电话号码可以使用不同的格式进行格式化,但每种格式必须代表可以从世界上任何地方拨打的号码。 以下格式均有效: 6135551212 16135551212 (613)555-1212 +1 613-555-1212 |
收货人名字 | 与送货地址关联的人员的名字。 |
收货人姓氏 | 与送货地址关联的人员的姓氏。 |
运输地址1 | 送货地址的第一个地址行。 例如,150埃尔金街 |
运输地址2 | 送货地址的可选地址行。 例如,单元202。 |
运输城市 | 送货地址的城市名称。 例如,渥太华或悉尼。 |
运输省份 | 客户所在地区(例如省,州,地区或地区)的名称。 如果包含此列,则需要“运输省代码”列。 例如,墨西哥城,塔斯马尼亚州,新南威尔士州或纽约州。 |
运输省代码 | 细分为该地区的代码(ISO 3166-2),例如该国家的州,省,县或地区。 ISO3116-2代码包含以下部分: 2个字符的国家/地区代码 - 不包含此部分。 连字符( - )分隔代码的两个部分 - 不包括连字符。 1到3个字符的细分代码 - 仅包括此部分。 ISO 3166-2细分代码省代码 MX-MEX(墨西哥城,墨西哥)MEX NY-US(纽约,美国)NY Ar-B(阿根廷布宜诺斯艾利斯)B FR-21(法国Côte-d'Or) |
运输国家 | 送货地址的国家名称。 例如,加拿大,印度或澳大利亚。 |
运输国家代码 | 客户地址所在国家/地区的双字母(ISO 3166-1 alpha-2代码)。 例如,CA for Canada。 即使您指定送货国家/地区,也建议您指定送货国家/地区代码。 |
运输邮政编码 | 客户地址的邮政编码,邮政编码或邮政编码。 例如,K2P 1L4,90210或110 012。 |
结算公司 | 与账单邮寄地址关联的人员的公司。 |
账单名称 | 与付款相关联的客户的全名。 如果您包含“结算名字”和“结算姓氏”列,请不要包含此列。 |
账单电话 | 与帐单邮寄地址关联的电话号码(E.164格式)。 电话号码可以使用不同的格式进行格式化,但每种格式必须代表可以从世界上任何地方拨打的号码。 以下格式均有效: 6135551212 16135551212 (613)555-1212 +1 613-555-1212 |
账单名字 | 与付款方式关联的人员的名字。 |
账单姓氏 | 与付款方式关联的人员的姓氏。 |
账单地址1 | 账单邮寄地址的第一个地址行。 例如,150埃尔金街 |
账单地址2 | 账单邮寄地址的可选地址行。 例如,单元202 |
账单城市 | 账单邮寄地址的城市名称。 例如,渥太华,德里和奥克兰。 |
账单省份 | 账单邮寄地址所在的地区(例如省,州,地区或地区)的名称。 如果包含此列,则需要“运输省代码”列。 例如,墨西哥城,纽约,努纳武特和新南威尔士。 |
账单省代码 | 细分为该地区的代码(ISO 3166-2),例如该国家的州,省,县或地区。 ISO3116-2代码包含以下部分: 2个字符的国家/地区代码 - 不包含此部分。 连字符( - )分隔代码的两个部分 - 不包括连字符。 1到3个字符的细分代码 - 仅包括此部分。 ISO 3166-2细分代码省代码 MX-MEX(墨西哥城,墨西哥)MEX 美国纽约(纽约,美国)纽约 AR-B(阿根廷布宜诺斯艾利斯)B FR-21(法国Côte-d'Or)21 |
账单邮政编码 | 账单邮寄地址的邮政编码,邮政编码或邮政编码。 例如,K2P 1L4。 |
账单国家 | 账单邮寄地址所在国家/地区的名称。 例如,加拿大,印度和德国。 |
账单国家代码 | 账单邮寄地址所在国家/地区的双字母(ISO 3166-1 alpha-2代码)。 例如,CA for Canada。 即使指定Country,也建议您指定Country代码。 |
Lineitem名称 | 购买的商品名称(产品型号)。 例如,蓝色衬衫。 此列是必需的。 |
Lineitem数量 | 购买的商品(产品型号)的数量(整数)。 例如,3。 |
Lineitem价格 | 应用任何折扣之前的项目(产品变体)的价格(小数)。 例如,10.50 .25和30。 |
Lineitem比较价格 | 物品的比较或建议价格(产品变体)。 例如,15。 |
Lineitem SKU | 物品的(产品型号)SKU(库存单位)编号。 |
Lineitem需要运输 | 商品(产品型号)是否需要发货。 有效值: true - 该项目需要发货。 false - 该项目不需要运送 |
Lineitem税收 | 该项目(产品变式)是否应纳税。 有效值: true - 该项目是应税的。 false - 该项目不征税。 |
Lineitem履行状态 | 在履行命令方面有多远。 有效值: null 完成 部分 |
税1标题 | 第一次征税的名称。 例如,HST或VAT。 |
税1价格 | 订单项的税额(ISO 4217)。 例如,1.50。 如果此列有值,则还必须包括“总税”列 |
税1税费 | 订单项的税费(十进制)。 例如,.7为7%的税率。 |
税2标题 | 第二次征税的名称。 |
税2价格 | 要征收的税额(ISO 4217)。 如果此列有值,则还必须包括“总税”列。 |
税2税费 | 订单项的税率。 |
税3标题 | 第三次征税的名称。 |
税3价格 | 订单项的税额(ISO 4217)。 如果此列有值,则还必须包括“总税”列。 |
税3税费 | 订单项的税率。 |
交易金额 | 交易所用金额(十进制)。 例如,50.00。 当您进行部分付款或部分退款时,此列是必需的。 |
交易种类 | 交易的类型。 包含任何事务列时,此列是必需的。 有效值: 授权 - 客户已同意支付的款项已获得授权,但尚未获取。 授权期限可能介于7到30天之间(取决于您的付款服务),而商店则会等待付款。 捕获 - 授权期间保留的资金转移。 销售 - 一步完成付款的授权和获取。 授权 - 取消待处理的授权或捕获。 退款 - 将获得的资金部分或全部退还给客户。 |
交易状态 | 交易的状态。 有效值: success - 交易已由支付网关成功完成。 这是默认值。 pending - 网关已收到交易信息,但它已发回一个响应,表明需要更多时间来完成它。 failure - 网关发送了一个事务未成功的响应(例如,因为卡被拒绝或商店没有正确设置支付网关)。 error - 发生通信错误(例如,未收到来自网关的响应或网关未收到请求)。 |
交易网关 | 通过发布交易的网关的名称。 可以在Shopify的支付网关页面上找到网关列表。 |
交易地点ID | 进行交易的地点的标识符。 当业务有多个交易位置时,通常需要一个值。 |
交易来源名称 | 交易的起源。 示例值:web,pos,iphone和android。 |
包邮行代码 | 对运输方法的参考。 默认值为Shipping line标题。 |
航线价格 | 运输方式的价值。 包含“装运”行标题列时,此列是必需的。 |
航运线标题 | 运输方式的标题。 包含Shipping line price列时,此列是必需的。 |
运输线承运人标识符 | 提供运费的承运人服务的标识符。 使用第三方运营商服务时通常需要一个值。 |
装运行要求履行服务ID | 请求送货方式的配送服务的标识符。 当运输方法需要由第三方履行服务处理时,通常需要一个值。 |
运费税1标题 | 运费行项目的税费名称。 例如,HST。 |
运费税1税率 | 运输行项目的税率(十进制)。 例如,0.15%的运费税率为15%(百分比)。 |
运费税价 | 运输行项目的税额(ISO 4217格式)。 如果此列有值,则还必须包括“总税”列。 例如,1.50。 |
折扣代码 | 折扣代码。 如果包含“折扣类型”列,则此列是必需的。 |
折扣金额 | 从订单中扣除的折扣价值(以商店货币计算)。 如果您包含折扣类型列,则此列是必需的. |
折扣类型 | 折扣的类型。 有效值: 固定金额 - 折扣代码是针对特定金额的。 这是默认值。 百分比 - 折扣代码是百分比金额。 运费 - 只要运费低于金额设定的价格,折扣优惠是免费送货。 例如,如果折扣金额为30且运费为30美元,则折扣为30美元。 如果折扣金额为30且运费为100美元,则没有折扣。 |
Metafield命名空间 | 一组元数据的容器。 要导入元字段,您需要在所有4个元字段列中包含值(Metafield命名空间,Metafield密钥,Metafield值和Metafield值类型)。 您应该为元域定义自定义命名空间,以区别于应用和Shopify使用的命名空间(包括默认全局)。 最大长度:20个字符。 |
Metafield Key | metafield的名称。 最大长度:30个字符。 如果包含其他元字段列,则此列是必需的。 |
Metafield价值 | 要存储为元数据的信息。 如果包含其他元字段列,则此列是必需的。 |
Metafield价值类型 | metafield的信息类型。 有效值: 串 整数 如果包含其他元字段列,则此列是必需的。 |
备注
文件名
CSV文件的名称需要包含单词顺序(它包含的对象类型的名称)。例如,myorders.csv。该文件需要采用UTF-8格式。
地址
订单中的送货地址成为客户的默认地址。当您导入具有与之关联的客户的订单时,Transporter应用程序会检查Shopify商店中的客户:
- 如果Transporter找到客户,则订单与客户关联,订单中的送货地址设置为客户的默认地址。
- 如果Transporter找不到客户,则添加客户并将订单与他们相关联。
多笔交易
通过为每个事务创建单独的行,可以将其他事务添加到订单中。订单名称需要包含在每一行中,以将交易链接到订单。
了解更多
- 产品CSV列说明
- 客户CSV列说明
- 使用Transporter导入数据
- Transporter应用程序故障排除
- 关于Transporter应用程序
- Transporter命令行工具