从旺店通到金蝶云星空：轻易云平台退换货数据对接详解

  • 轻易云集成顾问-叶威宏

通过轻易云实现旺店通·旗舰奇门退换货数据高效对接金蝶云星空

在现代电商环境中，高效的退换货处理是提升客户满意度和优化业务流程的重要环节，特别是在复杂的平台间进行数据集成时更显重要。在本技术案例中，我们将详解如何利用轻易云平台，实现从旺店通·旗舰奇门到金蝶云星空的数据无缝对接，并确保整个过程中数据准确、及时、高效地传输。具体方案名称为：旺店通退换货对接金蝶销售出库-new。

数据获取与接口调用

首先，为了抓取需处理的退换货订单数据，我们使用了旺店通·旗舰奇门提供的API接口wdt.aftersales.refund.refund.search。该接口支持分页查询，这对于海量订单批量导入并保证不漏单尤为关键。因此，我们需要设计一个定时任务，定期可靠地调用该API以确保获取最新的退款退货信息。

{
    "api": "wdt.aftersales.refund.refund.search",
    "parameters": {
        // 参数细节
    }
}

数据格式转换与映射

由于两系统之间的数据格式可能存在差异，因此，在进入下一步前，需要进行适当的数据格式转换和清洗，以便能够顺利写入到金蝶云星空。这包括字段名称、类型匹配以及必要的数据校验等步骤。同时，根据业务需求来定制化映射规则，将获取的原始数据与目标系统所需结构相匹配。

大量数据快速写入

随后，通过轻易云平台统一标准化处理后的数据将使用金蝶云星空提供的一系列API，例如batchSave接口，这一过程需要考虑大量并发请求下依旧保持高效稳定性能。我们采用分批次方式，一次性上传一定数量记录 的方法，极大提高了整体效率，并保证不会因单个请求过多而导致超时或失败问题。

{
    "api": "batchSave",
    "data": [
        // 经过清洗和转换后的JSON数组
    ]
}

异常处理与错误重试机制

为了保障整个集成流程中的稳定性和可追溯性，在实际操作过程中难免会遇到网络波动或其他异常情况。因此，实现在出现错误时自动重试及记录日志便成为必不可少的一部分。这不仅可以降低人工介入频率，还能确保每一条重要信息都能最终成功传递到目标数据库中去。

通过以上几项关键技术点，使得此次由“旺店通”至“金蝶”的跨平台多类型 用友与WMS系统接口开发配置

调用旺店通·旗舰奇门接口获取并加工数据

在数据集成过程中，调用源系统的API接口是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用旺店通·旗舰奇门接口wdt.aftersales.refund.refund.search，并对获取的数据进行初步加工。

接口调用配置

首先，我们需要配置API接口的元数据。根据提供的metadata，wdt.aftersales.refund.refund.search接口采用POST请求方式，主要参数包括分页参数和业务参数。以下是具体的配置细节：

{
  "api": "wdt.aftersales.refund.refund.search",
  "method": "POST",
  "number": "refund_no",
  "id": "refund_no",
  "idCheck": true,
  "request": [
    {
      "field": "pager",
      "label": "分页参数",
      "type": "object",
      "children": [
        {
          "field": "page_size",
          "label": "分页大小",
          "type": "string",
          "value": "200",
          "parent": "pager"
        },
        {
          "field": "page_no",
          "label": "页号",
          "type": "string",
          "value": "1",
          "parent": "pager"
        }
      ]
    },
    {
      "field": "params",
      ...
    }
  ],
  ...
}

分页参数

分页参数用于控制每次请求的数据量和当前页码。这里我们设置了每页200条记录，并从第一页开始。

  • page_size: 设置为200。
  • page_no: 设置为1。

业务参数

业务参数包含了多个字段，用于过滤和查询特定条件下的退换货数据。这些字段包括但不限于：

  • shop_nos: 店铺编号，由英文逗号分隔。
  • tid: 原始单号。
  • buyer_nick: 客户网名。
  • trade_no: 系统订单编号。
  • refund_no: 退换单号。
  • return_logistics_no: 物流单号（退换单上的退回物流单号）。
  • modified_from 和 modified_to: 修改时间范围，使用函数动态计算上个月的起始和结束时间。
  • status: 退换单状态，默认值为90（已完成）。

以下是部分业务参数的示例配置：

