运输单创建接口

创建运输单(客户->鸿讯)

请求参数

Body 参数application/json

createBy

string

客户标识

必需

鸿讯提供

dataSource

string

来源系统

必需

鸿讯提供

sign

string

签名

必需

规则见附录一

timestamp

string

时间戳

必需

格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。服务端允许客户端请求时间误差为10分钟

request

object (运输单信息)

必需

customerNumber

string

客户订单号

必需

客户单号

documentType

string

单据类型

必需

见附录二

inventoryCode

string

客户库存地编码(仓库编码)

必需

客户库存地编码(仓库编码)

inventoryName

string

客户库存地(仓库名称)

必需

客户库存地(仓库名称)

subbaseCode

string

客户子库编码(货主编码)

必需

客户子库编码(货主编码)

subbaseName

string

客户子库(货主名称)

必需

客户子库(货主名称)

customerCode

string

客户编码

必需

客户编码

customerName

string

客户名称

必需

客户名称

sourceOrderCode

string

客户参考单号(原订单号)

可选

客户参考单号(原订单号)

logisticsCode

string

物流公司编码

可选

物流公司编码

logisticsName

string

物流公司名称

可选

物流公司名称

expressCode

string

发运单号(运单号)

可选

发运单号(运单号)

signatureInfo

string

签收备注(签收信息)

可选

签收备注(签收信息)

notice

string

等通知出库(等通知出库(Y/N))

可选

等通知出库(等通知出库(Y/N))

jjFlag

string

急件发运(急件发运(Y/N))

可选

急件发运(急件发运(Y/N))

returnFlag

string

是否返单

可选

是否返单

customerWeight

string

客户订单重量(公斤)

可选

客户订单重量(公斤)

customerVolume

string

客户订单体积(立方米)

可选

客户订单体积(立方米)

operatorCode

string

操作员账号

可选

操作员账号

operatorName

string

制单人(操作员名称)

可选

制单人(操作员名称)

operateTime

string

操作时间

可选

操作时间

remark

string

订单备注(备注)

可选

订单备注(备注)

orderBusinessType

string

单据业务类型(10非整车20整车业务)

可选

shipperProvince

string

发货省名称

可选

shipperCity

string

发货市名称

可选

shipperCounty

string

发货区名称

可选

shipperName

string

发货人姓名

可选

shipperPhone

string

发货人电话

可选

shipperAddress

string

发货地址

可选

settleCustomerCode

string

结算客户编码

可选

settleCustomerName

string

结算客户名称

可选

receiverInfo

object

收货人

必需

发货信息

productList

array [object {21}]

产品明细集合

必需

产品明细集合

示例

{
    "createBy": "string",
    "dataSource": "string",
    "sign": "string",
    "timestamp": "string",
    "request": {
        "customerNumber": "string",
        "documentType": "string",
        "inventoryCode": "string",
        "inventoryName": "string",
        "subbaseCode": "string",
        "subbaseName": "string",
        "customerCode": "string",
        "customerName": "string",
        "sourceOrderCode": "string",
        "logisticsCode": "string",
        "logisticsName": "string",
        "expressCode": "string",
        "signatureInfo": "string",
        "notice": "string",
        "jjFlag": "string",
        "returnFlag": "string",
        "customerWeight": "string",
        "customerVolume": "string",
        "operatorCode": "string",
        "operatorName": "string",
        "operateTime": "string",
        "remark": "string",
        "orderBusinessType": "string",
        "shipperProvince": "string",
        "shipperCity": "string",
        "shipperCounty": "string",
        "shipperName": "string",
        "shipperPhone": "string",
        "shipperAddress": "string",
        "settleCustomerCode": "string",
        "settleCustomerName": "string",
        "receiverInfo": {
            "company": "string",
            "name": "string",
            "zipCode": "string",
            "mobile": "string",
            "email": "string",
            "countryCode": "string",
            "countryName": "string",
            "provinceName": "string",
            "cityName": "string",
            "countyName": "string",
            "townName": "string",
            "detailAddress": "string"
        },
        "productList": [
            {
                "customerLineNumber": "string",
                "customerProductCode": "string",
                "customerProductDescription": "string",
                "planQty": "string",
                "unitPrice": "string",
                "price": "string",
                "unit": "string",
                "unitWeight": "string",
                "totalWeight": "string",
                "singlePieceVolume": "string",
                "totalCapacity": "string",
                "productBatchNumber": "string",
                "specialLineNo": "string",
                "associatedOrder": "string",
                "relatedItems": "string",
                "ebeln": "string",
                "ebelp": "string",
                "remark": "string",
                "vinNum": "string",
                "hwProdCode": "string",
                "snList": [
                    {
                        "imei1": "string",
                        "imei2": "string",
                        "sn": "string",
                        "meid": "string"
                    }
                ]
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://uat.hongxunyun.cn/dtc/logistics/tmsOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "createBy": "string",
    "dataSource": "string",
    "sign": "string",
    "timestamp": "string",
    "request": {
        "customerNumber": "string",
        "documentType": "string",
        "inventoryCode": "string",
        "inventoryName": "string",
        "subbaseCode": "string",
        "subbaseName": "string",
        "customerCode": "string",
        "customerName": "string",
        "sourceOrderCode": "string",
        "logisticsCode": "string",
        "logisticsName": "string",
        "expressCode": "string",
        "signatureInfo": "string",
        "notice": "string",
        "jjFlag": "string",
        "returnFlag": "string",
        "customerWeight": "string",
        "customerVolume": "string",
        "operatorCode": "string",
        "operatorName": "string",
        "operateTime": "string",
        "remark": "string",
        "orderBusinessType": "string",
        "shipperProvince": "string",
        "shipperCity": "string",
        "shipperCounty": "string",
        "shipperName": "string",
        "shipperPhone": "string",
        "shipperAddress": "string",
        "settleCustomerCode": "string",
        "settleCustomerName": "string",
        "receiverInfo": {
            "company": "string",
            "name": "string",
            "zipCode": "string",
            "mobile": "string",
            "email": "string",
            "countryCode": "string",
            "countryName": "string",
            "provinceName": "string",
            "cityName": "string",
            "countyName": "string",
            "townName": "string",
            "detailAddress": "string"
        },
        "productList": [
            {
                "customerLineNumber": "string",
                "customerProductCode": "string",
                "customerProductDescription": "string",
                "planQty": "string",
                "unitPrice": "string",
                "price": "string",
                "unit": "string",
                "unitWeight": "string",
                "totalWeight": "string",
                "singlePieceVolume": "string",
                "totalCapacity": "string",
                "productBatchNumber": "string",
                "specialLineNo": "string",
                "associatedOrder": "string",
                "relatedItems": "string",
                "ebeln": "string",
                "ebelp": "string",
                "remark": "string",
                "vinNum": "string",
                "hwProdCode": "string",
                "snList": [
                    {
                        "imei1": "string",
                        "imei2": "string",
                        "sn": "string",
                        "meid": "string"
                    }
                ]
            }
        ]
    }
}'

返回响应

🟢200响应

application/json

Body

code

integer

响应码

必需

message

string

错误说明

必需

flag

boolean

响应标识

必需

true-成功，false-失败

value

object

响应内容

可选

示例

成功示例异常示例

{
    "code": 200,
    "message": "响应成功",
    "flag": true
}