旺店通·企业版和金蝶云星辰V1集成接口设计

源系统:旺店通·企业版

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

对接系统：金蝶云星辰V1

金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长

数据接口配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：旺店通·企业版的接口参数设置，以及设定好目标平台：金蝶云星辰V1的映射，即可启动方案进行测试

旺店通·企业版接口明细

调用接口：stockout_order_query_trade
接口名称：查询销售出库单
方法：POST

请求参数

字段字段名称类型配置值 start_time开始时间datetime2022-03-01 00:00:00 end_time结束时间datetime2022-03-30 00:00:00 status状态string110 src_order_no系统订单编号string src_tid原始单号string stockout_no出库单号string shop_no店铺编号string004,006 warehouse_no仓库编号string is_by_modifiedis_by_modifiedstring1 page_size分页大小string{{PAGINATION_PAGE_SIZE}} page_no页号string{{PAGINATION_START_PAGE}}

响应参数

字段字段名称类型配置值 order_no出库单号string src_order_no源单号string warehouse_no仓库编号string consign_time发货时间string order_type出库单类型string trade_status订单状态string order_type_name出库单类型名称string trade_type订单类型string subtype出库子类型string goods_total_amount货品总售价string goods_total_cost货品总成本string post_fee邮资成本string logistics_no物流单号string package_fee包装费string receiver_name收件人string receiver_country国家string receiver_province省份string receiver_city城市string receiver_district地区string receiver_address详细地址string receiver_mobile收件人移动电话string receiver_telno收件人固定电话string receiver_zip邮编string receiver_dtb大头笔string logistics_type物流公司类型string logistics_code物流公司编号string logistics_name物流公司名称string print_remark打印备注string salesman_no业务员编号string salesman_name业务员名称string fullname业务员名称string warehouse_name仓库string created创建时间string stockout_reason出库原因string outer_no外部单号string trade_no订单编号string src_trade_no原始单号string nick_name网名string customer_name客户名称string customer_no客户编号string trade_time交易时间string pay_time付款时间string status出库单状态string shop_name店铺名称string shop_no店铺编号string buyer_message买家留言string cs_remark客服备注string flag_name订单标记string post_amount邮费string block_reason截停原因string invoice_type发票类别string invoice_title发票抬头string invoice_content发票内容string invoice_id发票IDstring delivery_term发货条件string fenxiao_type分销类别string fenxiao_nick分销商IDstring cod_amount货到付款金额string id_card_type证件类别string receiver_area收件人地址string shop_remark店铺备注string platform_id平台idstring trade_id订单表主键string checker_name审单员编号string employee_no审单员编号string operator_name审核员string packager_no打包员编号string packager_name打包员string picker_no拣货员编号string picker_name拣货员string printer_no打单员编号string printer_name打单员string examiner_no验货员编号string examiner_name验货员string stockout_no出库单号string wms_status处理状态string error_info接口处理错误信息string warehouse_type仓库类别string warehouse_id出库仓库idstring customer_id客户idstring freeze_reason冻结原因string is_allocated是否分配string consign_status出库状态string ebill_status电子面单状态string operator_id制单人string goods_type_count货品种类数量string md5_strMD5字符串值string custom_type其他出库自定义子类别string receiver_ring京东三环内string to_deliver_time配送时间string pre_charge_time配送中心string logistics_id物流公司IDstring unknown_goods_amount未知成本销售总额string calc_post_cost预估邮费成本string post_cost邮费成本string calc_weight预估重量string post_weight快递重量string package_id包装idstring package_cost包装成本string has_invoice是否包含发票string printer_id打单员string pick_error_count拣货出错次数string picker_id拣货员idstring sorter_id分拣员idstring examiner_id验货员idstring consigner_id发货人idstring packager_id打包员idstring pack_score打包积分string pick_score拣货积分string checkouter_id签出员工idstring watcher_id监视员idstring picklist_no分拣单编号string picklist_seq分拣序号string invoice_print_status发票打印状态string flag_id颜色string logistics_template_id物流单模板idstring sendbill_template_id发货单模板idstring pos_allocate_mode货位分配方式string note_count便签条数string reason_id其他出库原因string lock_id锁定策略idstring reserve保留string src_tids原始单号string tax税额string currency币种string id_card证件号码string stock_check_time出库单审核时间string bad_reason异常状态string print_batch_no打印批次string sendbill_print_status发货单打印状态string logistics_print_status物流单打印状态string picklist_print_status分拣单打印状态string details_list货品列表节点array details_list.stockout_id出库单主键idstring details_list.goods_count货品数量string details_list.weight估重string details_list.paid已支付金额string details_list.refund_status退款状态string details_list.remark备注string details_list.src_order_type源单据类别string details_list.discount总折扣金额string details_list.tax_rate税率string details_list.spec_no商家编码string details_list.sell_price销售价string details_list.brand_no品牌编号string details_list.brand_name品牌名称string details_list.goods_type货品类型string details_list.gift_type是否是赠品string details_list.goods_name货品名称string details_list.goods_no货品编号string details_list.spec_name规格名称string details_list.spec_code规格码string details_list.suite_no来源组合装编码string details_list.total_amount总货款string details_list.goods_id货品idstring details_list.spec_id商品主键string details_list.market_price零售价string details_list.share_amount分摊后合计应收string details_list.barcode条码string details_list.unit_name基本单位string details_list.sale_order_id订单详情表主键string details_list.share_post邮费分摊string details_list.src_oid原始子订单号string details_list.src_tid原始订单号string details_list.from_mask单据内部来源string details_list.src_order_detail_idsales_trade_order表的主键string details_list.base_unit_id基本单位string details_list.unit_id辅助单位string details_list.unit_ratio单位换算string details_list.num2辅助数量string details_list.price最终价格string details_list.is_examined是否验货string details_list.is_package是否包装string details_list.is_zero_cost是否允许0成本string details_list.scan_type扫描方式string details_list.good_prop1货品档案自定义属性1string details_list.good_prop2货品档案自定义属性2string details_list.good_prop3货品档案自定义属性3string details_list.good_prop4货品档案自定义属性4string details_list.good_prop5货品档案自定义属性5string details_list.good_prop6货品档案自定义属性6string details_list.prop1单品列表自定义属性1string details_list.prop2单品列表自定义属性2string details_list.prop3单品列表自定义属性3string details_list.prop4单品列表自定义属性4string details_list.prop5单品列表自定义属性5string details_list.prop6单品列表自定义属性6string details_list.batch_remark批次备注string details_list.expire_date有效期string details_list.position_list货位节点列表array details_list.position_list.modified最后更新时间string details_list.position_list.batch_no批次号string details_list.position_list.rec_id货位主键idstring details_list.position_list.cost_price成本价string details_list.position_list.num货品数量string details_list.position_list.batch_id批次idstring details_list.position_list.position_id货位IDstring details_list.position_list.position_no货位编号string details_list.position_list.stockout_order_detail_id出库单明细idstring details_list.position_list.stockin_detail_id入库单明细idstring details_list.position_list.stock_spec_detail_id入库单号明细idstring details_list.position_list.position_goods_count货位出库数量string details_list.position_list.batch_no批次号string

