制单接口文档
  1. OPENAPI - 制单
制单接口文档
  • OPENAPI - 制单
    • 回邮单运输(异步)
      POST
    • 删除订单
      GET
    • 评估价格
      POST
    • 下单运输(异步)
      POST
    • 获取标签
      GET
    • 取消转单号
      GET
  • OPENAPI - 认证
    • 授权
      GET
  1. OPENAPI - 制单

回邮单运输(异步)

POST
http://api.intergo.cn/open-api/open/makeOrder/v1/asyncReturnShipment
OPENAPI - 制单

请求参数

Header 参数
Authorization
string 
认证 Token
可选
默认值:
Bearer test1
Body 参数application/json
makeServiceCode
string 
渠道编码
必需
示例值:
UPS
customNo
string 
客户单号
必需
示例值:
test_001
weightUnit
string 
必需
重量单位(cm/kg、in/lb)
示例值:
cm/kg
currencyCode
string 
申报货币编码
必需
示例值:
USD
declaredAmount
number 
申报金额
必需
示例值:
11.2
referenceNo1
string 
参考号一
可选
示例值:
number1
referenceNo2
string 
参考号二
可选
示例值:
number2
pkgList
array[object (PackageVo) {5}] 
箱单信息
必需
pkgNo
string 
客户箱号
必需
示例值:
C00001-1
length
number 
箱体长
必需
示例值:
12
breadth
number 
箱体宽
必需
示例值:
12
height
number 
箱体高
必需
示例值:
12
netWeight
number 
箱体实重
必需
示例值:
12
packageProduct
array[object (ProductVo) {8}] 
可选
产品信息 orderType=0 必填
productEnName
string 
产品英文品名
必需
>= 0 字符<= 128 字符
示例值:
test
productCnName
string 
产品中文品名
必需
>= 0 字符<= 128 字符
示例值:
测试
commodityCode
string 
海关编码
必需
>= 0 字符<= 16 字符
示例值:
10001000
unitPrice
number 
商品单价
必需
示例值:
1.22
unitNumber
integer <int32>
商品数量
必需
示例值:
1
unit
string 
商品数量单位
必需
示例值:
EA
proWeight
number 
产品重量
必需
示例值:
1
originCountryCode
string 
产地国二字码
必需
示例值:
CN
senderAddress
object (AddressVo) 
发件人信息
必需
contact
string 
联系人
必需
>= 0 字符<= 64 字符
示例值:
TOM
companyName
string 
公司
必需
>= 0 字符<= 64 字符
示例值:
DEMO company
phone
string 
电话
必需
>= 0 字符<= 20 字符
示例值:
000000000
countryCode
string 
国家二字码
必需
>= 0 字符<= 2 字符
示例值:
US
province
string 
省/州
可选
>= 0 字符<= 35 字符
示例值:
IN
city
string 
城市
必需
>= 0 字符<= 32 字符
示例值:
shenzhen
postCode
string 
邮编
必需
>= 0 字符<= 16 字符
示例值:
123456
address1
string 
地址一
必需
>= 0 字符<= 50 字符
address2
string 
地址二
可选
>= 0 字符<= 50 字符
address3
string 
地址三
可选
>= 0 字符<= 50 字符
doorplate
string 
DHL门牌号
可选
>= 0 字符<= 16 字符
account
string 
付费账号
可选
>= 0 字符<= 32 字符
vatNo
string 
VAT税号
可选
>= 0 字符<= 32 字符
iossNo
string 
ioss税号
可选
>= 0 字符<= 32 字符
residential
boolean 
是否非FBA地址
必需
addressCode
string 
可选
地址编码 FBA地址必填
>= 0 字符<= 16 字符
示例值:
MDT5
email
string 
邮箱
可选
>= 0 字符<= 50 字符
示例值:
****@163.com
recipientAddress
object (AddressVo) 
收件人信息
可选
isPickUp
integer <int32>
必需
必填 是否预约提货 0 否 1 是
isShipAddr
integer <int32>
可选
是否使用发件地址提货 0 否 1 是
standbyAddress
object (AddressVo) 
取货地址
可选
pickUpDateStr
string 
可选
isPickUp=1 必填 提货日期yyyy-MM-dd
pickUpTimeList1
array[string]
可选
isPickUp=1 选填 时间区间1 HH-SS, ["12:24","23:12"] length = 2
pickUpTimeList2
array[string]
可选
isPickUp=1 选填 时间区间2 HH-SS
示例
{
    "makeServiceCode": "UPS",
    "customNo": "test_001",
    "weightUnit": "cm/kg",
    "currencyCode": "USD",
    "declaredAmount": 11.2,
    "referenceNo1": "number1",
    "referenceNo2": "number2",
    "pkgList": [
        {
            "pkgNo": "C00001-1",
            "length": 12,
            "breadth": 12,
            "height": 12,
            "netWeight": 12
        }
    ],
    "packageProduct": [
        {
            "productEnName": "test",
            "productCnName": "测试",
            "commodityCode": "10001000",
            "unitPrice": 1.22,
            "unitNumber": 1,
            "unit": "EA",
            "proWeight": 1,
            "originCountryCode": "CN"
        }
    ],
    "senderAddress": {
        "contact": "TOM",
        "companyName": "DEMO company",
        "phone": "000000000",
        "countryCode": "US",
        "province": "IN",
        "city": "shenzhen",
        "postCode": "123456",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "doorplate": "string",
        "account": "string",
        "vatNo": "string",
        "iossNo": "string",
        "residential": true,
        "addressCode": "MDT5",
        "email": "****@163.com"
    },
    "recipientAddress": {
        "contact": "TOM",
        "companyName": "DEMO company",
        "phone": "000000000",
        "countryCode": "US",
        "province": "IN",
        "city": "shenzhen",
        "postCode": "123456",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "doorplate": "string",
        "account": "string",
        "vatNo": "string",
        "iossNo": "string",
        "residential": true,
        "addressCode": "MDT5",
        "email": "****@163.com"
    },
    "isPickUp": 0,
    "isShipAddr": 0,
    "standbyAddress": {
        "contact": "TOM",
        "companyName": "DEMO company",
        "phone": "000000000",
        "countryCode": "US",
        "province": "IN",
        "city": "shenzhen",
        "postCode": "123456",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "doorplate": "string",
        "account": "string",
        "vatNo": "string",
        "iossNo": "string",
        "residential": true,
        "addressCode": "MDT5",
        "email": "****@163.com"
    },
    "pickUpDateStr": "string",
    "pickUpTimeList1": [
        "string"
    ],
    "pickUpTimeList2": [
        "string"
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://api.intergo.cn/open-api/open/makeOrder/v1/asyncReturnShipment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "makeServiceCode": "UPS",
    "customNo": "test_001",
    "weightUnit": "cm/kg",
    "currencyCode": "USD",
    "declaredAmount": 11.2,
    "referenceNo1": "number1",
    "referenceNo2": "number2",
    "pkgList": [
        {
            "pkgNo": "C00001-1",
            "length": 12,
            "breadth": 12,
            "height": 12,
            "netWeight": 12
        }
    ],
    "packageProduct": [
        {
            "productEnName": "test",
            "productCnName": "测试",
            "commodityCode": "10001000",
            "unitPrice": 1.22,
            "unitNumber": 1,
            "unit": "EA",
            "proWeight": 1,
            "originCountryCode": "CN"
        }
    ],
    "senderAddress": {
        "contact": "TOM",
        "companyName": "DEMO company",
        "phone": "000000000",
        "countryCode": "US",
        "province": "IN",
        "city": "shenzhen",
        "postCode": "123456",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "doorplate": "string",
        "account": "string",
        "vatNo": "string",
        "iossNo": "string",
        "residential": true,
        "addressCode": "MDT5",
        "email": "****@163.com"
    },
    "recipientAddress": {
        "contact": "TOM",
        "companyName": "DEMO company",
        "phone": "000000000",
        "countryCode": "US",
        "province": "IN",
        "city": "shenzhen",
        "postCode": "123456",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "doorplate": "string",
        "account": "string",
        "vatNo": "string",
        "iossNo": "string",
        "residential": true,
        "addressCode": "MDT5",
        "email": "****@163.com"
    },
    "isPickUp": 0,
    "isShipAddr": 0,
    "standbyAddress": {
        "contact": "TOM",
        "companyName": "DEMO company",
        "phone": "000000000",
        "countryCode": "US",
        "province": "IN",
        "city": "shenzhen",
        "postCode": "123456",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "doorplate": "string",
        "account": "string",
        "vatNo": "string",
        "iossNo": "string",
        "residential": true,
        "addressCode": "MDT5",
        "email": "****@163.com"
    },
    "pickUpDateStr": "string",
    "pickUpTimeList1": [
        "string"
    ],
    "pickUpTimeList2": [
        "string"
    ]
}'

返回响应

🟢200成功
*/*
OK
Body
code
integer <int32>
错误码
可选
data
object (ShipmentRespDto) 
返回数据
可选
customNo
string 
可选
orderNo
string 
可选
trackNumber
string 
可选
shipmentEnterprise
string 
可选
lableUrl
string 
可选
invoiceUrl
string 
可选
copyUrl
string 
可选
packages
array[object (ShipPackageDto) {7}] 
可选
msg
string 
错误提示
可选
示例
{
    "code": 0,
    "data": {
        "customNo": "string",
        "orderNo": "string",
        "trackNumber": "string",
        "shipmentEnterprise": "string",
        "lableUrl": "string",
        "invoiceUrl": "string",
        "copyUrl": "string",
        "packages": [
            {
                "boxNo": "string",
                "pkgNo": "string",
                "trackingNumber": "string",
                "expressSheetImgUrl": "string",
                "returnNumber": "string",
                "returnUrl": "string",
                "returnBase64": "string"
            }
        ]
    },
    "msg": "string"
}
修改于 2025-04-16 07:25:27
下一页
删除订单
Built with