尚为客户操作手册

3. 地址问题 ​


地址

地址报错通常是邮编与省市不匹配，需要检查修改

也可能是字符过长，超过了服务商的限制

也可能是地址信息错误，需要检查修改

门牌号

绝大部分渠道不需要填写门牌号字段，仅以下渠道的门牌号字段(consignee_doorplate)为必填项

PL-INPOST - 必填
PL-DHL - 必填
LT-POST - 必填
HR-POST - 必填

这几个渠道，使用英文句号.作为默认数据预报门牌号

street
​

示例1
​


  • "invalid_nobnp_street","attribute":"recipient.street\
  • 无效的街道地址

JSON
{
    "ask": "Failure",
    "message": "服务异常:[SWKM4111800227]换号失败 下家接口报错{\"reason\":\"invalid_nobnp_street\",\"attribute\":\"recipient.street\"};order system with out content answer from DTS.",
    "reference_no": "6054302613750",
    "Error": {
        "errMessage": "服务异常:[SWKM4111800227]换号失败 下家接口报错{\"reason\":\"invalid_nobnp_street\",\"attribute\":\"recipient.street\"};order system with out content answer from DTS.",
        "errCode": "50048"
    },
    "time_cost(s)": 2.3692002296447754
}

示例2
​


  • The receiverAddress.street must be at least 3 characters
  • 收件人地址的街道必须至少包含3个字符

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWLG4111800019]换号失败 下家接口报错The receiverAddress.street must be at least 3 characters.;order system with out content answer from DTS.",
  "reference_no": "NC2024B124777098",
  "Error": {
    "errMessage": "服务异常:[SWLG4111800019]换号失败 下家接口报错The receiverAddress.street must be at least 3 characters.;order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 4.043100118637085
}

示例3
​


  • The receiverAddress.street may not be greater than 35 characters
  • 收件人地址的街道不能超过35个字符

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWLG4112000017]换号失败 下家接口报错The receiverAddress.street may not be greater than 35 characters.;order system with out content answer from DTS.",
  "reference_no": "2024111629483412063",
  "Error": {
    "errMessage": "服务异常:[SWLG4112000017]换号失败 下家接口报错The receiverAddress.street may not be greater than 35 characters.;order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 2.2226998805999756
}

address
​

示例1
​


  • O campo address.location n\u00e3o pode ser superior a 26 caracteres
  • 地址字段不得超过26个字符

JSON
{
    "ask": "Failure",
    "message": "服务异常:[SWJC4111800102]换号失败 下家接口报错O campo address.location n\\u00e3o pode ser superior a 26 caracteres.;order system with out content answer from DTS.",
    "reference_no": "6230036349238",
    "Error": {
        "errMessage": "服务异常:[SWJC4111800102]换号失败 下家接口报错O campo address.location n\\u00e3o pode ser superior a 26 caracteres.;order system with out content answer from DTS.",
        "errCode": "50048"
    },
    "time_cost(s)": 6.099200010299683
}

