• 1.目前开发者调用API可能出现的错误有三类:API平台错误、容器类错误和ISV业务错误。下面介绍一下和ISV成功率有关的名词说明:

    有效访问量=成功访问量+ISV业务错误(成功访问指的是正常获取到数据并且无报错的调用)

    ISV成功率=成功访问量/有效访问量

    2.连接当当服务器错误主要是http连接错误或者连接被重置被拒绝等,这类错误是开发者访问当当服务器出现的问题,请直接联系服务器管理员或通过网络搜索答案。

  • 错误码小于200的调用错误,这种错误一般是由于用户的请求不符合各种基本校验而引起的。用户遇到这些错误的返回首先检查应用的权限、频率等情况,然后参照文档检验一下传入的参数是否完整且合法。

    错误码小于200的平台级错误:


    错误码 错误描述

    0

    处理成功

    9

    HTTP方法被禁止

    10

    无参数传入

    11

    接口名称参数为空

    12

    接口名称参数非法

    13

    timestamp参数为空

    14

    timestamp参数非法

    15

    format参数为空

    16

    format参数非法

    17

    app_key参数为空

    18

    app_key参数非法

    19

    签名参数为空

    20

    签名参数非法

    21

    加密方法参数为空

    22

    加密方法参数非法

    23

    session参数为空

    24

    session参数非法

    25

    店铺号参数为空

    26

    店铺号参数非法

    27

    API协议版本参数为空

    28

    API协议版本参数非法

    29

    上传文件非法

    30

    文件流解析出错

    31

    timestamp误差不在服务器允许的范围内

    32

    商家访问API一分钟频率超限

    33

    商家访问API总数超限

    34

    商家访问API一分钟频率和总数均超限

    35

    API总调用一分钟频率超限

    36

    API总调用总数超限

    37

    API总调用一分钟频率和总数均超限

    38

    APP总调用超限

    39

    SHOP总调用超限

    110

    不存在的调用接口

    111

    调用接口已下线

    150

    API组校验失败

    151

    APP信息校验失败

    152

    黑白名单校验失败

    153

    SECRET_TOKEN校验失败

    154

    返回名单为黑名单

    155

    返回名单为白名单

    175

    app与shop无订购关系

    176

    app与shop订购关系过期

    177

    token为空

    178

    token错误

    179

    token过期

    180

    用户未授权app访问API组

    181

    时间戳格式不正确

    182

    时间戳与服务器的时间差不在允许的误差范围内

    183

    店铺ID为空

    184

    店铺ID不正确

    185

    app_key为空

    186

    app_key不正确

    187

    app无效或未上架

    188

    过期时间格式错误或小于当前时间

    189

    不存在的增值包

    190

    增值包状态不可用

    191

    所申请的包为非增值包


     


  • 错误码 错误描述

    202

    系统错误,建议清理浏览器缓存,稍后重试

    203

    系统内部调用错误



  • 业务操作码(operCode)标志业务操作成功失败情况,业务操作码等于0代表成功,大于0代表失败。

    错误码对照表


    错误码  错误描述 

    0

    操作成功

    1

    商品名称错误

    2

    商品分类错误

    3

    从属分类错误

    4

    库存数量错误

    5

    商品描述错误

    6

    市场价错误

    7

    单价错误

    8

    是否提供VIP价错误

    9

    店内分类1错误

    10

    店内分类2错误

    11

    商品状态错误

    12

    进货价错误

    13

    商品属性错误

    14

    销售属性错误

    17

    商品标识符错误

    18

    品牌型号错误

    19

    品牌错误

    20

    型号错误

    21

    不可删除

    22

    企业商品标识符错误

    23

    图片已经被接收,系统需要一段时间处理后才能显示到后台。敬请等待

    24

    图片1:图片大小请限定在300k以内的gif或jpg格式或者缺少图片{0}

    26

    图片3:图片大小请限定在300k以内的gif或jpg格式或者缺少图片{0}

    27

    请至少上传一张图片

    28

    销售属性图片:图片大小请限定在300k以内的gif或jpg格式或者缺少图片{0}

    29

    条形码错误

    30

    处理失败,请重新上传

    31

    没问题

    32

    商品副标题错误

    33

    图片3:图片大小请限定在300k以内的gif或jpg格式或者缺少图片{0}34

    35

    订单编号错误

    36

    订单取消原因错误

    37

    退货单编号错误

    38

    换货单编号错误

    39

    发货数量全为0

    40

    物流公司、电话或物流单号出错

    41

    发货商品错误

    42

    发货商品数量错误

    43

    订单数据错误

    44

    订单数据传输错误(price_str经过加密之后不等于cprice_str)

    45

    字符长度超出限制

    46

    订单退换货类型错误

    47

    订单处理状态错误

    48

    订单处理结果错误

    49

    时间格式错误

    50

    页数错误

    51

    订单状态错误

    52

    送货方式错误

    53

    付款方式错误

    54

    订单标记错误

    55

    不允许修改促销品价格

    56

    企业商品标识符不唯一

    57

    属性值类不存在

    58

    销售属性值不允许重复

    59

    销售属性值不允许超过10个汉字(20个字符)

    60

    属性值类和属性值的顺序不匹配

    61

    商品类型错误

    62

    促销编号或者促销序号错误

    63

    只能对非分色分码商品设置“最佳拍档”

    64

    拍档商品不能为分色分码商品

    65

    同一个商品中的拍档商品不能重复

    66

    拍档数量不能多于3个

    67

    拍档商品不能是被设置商品本身

    68

    拍档商品内容格式错误或商品编号不存在

    69

    拍档商品必须是商家店内的商品

    70

    每页结果数量错误

    71

    公用栏目名称不存在

    72

    公用栏目显示顺序不允许重复(“商品说明”的显示顺序默认是5000)

    73

    公用栏目内容格式错误

    74

    同一个商品的公用栏目不能多于3个

    75

    同一个商品的公用栏目不能重复

    76

    公用栏目显示顺序值必须为0-9999之间的整数

    77

    COD内容错误,只能填写“是”或“否”

    78

    未开通COD业务的店铺,不允许设置单品COD

    79

    店内分类3错误

    80

    店内分类4错误

    81

    店内分类5错误

    82

    订单编号错误。只能更新自发线上订单和自发COD订单的配送状态

    83

    配送状态错误。选项包括:1表示“配送成功”,2表示“配送失败”

    84

    更新状态错误。只能填写“上架”或“下架”

    85

    审核状态错误。选项包括:1表示“审核通过”,2表示“审核不通过”

    86

    没有提交分类数据

    87

    分类数据错误

    99

    请提供商品编号串

    100

    没有上传xml文件

    101

    上传文件过大

    102

    上传文件不是xml格式

    103

    上传文件错误

    104

    上传文件不是rar压缩包

    105

    压缩包内没有XML文件

    106

    系统不支持多个XML文件

    107

    没有上传文件

    108

    XML文件数据错误

    109

    图片名称不能是中文

    110

    图片名称长度过长

    111

    结束时间修改成功(活动开始前2个小时及开始后,只能修改促销结束时间,其他设置不能修改)

    114

    开始时间不能小于当前时间

    117

    开始时间不能大于结束时间

    118

    促销时间不能大于180天

    119

    赠品及赠品数量必填

    120

    商品id、赠品及赠品数中有非法字符

    121

    商品id必填且不能为空

    122

    系统错误

    123

    商品id不存在

    124

    产品不能参加促销

    125

    赠品中的数量和填写个数不匹配

    126

    {0}不能被设置促销

    127

    赠品数量必须为整数

     128

    促销产品id不合法

    129

    赠品{0}不存在

    130

    {0}不是赠品或不是商家状态或不是本商家商品

    131

    百货商品和出版物商品不能互赠

    200

    商家发布产品数及最大上传空间均超限

    201

    您店铺中的商品数(包括上架与下架)已达到上限。请删除一些下架商品后再上传新商品

    210

    最大上传空间均超限

    211

    促销编号错误

    212

    促销数量已达到最大值,不能再添加新的促销

    213

    促销名称不能为空且不能大于30个汉字

    214

    开始时间不能为空

    215

    开始时间格式错误

    216

    开始时间不能早于当前时间的第二天

    217

    开始时间必须设置{0}小时之后

    218

    结束时间不能为空

    219

    结束时间格式错误

    220

    结束时间必须大于开始时间

    221

    促销活动最多允许持续{0}天

    222

    {0}这个商品不存在

    223

    {0}非自己所属商品不能再参加此促销

    224

    不支持分色分码产品的编号

    225

    {0}该行促销价填写错误!

    226

    {0}此商品当当价小于{0}元!

    227

    {0}促销价不能小于等于当当价的{0}!

    228

    促销价不能高于当当价!

    229

    参与促销的商品不能为空

    230

    {0}参与了其他促销活动,不能再参加此促销

    231

    外部商家促销编号必须小于40个字符

    232

    操作失败

    233

    商品{0}为赠品不能参加促销

    234

    名称不能为空

    235

    开始时间不能空

    236

    结束时间不能空

    237

    默认开始时间必须大于当前时间4个小时或时间格式错误

    238

    团购持续时间必须为10分钟或以上或时间格式错误

    239

    团购持续时间不能大于.TUAN_LIMIT_DATE.天或时间格式错误

    240

    团购开始和结束时间设置有误

    241

    商品信息不能为空

    242

    商品不能多于100个

    243

    商品id不能为空

    244

    库存不能小于等于0

    245

    原价不能小于等于0/原价不能小于团购价/团购价不能小于0

    246

    商品显示状态错误

    247

    商品类型错误

    248

    为虚拟商品

    249

    为不可移仓

    250

    商品数量不能小于团购数量

    251

    团购id不存在或团购已过期

    252

    赠品id或数量不合法

    253

    同一商品中赠品id重复

    254

    赠品个数超过最大值,默认为10

    255

    促销活动结束,不能修改促销信息

    256

    团购id不能为空

    257

    不是本商家商品

    258

    当当价在0.01元到1000000之间

    259

    市场价在0.01元到1000000之间

    300

    商家无此经营分类

    308

    上架商品不能删除

    309

    赠品不能删除

    310

    促销中的商品不能删除

    311

    只有状态为可销售且未参加促销的商品(须含商品图片),才可以被转为赠品

    312

    商品没有图片不能转为赠品

    313

    只有状态为可销售的赠品才可以被转为商品

    400

    发布商品失败

    401

    更新商品失败

    402

    更新商品图片失败

    410

    gshopID为空

    411

    gshopID不存在

    420

    未开通

    421

    停用

    422

    到期

    423

    关闭

    424

    欠费

    425

    终止合作

    450

    xml文件没有上传

    451

    上传文件过大

    452

    上传文件不是xml格式

    453

    上传文件错误

    455

    上传文件不是RAR压缩包

    456

    压缩包内没有XML文件

    457

    不支持多个XML文件

    458

    批量提交的处理数量超限

    459

    接口单位时间内调用次数超限

    460

    商品标识符"it"参数错误

    461

    企业商品标识符"oit"参数错误

    462

    库存"stk"参数错误

    463

    价格"pr"参数错误

    500

    系统异常

    600

    不允许取消COD订单

    601

    不允许修改COD订单状态

    602

    不允许对COD订单退货

    603

    不允许对COD订单换货

    604

    队列中已经存在数据

    605

    订单状态决定该订单不能进行操作

    606

    商家操作错误

    607

    本退换货申请,已经被处理过了

    609

    本退换货申请还未审核,请先进行审核处理

    610

    本退换货申请,已经做过延期处理

    612

    退货单编号不存在

    613

    本退换货申请,审核未通过,不允许操作

    614

    该产品所属分类不包含规格参数

    615

    上传文件中规格参数组名不存在

    616

    规格参数tab不允许上传描述内容

    617

    上传文件中tab描述总数与分类设置不一致

    618

    所属大商家分类不允许部分发货

    619

    rar文件名不能是中文

    620

    图片:{0}不存在

    621

    图片:{0}名称不能是中文

    622

    图片:{0}图片名称过长

    623

    图片:{0}图片类型不正确

    624

    图片:{0}大小超过规定大小

    625

    图片:{0}长度宽度不符合规定

    626

    上传文件中规格参数名不存在

    627

    上传文件中规格参数名为空

    628

    上传文件中规格参数组名为空

    629

    上传文件中规格参数属性为空

    632

    未打单

    633

    只能对代发cod标记取货

    634

    订单列表不能为空

    635

    该订单已经标记取货

    639

    该订单已经发货

    640

    顾客所在市没有对应库房

    641

    不允许延期退货

    650

    图片:{0}上传失败

    651

    图片:{0}无法读取

    700

    上传图片接口调用次数过于频繁

    706

    运费类型错误

    707

    运费值必须大于等于0,小于9999,最多2位小数

    800

    当当价不能小于市场价50%

    801

    当当价不能大于市场价

    802

    商品:{0}没有价格信息

    803

    当当价小于店铺基准价

    804

    当当价不能修改

    805

    不能对产品进行价格修改

    811

    没有操作权限

    812

    不能对产品下商品进行操作

    813

    没有对应的企业商品标识符

    814

    企业商品标识符不存在

    815

    该商品不是审核不通过状态,不能将其修改为待审核状态

    816

    不能对产品进行库存修改

    817

    请求查询类型'datatype'参数错误

    818

    商品编码最多支持20个

    819

    条形码最多支持20个

    820

    拍档:{0}不是该店铺的商品或不存在

    821

    拍档:{0}格式错误

    822

    商品:{0}不存在可以设置的最佳拍档

    823

    商品:{0}设置最佳拍档发生异常

    827

    是否支持cod参数错误

    828

    是否为赠品参数错误

    850

    同一商品不允许设置重复的最佳拍档ID

    1000

    商品:{0}已经是{1}状态,不需要修改该商品状态

    1001

    商品:{0}已经删除

    1002

    请先将商品:{0}下架再执行删除操作

    1003

    该商品不允许修改为状态:{0}

    1004

    商品:{0}是赠品不能删除

    1005

    商品数据异常,不允许修改商品:{0}的状态

    1006

    商品数据异常,不允许删除商品:{0}

    1007

    需要修改的状态不存在

    1009

    无效商品数据,不能修改商品:{0}的状态

    1010

    无效商品数据,不删除商品:{0}

    1011

    产品下商品,无法删除

    1012

    产品下商品,不能修改状态

    1014

    商品:{0}正在审核中不能修改状态

    1015

    商品:{0}正在审核中不能删除

    1016

    该商品正在进行促销,请解除促销后再尝试该操作

    1600

    修改商品类型不符合规范,商品类型只支持0(商品),1(赠品)

    1601

    商品类型"ty"参数错误

    1100

    退换货申请单编号错误

    1101

    不能对代退货申请进行审核

    1102

    部分扣款格式错误

    1103

    审核意见不能为空

    1104

    部分扣款金额错误

    1400

    该类型退款不需要进行审核

    1401

    退款总金额超过订单实际支付金额

    1501

    礼券不存在

    1502

    过期

    1503

    错误的密码

    1504

    别的客户已绑定过

    1505

    当前客户已经绑定

    1506

    已超过活动设定的礼券激活上限

    1507

    激活失败

    1508

    商铺没有剩余礼券

    1509

    优惠码不存在

    1510

    已超过活动设定的礼券激活上限

    1511

    客户id错误

    1512

    参数不正确

    1513

    服务器内部异常, 获取礼券列表失败

    1514

    超出商铺剩余礼券

    1515

    所选用户拥有礼券已经达到上限