管易云·奇门对接打通金蝶云星空发货单查询接口与销售出库新增接口

管易云·奇门对接打通金蝶云星空发货单查询接口与销售出库新增接口

对接系统：管易云·奇门

金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。

写入目标:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据对接方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：管易云·奇门，然后选择对应的连接器。选择对应的gy.erp.trade.deliverys.get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

管易云·奇门接口明细

• 调用接口：gy.erp.trade.deliverys.get
• 接口名称：发货单查询
• 方法：POST

请求参数

字段	字段名称	类型	配置值
start_create	创建时间开始段	string
end_create	创建时间结束段	string
start_delivery_date	发货时间开始段	string	2022-07-31 00:00:00
end_delivery_date	发货时间结束段	string	2022-08-01 00:00:00
start_modify_date	修改时间开始段	string
end_modify_date	修改时间结束段	string
del	返回是否作废的单据	string
page_no	页号	string	{{PAGINATION_START_PAGE}}
page_size	分页大小	string	{{PAGINATION_PAGE_SIZE}}

响应参数

字段	字段名称	类型	配置值
id	id	string
code	单据编号	string
warehouse_code	仓库代码	string
shop_code	店铺代码	string
outer_code	平台单号	string
print	打印状态	string
scan	扫描状态	string
delivery	发货状态	string
cod	货到付款状态	string
vip_name	会员名称	string
create_date	制单时间	string
modify_date	修改时间	string
cancel	取消状态	string
payment	已付金额	string
pay_time	支付时间	string
invoiceDate	确认开票时间	string
bigchar	大头笔	string
unpaid_amount	未付金额	string
cod_fee	货到付款服务费	string
post_cost	物流成本	string
plan_delivery_date	预计发货时间	string
buyer_memo	买家留言	string
seller_memo	卖家备注	string
receiver_name	收货人姓名	string
receiver_phone	收货人电话	string
receiver_mobile	收货人手机	string
receiver_zip	收货邮编	string
receiver_address	收货地址	string
create_name	制单人	string
express_no	快递单号	string
shop_name	店铺名称	string
area_name	收货地区	string
warehouse_name	仓库名称	string
location_code	库位代码	string
express_code	快递公司代码	string
express_name	快递公司名称	string
tag_name	订单标记名称	string
seller_memo_late	二次备注	string
shelf_no	格子号	string
details	商品列表	string
details.qty	商品数量	string
details.price	实际单价	string
details.amount	商品总价	string
details.refund	退款状态	string
details.itemCategoryName	商品类别名称	string
details.itemUnitName	商品单位	string
details.barcode	商品条码	string
details.tariff	关税	string
details.memo	备注	string
details.picUrl	图片地址	string
details.oid	子订单号	string
details.trade_code	销售订单号	string
details.item_id	商品ID	string
details.item_sku_id	规格ID	string
details.item_code	商品代码	string
details.item_name	商品名称	string
details.sku_code	规格代码	string
details.sku_name	规格名称	string
details.sku_note	商品的规格备注	string
details.discount_fee	让利金额	string
details.amount_after	让利后金额	string
details.post_fee	物流费用	string
details.order_type	订单类型	string
details.platform_flag	平台旗帜	string
details.detail_unique	唯一码列表	string
details.detail_batch	批次列表	string
details.is_gift	是否赠品	string
details.businessman_name	业务员	string
details.platform_code	平台单号	string
details.tax_rate	税率	string
details.tax_amount	税额	string
details.tax_no	税号	string
details.other_service_fee	其他服务费	string
details.gift_source_view	赠品来源	string
details.currency_code	币别代码	string
details.currency_name	币别名称	string
details.delivery_statusInfo	单据状态信息	string
details.invoices	发票列表	string
details.vip_code	会员代码	string
details.vip_real_name	真实姓名	string
details.vip_id_card	身份证号码	string
details.package_center_code	集包地代码	string
details.package_center_name	集包地名称	string
details.sync_status	数据同步状态	string
details.sync_memo	数据同步备注	string
details.picture_bill	是否多包裹	string
details.drp_tenant_name	分销商名称	string
details.drp_tenant_mobile	分销商手机号	string

金蝶云星空接口明细

