订单API

请使用CTRL+F 快速查找对应的问题,帮助您解决问题。

1 trade_push

向旺店通ERP 推送原始销售订单,支持更新详情见注意事项
    • 无效店铺编号
店铺编号(shop_no)在系统中不存在或为空
    • 店铺已停用
店铺编号(shop_no)在系统中存在但已被停用
    • 只有自有平台店铺才支持推送
对外api只支持自有平台店铺调用,保证platform_id为127并检查shop_no对应的店铺在旺店通ERP内店铺所属的平台类型是否为自有。
    • trade_list json格式错误,无法解析
trade_list 结构异常,接口解析后得到的trade_list 的结构与对外api文档中的结构不一致,请确认参数的正确性
    • trade_list订单列表为空
订单列表没有订单信息,请检查数据的正确性
    • trade_list订单列表结构异常
trade_list 不是一个索引数组,请检查数据的正确性
    • 货到付款订单COD金额不能为0
原始订单为货到付款 delivery_term = 2  trade_status = 30  但 货到付款金额 cod_amount = 0,请检查 delivery_term、trade_status 和 cod_amount 的值  如果 delivery_term = 2  trade_status = 30 那么 cod_amount 就不能为0
    • 子订单xxx退款状态与子订单状态不一致
order_list 中的一条记录中  status 的状态 和 refund_status 的状态不匹配  比如 refund_status > 2 但 status != 80  请检查 refund_status 和 status 的值
    • 应收不能小于0
接口根据参数计算出来的paid 小于 0
    • COD金额cod_amount大于应收paid
货到付款时  货到付款金额大于了应收金额
    • 已付金额不正确 paid
参数中的 paid 与 接口根据参数中的数据计算出来的不一致,请确认计算公式使用的正确性,paid = (price*num + adjust_amount -discount - share_discount 累加  再加 post_amount)其中  price*num + adjust_amount -discount - share_discount 为 一种商品应收金额的计算方法
    • 已付金额paid大于应收
参数中的 paid 大于了 接口根据参数中的数据计算出来的金额值,请确认参数的正确性以及计算公式使用的正确性paid = (price*num + adjust_amount -discount - share_discount 累加  再加 post_amount)其中  price*num + adjust_amount -discount - share_discount 为 一种商品应收金额的计算方法
    • 非货到付款订单不能有货到付款金额
delivery_term = 1 cod_amount > 0 不是货到付款的订单但货到付款金额大于0,请检查 delivery_term 和 cod_amount 字段的值
    • 未付款订单不可发货
确保 delivery_term = 1  trade_status = 30  pay_status = 2 ,且paid != 0
    • 部分付款订单不可发货
确保 delivery_term = 1  trade_status = 30  pay_status = 2 ,且根据公式计算出正确的paid值
    • buyer_nick 名字不能只用一个,不同客户必须用不同的名字
一次推送相同buyer_nick不可以大于30条,相同的buyer_nick分批进行推送
    • 证件类型不支持
id_card_type 有效 但值 未定义 请检查 id_card_type 的值是否在文档说明的范围内
    • 注意事项:
   1> 该api支持更新但更新是有限制的,比如系统内已经发货了再更新也不会影响发货了。
   2> 支持的状态更新(不在下面列表中的更新均为非法更新)
      未确认 ---> 已关闭
      未确认 ---> 已付款待发货
      待尾款 ---> 已付款待发货
      已付款待发货---> 已退款
      已发货 ---> 已签收
      已发货 ---> 已完成
      另外还可以更新订单明细的状态
      status 以及 退款状态refund_status

   3> 其他更新
      修改地址
      修改发票
      修改物流
      部分退款
      添加货品

   4> 关于平台商家编码与系统内维护不一致导致 推送原始订单后无法递交 报 无效货品的处理方案为:
      修改平台商家编码为正确值
      手动关联货品
      重新推送原始订单

   5> 原始订单退款或部分退款时paid怎么处理
      当发生退款或部分退款时,计算paid的时候不能把退款的商品的金额计算到paid里面,paid = 那些没有退款的商品的金额之和+运费等来计算

2 trade_query

查询销售订单的接口
根据最后修改时间查询、旺店通系统内单号查询、平台单号查询、旺店通系统内订单状态查询
    • 注意事项:
1> 订单会重复获得(根据最后修改时间查询时),比如通过分页的方式多次获取,因为某些订单发生了修改最后修改时间发生了变化可能在多页中重复出现
2> 对于平台上的申请退款、退款等操作,需要接口调用方与ERP操作方协商,当平台发生申请退款时需要确保接口调用方可以取消订单才可以同意退款,如果同意退款操作不受ERP操作方控制,则需要接口调用方获取订单信息时注意订单和明细中的退款状态,以及获取已取消状态的订单(平台同意退款后旺店通ERP会自动取消未发货订单),及时拦截发货
3> 对于订单的修改操作,由于操作ERP方修改信息后接口调用方不知道是否可以更新,所以客户的修改动作 如驳回审核 、 修改地址 等等 操作ERP方需要与调用接口方确认这些修改接口方以怎样的方式处理

