电池代码	描述
PI966	LITHIUM ION BATTERIES IN COMPLIANCE WITH SECTION II OF PI966, 4 CELL/2 BATTERIES OR LESS
PI9662	LITHIUM ION BATTERIES IN COMPLIANCE WITH SECTION II OF PI966
PI967	LITHIUM ION BATTERIES IN COMPLIANCE WITH SECTION II OF PI967, 4 CELL/2 BATTERIES OR LESS
PI9672	LITHIUM ION BATTERIES IN COMPLIANCE WITH SECTION II OF PI967
PI969	LITHIUM METAL BATTERIES IN COMPLIANCE WITH SECTION II OF PI969, 4 CELL/2 BATTERIES OR LESS
PI9692	LITHIUM METAL BATTERIES IN COMPLIANCE WITH SECTION II OF PI969
PI970	LITHIUM METAL BATTERIES IN COMPLIANCE WITH SECTION II OF PI970, 4 CELL/2 BATTERIES OR LESS
PI9702	LITHIUM METAL BATTERIES IN COMPLIANCE WITH SECTION II OF PI970

商品属性

code	name
liquor	液体
oily	油状
cream	膏状
aquiform	水状
oneLessHundredMl	单个商品≤100ml
oneMoreHundredMl	单个商品＞100ml
stive	粉末
cakePowder	化妆品-粉饼
loosePowder	化妆品-散粉
tonerInk	硒鼓/墨盒
battery	电池
builtinBattery	内置电池
attachBattery	配套电池
oneLessHundredWh	单块电池≤100Wh
oneMoreHundredWH	单块电池＞100Wh
electronicCigarette	电子烟
containTar	含烟油
noTar	不含烟油
adult	成人用品
general	普货

请求参数

Header 参数

Token

string

鉴权Token

必需

示例值:

820E4150E0B2C191F0E

Body 参数application/json

refno

string

参考号

必需

<= 30 字符

product_code

string

产品名称

必需

<= 15 字符

sender

string

发件人

可选

<= 63 字符

sender_company

string

发件人公司名

可选

<= 63 字符

sender_countrycode

string

发件人国家二字码

可选

sender_address

string

发件人地址

可选

<= 254 字符

sender_city

string

发件人城市

可选

<= 63 字符

sender_zipcode

string

发件人邮编

可选

<= 15 字符

sender_provincecode

string

发件人省/州

可选

<= 63 字符

sender_phone

string

发件人电话

可选

<= 63 字符

sender_email

string

发件人email

必需

sender_ioss

string

发件人IOSS号

可选

<= 50 字符

receiver

string

收件人

必需

<= 63 字符

receiver_company

string

收件人公司

可选

<= 63 字符

receiver_countrycode

string

收件人国家代码

必需

<= 254 字符

receiver_address

string

收件人地址

必需

receiver_city

string

收件人城市

必需

<= 63 字符

receiver_zipcode

string

收件人邮编

可选

<= 15 字符

receiver_provincecode

string

收件人省/州

可选

<= 63 字符

receiver_phone

string

收件人电话

必需

<= 63 字符

receiver_email

string

收件人Email

可选

receiver_taxno

string

收件人VAT号

可选

<= 50 字符

receiver_eori

string

收件人EORI号

可选

<= 50 字符

quantity

integer

件数

必需

declared_value

number

总申报价值

必需

declared_currency

string

总申报币种(USD、EUR、JPY、HKD、MOP、TWD、 RUB、CAD、AUD、SGD、INR、KRW、PHP、NZD、THB、VND、GBP、CHF)

必需

customs_supervision_type

string

海关监管方式(0110：一般贸易、9610：9610、9710：9710、9810：9810)

可选

contents

string

英文品名

必需

<= 90 字符

dg_content_id

string

电池代码

可选

customsInfo

object

申报信息

必需

form_type

string

发票类型(COMMERCIAL_INVOICE：商业发票)

必需

freight_charges

string

运费

可选

other_charges

string

其他费

可选

items

array [object {17}]

申报明细

必需

attachments

object

附件

可选

type

string

附件类型（PAYMENT：交易证明）

可选

file_type

string

文件类型（PNG,JPG,PDF）

可选

data

string

文件数据（Base64编码）

可选

cargo_type

integer

包裹类型(0：文件、1：包裹、2：防水袋)

必需

packages

array [object {4}]

材积

必需

length

integer

长（cm）

必需

width

integer

长（cm）

必需

height

integer

长（cm）

必需

actual_weight

number

实重（kg）

必需

weight

number

总重量(kg)

必需

示例