金蝶云星辰V1接口明细

调用接口：jdy/sal/sal_outbound_save
接口名称：新增或修改一张销售出库单
方法：POST

请求参数

字段字段名称类型配置值 billsource单据来源，固定传入APPstringAPP billdate出库日期,格式：2019-01-01string{{consign_time datetime}} billno单据编号string{{order_no}} customerid_id客户信息stringfindCollection find id from a179791c-2fdf-30be-bf55-201f3b85bd6e where name={{shop_name}} empid_id业务员信息string remark单据备注string{{cs_remark}} contact_linkman联系信息-联系人string contact_phone联系信息-联系方式string contact_country_id联系信息-国家IDstring contact_province_id联系信息-省IDstring contact_city_id联系信息-市IDstring contact_district_id联系信息-区IDstring contact_address联系信息-详细地址string cost_fee销售费用string material_entity商品分录arraydetails_list material_entity.materialid_id商品string_findCollection find id from 3d4d739d-5826-3090-a582-d17a10a43790 where number={{details_list.spec_no}} material_entity.stockid_id仓库stringfindCollection find id from 35c82f7f-bdef-3bc1-86e6-4654e14ff702 where name={{warehouse_name}} material_entity.spid_id仓位string material_entity.qty数量string{{details_list.goods_count}} material_entity.unit_id单位string2 material_entity.price单价string{{details_list.sell_price}} material_entity.cess税率string{{details_list.tax_rate}} material_entity.disamount折扣额string material_entity.disrate折扣率（%）string material_entity.discount折扣（折）string material_entity.is_free是否赠品string_function CASE WHEN {{details_list.sell_price}}>0 THEN 'false' ELSE 'true' END material_entity.comment商品行备注string material_entity.auxpropid_id辅助属性string material_entity.batchno批次string{{batch_no}} material_entity.snlistid序列号流转idstring material_entity.sn_list序列号string material_entity.kfdate生产日期string material_entity.validdate到期日string material_entity.kfperiod保质期string material_entity.kftype保质期单位string material_entity.srcbillno源单编号string material_entity.custom_field128l7dyhux0m0pxie销售订单号string{{trade_no}}

系统数据对接

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

旺店通·企业版和金蝶云星辰V1集成接口设计