3 stockout_order_query_trade

    • 获取返回结果失败!
返回结果异常,请重试,如果频率较高请联系旺店通相关技术,联系方式点击这里查看。
    • 时间格式错误
start_time、end_time  有1个或2个为空,或者 start_time 在 end_time 之后  比如 start_time = 2015-01-01 00:00:00  end_time = 2014-01-01 00:00:00
    • 起止时间跨度不能超过 xxx
接口对于 start_time 和 end_time  之间的间隔 有相应的要求,目的是为了  控制查询结果中单据的数量,提高接口调用的成功率 比如 start_time = 2014-01-01 00:00:00  end_time = 2015-01-01 00:00:00  间隔为 1年,解决方案是  把1年 分成 很小的时间段  分多次访问。

4 logistics_sync_query 与 logistics_sync_ack 配合使用完成 订单在旺店通ERP发货后的物流信息查询和状态回传功能 — 物流信息(详细说明见详细说明)

    • 获取子订单号失败
接口支持多物流单号查询(tid 包含多个 oid  以oid 为单位的拆分 oid 不能再拆),获取子订单物流信息时失败了,遇到问题请重试,失败频率较高时联系旺店通对外api相关技术,联系方式点击这里查看。

5 logistics_sync_ack 与 logistics_sync_query 配合使用

    • logistics_list json格式错误,无法解析
json解析失败,logistics_list 不是有效的json串,请检查数据的正确性
    • logistics_list 物流列表为空
json解析后的结果为空,请检查数据的正确性
    • logistics_list 物流列表结构异常
logistics_list 不是索引数组
    • logistics_list数组过大,不得高于100

    • SP_OPENAPI_LOGISTICS_SYNC Fail:
操作异常,请重试,如果频率较高请联系旺店通对外api相关技术,联系方式点击这里查看。
    • 注意事项:
接口 logistics_sync_query 与 logistics_sync_ack 的具体使用方法
就像有个池子一样 订单发货后会向池子中添加物流信息,调用 logistics_sync_query  可以从池子中取出来n条,然后处理,
处理的过程中,可以选择一部分一部分的处理,比如  处理 几十条 调用一次  logistics_sync_ack 告诉 旺店通ERP,不管同步的是成功还是失败,
只要处理成功就会从池子中去掉这些物流信息,下次再查询就查询不到了;然后再处理 处理之后再调用 logistics_sync_ack,
继续这样直到查询到的物流信息处理完,然后再调用   logistics_sync_query  查询剩余的物流信息 继续操作。
    • 错误的用法:
只调用 logistics_sync_query 查询物流信息 处理  不 调用 logistics_sync_ack  这样 总是从池子里复制物流信息,而不在处理后去掉它们,这样总是查询重复的物流信息,其他的物流信息没有办法再获取到。
    • 建议:
这样的方式调用   调用 logistics_sync_query 后 必须要调用 logistics_sync_ack  处理完 查询到的物流信息,不管是调用多次 logistics_sync_ack 还是 处理完一次调用,都可以。

6 api_goods_stock_change_query

有一个前提条件:对接该接口必须要对接 api_goodsspec_push 接口,具体原因见 api_goodsspec_push 接口功能说明

店铺编号shop_no 在系统中不存在或已停用

店铺编号shop_no 在系统中对应的店铺类型不是 自有类型

查询库存信息发生异常,请联系旺店通技术,联系方式点击这里查看。

7 api_goods_stock_change_ack

    • sync_list 结构异常
sync_list 不是一个数组结构,请检查数据的正确性
    • api_goods_stock_change_query 与 api_goods_stock_change_ack 配合使用
api_goods_stock_change_query 查询到的结果是旺店通ERP内商品库存发生变化的记录,当商品在旺店通ERP内库存发生变化时会向表中添加记录,调用接口时就能获取到记录了,
当平台同步完库存以后 调用 api_goods_stock_change_ack 接口告诉旺店通ERP api_goods_stock_change_query的查询到的库存记录有那些已经处理了,
旺店通ERP会把这些信息标记为已同步,下次再调用 api_goods_stock_change_query 就获取不到了。不能只调用 api_goods_stock_change_query 不调用 api_goods_stock_change_ack
2者必须是  先调用 api_goods_stock_change_query 再调用 api_goods_stock_change_ack 把需要处理的数据都处理完成了  再调用 api_goods_stock_change_query
Print Friendly, PDF & Email