{
  "refno": "8888888888",
  "sender": "SI LI",
  "sender_company": "ABC CO LTD",
  "sender_countrycode": "CN",
  "sender_address": "No.311 BAO AN",
  "sender_city": "SHEN ZHEN",
  "sender_zipcode": "518000",
  "sender_provincecode": "GD",
  "sender_phone": "13000000000",
  "sender_email": "abc@qq.com",
  "sender_ioss": "IM888888888",
  "receiver": "ANDREAS DONIS",
  "receiver_company": "ANDREAS DONIS",
  "receiver_countrycode": "US",
  "receiver_address": "IBACHSTRASSE 39A",
  "receiver_city": "SPOTSYLVANIA",
  "receiver_suburb": "",
  "receiver_zipcode": "22551",
  "receiver_provincecode": "VA",
  "receiver_phone": "10000001",
  "receiver_email": "abc@gmail.com",
  "receiver_taxno": "TAX888888888",
  "receiver_eori": "EORI888888888",
  "cargo_type": "1",
  "product_code": "DHL",
  "quantity": "1",
  "weight": "5.000",
  "declared_value": "20.00",
  "declared_currency": "USD",
  "contents": "JACKET",
  "dg_content_id": "",
  "bill_duty_paymenttype": "R",
  "customs_supervision_type": "0110",
  "customsInfo": {
    "items": [
      {
        "cn_description": "夹克衫",
        "description": "JACKET",
        "quantity": "10",
        "quantity_unit": "PCS",
        "unit_price": 2,
        "currency": "USD",
        "weight": 5,
        "hscode": "122222",
        "model": "",
        "brand": "",
        "material": "",
        "sales_url": "",
        "photo_url": "",
        "sku": "",
        "origin_countrycode": "CN",
        "attributes": [
          {
            "code": "battery",
            "name": "电池"
          }
        ]
      }
    ]
  },
  "attachments": [
    {
      "type": "PAYMENT",
      "file_type": "PDF",
      "data": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBA0A=="
    }
  ],
  "packages": [
    {
      "length": 12,
      "width": 12,
      "height": 12,
      "actual_weight": 12.444
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://api.bsdexp.com:8400/api/ec/order/booking' \
--header 'Token: 820E4150E0B2C191F0E' \
--header 'Content-Type: application/json' \
--data-raw '{
  "refno": "8888888888",
  "sender": "SI LI",
  "sender_company": "ABC CO LTD",
  "sender_countrycode": "CN",
  "sender_address": "No.311 BAO AN",
  "sender_city": "SHEN ZHEN",
  "sender_zipcode": "518000",
  "sender_provincecode": "GD",
  "sender_phone": "13000000000",
  "sender_email": "abc@qq.com",
  "sender_ioss": "IM888888888",
  "receiver": "ANDREAS DONIS",
  "receiver_company": "ANDREAS DONIS",
  "receiver_countrycode": "US",
  "receiver_address": "IBACHSTRASSE 39A",
  "receiver_city": "SPOTSYLVANIA",
  "receiver_suburb": "",
  "receiver_zipcode": "22551",
  "receiver_provincecode": "VA",
  "receiver_phone": "10000001",
  "receiver_email": "abc@gmail.com",
  "receiver_taxno": "TAX888888888",
  "receiver_eori": "EORI888888888",
  "cargo_type": "1",
  "product_code": "DHL",
  "quantity": "1",
  "weight": "5.000",
  "declared_value": "20.00",
  "declared_currency": "USD",
  "contents": "JACKET",
  "dg_content_id": "",
  "bill_duty_paymenttype": "R",
  "customs_supervision_type": "0110",
  "customsInfo": {
    "items": [
      {
        "cn_description": "夹克衫",
        "description": "JACKET",
        "quantity": "10",
        "quantity_unit": "PCS",
        "unit_price": 2.0,
        "currency": "USD",
        "weight": 5.0,
        "hscode": "122222",
        "model": "",
        "brand": "",
        "material": "",
        "sales_url": "",
        "photo_url": "",
        "sku": "",
        "origin_countrycode": "CN",
        "attributes": [
          {
            "code": "battery",
            "name": "电池"
          }
        ]
      }
    ]
  },
  "attachments": [
    {
      "type": "PAYMENT",
      "file_type": "PDF",
      "data": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBA0A=="
    }
  ],
  "packages": [
    {
      "length": 12,
      "width": 12,
      "height": 12,
      "actual_weight": 12.444
    }
  ]
}'

返回响应

🟢200成功

application/json

Body

ack

boolean

必需

结果状态：true：成功，false：失败

errors

array[string]

失败信息

必需

data

object

可选

refno

string

参考号

必需

label_size

string

面单尺寸

必需

label_url

string

面单地址

必需

示例

成功示例异常示例

{
  "ack": true,
  "errors": [],
  "data": {
    "refno": "8888888888",
    "label_size": "10cm*15cm",
    "label_url": "http://api.bsdexp.com:9000/store/tms/data/temp/2025/02/07/64a1a3760e4948889f102fb5a735b3ff.PDF"
  }
}

预报订单

商品属性#

请求参数

示例代码

返回响应

商品属性