创建 Resend Order

Create resend order

curl --request POST \
  --url https://api.returnshelper.com/uat/user/api/Resend/createResend \
  --header 'Content-Type: application/json' \
  --header 'x-rr-apikey: <api-key>' \
  --header 'x-rr-apitoken: <api-key>' \
  --data '
{
  "returnInventoryIdList": [
    123
  ],
  "resendShipment": {
    "warehouseId": 123,
    "shipmentCountryCode": "<string>",
    "shipmentName": "<string>",
    "shipmentPhone": "<string>",
    "shipmentStreet1": "<string>",
    "shipmentStreet2": "<string>",
    "shipmentState": "<string>",
    "shipmentCity": "<string>",
    "shipmentPostalCode": "<string>",
    "shipmentServiceType": "<string>",
    "shipmentFax": "<string>",
    "shipmentEmail": "<string>",
    "shipmentStreet3": "<string>"
  },
  "description": "<string>",
  "remarks": "<string>"
}
'

import requests

url = "https://api.returnshelper.com/uat/user/api/Resend/createResend"

payload = {
    "returnInventoryIdList": [123],
    "resendShipment": {
        "warehouseId": 123,
        "shipmentCountryCode": "<string>",
        "shipmentName": "<string>",
        "shipmentPhone": "<string>",
        "shipmentStreet1": "<string>",
        "shipmentStreet2": "<string>",
        "shipmentState": "<string>",
        "shipmentCity": "<string>",
        "shipmentPostalCode": "<string>",
        "shipmentServiceType": "<string>",
        "shipmentFax": "<string>",
        "shipmentEmail": "<string>",
        "shipmentStreet3": "<string>"
    },
    "description": "<string>",
    "remarks": "<string>"
}
headers = {
    "x-rr-apikey": "<api-key>",
    "x-rr-apitoken": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-rr-apikey': '<api-key>',
    'x-rr-apitoken': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnInventoryIdList: [123],
    resendShipment: {
      warehouseId: 123,
      shipmentCountryCode: '<string>',
      shipmentName: '<string>',
      shipmentPhone: '<string>',
      shipmentStreet1: '<string>',
      shipmentStreet2: '<string>',
      shipmentState: '<string>',
      shipmentCity: '<string>',
      shipmentPostalCode: '<string>',
      shipmentServiceType: '<string>',
      shipmentFax: '<string>',
      shipmentEmail: '<string>',
      shipmentStreet3: '<string>'
    },
    description: '<string>',
    remarks: '<string>'
  })
};

