摘要由AI智能服务提供本文介绍了金蝶云Web API中单据保存接口的操作，特别是无源单的单据保存。文章以销售订单为例，详细说明了准备对接的三要素：URL、Data（请求参数）和Cookies（用户验证）。其中，Data部分详细分析了请求参数的构成，包括必填和非必填参数，以及如何通过JSON格式传递数据。文章还介绍了如何通过Python代码实现登录和单据保存操作，并展示了成功保存销售订单的示例。最后，提供了QQ群号以便读者交流学习。
今天接着来分享一下Web API中的保存接口的另外一个接口：单据保存。单据保存可分为无源单的单据保存，和有源单的单据保存。本文主要分享关于无源单的单据保存接口操作。（有源单的单据保存接口操作：https://vip.kingdee.com/article/45025）保存接口的内容有点多，你一定要细心看下去，对其他的API操作也有一定的帮助。好了，闲话不多说，进入正题：下面我以销售订单为例子进行讲解分析：
首先，同样地，我们需要准备好对接的三大利器：1：URL(链接)：保存接口的URL是：https://自己企业的登录域名 +/k3Cloud/Kingee.Bos.WebApi.ServicesStub.DynamicFormservice.Save.Common.KDSVC (固定不变）举个例子，如果贵公司的登录域名是：https://thisisatest.ik3cloud.com，那么，保存接口的URL就应应该是：https://thisisatest.ik3cloud.com ... e.Save.Common.KDSVC 顺便说明一下，我上面举例是用https协议的，而有的企业是http协议的，如果是的话，就要使用http协议。尽量复制域名，这样才不会出错，也别多复制一个k3cloud哈。
2： Data(即请求参数)：打开金蝶的Web API功能，可以看到保存接口的请求参数有，如图所示
首先，你要记住一个规则，金蝶云的Web API有个特点，非必填的参数是可以不用传的。
看到这里，有的朋友就问，非必填的话，我可以传空值吗？答案是：有时候可以，但有的时候就不可以，因为空值有的时候会报错(未将对象引用设置到对象的实例)，这个就是典型的：没有实例化。传了key，然后服务器找不到value。如果不传key，那么就不会报这个错。所以非必填的参数能不传就不传。千万要记住这一点。记住这一点后，你的成功率就达到90%以上了！！！然后估计又有人问了，那我哪知道哪些是必传，哪些是非必传呢？看下面截图：
讲了这么多，大家应该知道怎么去构建请求参数了吧。是不是清晰了很多。再跟大家说一个技巧，先截图：
3：Cookies(用户验证,基于HTTP协议的)
之前的文章已经说了如何通过API登录验证，这里就不多说了，需要看的话，点击链接查看即可：https://vip.kingdee.com/article/45012这里只是说一下，除了登录校验不需要cookies，其他的API接口都需要携带cookies进行操作的。建议写一个登录函数，然后返回 cookies，即可每次携带cookies访问了。可参照我下面的函数。如果没有携带，会出现如下的返回信息：
我也看不懂，反正'IsSuccess'==False，我就知道是操作失败了。-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------好了，三大利器准备好了，我就直接上Python代码了：
import requests,json
login_url="https://pocknoiral.ik3cloud.com/k3cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc"
save_url ="https://pocknoiral.ik3cloud.com/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save.common.kdsvc"
login_data={ "acctid":"20180321174312","username":"你的用户名","password":"你的密码","lcid":2052}
def login(): # 定义登录函数
login_response=requests.post(url=login_url,data=login_data)
return login_response.cookies # 返回cookies,方便下次访问时携带
post_data = {"Model": { "FCustId": {"FNumber": "01.019"},
"FDate":"2019-04-20",
"FSalerId": {"FNumber": "GY002"},
"FSaleOrderEntry":[{ "FMaterialId":{"FNumber": "A.000361"},"FQty":10,"FTaxPrice": 1000,}]}}
data = {"FormID": "SAL_SaleOrder", "Data": json.dumps(post_data)}
save_response = requests.post(url=save_url,data=data,cookies=login())
print(save_response.text)
返回信息： 
截止至此，希望你能很透彻地理解金蝶云的Web API了。
非常感谢！！！
其他的分享，请关注评论内容，里面有链接。
-----------------------------------------------------------------------------------------------------------------------------------------------------------另外，如果大家有遇到问题，随时可以加我建立的QQ群：712623210 (金蝶云Web API系统集成沟通群)。只要我能解决的，都会帮忙，毕竟大家都是一个行业的，相互交流，学习。-----------------------------------------------------------------------------------------------------------------------------------------------------------
推荐阅读