【应用场景】

第三方对接系统业务单据的常用单据--销售订单，常用的新增、修改销售订单的WebAPI接口

【销售订单保存接口说明及示例】

一、接口说明：

1.接口名称：Save    [批量保存：BatchSave]

   接口组件：Kingdee.BOS.WebApi.ServicesStub.dll

   接口类名：Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.cs

2.接口调用全称：

  SDK调用：Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save

                   Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.BatchSave

  HTTP调用：

http://服务器地址/k3cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save.common.kdsvc

http://服务器地址/k3cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.BatchSave.common.kdsvc

【参数说明】

*****【重点】**************************【Model字段构造】*****************************【重点】*****

原则：

1.构造json字段尽量精简，按需构造关键字段即可，WebAPI构造单据原理类似模拟录单，有默认值的字段和字段会自动联动携带相关值（包括字段值更新、插件等逻辑联动携带出来，如：客户字段自动携带默认销售员、结算币别等）的字段可无须构造。

2.修改保存单据，只需要构造单据主键FID或分录主键FEntryId+需要修改的字段即可。

3.json字段顺序位置非常关键，构造单据时是按照json字段顺序逐实体逐个字段触发值更新事件和服务的。

4.json数据包字段多少和顺序对性能和数据正确性有很大影响，尽量按需构造，避免无用的字段

示例1：【极简模式】：

{   

 "formId":"SAL_SaleOrder",  

  "data":{      

              "Model": {                  

                          "FSaleOrgId": { "FNumber": "100" },       

                         "FCustId": {"FNumber": "WebAPICust" },         

                          "FSaleOrderEntry": [       

                                {            

                                     "FMaterialId":{"FNumber":"1.01.001.0001"},                    

                                      "FQty":"8",                

                                      "FTaxPrice":"8.88"              

                                 }                   ]       

                             }  

              }

 }

【示例1  PostMan测试验证】

示例2：【极简模式基础上逐步追加所需字段】：

{    

    "formId":"SAL_SaleOrder",    

    "data":{        

                "Model": {          

                              "FBillTypeID": { "FNumber": "XSDD01_SYS"},           

                               "FSaleOrgId": { "FNumber": "100" },          

                              "FCustId": { "FNumber": "WebAPICust" },       

                             "FSalerId": {"FNumber":"201801014_GW000005_100041" },         

                             "FSaleOrderFinance":    {                        

                                               "FSettleCurrId": { "FNumber": "PRE007" }               

                              },        

                             "FSaleOrderEntry": [            

                                        {                 

                                               "FMaterialId":{"FNumber":"1.01.001.0001"},                    

                                                "FQty":"8",                

                                                "FTaxPrice":"8.88"              

                                      },     

                                      {              

                                                  "FMaterialId":{"FNumber":"1.01.002"},         

                                                   "FQty":"9",                

                                                    "FTaxPrice":"9.99"           

                                      }               ]     

                           }   

                 } 

}

【示例2  PostMan测试验证】

从简化Json逐步追加业务所需字段说明和格式的查找方式：

【修改保存】

*****【重点】**************************【Model字段构造】*****************************【重点】*****

原则：

1.修改保存时，除了构造主键FID、分录主键FEntryId 以及需要修改的字段外，不要构造其他多余字段

2.修改保存时，注意IsDeleteEntry参数非常重要，且默认为true，需小心使用。如为true，则原分录行的FEntryId未在分录json出现的行，将会被删除 （如无需删除分录行，需将参数值改为fasle 或者 json里面传入对应行的FEntryId值）

修改保存示例：

{   

 "formId":"SAL_SaleOrder",    

 "data":{

         "IsDeleteEntry":"false",       

         "Model": {                       

                 "FId": "100917",             

                 "FSaleOrderEntry": [               

                                 {                  

                                      "FEntryId":"101348",   

                                        "FQty":"5"                          

                                  }          ]     

                       }   

         } 

}

【修改保存  PostMan测试验证】

【参考资料】

【相关链接】

浅谈通过WebAPI实现金蝶云单据对接的那些事[持续更新完善]https://vip.kingdee.com/article/11179