跳转至

[20106611] 订单系统-》eBay平台对接-新对接eBay托管账户

状态：已发布 ｜ 创建：2020-05-28 13:57:06 ｜ 完成：2020-10-11 04:10:47 ｜ 最后更新：2020-10-27 11:25:13 TAPD链接 ｜ 项目：ERP_需求分析（20106611） 处理人：陈家宜; ｜ 开发： ｜ 创建人：黄媛凤 ｜ 优先级：High ｜ 模块：销售-订单管理 ｜ 标签：

原始需求描述

【用户场景】

客户：普泰ptc(忠建电子） 反馈eBay平台要求他们新注册托管账户，今后付款将不再使用PayPal，希望我司可以对接好此项服务

图片

图片

图片

提供的api链接：https://developer.ebay.com/managed-payments

图片

图片

图片

【期望结果】

可以顺利用erp对接托管账户，进行交易记录确认和操作退款

————————————————————————以上为原始需求，需求提出者编辑———————————————————————— 【页面路径】

订单系统》订单管理》EBAY订单-rma管理-退款

eBay Managed Payments

退款对接接口：https://developer.ebay.com/api-docs/sell/fulfillment/resources/order/methods/issueRefund

一、托管账号订单辨认

1.当旧版获取订单GetOrders接口拉取到的数据内的PaymentMethod=CreditCard/CCAccepted时 这个订单则为托管账户订单 当新版获取订单接口 getOrders（ OAuth授权 ）拉取到的订单当.paymentMethod=EBAY是这个订单则为托管账户订单

图片

图片

2.如果是托管账户的订单则无需判断是否有paypal交易记录也无需标记：系统标记:Paypal交易记录缺失

图片

二、ebay托管账户退款对接

注：以下需求说明内的字段都为旧版的接口字段内容

1.在ebay订单内创建RMA退款的时候显示退款原因 ①新增显示退款原因（eBay Managed Payments订单退款必选）

图片

退款原因下拉框取值： https://developer.ebay.com/api-docs/sell/fulfillment/types/api:ReasonForRefundEnum 图片

平台退款原因枚举 | 系统内退款原因枚举 | BUYER_CANCEL

| Buyer Cancel(买家取消订单)

| SELLER_CANCEL

| Seller Cancel(卖家取消订单)

| ITEM_NOT_RECEIVED

| Item Not Received（没有收到商品）

| BUYER_RETURN

| BUYER RETURN（买家退款）

| ITEM_NOT_AS_DESCRIBED

| Item Not As Described（商品与描述不符）

| SHIPPING_DISCOUNT

| Shipping Discount（物流折扣）

| OTHER_ADJUSTMENT | Other Adjustment（其他调整） |

②卖家留言用户填写了的话则推送到comment字段 ③rma管理内的温馨提示更改为： ebay平台如果使用paypal收款的则需要绑定paypal才支持平台退款，如果是使用eBay Managed Payments收款的则需要对店铺账号进行OAuth授权才能进行平台退款

图片

2当订单为托管账户订单，在提交退款RMA的时候 ①当提交rma选择的退款原因显示在列表中的“平台退款原因”中。

②退款管理新增平台审核中状态（该状态的icon详见附件） 平台审核状态中的退款订单能实施的操作：查看、作废（作废后状态变为已作废）、标记退款（标记退款后状态变为已退款） 平台审核中状态的旁边增加一个？：平台审核中状态是等待平台更新退款的状态。目前仅对订单的退款审核通过后7天内主动查询退款状态，如果订单的退款状态在退款审核时间的7天后再返回则不会更新退款的状态，需要手动标记退款

图片

③当用户在订单系统》RMA管理》退款管理中将该待审核状态退款单审核通过或免审核直接退款时调用issueRefund接口【该接口需要OAuth授权】向平台发起退款申请。如果平台的返回了refundStatus=PENDING则表示退款申请发起成功，系统退款状态变更为状态：“平台审核”。 issueRefund接口：https://developer.ebay.com/api-docs/sell/fulfillment/resources/order/methods/issueRefund

④对处于平台审核状态中的ebay退款订单在退款审核通过的7天内 当拉取订单时，获取到订单的退款状态：OrderArray.Order.MonetaryDetails.Refunds.Refund.RefundStatu这个来判断订单当前的退款状态，当这个refundStatus= Succeeded 的时候，系统内的退款订单状态更新为已退款。如果当这个refundStatus= Failed 则系统状态更新为退款失败。refundStatus= pending 的时候则维持在退款状态：平台审核

getOrders接口： https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetOrders.html#GetOrders