• API：batchSave
• NAME：销售出库新增
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	XSCKD01_SYS	单据类型
FBillNo	单据编号		单据编号
FDate	日期		日期
FSaleOrgId	销售组织		组织
FCustomerID	客户		基础资料
FBranchId	销售门店		基础资料
FSaleDeptID	销售部门		基础资料
FCorrespondOrgId	对应组织		组织
FCarrierID	承运商		基础资料
FCarriageNO	运输单号		文本
FSalesGroupID	销售组		基础资料
FSalesManID	销售员		基础资料
FStockOrgId	发货组织		组织
FDeliveryDeptID	发货部门		基础资料
FLinkPhone	联系电话		文本
FLinkMan	收货人姓名		文本
FStockerID	仓管员		基础资料
FNote	备注		多行文本
FReceiverID	收货方		基础资料
FReceiveAddress	收货方地址		文本
FSettleID	结算方		基础资料
FReceiverContactID	收货方联系人		基础资料
FPayerID	付款方		基础资料
FOwnerTypeIdHead	货主类型		多类别基础资料列表
FSHOPNUMBER	网店编码		文本
FSALECHANNEL	销售渠道		文本
FOwnerIdHead	货主		多类别基础资料
SubHeadEntity	财务信息
SubHeadEntity.FSettleOrgID	结算组织		组织
SubHeadEntity.FSettleTypeID	结算方式		基础资料
SubHeadEntity.FReceiptConditionID	收款条件		基础资料
SubHeadEntity.FBuyerNick	会员名称		文本
SubHeadEntity.FReceiverAddress	收货人地址		文本
SubHeadEntity.FReceiverName	收货人		文本
SubHeadEntity.FReceiverMobile	收货人手机		文本
SubHeadEntity.FReceiverCountry	收货人国家		文本
SubHeadEntity.FReceiverState	收货人省份		文本
SubHeadEntity.FReceiverCity	收货人城市		文本
SubHeadEntity.FReceiverDistrict	收货人地区		文本
SubHeadEntity.FReceiverPhone	收货人电话		文本
SubHeadEntity.FVIPCODE	会员编码		文本
SubHeadEntity.FEntity	明细信息
SubHeadEntity.FEntity.FCustMatID	客户物料编码		基础资料
SubHeadEntity.FEntity.FMaterialID	物料编码		基础资料
SubHeadEntity.FEntity.FBarcode	零售条形码		文本
SubHeadEntity.FEntity.FRealQty	实发数量		数量
SubHeadEntity.FEntity.FPrice	单价		单价
SubHeadEntity.FEntity.FTaxPrice	含税单价		单价
SubHeadEntity.FEntity.FIsFree	是否赠品		复选框
SubHeadEntity.FEntity.FLot	批号		批次
SubHeadEntity.FEntity.FProduceDate	生产日期		日期
SubHeadEntity.FEntity.FExpiryDate	有效期至		日期
SubHeadEntity.FEntity.FEntryTaxRate	税率%		小数
SubHeadEntity.FEntity.FEntryTaxAmount	税额		金额
SubHeadEntity.FEntity.FAmount	金额		金额
SubHeadEntity.FEntity.FAllAmount	价税合计		金额
SubHeadEntity.FEntity.FStockID	仓库		基础资料
SubHeadEntity.FEntity.FStockLocID	仓位		维度关联字段
SubHeadEntity.FEntity.FStockStatusID	库存状态		基础资料
SubHeadEntity.FEntity.FMtoNo	计划跟踪号		文本
SubHeadEntity.FEntity.FEntrynote	备注		文本
SubHeadEntity.FEntity.FSoorDerno	订单单号		文本
SubHeadEntity.FEntity.FDiscountRate	折扣率%		小数
SubHeadEntity.FEntity.FEntity_Link	关联关系表
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FRuleId	转换规则		SaleOrder-OutStock T_SAL_ORDERENTRY DeliveryNotice-OutStock T_SAL_DELIVERYNOTICEENTRY
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSTableName	源单表
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSBillId	源单内码
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSId	源单分录内码
SubHeadEntity.FEntity.FormId	业务对象表单Id	SAL_OUTSTOCK	必须填写金蝶的表单ID如 UR_PurchaseOrder
SubHeadEntity.FEntity.Operation	执行的操作	Save
SubHeadEntity.FEntity.IsAutoSubmitAndAudit	提交并审核	true
SubHeadEntity.FEntity.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
SubHeadEntity.FEntity.SubSystemId	系统模块	21	默认仓库模块

系统打通概况

从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。