利用简道云API实现与小满CRM的数据互通实战

最近在做一个项目，需要把公司销售端的小满CRM和我们内部使用的简道云应用打通。核心需求有两个：一是小满里的订单审核通过后，简道云里能自动生成一张发货单；二是简道云里的回款信息能同步回小满。

搜了一圈，发现简道云的API开放能力挺强的，于是自己动手写了个Python脚本跑通了。分享下具体的实现思路和关键代码。

1. 整体思路

采用"中间表+定时任务"的策略。我没有选择实时推送，而是用了一个折中的方案：

• 小满CRM将需要同步的数据通过API写入一个指定的中间数据库

• 简道云通过API轮询这个中间数据库

• 拉取到新数据后，通过简道云的API写入对应的应用表单

这样做的好处是解耦，即使一个系统挂了，数据也不会丢。

2. 关键代码解析

以下是我写的核心同步逻辑，去掉了敏感信息，供大家参考：

第一步：拉取小满数据

python

# 调用小满API获取今日新增订单
def get_xiaoman_orders():
    url = "https://api.xiaoman.cn/v1/order/list"
    headers = {"Content-Type": "application/json"}
    payload = {
        "client_id": "YOUR_ID",
        "start_date": "2024-05-01"
    }
    response = requests.post(url, json=payload, headers=headers)
    return response.json()

第二步：写入简道云

python

# 将数据写入简道云的「销售订单」表单
def push_to_jiandaoyun(order_data):
    url = "https://api.jiandaoyun.com/api/v1/app/APP_ID/entry/ENTRY_ID/create"
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    
    # 重点：字段映射
    data = {
        "data": {
            "客户名称": order_data['customer_name'],
            "订单金额": float(order_data['amount']),
            "商品明细": order_data['products']
        }
    }
    requests.post(url, json=data, headers=headers)

3. 踩坑记录

坑一：分页数据丢失

• 现象：每次只能同步20条，后面的数据同步不过来。

• 解决：小满API默认分页，需要在代码里写循环，直到拉不到数据为止。

坑二：字段类型不匹配

• 现象：金额同步过去变成了文本，无法做SUM计算。

• 解决：在写入简道云时，强制将数字字段转成float类型，同时确认简道云表单里的字段类型是「数字」。

坑三：重复数据问题

• 现象：脚本多跑了几次，简道云里出现重复单据。

• 解决：利用简道云的「表单校验」功能，设置了订单编号的唯一性，重复提交时用update接口替代create接口。

4. 结果

目前这套脚本已经跑了2周，配合Windows计划任务每小时执行一次。人工重复录入的工作量减少了80%以上。