端点
注意: 响应键可能会被修改和/或添加额外的键。如果您将使用该端点,请设置您的代码以适应这些可能性。
POST | https://api.iglobalstores.com/v2/orderDetail
HTTPS 请求
字段 | 备注 |
---|---|
HTTP 方法 | POST |
端点 | https://api.iglobalstores.com/v2/orderDetail |
协议 | HTTPS |
消息格式 | JSON |
接受 HTTP 头 | Accept: application/json |
内容类型 HTTP 头 | Content-Type: application/json |
请求体中的 JSON 键/值对
字段 | 备注 |
---|---|
orderId 可选,如果传递 referenceId 参数 | Zonos 订单 Id 可以与或不与您的商店 Id 和连字符一起传递(示例:123-45678 或 45678)。注意:在订单完成和付款后,客户将被重定向到托管在您域上的订单完成/感谢页面。URL 将包含一个查询字符串参数“orderId”,该参数将包含此值。integer / string |
referenceId 可选,如果传递 “orderId” 参数 | 此参数用于通过在 createTempCart API 服务端点中传递的唯一 referenceId 查找订单的数据。当打算根据 orderId 参数查找订单详细信息时,此参数应留空或为 null。string |
secret 必需 | 由 Zonos 提供的 API 秘密 GUIDstring |
storeId 必需 | 由 Zonos 提供的商店 ID。integer |
错误 HTTP 响应
错误代码 | 消息 | 含义 |
---|---|---|
415 | 不支持的媒体类型 | HTML 实体。HTTP “Content-Type” 头无效。 |
406 | 不可接受 | HTML 实体。HTTP “Accept” 头无效。 |
400 | 错误请求 | “error”:”orderId: 999-99999 不是有效的 orderId”“error”:”找不到 orderId: 999-99999 的订单”“error”:”无效的安全凭证”“error”:”无效的请求体”“error”:”参数 orderId 或 referenceId 是必需的”“error”:”不能同时指定参数 orderId 和 referenceId”“error”:”找不到 orderId: 999-99999 的订单”“error”:”参数 store 是必需的”“error”:”找不到 storeId: 999 的 referenceId: 999999 的订单”“error”:”storeId: 999 的 referenceId: 999999 已重复”“error”:”无法检索 referenceId: 999999 的订单” |
500 | 内部服务器错误 | “error”:”无法处理订单详细信息” |
响应 JSON 定义
字段 | 备注 |
---|---|
error | 仅在发生错误时此参数存在,并将包含错误描述。字符串 |
order | 这是订单详细信息的映射。JSON 字符串 |
order.billingZip | 订单的账单地址 - 值已输入到Zonos Checkout。字符串 |
orderboxCount | 此字段描述将用于发货的箱子,传递createTempCart 请求中。字符串 |
order.carrierAccountNumber | 访客自己的运输承运人账户号码;在启用访客承运人账户时使用。字符串 |
order.carrierAccountShippingMethod | 访客自己运输承运人账户上选择的运输方式;在启用访客承运人账户时使用。字符串 |
order.cslListMatch | 合并筛查清单 (CSL) 匹配。一个布尔值,指示客户信息是否在美国合并筛查清单中产生匹配,并应审查以确定可能的拒绝方关联。布尔值 |
order.customerSelectedShippingName | 在Zonos Checkout内显示的运输选项名称。字符串 |
order.dutyTaxesBreakdown | 税费明细的映射。注意 - 如果适用,国际处理费 (IPF) 不包括在内。JSON 字符串 |
order.dutyTaxesBreakdown.brokerageFee | 以美元计的经纪费金额;正浮点数,两位小数。整数 |
order.dutyTaxesBreakdown.dispursementFee | 以美元计的支付费用金额;正浮点数,两位小数。整数 |
order.dutyTaxesBreakdown.duty | 以美元计的关税金额;正浮点数,两位小数。整数 |
order.dutyTaxesBreakdown.prepaymentFee | 以美元计的预付款费用金额;正浮点数,两位小数。整数 |
order.dutyTaxesBreakdown.vatOnDispursementFee | 以美元计的支付费用的增值税/税费金额;正浮点数,两位小数。整数 |
order.dutyTaxesBreakdown.vatTax | 以美元计的增值税/税费金额,不包括支付费用的增值税/税费;正浮点数,两位小数。整数 |
order.dutyTaxesTotal | 以美元计的关税和税费总额;正浮点数,两位小数。整数 |
order.foreignCurrencyCode | 订单支付结算的货币代码。字符串 |
remittance_amount | 需要汇款到特定国家的金额(例如,英国增值税)。十进制 |
order.grandTotal | 以美元计的总金额;正浮点数,两位小数。整数 |
order.grandTotalForeign | 以结算货币计的总金额;正浮点数,两位小数。整数 |
order.items | 项目映射的列表。项目映射包含在临时购物车创建时传递给Zonos Checkout的项目详细信息。有关项目属性的更多详细信息,请查createTempCart API 文档。JSON 字符串 |
order.itemsCount | 订单行项目的计数。整数 |
order.itemsTotal | 以美元计的商品/产品总额;正浮点数,两位小数。整数 |
order.itemsTotalForeign | 以结算货币计的商品/产品总额;正浮点数,两位小数。整数 |
order.items[index].height | 正浮点数,两位小数。整数 |
order.items[index].itemNonShippable | 布尔值 |
order.items[index].length | 正浮点数,两位小数。整数 |
order.items[index].quantity | 整数 |
order.items[index].weight | 正浮点数,保留两位小数integer |
order.items[index].width | 正浮点数,保留两位小数integer |
order.items[index].unitPrice | 正浮点数,保留两位小数integer |
order.merchantOrderId | 与订单关联的MerchantOrderId 通updateMerchantOrderIdAPI服务端点。string |
order.misc1 | 通createTempCartAPI服务端点与订单关联的附加值。string |
order.misc2 | 通createTempCartAPI服务端点与订单关联的附加值。string |
order.misc3 | 通createTempCartAPI服务端点与订单关联的附加值。string |
order.misc4 | 通createTempCartAPI服务端点与订单关联的附加值。string |
order.misc5 | 通createTempCartAPI服务端点与订单关联的附加值。string |
order.misc6 | 通createTempCartAPI服务端点与订单关联的附加值。string |
order.nationalIdentifier | 订单所需的附加国际账单地址信息。值已输入到Zonos Checkout。string |
order.notes | 注释映射的列表;注释映射包含有关订单注释的详细信息。JSON string |
order.notes[index].createdByUser | string |
order.notes[index].customerNote | 一个布尔值,指示这是否是客户创建的关于订单、运输等的注释。boolean |
order.notes[index].dateCreated | millis |
order.notes[index].dateCreatedString | string |
order.notes[index].flagged | 一个boolean ,指示此注释是否被标记为重要 |
order.notes[index].note | 注释内容string |
order.optInEmail | 表示客户在Zonos Checkout中选择了“注册我们的新闻通讯”复选框,仅在您选择在checkout页面上显示此复选框时适用。boolean |
order.orderId | 订单在Zonos系统中的识别号码string |
order.orderDate | 订单创建时间戳毫秒,UTC/GMT。millis |
order.orderDateString | 订单创建时间戳字符串,UTC/GMT。string |
order.orderStatus | 订单在Zonos系统中的状态/状态。有关orderStatus 使用的更多详细信息,请查在此处检索订单文档。有关订单状态的更多信息可以在此处更新订单文档中找到。string |
order.orderStatusDate | 在Zonos系统中最近一次orderStatus 更改的时间戳毫秒,UTC/GMT。millis |
order.orderStatusDateString | 在Zonos系统中最近一次orderStatus 更改的时间戳字符串,UTC/GMT。string |
order.paymentProcessing | paymentProcessing 详细信息的映射。一些参数可能不适用于您的帐户,并将从响应中排除。JSON string |
order.paymentProcessing.captureDate | 如果可用,支付捕获的日期(毫秒)。如果Zonos正在处理支付,则此节点将从响应中排除。millis |
order.paymentProcessing.captureDateString | 如果可用,支付捕获的日期字符串。如果Zonos正在处理支付,则此节点将从响应中排除。string |
order.paymentProcessing.cardType | 信用卡品牌。如果Zonos正在处理支付,则此节点将从响应中排除。string |
order.paymentProcessing.lastFour | 账单信用卡号的最后四位数字。如果 Zonos 正在处理付款,则此节点将从响应中排除。string |
order.paymentProcessing.paymentGateway | 付款网关名称。如果 Zonos 正在处理付款,将指示 “iGlobal_CC” 或 “iGlobal_PayPal”。string |
order.paymentProcessing.transactionType | 表示交易类型 “AUTH_CAPTURE” 或 “AUTH_ONLY”。如果 Zonos 正在处理付款,则此节点将从响应中排除。string |
order.poNumber | 在 Zonos Checkout 中指定的订单的采购订单号;在启用采购订单时使用。string |
order.quotedDutyTaxes | 在 Zonos Checkout 中报价的关税和税费,以美元显示;正浮点数,两位小数。integer |
order.quotedDutyTaxesForeign | 在 Zonos Checkout 中报价的关税和税费。以结算货币显示;正浮点数,两位小数。integer |
order.referenceId | 通过 createTempCart API 服务端点与订单关联的唯一 referenceId 。string |
order.shipComplete | 表示订单是否应分多个部分发货。boolean |
order.shippingCarrierServiceLevel | 选定运输选项的承运人和服务级别标识符。string |
order.shippingInstructions | 可自定义的运输服务级别说明。string |
order.shippingTotal | 以美元计算的运输总费用;正浮点数,两位小数。integer |
order.shippingTotalForeign | 以结算货币计算的运输总费用;正浮点数,两位小数。integer |
order.testOrder | 表示订单是否为测试订单。boolean |
order.trackingNumber | 为货物生成的追踪号码(如适用)。string |
order.zip | 订单的目的地/运输地址 - 值是输入到 Zonos Checkout 中或通过重定向传递到 Zonos Checkout 的。string |
其他数据类型:
order.address1
order.address2
order.address3
order.altPhone
order.billingAddress1
order.billingAddress2
order.billingAddress3
order.billingAltPhone
order.billingCity
order.birthDate
order.billingCompany
order.billingCountryCode
order.billingCountryName
order.billingEmail
order.billingName
order.billingPhone
order.billingState
order.city
order.company
order.countryCode
order.countryName
order.email
order.items[index].countryOfOrigin
order.items[index].description
order.items[index].imageURL
order.items[index].itemBrand
order.items[index].itemCategory
order.items[index].itemColor
order.items[index].itemCustomization
order.items[index].itemDescriptionDetailed
order.items[index].itemDescriptionLong
order.items[index].itemFabricContent
order.items[index].itemHSCode
order.items[index].itemLtlClass
order.items[index].itemMaterial
order.items[index].itemURL
order.items[index].productId
order.items[index].sku
order.items[index].productId
order.items[index].weightUnits
order.name
order.phone
order.state
订单详细信息
了解订单详细信息端点的工作原理。orderDetail
端点用于安全地检索通过 Zonos Checkout 完成的订单的详细信息和状态。