示例2
​


  • "The length of field \"recipient.address.address\" is invalid."
  • 地址长度问题，需要检查修改

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWOH4121500007]换号失败 下家接口报错{\"code\":\"103\",\"parameter\":\"sender.invoice.address\",\"text\":\"A(z) \\\"sender.invoice.address\\\" mezo hossza nem megfelelo.\",\"text_eng\":\"The length of field \\\"sender.invoice.address\\\" is invalid.\"},{\"code\":\"103\",\"parameter\":\"recipient.address.address\",\"text\":\"A(z) \\\"recipient.address.address\\\" mezo hossza nem megfelelo.\",\"text_eng\":\"The length of field \\\"recipient.address.address\\\" is invalid.\"};order system with out content answer from DTS.",
  "reference_no": "2024121015527770063",
  "Error": {
    "errMessage": "服务异常:[SWOH4121500007]换号失败 下家接口报错{\"code\":\"103\",\"parameter\":\"sender.invoice.address\",\"text\":\"A(z) \\\"sender.invoice.address\\\" mezo hossza nem megfelelo.\",\"text_eng\":\"The length of field \\\"sender.invoice.address\\\" is invalid.\"},{\"code\":\"103\",\"parameter\":\"recipient.address.address\",\"text\":\"A(z) \\\"recipient.address.address\\\" mezo hossza nem megfelelo.\",\"text_eng\":\"The length of field \\\"recipient.address.address\\\" is invalid.\"};order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 2.907
}

buliding
​

示例1
​


  • "field":"building"
  • Nenurodytas arba neteisingas namo numeris
  • 未指定或错误的门牌号,报错原因是未填写门牌号，使用英文句号.作为默认数据预报门牌号

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWIH4111900025]换号失败 下家接口报错Supply order system got error:[{\"field\":\"building\",\"messages\":[\"Nenurodytas arba neteisingas namo numeris.\"]}];order number is 2024111527762580663;ycode is null",
  "reference_no": "2024111527762580663",
  "Error": {
    "errMessage": "服务异常:[SWIH4111900025]换号失败 下家接口报错Supply order system got error:[{\"field\":\"building\",\"messages\":[\"Nenurodytas arba neteisingas namo numeris.\"]}];order number is 2024111527762580663;ycode is null",
    "errCode": "50048"
  },
  "time_cost(s)": 3.3942999839782715
}

示例2
​


  • "receiver":[{"address":[{"building_number":["required]}]}]
  • 未填写门牌号，使用英文句号.作为默认数据预报门牌号

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWDR4112000096]换号失败 服务商接口报错: OAPI:There are some validation errors. Check details object for more info. {\"receiver\":[{\"address\":[{\"building_number\":[\"required\"]}]}]}",
  "reference_no": "21067393287696962105721245",
  "Error": {
    "errMessage": "服务异常:[SWDR4112000096]换号失败 服务商接口报错: OAPI:There are some validation errors. Check details object for more info. {\"receiver\":[{\"address\":[{\"building_number\":[\"required\"]}]}]}",
    "errCode": "50048"
  },
  "time_cost(s)": 3.344
}

Neispravan podatak: recipient_hnum，HR-POST 需要填写门牌号

Получател Адрес
​

示例
​


  • Получател Адрес 1: Максималната позволена дължина е 35
  • 收件人地址 1：最大允许长度为35个字符

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWMH4112000032]换号失败 服务商接口报错: OAPI:Получател Адрес 1: Максималната позволена дължина е 35 (EE20241120044851659OAZLNKIE)",
  "reference_no": "C2024B177902983",
  "Error": {
    "errMessage": "服务异常:[SWMH4112000032]换号失败 服务商接口报错: OAPI:Получател Адрес 1: Максималната позволена дължина е 35 (EE20241120044851659OAZLNKIE)",
    "errCode": "50048"
  },
  "time_cost(s)": 5.4563000202178955
}

Consignee state
​

示例
​


  • Consignee state is required
  • 收件人省/州字段必填

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWNI4111900142]换号失败 下家接口报错Consignee state is required.",
  "reference_no": "2024111615533688953",
  "Error": {
    "errMessage": "服务异常:[SWNI4111900142]换号失败 下家接口报错Consignee state is required.",
    "errCode": "50048"
  },
  "time_cost(s)": 0.691500186920166
}

Consignee city
​

示例
​


  • Consignee city is required
  • 收件人城市字段必填

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWLX4111900093]换号失败 下家接口报错Consignee city is required.",
  "reference_no": "C2024B133265114",
  "Error": {
    "errMessage": "服务异常:[SWLX4111900093]换号失败 下家接口报错Consignee city is required.",
    "errCode": "50048"
  },
  "time_cost(s)": 0.5283000469207764
}

recipient's locality
​

示例
​


  • The recipient's locality could not be matched
  • 无法匹配收件人的所在地，需要检查地址地址邮编信息

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWJM4112000007]换号失败 下家接口报错The recipient's locality could not be matched!;order system with out content answer from DTS.",
  "reference_no": "SOLA12681",
  "Error": {
    "errMessage": "服务异常:[SWJM4112000007]换号失败 下家接口报错The recipient's locality could not be matched!;order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 3.4151999950408936
}

Населено място
​

