上传交接单文件
外部-测试环境
https://testing.westmonth.com
外部-测试环境
https://testing.westmonth.com
POST
/openapi/order/uploadDeliveryReceiptFile
上传交接单文件
适用场景
接口类型
请求频率限制
请求说明
https://www.westmonth.com/openapi/order/uploadDeliveryReceiptFile测试环境：
https://testing.westmonth.com/openapi/order/uploadDeliveryReceiptFile请求参数
Header参数
| 参数名 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|
| Authorization | string | 是 | authorization | 身份验证Token |
| Content-Type | string | 是 | multipart/form-data | 固定使用该格式 |
Body参数（FormData格式）
| 参数名 | 类型 | 必填 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|---|
| files | binary | 是 | - | - | 要上传的PDF文件 |
| order_nos | string | 是 | - | - | 订单号（西月订单号） |
| type | integer | 是 | - | 1:条形码 2:箱唛 3:其他 4:交接单 | 文件类型 |
| delivery_region_id | integer | 是 | - | - | 发货区域ID |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 业务状态码（0表示成功） |
| msg | string | 提示信息（成功时返回"请求成功"） |
| data | object | 业务数据 |
| 字段 | 类型 | 说明 |
|---|---|---|
| fileId | integer | 上传成功后的文件ID，用于后续查询或操作该文件 |
调用示例
URL请求
请求示例
成功返回示例
{
"code": 0,
"msg": "请求成功",
"data": {
"fileId": 42
}
}失败返回示例
{
"code": 3,
"msg": "授权无效 authorization timestamp error",
"data": []
}错误处理
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|
注意事项
/openapi/productCategory/getDeliveryRegions接口获取常见问题
Q1：如何确定文件上传成功？
Q2：文件上传后存储在哪里？如何访问？
Q3：上传文件失败，提示"订单不允许上传该类型文件"，怎么办？
/openapi/order/verifyOrderDeliveryReceipts接口验证订单是否允许上传。Q4：文件类型（type）的枚举值代表什么？
版本历史
| 版本 | 日期 | 修改说明 |
|---|---|---|
| v1.0 | 2025-06-20 | 初始版本，支持俄罗斯订单文件上传 |
请求参数
Header 参数
Body 参数multipart/form-data
请求示例代码
返回响应
修改于 2026-02-24 03:24:01