{
  ...
  {
    "field": "params",
    ...
    {
      ...
      {
        ...
        {
          ...
          {
            ...
            {
              ...
              {
                ...
                {
                  ...
                  {
                    ...
                    {
                      ...
                      {
                        ...
                        {
                          ...
                          {
                            ...
                            {
                              ...
                              {
                                ...
                                {
                                  ...
                                  {
                                    ...
                                    {"field":"status","label":"退换单状态","type":"string","describe":"10:已取消;20:待审核;30:已审核;40已推送:80:已结算;81:待回传;85:待过账;86:已过账;87:成本确认;90:已完成","value":"90","parent":"params"}
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    ...
  },
  ...
}

数据请求与清洗

在完成API调用配置后，我们可以通过轻易云平台发起请求并获取数据。由于返回的数据可能包含大量无用信息或格式不一致，需要进行初步清洗和转换。

  1. 数据过滤：根据条件过滤掉不符合要求的数据。例如，只保留状态为90（已完成）的记录。
  2. 字段映射：将返回的数据字段映射到目标系统所需的字段。例如，将refund_no映射到目标系统中的相应字段。
  3. 数据格式化：对日期、金额等字段进行格式化处理，以符合目标系统的要求。

以下是一个简单的数据清洗示例：

def clean_data(data):
    cleaned_data = []
    for record in data:
        if record['status'] == '90':
            cleaned_record = {
                'refund_no': record['refund_no'],
                'shop_no': record['shop_no'],
                'buyer_nick': record['buyer_nick'],
                'trade_no': record['trade_no'],
                'modified_time': format_date(record['modified']),
                # 更多字段映射...
            }
            cleaned_data.append(cleaned_record)
    return cleaned_data

数据转换与写入

在完成数据清洗后，下一步是将数据转换为目标系统所需的格式，并写入目标系统。这一步通常涉及到更多复杂的逻辑处理，如数据合并、去重等。

def transform_and_write(data):
    transformed_data = transform(data)
    write_to_target_system(transformed_data)

def transform(data):
    # 数据转换逻辑
    return transformed_data

def write_to_target_system(data):
    # 写入目标系统逻辑

通过上述步骤，我们可以高效地调用旺店通·旗舰奇门接口获取并加工退换货数据，为后续的数据集成奠定基础。 用友与WMS系统接口开发配置

使用轻易云数据集成平台将旺店通退换货数据转换并写入金蝶云星空API

在数据集成的生命周期中，ETL（Extract, Transform, Load）转换是关键步骤之一。本文将详细探讨如何使用轻易云数据集成平台将旺店通退换货数据转换为金蝶云星空API接口所能接收的格式，并最终写入目标平台。

数据请求与清洗

首先，我们需要从源系统（旺店通）获取退换货数据。这一步骤包括数据请求和初步清洗，以确保数据质量和一致性。在此阶段，我们会提取如退款编号、退款时间、销售组织、库存组织、退货客户等关键信息。

数据转换与写入

接下来是将清洗后的数据进行转换，并通过金蝶云星空API接口写入目标平台。以下是具体的元数据配置及其解析：

{
  "api": "batchSave",
  "method": "POST",
  "idCheck": true,
  "operation": {
    "rowsKey": "array",
    "rows": 1,
    "method": "batchArraySave"
  },
  "request": [
    {
      "field": "FBillTypeID",
      "label": "单据类型",
      "type": "string",
      "describe": "单据类型",
      "parser": {
        "name": "ConvertObjectParser",
        "params": "FNumber"
      },
      "value": "XSTHD01_SYS"
    },
    {
      "field": "FBillNo",
      "label": "单据编号",
      ...

关键字段解析

  1. FBillTypeID: 单据类型，固定值为XSTHD01_SYS。
  2. FBillNo: 单据编号，对应于源系统中的退款编号{refund_no}。
  3. FSaleOrgId: 销售组织，固定值为100。
  4. FDate: 日期，对应于退款时间{refund_time}。
  5. FStockOrgId: 库存组织，固定值为100。
  6. FRetcustId: 退货客户，对应于源系统中的店铺编号{shop_no}。
  7. FEntity: 明细信息，包括物料编码、实退数量、退换货类型等。

子字段解析

在明细信息（FEntity）中，每个子字段都需要进行相应的转换：

  • FMaterialId: 物料编码，对应于源系统中的商品编号{{detail_list.goods_no}}。
  • FRealQty: 实退数量，对应于源系统中的库存数量{{detail_list.stockin_num}}。
  • FReturnType: 退换货类型，固定值为1。

API调用与写入

通过上述配置，我们可以构建一个完整的JSON请求体，并使用HTTP POST方法调用金蝶云星空的batchSave API接口。以下是一个示例请求体：

{
  ...
  {
    ...
    {
      ...
      {
        ...
        {
          ...
          {
            ...
            {
              ...
              {
                ...
                {
                  ...
                  {
                    ...
                    {
                      ...
                      {
                        ...
                        {
                          ...
                          {
                            ...
                            {
                              ...
                              {
                                ...
                                {
                                  ...
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  ... 
}

通过这种方式，我们能够实现旺店通退换货数据到金蝶云星空的无缝对接，确保每个字段都能准确映射并成功写入目标平台。 数据集成平台API接口配置

版权声明

该文章《从旺店通到金蝶云星空：轻易云平台退换货数据对接详解》为原创内容，版权归 广东轻亿云软件科技有限公司 所有。 未经本公司书面授权，严禁转载、引用、复制或建立镜像等行为。 若需转载或引用本文内容，请联系本公司获取授权，并在显著位置注明作者姓名、文章出处（包括原文链接）等信息。

金蝶云星空与旺店通打通
更多系统对接方案