必须先在轻易云平台创建并配置数据集成方案，选择旺店通·企业奇门为源系统，完成AppKey/AppSecret授权；配置wdt.purchase.return.query或wdt.stockout.order.query接口，设置时间范围、status等必要参数；目标写入用友BIP需映射src_order_no→billNo、return_amount→totalAmount，并转换status数值为字符串；保存测试通过后启用每30分钟定时任务。
要让旺店通API接口与第三方系统完成联调，必须先在轻易云数据集成平台中创建并配置数据集成方案，否则无法发起有效请求。
准备旺店通API连接器
登录轻易云数据集成平台→点击【数据集成方案】→选择【开始创建数据集成方案】。
在方案配置表单中，源业务系统选择【旺店通·企业奇门】，目标系统暂不填写；系统将自动加载对应连接器，此时需确认连接器状态为“已授权”——【未完成旺店通应用授权的连接器无法发起任何API调用】。
授权操作需跳转至旺店通开放平台，在“我的应用”中找到对应AppKey，复制AppSecret并粘贴回轻易云连接器配置页完成绑定。
配置数据拉取接口
方法一：采购退货单同步（wdt.purchase.return.query）
在源系统配置区，API名称填写 wdt.purchase.return.query，请求方法选 POST；设置时间范围参数：start_time 填 { {LAST_SYNC_TIME datetime}}，end_time 填 { {CURRENT_TIME datetime}}。
关键注意：status 字段必须显式传值，例如填 110（已完成）或 95（已发货），不传则默认返回空结果集。
方法二：销售出库单同步（wdt.stockout.order.query）
API名称填 wdt.stockout.order.query，method 为 POST；分页参数 page_no 和 page_size 必须同时配置，建议 page_size 设为 30；过滤条件中 warehouse_no 可留空，但需添加 status=95,110 排除已取消和待审核单据。
配置目标系统写入动作
第一步：选择目标平台为【用友BIP】，加载对应连接器；
第二步：在目标动作中选择接口路径 /yonbip/scm/purinrecord/mergeSourceData/save；
第三步：映射字段——旺店通返回的 src_order_no 必须映射到用友BIP的 billNo 字段，return_amount 映射到 totalAmount；【若 src_order_no 为空，用友BIP将拒绝该条记录入库】。
第四步：启用字段转换逻辑，将旺店通的 status 数值（如 110）转为用友BIP要求的字符串状态（如 "FINISH"）。
启动联调与验证
① 点击【保存并测试】，平台将立即执行一次单页拉取（page_no=1, page_size=10）；
② 查看日志输出中的 response code 是否为 200，且 body 中有非空 data 数组；
③ 若返回 error_code=4001，说明旺店通 AppKey 或 AppSecret 错误；
④ 若返回 data=[] 但 code=200，检查 start_time 是否早于旺店通系统中最早退货单的修改时间；
⑤ 测试通过后，启用定时任务，周期设为每30分钟一次，起始时间为当前时间减30分钟。