示例
​


  • Получател Населено място: Невалидно населено място
  • 收件人所在城市：无效的城市，需要检查城市和邮编信息

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWLP4112000042]换号失败 服务商接口报错: OAPI:Получател Населено място: Невалидно населено място (EE20241120075313583XUAPKLDZ)",
  "reference_no": "241115245897450",
  "Error": {
    "errMessage": "服务异常:[SWLP4112000042]换号失败 服务商接口报错: OAPI:Получател Населено място: Невалидно населено място (EE20241120075313583XUAPKLDZ)",
    "errCode": "50048"
  },
  "time_cost(s)": 3.647599935531616
}

RSTREET
​

示例
​


  • RSTREET musí být typu řetězce nebo pole s maximální délkou 35
  • RSTREET 字段必须是字符串类型，且最大长度为35个字符

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWJT4111400017]换号失败 服务商接口报错: OAPI:Service operation NewShipment failed due to validation error \r\n\r\nPole RSTREET musí být typu řetězce nebo pole s maximální délkou 35.",
  "reference_no": "21067213871159202360002506",
  "Error": {
    "errMessage": "服务异常:[SWJT4111400017]换号失败 服务商接口报错: OAPI:Service operation NewShipment failed due to validation error \r\n\r\nPole RSTREET musí být typu řetězce nebo pole s maximální délkou 35.",
    "errCode": "50048"
  },
  "time_cost(s)": 1.023400068283081
}

BATCH_INVALID
​

示例
​


  • "responseCode":19,"responseText":"BATCH_INVALID"
  • 检查省市地址信息是否匹配

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWOB4122000023]换号失败 下家接口报错{\"responseCode\":19,\"responseText\":\"BATCH_INVALID\"};order system with out content answer from DTS.",
  "reference_no": "2024121816420116283",
  "Error": {
    "errMessage": "服务异常:[SWOB4122000023]换号失败 下家接口报错{\"responseCode\":19,\"responseText\":\"BATCH_INVALID\"};order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 17.304
}

Receiver location is invalid
​

示例
​


  • Receiver location is invalid - must be exact!
  • 检查地址邮编是否匹配

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWJS4121400047]换号失败 下家接口报错[{\"Code\":2536,\"Message\":\"Receiver location is invalid - must be exact!\"}];order system with out content answer from DTS.",
  "reference_no": "SZZH-YXH12146763087",
  "Error": {
    "errMessage": "服务异常:[SWJS4121400047]换号失败 下家接口报错[{\"Code\":2536,\"Message\":\"Receiver location is invalid - must be exact!\"}];order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 2.178
}

CosigneeStreetAndNumber
​

示例
​


  • CosigneeStreetAndNumber je predugačak (najviše 70 znakova)
  • 收件人街道和门牌号太长（最多70个字符）

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWJS4121400042]换号失败 下家接口报错[{\"Code\":2425,\"Message\":\"CosigneeStreetAndNumber  je predugačak (najviše 70 znakova)!\"}];order system with out content answer from DTS.",
  "reference_no": "SZZH-YXH12146763144",
  "Error": {
    "errMessage": "服务异常:[SWJS4121400042]换号失败 下家接口报错[{\"Code\":2425,\"Message\":\"CosigneeStreetAndNumber  je predugačak (najviše 70 znakova)!\"}];order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 2.914
}

Nu exista o localitate
​

示例
​


  • Nu exista o localitate cu numele OBARSENI in judetul cu numele Vaslui
  • Vaslui 县内没有名为 OBARSENI 的地区。

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWOK5021900341]换号失败 下家接口报错Nu exista o localitate cu numele OBARSENI in judetul cu numele Vaslui.;order system with out content answer from DTS.",
  "reference_no": "2025021414844626803",
  "Error": {
    "errMessage": "服务异常:[SWOK5021900341]换号失败 下家接口报错Nu exista o localitate cu numele OBARSENI in judetul cu numele Vaslui.;order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 2.606300115585327
}

门店信息不存在
​

示例
​


  • 180780门店信息不存在
  • 门店关闭，需要就近查询新的门店

台湾 7-11 门店在线查询

台湾 全家 门店在线查询

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWDN5012000009]换号失败 下家接口报错  180780门店信息不存在",
  "reference_no": "251196A6D110BC53",
  "Error": {
    "errMessage": "服务异常:[SWDN5012000009]换号失败 下家接口报错  180780门店信息不存在",
    "errCode": "50048"
  },
  "time_cost(s)": 0.6846001148223877
}

