运输单单确认接口

运输单确认信息(鸿讯->客户)

请求参数

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

客户订单号

必需

客户单号

callbackBatchId

string

批次号

必需

批次号

downstreamOrderCode

string

仓库单号

可选

仓库单号

documentType

string

单据类型

必需

单据类型

inventoryCode

string

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

必需

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

subbaseCode

string

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

必需

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

orderStatus

string

单据状态

必需

(只传英文编码)1，整单回传状态：FULFILLED-发货完成 ,2，分批回传状态: RECEIVING –发货中

actualTotalCapacity

null

Double类型

可选

累计实际入库总体积(立方米)

actualTotalWeight

null

Double类型

可选

累计实际入库总重量(公斤),

actualTotalQuantity

integer

累计已入库数量

可选

累计已入库数量

totalQuantity

integer

订单总数量

必需

actualQuantity

integer

当前传递数量

必需

exitOrderTime

string

出库作业时间

必需

numberOfConsumables

string

耗材数量

可选

numberOfPackages

string

包裹数量

可选

operatorName

string

操作员名称

可选

操作员名称

operateTime

string

操作时间

可选

操作时间

customerCode

string

客户编码

可选

customerName

string

客户名称

可选

receiverCode

string

收货用户编码

可选

receiverName

string

收货用户名称

可选

receiverUser

string

收货人

可选

receiverContactNumber

string

收货电话

可选

receiverProvinceName

string

收货省

可选

receiverCityName

string

收货市

可选

receiverCountyName

string

收货区

可选

receivingName

string

收货街道

可选

harvestDetailedAddress

string

收货详细地址

可选

remark

string

备注

可选

备注

packageList

array [object {7}]

包裹信息

可选

条件必填，有包裹信息则回传

productList

array [object {21}]

产品明细集合

必需

产品明细集合

示例

{
    "createBy": "string",
    "dataSource": "string",
    "sign": "string",
    "timestamp": "string",
    "request": {
        "customerNumber": "string",
        "callbackBatchId": "string",
        "downstreamOrderCode": "string",
        "documentType": "string",
        "inventoryCode": "string",
        "subbaseCode": "string",
        "orderStatus": "string",
        "actualTotalCapacity": null,
        "actualTotalWeight": null,
        "actualTotalQuantity": 0,
        "totalQuantity": 0,
        "actualQuantity": 0,
        "exitOrderTime": "string",
        "numberOfConsumables": "string",
        "numberOfPackages": "string",
        "operatorName": "string",
        "operateTime": "string",
        "customerCode": "string",
        "customerName": "string",
        "receiverCode": "string",
        "receiverName": "string",
        "receiverUser": "string",
        "receiverContactNumber": "string",
        "receiverProvinceName": "string",
        "receiverCityName": "string",
        "receiverCountyName": "string",
        "receivingName": "string",
        "harvestDetailedAddress": "string",
        "remark": "string",
        "packageList": [
            {
                "logisticsCode": "string",
                "logisticsName": "string",
                "mailno": "string",
                "waybillNumber": "string",
                "expressCode": "string",
                "packageCapacity": null,
                "packageWeight": null
            }
        ],
        "productList": [
            {
                "customerLineNumber": "string",
                "customerProductCode": "string",
                "customerProductDescription": "string",
                "actualQty": 0,
                "planQty": 0,
                "unitWeight": null,
                "singlePieceVolume": null,
                "productData": "string",
                "validPeriod": "string",
                "productBatchNumber": "string",
                "specialInventoryFlag": "string",
                "associatedOrder": "string",
                "relatedItems": "string",
                "ebeln": "string",
                "ebelp": "string",
                "remark": "string",
                "vinNum": "string",
                "licensePlateNumber": "string",
                "driverName": "string",
                "driverPhone": "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 '' \
--header 'Content-Type: application/json' \
--data-raw '{
    "createBy": "string",
    "dataSource": "string",
    "sign": "string",
    "timestamp": "string",
    "request": {
        "customerNumber": "string",
        "callbackBatchId": "string",
        "downstreamOrderCode": "string",
        "documentType": "string",
        "inventoryCode": "string",
        "subbaseCode": "string",
        "orderStatus": "string",
        "actualTotalCapacity": null,
        "actualTotalWeight": null,
        "actualTotalQuantity": 0,
        "totalQuantity": 0,
        "actualQuantity": 0,
        "exitOrderTime": "string",
        "numberOfConsumables": "string",
        "numberOfPackages": "string",
        "operatorName": "string",
        "operateTime": "string",
        "customerCode": "string",
        "customerName": "string",
        "receiverCode": "string",
        "receiverName": "string",
        "receiverUser": "string",
        "receiverContactNumber": "string",
        "receiverProvinceName": "string",
        "receiverCityName": "string",
        "receiverCountyName": "string",
        "receivingName": "string",
        "harvestDetailedAddress": "string",
        "remark": "string",
        "packageList": [
            {
                "logisticsCode": "string",
                "logisticsName": "string",
                "mailno": "string",
                "waybillNumber": "string",
                "expressCode": "string",
                "packageCapacity": null,
                "packageWeight": null
            }
        ],
        "productList": [
            {
                "customerLineNumber": "string",
                "customerProductCode": "string",
                "customerProductDescription": "string",
                "actualQty": 0,
                "planQty": 0,
                "unitWeight": null,
                "singlePieceVolume": null,
                "productData": "string",
                "validPeriod": "string",
                "productBatchNumber": "string",
                "specialInventoryFlag": "string",
                "associatedOrder": "string",
                "relatedItems": "string",
                "ebeln": "string",
                "ebelp": "string",
                "remark": "string",
                "vinNum": "string",
                "licensePlateNumber": "string",
                "driverName": "string",
                "driverPhone": "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
}