保存交接单

提供俄罗斯订单专属的交接单保存能力，用于将已上传的交接单文件与订单关联，并记录交接单的编号和名称，完成交接单的正式存档。

适用场景

将上传的交接单文件与俄罗斯订单绑定

记录交接单的编号和名称等关键信息

批量关联多个订单与同一份交接单文件

接口类型

POST

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
order_nos	array	是	-	-	订单号列表（西月订单号，俄罗斯订单）
file_id	integer	是	-	-	上传交接单文件后返回的file_id（通过`/openapi/order/uploadDeliveryReceiptFile`接口获取）
delivery_receipt_number	string	是	-	-	交接单编号（用于标识交接单的唯一编号）
delivery_receipt_name	string	是	-	-	交接单名称（描述交接单的内容或用途）

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时返回"请求成功"）
data	array	业务数据（成功关联的订单信息，通常为空数组）

调用示例

URL请求

请求示例

{
    "order_nos": [
        "BXY2506051560050","BXY2506051560051","BXY2506051560052"
    ],
    "file_id": 1,
    "delivery_receipt_number": "3213123",
    "delivery_receipt_name": "交接单名称",
}

成功返回示例

{
    "code": 0,
    "msg": "请求成功",
    "data": []
}

失败返回示例

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

错误处理

公共错误码

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

注意事项

本接口为俄罗斯订单专属接口，非俄罗斯订单调用将返回错误

file_id必须是通过/openapi/order/uploadDeliveryReceiptFile接口上传文件后返回的有效ID，否则会提示文件无效

交接单编号（delivery_receipt_number）建议保持唯一性，便于后续查询和管理

支持批量关联多个订单（order_nos）与同一份交接单文件，适用于同一批次订单共用一份交接单的场景

常见问题

Q1：如何确认交接单已成功保存？

A：当接口返回code为0且msg为"请求成功"时，表示交接单已成功保存并与订单关联。

Q2：保存后发现交接单信息错误，如何修改？

A：目前不支持直接修改已保存的交接单信息，需先删除原有关联（通过相关删除接口），再重新上传文件并保存新的交接单信息。

Q3：一次最多可以关联多少个订单？

A：建议单次关联订单数量不超过50个，避免请求数据过大导致超时。

版本历史

版本	日期	修改说明
v1.0	2025-06-20	初始版本，支持俄罗斯订单交接单保存

{ "order_nos": [ "BXY2506051560050","BXY2506051560051","BXY2506051560052" ], "file_id": 1, "delivery_receipt_number": "3213123", "delivery_receipt_name": "交接单名称", }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

保存交接单

保存交接单#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

注意事项#

常见问题#

Q1：如何确认交接单已成功保存？#

Q2：保存后发现交接单信息错误，如何修改？#

Q3：一次最多可以关联多少个订单？#

版本历史#

请求参数

请求示例代码

返回响应

保存交接单

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何确认交接单已成功保存？

Q2：保存后发现交接单信息错误，如何修改？

Q3：一次最多可以关联多少个订单？

版本历史