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

下单运输(异步)

POST
http://api.intergo.cn/open-api/open/makeOrder/v1/asyncShipment
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
freightPayment
integer <int32>
必需
运费支付方式（1发件人、2收件人）
示例值:
1
taxPayment
integer <int32>
可选
税费支付方式 orderType=0 必填（1发件人、2收件人、3第三方,第三方时请传入税费付款人信息）
示例值:
2
currencyCode
string 
申报货币编码
必需
示例值:
USD
batteryOptions
integer <int32>
必需
电池选项0不带电 1内电 2配电 3纯电
示例值:
0
insuranceCharges
number 
申报保险费
可选
示例值:
0
freightCharges
number 
申报运费
可选
示例值:
0
signatureService
integer <int32>
可选
签名服务 1 要求签名 2要求成人签名
示例值:
2
purchaseNo
string 
采购单号
可选
示例值:
123456
invoiceNo
string 
发票单号
可选
示例值:
123456
invoiceDateStr
string <String>
可选
发票日期，例：YYYY-MM-DD
示例值:
YYYY-MM-DD
emailNotification
integer <int32>
可选
是否邮箱通知 0 否 1是
invoiceConsignorNumber
string 
发件人eori
可选
reasonForExport
string 
可选
出口理由 orderType=0跨境订单必填
DHL：COMMERCIAL_SAMPLE，PRESENT，DOCUMENT，RETURN_OF_GOODS，COMMERCIAL_GOODS，OTHER
UPS:SALE,GIFT,SAMPLE,RETURN,REPAIR,INTERCOMPANYDATA
示例值:
SALE
termsOfShipment
string 
可选
销售条款 orderType=0 跨境订单必填
UPS/DHL:CIF,CFR,CIP,CPI,DDP,DDU,DEQ,DES,DAF,DAP,DAT,EXW,FAS,FCA,FOB,OTHER
DPD:请根据需求传key ,如：01
01 = DAP, cleared,
02 = DDP, delivered duty paid (incl. duties and excl.taxes)
03 = DDP, delivered duty paid (incl. duties andtaxes)
05 = Ex works (EXW),
06 = DAP
示例值:
DDU
exportDescription
string 
可选
出口描述 出口理由为other需要
permitNo
string 
许可证号
可选
示例值:
123456
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
logisticsFeePayerAddress
object 
可选
运费付款方式为3才填
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 
门牌号
可选
>= 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
taxFeePayerAddress
object 
可选
税费付款方式为3才填
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 
门牌号
可选
>= 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 
收件人
必需
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 
门牌号
可选
>= 0 字符<= 16 字符
account
string 
付费账号
可选
>= 0 字符<= 32 字符
vatNo
string 
VAT税号
可选
>= 0 字符<= 32 字符
iossNo
string 
ioss税号
可选
>= 0 字符<= 32 字符
residential
boolean 
必需
是否私人/非FBA地址 --> 私人/非FBA:true 商业/FBA地址 flase
addressCode
string 
可选
FBA仓库编码 FBA地址必填
>= 0 字符<= 16 字符
示例值:
MDT5
email
string 
邮箱
可选
>= 0 字符<= 50 字符
示例值:
****@163.com
importerAddress
object 
进口商信息
可选
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 
门牌号
可选
>= 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
示例
{
    "makeServiceCode": "UPS",
    "customNo": "test_001",
    "weightUnit": "cm/kg",
    "freightPayment": 1,
    "taxPayment": 2,
    "currencyCode": "USD",
    "batteryOptions": 0,
    "insuranceCharges": 0,
    "freightCharges": 0,
    "signatureService": 2,
    "purchaseNo": "123456",
    "invoiceNo": "123456",
    "invoiceDateStr": "YYYY-MM-DD",
    "emailNotification": 0,
    "invoiceConsignorNumber": "string",
    "reasonForExport": "SALE",
    "termsOfShipment": "DDU",
    "exportDescription": "string",
    "permitNo": "123456",
    "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"
        }
    ],
    "logisticsFeePayerAddress": {
        "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"
    },
    "taxFeePayerAddress": {
        "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"
    },
    "importerAddress": {
        "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"
    }
}

示例代码

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/asyncShipment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "makeServiceCode": "UPS",
    "customNo": "test_001",
    "weightUnit": "cm/kg",
    "freightPayment": 1,
    "taxPayment": 2,
    "currencyCode": "USD",
    "batteryOptions": 0,
    "insuranceCharges": 0,
    "freightCharges": 0,
    "signatureService": 2,
    "purchaseNo": "123456",
    "invoiceNo": "123456",
    "invoiceDateStr": "YYYY-MM-DD",
    "emailNotification": 0,
    "invoiceConsignorNumber": "string",
    "reasonForExport": "SALE",
    "termsOfShipment": "DDU",
    "exportDescription": "string",
    "permitNo": "123456",
    "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"
        }
    ],
    "logisticsFeePayerAddress": {
        "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"
    },
    "taxFeePayerAddress": {
        "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"
    },
    "importerAddress": {
        "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"
    }
}'

返回响应

🟢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-25 01:46:10
上一页
评估价格
下一页
获取标签
Built with