管易云·奇门和MySQL集成接口设计

源系统:管易云·奇门

管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品

目标系统:MySQL

MySQL是最流行的数据库之一，是一个免费开源的关系型数据库管理系统，但也不意味着该数据库是完全免费的。MySQL由瑞典MySQLAB公司开发，目前属于Oracle公司。MySQL适合中小型软件，被个人用户以及中小企业青睐。

数据对接方案

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：管易云·奇门，并且选择对应的连接器（关于管易云·奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的发货单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为MySQL，并且选择对应连接器。选择对应的执行操作语句-v2接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

管易云·奇门接口明细

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

请求参数

字段名称类型 end_create创建时间结束段datetime outer_code平台单号string wms是否外仓单据int code单据编码string end_modify_date修改时间结束段datetime start_delivery_date发货时间开始段datetime page_size每页大小int shop_code店铺编码string start_modify_date修改时间开始段datetime del是否返回已作废的int delivery发货状态int mail_no物流单号string start_create创建时间开始段datetime page_no页码int end_delivery_date发货时间结束段datetime warehouse_code仓库编码string

响应参数

字段名称类型描述 shop_name店铺名称string店铺名称 warehouse_name仓库名称string仓库名称 amount总金额float总金额 qty商品总数float商品总数 platform_code平台单号string平台单号 seller_memo_late二次备注string二次备注 cod_fee货到付款服务费float货到付款服务费 delivery_statusInfo单据状态信息object单据状态信息 delivery_statusInfo.delivery_print_date发货单打印时间datetime发货单打印时间 delivery_statusInfo.print_delivery是否打印发货单string是否打印发货单 delivery_statusInfo.cancel是否取消bool是否取消 delivery_statusInfo.express_print_date物流单打印时间datetime物流单打印时间 delivery_statusInfo.delivery_name发货人string发货人 delivery_statusInfo.scan_name扫描人string扫描人 delivery_statusInfo.delivery_date发货时间datetime发货时间 delivery_statusInfo.delivery_print_name发货单打印人string发货单打印人 delivery_statusInfo.cancel_date取消时间string取消时间 delivery_statusInfo.weight_qty称重重量float称重重量 delivery_statusInfo.express_print_name物流单打印人string物流单打印人 delivery_statusInfo.print_express是否打印快递单string是否打印快递单 delivery_statusInfo.thermal_print_status电子面单分配状态string电子面单分配状态 delivery_statusInfo.delivery发货状态int发货状态 delivery_statusInfo.weight是否称重bool是否称重 delivery_statusInfo.weight_name称重人string称重人 delivery_statusInfo.cancel_name取消人string取消人 delivery_statusInfo.thermal_print电子面单打印状态bool电子面单打印状态 delivery_statusInfo.weight_date称重时间datetime称重时间 delivery_statusInfo.wms是否外仓订单int是否外仓订单 delivery_statusInfo.standard_weight标准重量float标准重量 delivery_statusInfo.scan_date扫描时间datetime扫描时间 delivery_statusInfo.wms_order外仓转入状态int外仓转入状态 delivery_statusInfo.scan是否扫描bool是否扫描 delivery_statusInfo.bigchar大头笔string大头笔 delivery_statusInfo.vip_real_name真实姓名string真实姓名 delivery_statusInfo.tag_name订单标记名称string订单标记名称 delivery_statusInfo.warehouse_code仓库代码string仓库代码 delivery_statusInfo.express_code快递公司代码string快递公司代码 delivery_statusInfo.express_no快递单号string快递单号 delivery_statusInfo.modify_date修改时间datetime修改时间 delivery_statusInfo.post_cost物流成本float物流成本 delivery_statusInfo.unpaid_amount未付金额float未付金额 delivery_statusInfo.vip_name会员名称string会员名称 delivery_statusInfo.seller_memo卖家备注string卖家备注 delivery_statusInfo.vip_code会员代码string会员代码 delivery_statusInfo.create_name制单人string制单人 delivery_statusInfo.details商品列表array商品列表 delivery_statusInfo.details.currency_name币别名称string币别名称 delivery_statusInfo.details.platform_flag平台旗帜int平台旗帜 delivery_statusInfo.details.other_service_fee其他服务费float其他服务费 delivery_statusInfo.details.sku_code规格代码string规格代码 delivery_statusInfo.details.item_name商品名称string商品名称 delivery_statusInfo.details.gift_source_view赠品来源string赠品来源 delivery_statusInfo.details.order_type订单类型string订单类型 delivery_statusInfo.details.detail_unique唯一码列表array唯一码列表 delivery_statusInfo.details.detail_unique.warwhouse_name仓库名称string仓库名称 delivery_statusInfo.details.detail_unique.unique_code唯一码string唯一码 delivery_statusInfo.details.detail_unique.qty数量float数量 delivery_statusInfo.details.detail_unique.imei串码string串码 delivery_statusInfo.details.detail_unique.refund退款状态int退款状态 delivery_statusInfo.details.detail_unique.amount_after让利后金额float让利后金额 delivery_statusInfo.details.detail_unique.detail_batch批次列表array批次列表 delivery_statusInfo.details.detail_unique.detail_batch.batchNumber批号string批号 delivery_statusInfo.details.detail_unique.detail_batch.validTime有效日期date有效日期 delivery_statusInfo.details.detail_unique.detail_batch.productionTime生产日期date生产日期 delivery_statusInfo.details.detail_unique.detail_batch.qty数量float数量 delivery_statusInfo.details.detail_unique.detail_batch.memo备注string备注 delivery_statusInfo.details.detail_unique.detail_batch.currency_code币别代码string币别代码 delivery_statusInfo.details.detail_unique.detail_batch.tax_rate税率float税率 delivery_statusInfo.details.detail_unique.detail_batch.item_sku_id规格IDstring规格ID delivery_statusInfo.details.detail_unique.detail_batch.platform_code平台单号string平台单号 delivery_statusInfo.details.detail_unique.detail_batch.is_gift是否赠品int是否赠品 delivery_statusInfo.details.detail_unique.detail_batch.picUrl图片地址string图片地址 delivery_statusInfo.details.detail_unique.detail_batch.discount_fee让利金额float让利金额 delivery_statusInfo.details.detail_unique.detail_batch.trade_code销售订单号string销售订单号 delivery_statusInfo.details.detail_unique.detail_batch.tax_amount税额float税额 delivery_statusInfo.details.detail_unique.detail_batch.post_fee物流费用float物流费用 delivery_statusInfo.details.detail_unique.detail_batch.item_code商品代码string商品代码 delivery_statusInfo.details.detail_unique.detail_batch.price实际单价float实际单价 delivery_statusInfo.details.detail_unique.detail_batch.businessman_name业务员string业务员 delivery_statusInfo.details.detail_unique.detail_batch.item_id商品IDstring商品ID delivery_statusInfo.details.detail_unique.detail_batch.amount商品总价float商品总价 delivery_statusInfo.details.detail_unique.detail_batch.sku_name规格名称string规格名称 delivery_statusInfo.details.detail_unique.detail_batch.sku_note商品的规格备注string商品的规格备注 delivery_statusInfo.details.detail_unique.detail_batch.qty商品数量float商品数量 delivery_statusInfo.details.invoiceDate确认开票时间datetime确认开票时间 delivery_statusInfo.details.post_fee物流费用float物流费用 delivery_statusInfo.details.refund是否退款int是否退款 delivery_statusInfo.details.receiver_name收货人姓名string收货人姓名 delivery_statusInfo.details.express_name快递公司名称string快递公司名称 delivery_statusInfo.details.cancel取消状态int取消状态 delivery_statusInfo.details.area_name收货地区string收货地区 delivery_statusInfo.details.receiver_phone收货人电话string收货人电话 delivery_statusInfo.details.shop_code店铺代码string店铺代码 delivery_statusInfo.details.discount_fee优惠金额float优惠金额 delivery_statusInfo.details.receiver_address收货地址string收货地址 delivery_statusInfo.details.plan_delivery_date预计发货时间datetime预计发货时间 delivery_statusInfo.details.receiver_mobile收货人手机string收货人手机 delivery_statusInfo.details.receiver_zip收货邮编string收货邮编 delivery_statusInfo.details.shelf_no格子号string格子号 delivery_statusInfo.details.create_date制单时间datetime制单时间 delivery_statusInfo.details.pay_time支付时间datetime支付时间 delivery_statusInfo.details.buyer_memo买家留言string买家留言 delivery_statusInfo.details.cod是否货到付款bool是否货到付款 delivery_statusInfo.details.payment已付金额float已付金额 delivery_statusInfo.details.code单据编号string单据编号 delivery_statusInfo.details.sync_memo数据同步备注string数据同步备注 delivery_statusInfo.details.package_center_name集包地名称string集包地名称 delivery_statusInfo.details.invoices发票列表array发票列表 delivery_statusInfo.details.invoices.bank_account账号string账号 delivery_statusInfo.details.invoices.phone电话string电话 delivery_statusInfo.details.invoices.tex_payer_number纳税人识别号string纳税人识别号 delivery_statusInfo.details.invoices.bank_name开户行string开户行 delivery_statusInfo.details.invoices.invoice_content发票内容string发票内容 delivery_statusInfo.details.invoices.invoice_amount发票金额float发票金额 delivery_statusInfo.details.invoices.address地址string地址 delivery_statusInfo.details.invoices.invoice_no发票号string发票号 delivery_statusInfo.details.invoices.invoice_title发票抬头string发票抬头 delivery_statusInfo.details.invoices.invoice_type_name发票种型名称string发票种型名称 delivery_statusInfo.details.invoices.sync_status数据同步状态int数据同步状态 delivery_statusInfo.details.invoices.package_center_code集包地代码string集包地代码 delivery_statusInfo.details.invoices.picture_bill是否多包裹bool是否多包裹 delivery_statusInfo.details.invoices.vip_id_card身份证号码string身份证号码

