交接单列表

提供俄罗斯订单专属的交接单列表查询能力，支持通过西月订单号获取该订单关联的交接单文件信息，包括文件地址、大小等详情。

适用场景

查询俄罗斯订单的交接单文件

获取交接单的编号、名称及下载地址

核对订单对应的交接单信息

接口类型

GET

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/order/orderListDeliveryReceipts
测试环境：https://testing.westmonth.com/openapi/order/orderListDeliveryReceipts

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Query参数

参数名	类型	必填	默认值	可选值	说明
order_no	string	是	-	-	西月订单号（俄罗斯订单专属）

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时返回"请求成功"）
data	array	交接单列表数据

data数组字段

字段	类型	说明
id	integer	交接单ID
receiptNumber	string	交接单号
receiptName	string	交接单名称
name	string	交接单文件原始名称
filepath	string	交接单文件下载地址（URL）
filesize	number	文件大小（单位：MB）

调用示例

URL请求

请求示例

成功返回示例

{
    "code": 0,
    "msg": "请求成功",
    "data": [
        {
            "id": 39,
            "receiptNumber": "xxx",
            "receiptName": "xxx",
            "name": "俄罗斯面单.pdf",
            "filepath": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/catalog/deliveryReceipt/20250605155653322200.pdf",
            "filesize": 0.02
        }
    ]
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

注意事项

本接口为俄罗斯订单专属接口，非俄罗斯订单调用可能返回空数据或错误

文件地址（filepath）为临时有效链接，建议获取后及时下载保存

若订单无关联的交接单，data数组将返回空列表

常见问题

Q1：如何获取西月订单号（order_no）？

A：西月订单号可通过订单创建接口（如/openapi/order/upload）的返回结果获取，对应字段为orderNoXy。

Q2：文件大小（filesize）为0.02表示什么？

A：表示文件大小为0.02MB，即20KB左右。

Q3：调用接口后返回data为空数组，是什么原因？

A：可能原因：1. 该订单尚未生成交接单；2. 订单非俄罗斯订单；3. 交接单文件已过期或被删除。

版本历史

版本	日期	修改说明
v1.0	2025-06-10	初始版本，支持俄罗斯订单交接单列表查询

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "请求成功",
    "data": [
        {
            "id": 39,
            "receiptNumber": "xxx",
            "receiptName": "xxx",
            "name": "俄罗斯面单.pdf",
            "filepath": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/catalog/deliveryReceipt/20250605155653322200.pdf",
            "filesize": 0.02
        }
    ]
}

交接单列表

交接单列表#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Query参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

注意事项#

常见问题#

Q1：如何获取西月订单号（order_no）？#

Q2：文件大小（filesize）为0.02表示什么？#

Q3：调用接口后返回data为空数组，是什么原因？#

版本历史#

请求参数

请求示例代码

返回响应

交接单列表

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Query参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何获取西月订单号（order_no）？

Q2：文件大小（filesize）为0.02表示什么？

Q3：调用接口后返回data为空数组，是什么原因？

版本历史