fetch('https://api.returnshelper.com/uat/user/api/Resend/createResend', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.returnshelper.com/uat/user/api/Resend/createResend",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'returnInventoryIdList' => [
        123
    ],
    'resendShipment' => [
        'warehouseId' => 123,
        'shipmentCountryCode' => '<string>',
        'shipmentName' => '<string>',
        'shipmentPhone' => '<string>',
        'shipmentStreet1' => '<string>',
        'shipmentStreet2' => '<string>',
        'shipmentState' => '<string>',
        'shipmentCity' => '<string>',
        'shipmentPostalCode' => '<string>',
        'shipmentServiceType' => '<string>',
        'shipmentFax' => '<string>',
        'shipmentEmail' => '<string>',
        'shipmentStreet3' => '<string>'
    ],
    'description' => '<string>',
    'remarks' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-rr-apikey: <api-key>",
    "x-rr-apitoken: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.returnshelper.com/uat/user/api/Resend/createResend"

	payload := strings.NewReader("{\n  \"returnInventoryIdList\": [\n    123\n  ],\n  \"resendShipment\": {\n    \"warehouseId\": 123,\n    \"shipmentCountryCode\": \"<string>\",\n    \"shipmentName\": \"<string>\",\n    \"shipmentPhone\": \"<string>\",\n    \"shipmentStreet1\": \"<string>\",\n    \"shipmentStreet2\": \"<string>\",\n    \"shipmentState\": \"<string>\",\n    \"shipmentCity\": \"<string>\",\n    \"shipmentPostalCode\": \"<string>\",\n    \"shipmentServiceType\": \"<string>\",\n    \"shipmentFax\": \"<string>\",\n    \"shipmentEmail\": \"<string>\",\n    \"shipmentStreet3\": \"<string>\"\n  },\n  \"description\": \"<string>\",\n  \"remarks\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-rr-apikey", "<api-key>")
	req.Header.Add("x-rr-apitoken", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.returnshelper.com/uat/user/api/Resend/createResend")
  .header("x-rr-apikey", "<api-key>")
  .header("x-rr-apitoken", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"returnInventoryIdList\": [\n    123\n  ],\n  \"resendShipment\": {\n    \"warehouseId\": 123,\n    \"shipmentCountryCode\": \"<string>\",\n    \"shipmentName\": \"<string>\",\n    \"shipmentPhone\": \"<string>\",\n    \"shipmentStreet1\": \"<string>\",\n    \"shipmentStreet2\": \"<string>\",\n    \"shipmentState\": \"<string>\",\n    \"shipmentCity\": \"<string>\",\n    \"shipmentPostalCode\": \"<string>\",\n    \"shipmentServiceType\": \"<string>\",\n    \"shipmentFax\": \"<string>\",\n    \"shipmentEmail\": \"<string>\",\n    \"shipmentStreet3\": \"<string>\"\n  },\n  \"description\": \"<string>\",\n  \"remarks\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.returnshelper.com/uat/user/api/Resend/createResend")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-rr-apikey"] = '<api-key>'
request["x-rr-apitoken"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"returnInventoryIdList\": [\n    123\n  ],\n  \"resendShipment\": {\n    \"warehouseId\": 123,\n    \"shipmentCountryCode\": \"<string>\",\n    \"shipmentName\": \"<string>\",\n    \"shipmentPhone\": \"<string>\",\n    \"shipmentStreet1\": \"<string>\",\n    \"shipmentStreet2\": \"<string>\",\n    \"shipmentState\": \"<string>\",\n    \"shipmentCity\": \"<string>\",\n    \"shipmentPostalCode\": \"<string>\",\n    \"shipmentServiceType\": \"<string>\",\n    \"shipmentFax\": \"<string>\",\n    \"shipmentEmail\": \"<string>\",\n    \"shipmentStreet3\": \"<string>\"\n  },\n  \"description\": \"<string>\",\n  \"remarks\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "resendId": 123
}

{
  "correlationId": "<string>",
  "meta": {
    "status": 123,
    "data": {},
    "errorCode": "<string>",
    "error": {}
  }
}

POST

api

Resend

createResend

Create resend order

curl --request POST \
  --url https://api.returnshelper.com/uat/user/api/Resend/createResend \
  --header 'Content-Type: application/json' \
  --header 'x-rr-apikey: <api-key>' \
  --header 'x-rr-apitoken: <api-key>' \
  --data '
{
  "returnInventoryIdList": [
    123
  ],
  "resendShipment": {
    "warehouseId": 123,
    "shipmentCountryCode": "<string>",
    "shipmentName": "<string>",
    "shipmentPhone": "<string>",
    "shipmentStreet1": "<string>",
    "shipmentStreet2": "<string>",
    "shipmentState": "<string>",
    "shipmentCity": "<string>",
    "shipmentPostalCode": "<string>",
    "shipmentServiceType": "<string>",
    "shipmentFax": "<string>",
    "shipmentEmail": "<string>",
    "shipmentStreet3": "<string>"
  },
  "description": "<string>",
  "remarks": "<string>"
}
'

import requests

url = "https://api.returnshelper.com/uat/user/api/Resend/createResend"

payload = {
    "returnInventoryIdList": [123],
    "resendShipment": {
        "warehouseId": 123,
        "shipmentCountryCode": "<string>",
        "shipmentName": "<string>",
        "shipmentPhone": "<string>",
        "shipmentStreet1": "<string>",
        "shipmentStreet2": "<string>",
        "shipmentState": "<string>",
        "shipmentCity": "<string>",
        "shipmentPostalCode": "<string>",
        "shipmentServiceType": "<string>",
        "shipmentFax": "<string>",
        "shipmentEmail": "<string>",
        "shipmentStreet3": "<string>"
    },
    "description": "<string>",
    "remarks": "<string>"
}
headers = {
    "x-rr-apikey": "<api-key>",
    "x-rr-apitoken": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-rr-apikey': '<api-key>',
    'x-rr-apitoken': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    returnInventoryIdList: [123],
    resendShipment: {
      warehouseId: 123,
      shipmentCountryCode: '<string>',
      shipmentName: '<string>',
      shipmentPhone: '<string>',
      shipmentStreet1: '<string>',
      shipmentStreet2: '<string>',
      shipmentState: '<string>',
      shipmentCity: '<string>',
      shipmentPostalCode: '<string>',
      shipmentServiceType: '<string>',
      shipmentFax: '<string>',
      shipmentEmail: '<string>',
      shipmentStreet3: '<string>'
    },
    description: '<string>',
    remarks: '<string>'
  })
};