Illegal unquoted character
​

示例
​


  • Unable to parse JSON - Illegal unquoted character ((CTRL-CHAR, code 9))
  • 地址包含非法字符，需要检查后修改

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWOA5012100040]换号失败 下家接口报错Unable to parse JSON - Illegal unquoted character ((CTRL-CHAR, code 9)): has to be escaped using backslash to be included in string value\\n at [Source: (String)\\;order system with out content answer from DTS.",
  "reference_no": "2025012016435360413",
  "Error": {
    "errMessage": "服务异常:[SWOA5012100040]换号失败 下家接口报错Unable to parse JSON - Illegal unquoted character ((CTRL-CHAR, code 9)): has to be escaped using backslash to be included in string value\\n at [Source: (String)\\;order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 4.359500169754028
}

Номер на улица
​

示例
​


  • Получател Номер на улица: Максималната позволена дължина е 10
  • 收件人街道号码：允许的最大长度为 10
  • GR-DPD 门牌号不需要填写

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWGT5011900037]换号失败 服务商接口报错: OAPI:Получател Номер на улица: Максималната позволена дължина е 10 (EE20250119035008132XWGPNKEO)",
  "reference_no": "YEN1073918006",
  "Error": {
    "errMessage": "服务异常:[SWGT5011900037]换号失败 服务商接口报错: OAPI:Получател Номер на улица: Максималната позволена дължина е 10 (EE20250119035008132XWGPNKEO)",
    "errCode": "50048"
  },
  "time_cost(s)": 1.9072999954223633
}

house number
​

示例
​


  • The house number cannot be 0
  • 门牌号不能为0
  • HU-GLS 门牌号不需要填写

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWFO5012100127]换号失败 服务商接口报错: OAPI:The house number cannot be 0",
  "reference_no": "SWEU2501211900198",
  "Error": {
    "errMessage": "服务异常:[SWFO5012100127]换号失败 服务商接口报错: OAPI:The house number cannot be 0",
    "errCode": "50048"
  },
  "time_cost(s)": 0.9423999786376953
}

Unexpected character
​

示例
​


  • Supply order system got error:Unexpected character ('s' (code 115))
  • 地址包含非法字符，需要检查后修改

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWIH5012500001]换号失败 下家接口报错Supply order system got error:Unexpected character ('s' (code 115)): was expecting comma to separate Object entries\n at [Source: (org.springframework.util.StreamUtils$NonClosingInputStream); line: 1, column: 148];order number is KAW00003139;ycode is null",
  "reference_no": "KAW00003139",
  "Error": {
    "errMessage": "服务异常:[SWIH5012500001]换号失败 下家接口报错Supply order system got error:Unexpected character ('s' (code 115)): was expecting comma to separate Object entries\n at [Source: (org.springframework.util.StreamUtils$NonClosingInputStream); line: 1, column: 148];order number is KAW00003139;ycode is null",
    "errCode": "50048"
  },
  "time_cost(s)": 6.5833001136779785
}

Nu exista un judet
​

示例
​


  • Nu exista un judet cu identificatorul sau numele TIBANESTI
  • 不存在标识符或名称为TIBANESTI的县
  • 地址邮编不匹配

JSON
{
  "ask": "Failure",
  "message": "服务异常:[SWOK5021500147]换号失败 下家接口报错Nu exista un judet cu identificatorul sau numele TIBANESTI.;order system with out content answer from DTS.",
  "reference_no": "2025021314669382683",
  "Error": {
    "errMessage": "服务异常:[SWOK5021500147]换号失败 下家接口报错Nu exista un judet cu identificatorul sau numele TIBANESTI.;order system with out content answer from DTS.",
    "errCode": "50048"
  },
  "time_cost(s)": 2.647599935531616
}

本网站可能包含指向第三方网站的链接，这些链接仅为方便用户提供，我们不对这些链接的内容或可用性负责，用户访问这些第三方网站的风险由用户自行承担。

Copyright © 2019-2025 深圳市尚为国际供应链管理有限公司 粤ICP备20038808号-2