MySQL接口明细

API：execute
NAME：执行操作语句-v2
METHOD：SQL

请求参数

接口字段名称预设值 main_params主参数 main_params.no订单编码{{code}} main_params.shop店铺名称{{shop_name}} main_params.platform所属平台{{platform_code}} main_params.is_online是否线上1 main_params.salesman销售员{{create_name}} main_params.department部门{{warehouse_name}} main_params.datetime订单时间{{create_date}} main_params.discount_amount折扣总额{{unpaid_amount}} main_params.payment_amount实际支付金额{{amount}} main_params.remark订单备注测试订单 main_params.extend_params_11:1扩展参数 main_params.extend_params_1.lastInsertId订单ID:lastInsertId main_params.extend_params_1.recipient收件人{{receiver_name}} main_params.extend_params_1.address收件地址{{receiver_address}} main_params.extend_params_1.mobile手机号{{receiver_mobile}} main_params.extend_params_1.is_vip是否VIP1 main_params.extend_params_1.buyer_message买家留言{{buyer_memo}} main_params.extend_params_1.extend_params_21:N扩展参数details main_params.extend_params_1.extend_params_2.lastInsertId订单ID:lastInsertId main_params.extend_params_1.extend_params_2.sku商品规格码{{details.item_code}} main_params.extend_params_1.extend_params_2.sku_spec规格描述{{details.item_name}} main_params.extend_params_1.extend_params_2.sku_category商品分类{{details.order_type}} main_params.extend_params_1.extend_params_2.price单价{{details.price}} main_params.extend_params_1.extend_params_2.num数量1 main_params.extend_params_1.extend_params_2.amount金额{{details.amount}} main_params.extend_params_1.extend_params_2.weight重量90 main_params.extend_params_1.extend_params_2.tax_rate税率13 main_params.extend_params_1.extend_params_2.tax_price含税单价1 main_params.extend_params_1.extend_params_2.tax税额2 main_params.extend_params_1.extend_params_2.full_amount价税合计3 main_params.extend_params_1.extend_params_2.main_sql主语句INSERT INTO sale_order (no,shop,platform,is_online,salesman,department,datetime,discount_amount,payment_amount,remark) VALUES (:no,:shop,:platform,:is_online,:salesman,:department,:datetime,:discount_amount,:payment_amount,:remark) main_params.extend_params_1.extend_params_2.extend_sql_11:1扩展子表语句INSERT INTO sale_order_ext ( id, recipient, address, mobile, is_vip, buyer_message) VALUES ( :lastInsertId,:recipient,:address,:mobile,:is_vip,:buyer_message ) main_params.extend_params_1.extend_params_2.extend_sql_21:N扩展子表语句INSERT INTO sale_order_detail ( order_id, sku,sku_spec,sku_category,price, num, amount,weight, tax_rate,tax_price, tax, full_amount) VALUES ( :lastInsertId, :sku,:sku_spec,:sku_category,:price, :num, :amount,:weight, :tax_rate,:tax_price, :tax, :full_amount)

系统对接概况

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接管易云·奇门接口抽取数据后再自动分发到MySQL，解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。

管易云·奇门和MySQL集成接口设计