fetch('https://api.returnshelper.com/uat/user/api/Resend/createResend', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.returnshelper.com/uat/user/api/Resend/createResend",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'returnInventoryIdList' => [
        123
    ],
    'resendShipment' => [
        'warehouseId' => 123,
        'shipmentCountryCode' => '<string>',
        'shipmentName' => '<string>',
        'shipmentPhone' => '<string>',
        'shipmentStreet1' => '<string>',
        'shipmentStreet2' => '<string>',
        'shipmentState' => '<string>',
        'shipmentCity' => '<string>',
        'shipmentPostalCode' => '<string>',
        'shipmentServiceType' => '<string>',
        'shipmentFax' => '<string>',
        'shipmentEmail' => '<string>',
        'shipmentStreet3' => '<string>'
    ],
    'description' => '<string>',
    'remarks' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-rr-apikey: <api-key>",
    "x-rr-apitoken: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.returnshelper.com/uat/user/api/Resend/createResend"

	payload := strings.NewReader("{\n  \"returnInventoryIdList\": [\n    123\n  ],\n  \"resendShipment\": {\n    \"warehouseId\": 123,\n    \"shipmentCountryCode\": \"<string>\",\n    \"shipmentName\": \"<string>\",\n    \"shipmentPhone\": \"<string>\",\n    \"shipmentStreet1\": \"<string>\",\n    \"shipmentStreet2\": \"<string>\",\n    \"shipmentState\": \"<string>\",\n    \"shipmentCity\": \"<string>\",\n    \"shipmentPostalCode\": \"<string>\",\n    \"shipmentServiceType\": \"<string>\",\n    \"shipmentFax\": \"<string>\",\n    \"shipmentEmail\": \"<string>\",\n    \"shipmentStreet3\": \"<string>\"\n  },\n  \"description\": \"<string>\",\n  \"remarks\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-rr-apikey", "<api-key>")
	req.Header.Add("x-rr-apitoken", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.returnshelper.com/uat/user/api/Resend/createResend")
  .header("x-rr-apikey", "<api-key>")
  .header("x-rr-apitoken", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"returnInventoryIdList\": [\n    123\n  ],\n  \"resendShipment\": {\n    \"warehouseId\": 123,\n    \"shipmentCountryCode\": \"<string>\",\n    \"shipmentName\": \"<string>\",\n    \"shipmentPhone\": \"<string>\",\n    \"shipmentStreet1\": \"<string>\",\n    \"shipmentStreet2\": \"<string>\",\n    \"shipmentState\": \"<string>\",\n    \"shipmentCity\": \"<string>\",\n    \"shipmentPostalCode\": \"<string>\",\n    \"shipmentServiceType\": \"<string>\",\n    \"shipmentFax\": \"<string>\",\n    \"shipmentEmail\": \"<string>\",\n    \"shipmentStreet3\": \"<string>\"\n  },\n  \"description\": \"<string>\",\n  \"remarks\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.returnshelper.com/uat/user/api/Resend/createResend")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-rr-apikey"] = '<api-key>'
request["x-rr-apitoken"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"returnInventoryIdList\": [\n    123\n  ],\n  \"resendShipment\": {\n    \"warehouseId\": 123,\n    \"shipmentCountryCode\": \"<string>\",\n    \"shipmentName\": \"<string>\",\n    \"shipmentPhone\": \"<string>\",\n    \"shipmentStreet1\": \"<string>\",\n    \"shipmentStreet2\": \"<string>\",\n    \"shipmentState\": \"<string>\",\n    \"shipmentCity\": \"<string>\",\n    \"shipmentPostalCode\": \"<string>\",\n    \"shipmentServiceType\": \"<string>\",\n    \"shipmentFax\": \"<string>\",\n    \"shipmentEmail\": \"<string>\",\n    \"shipmentStreet3\": \"<string>\"\n  },\n  \"description\": \"<string>\",\n  \"remarks\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "resendId": 123
}

{
  "correlationId": "<string>",
  "meta": {
    "status": 123,
    "data": {},
    "errorCode": "<string>",
    "error": {}
  }
}

此页面由 AI 自动翻译。API 技术规格以英文呈现为标准。如有任何疑问，请参阅英文版本。

建立补寄订单——将一个或多个已收到的退件库存项打包，再寄到客户地址。会触发异步面单生成；面单 URL 透过 webhook 推送。

前置条件

目标库存项已在您的账户中。returnInventoryId 由 newInventoryCreated webhook 事件推送——请在自有侧缓存。
同一次补寄的所有库存必须位于同一仓库。
每条库存当前的 handlingStatusCode 必须可推进至 rsd（补寄）——通常需为 ohd（暂存）。
任何项的所属行项目不可存在待处理 VAS。
每条库存必须实际在库（非运输中、亦未处于其他活跃流程）。
备好目的地地址。

必填字段

resendShipment — 完整 Shipment payload（目的地址、联络人、尺寸、重量、服务类型）。国家代码为 ISO3。
- warehouseId 为必填，且必须与 returnInventoryIdList 中各项目所属的仓库相同（同一次补寄的所有项目共用同一仓库）。省略将导致校验失败。
- payload 内的 shipmentServiceType 是 Shipment Service Type（不是 Return Service Type）— 有效代码请见获取 Warehouse 可用的 Shipment Service Types。传入 Return Service Type 代码会在校验阶段失败。
returnInventoryIdList — 非空 List<long>。上限为 ResendConfig.groupResendMaxRmaCount（通常为个位数；如需打包更多请联络客服）。

选填字段

description — 补寄订单的自由文本描述（上限 255 字符）。会保存至订单，并由取得补寄订单详情返回。
remarks — 补寄订单的商家备注（上限 5000 字符）。会保存至订单，并由取得补寄订单详情返回。

两者对应 Portal 上 Create Resend 表单的 Description 与 Remarks 字段。均为选填——省略即表示该订单不设描述或备注。

副作用

每条库存的 handlingCode 会被设为 rsd。
待面单就绪后，仓库将出货。

标签生成：自动 vs 手动服务类型

补寄是否自动生成运单标签，取决于您在 resendShipment.shipmentServiceType 中传入的 shipment service type。每个 shipment service type 都带有 isEnableAutoCreateLabel 标志——请从获取 Warehouse 可用的 Shipment Service Types 获取，并读取您打算使用的代码的 isEnableAutoCreateLabel。

自动标签（`isEnableAutoCreateLabel: true`）

标签在创建后异步生成。补寄状态流转为： queued → label-success → completed（若标签生成失败则 queued → failed）仅当补寄处于 label-success 且在截止时间之前，才能通过取消补寄订单取消。处于 queued 时无法取消，因为标签仍在生成中。

手动标签（`isEnableAutoCreateLabel: false`）

不会自动生成标签；由仓库处理该补寄。补寄状态流转为： pending → in-progress → completed 当补寄处于 pending 且在截止时间之前，可通过取消补寄订单取消。

取消截止时间

每个补寄都有取消截止时间，即工作日的 08:00 UTC，在补寄创建时设定。只要补寄处于其可取消状态（自动标签为 label-success，手动标签为 pending），您可在该截止时间之前取消。一旦超过截止时间，便无法再通过 API 取消。

若已超过截止时间但您仍需取消补寄，请联络我们的客服团队协助。截止时间过后无法保证能取消——包裹可能已经寄出。

概览

API

FBA

合并运货单

通知

回收

重寄

退货库存

退件运货单（创建）

服务类型

退件运货单

退件运货单服务类型

增值服务

仓库

前置条件

必填字段

选填字段

副作用

标签生成：自动 vs 手动服务类型

自动标签（`isEnableAutoCreateLabel: true`）

手动标签（`isEnableAutoCreateLabel: false`）

取消截止时间

相关

授权

请求体

响应

​前置条件

​必填字段

​选填字段

​副作用

​标签生成：自动 vs 手动服务类型

​自动标签（isEnableAutoCreateLabel: true）

​手动标签（isEnableAutoCreateLabel: false）

​取消截止时间

​相关

授权

请求体

响应

前置条件

必填字段

选填字段

副作用

标签生成：自动 vs 手动服务类型

自动标签（`isEnableAutoCreateLabel: true`）

手动标签（`isEnableAutoCreateLabel: false`）

取消截止时间

相关