旺店通·企业奇门对接打通用友BIP查询销售出库单接口与销售出库单个保存接口

旺店通·企业奇门对接打通用友BIP查询销售出库单接口与销售出库单个保存接口

来源系统:旺店通·企业奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

对接目标系统:用友BIP

YonBIP用友商业创新平台，是用友在数字经济时代面向成长型、大型企业及巨型企业，融合了先进且高可用技术平台和公共与关键商业应用与服务，支撑和运行客户的商业创新（业务创新、管理变革），并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。

数据对接方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的wdt.stockout.order.query.trade作为数据对接来源。然后再写入目标平台配置目标系统为用友BIP，并且选择对应连接器（关于用友BIP的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的/yonbip/scm/salesout/single/save接口作为数据写入动作完成第一步的接口配置。

旺店通·企业奇门接口明细

• API：wdt.stockout.order.query.trade
• NAME：查询销售出库单
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_time	开始时间	{{LAST_SYNC_TIME datetime}}	增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	{{CURRENT_TIME datetime}}	增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
status	状态	110	5已取消，55已审核，95已发货，105 部分打款，110已完成，113：异常发货
src_order_no	系统订单编号
src_tid	原始单号
stockout_no	出库单号
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
warehouse_no	仓库编号		代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号)
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	每页返回的数据条数，输入值范围1100，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	{{PAGINATION_START_PAGE}}	不传值默认从0页开始

响应参数

接口字段	字段名称	预设值	描述
stockout_id	出库单主键id		出库单主键id
order_no	出库单号		出库单号,唯一单号
src_order_no	源单号		源单号，旺店通系统单号（多默认为JY开头）
warehouse_no	仓库编号		仓库编号
consign_time	发货时间		销售出库单发货时间  时间格式：yyyy-MM-dd HH:mm:ss
order_type	出库单类型		出库单类型
trade_status	订单状态		订单状态 5已取消 10待付款 12待尾款 13待选仓 15等未付16延时审核 19预订单前处理 20前处理(赠品，合并，拆分)21委外前处理22抢单前处理 25预订单 27待抢单 30待客审 35待财审 40待递交仓库 45递交仓库中 50已递交仓库 53未确认 55已确认 95已发货 105部分打款 110已完成 113异常发货
order_type_name	出库单类型名称		固定名称“销售出库”
trade_type	订单类型		1网店销售 2线下零售 3售后换货 4批发业务 5保修换新 6保修完成 7订单补发 .. 101自定义类型1 102自定义类型2 103自定义类型3 104自定义类型4 105自定义类型5 106自定义类型6
subtype	出库子类型		出库子类型
goods_count	数量		货品数量
goods_total_amount	货品总售价		货品总售价
goods_total_cost	货品总成本		货品总成本
post_fee	邮资成本		邮资成本
logistics_no	物流单号		物流单号
package_fee	包装费		包装费
receiver_name	收件人		收件人
receiver_country	国家		国家
receiver_province	省份		省份
receiver_city	城市		城市
receiver_district	地区		地区
receiver_address	详细地址		详细地址
receiver_mobile	收件人移动电话		收件人移动电话
receiver_telno	收件人固定电话		收件人固定电话
receiver_zip	邮编		邮编
receiver_dtb	大头笔		大头笔
weight	实际重量		ERP系统称重功能记录的重量，如果没有使用称重功能默认使用货品档案维护的预估重量
logistics_type	物流公司类型		响应值为ERP定义的ID数值，数值对应的物流公司类型名称单击这里
logistics_code	物流公司编号		代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_name	物流公司名称		物流公司名称
print_remark	打印备注		打印备注
paid	已付金额		已付金额
refund_status	退款状态		退款状态： 0无退款，1取消退款，2已申请退款，3等待退货，4等待收货，5退款成功
salesman_no	业务员编号		业务员编号
salesman_name	业务员名称		业务员名称
fullname	业务员名称		业务员名称
warehouse_name	仓库		仓库
created	创建时间		创建时间  时间格式：yyyy-MM-dd HH:mm:ss
remark	备注		备注
stockout_reason	出库原因		出库原因
outer_no	外部单号		外部单号
trade_no	订单编号		系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
src_trade_no	原始单号		商城或电商平台的订单编号,合并订单的多个订单编号有逗号隔开
nick_name	网名		网名
customer_name	客户名称		客户名称（客户真实姓名，取自receiver_name）
customer_no	客户编号		客户编号
trade_time	交易时间		交易时间   时间格式：yyyy-MM-dd HH:mm:ss
pay_time	付款时间		付款时间   时间格式：yyyy-MM-dd HH:mm:ss
status	出库单状态		出库单状态 5 已取消 48未确认 50待审核 52待推送 53同步失败  55已审核 95 已发货 105部分打款 110已完成  113 异常发货 115回传失败 120回传成功
shop_name	店铺名称		店铺名称
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
buyer_message	买家留言		买家留言
cs_remark	客服备注		客服备注
flag_name	订单标记		订单标记
post_amount	邮费		从平台获取的销售订单的邮费
block_reason	截停原因		截停原因：1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他 2048 拦截赠品 4096 拦截天猫换货 8192 买家留言变更 16384 该换货订单存在退货/退款
invoice_type	发票类别		发票类别0 不需要，1普通发票，2普通增值税发票，3专用增值税发票
invoice_title	发票抬头		发票抬头
invoice_content	发票内容		发票内容
invoice_id	发票ID		发票ID，目前只设0-1，1表示已开发票
delivery_term	发货条件		发货条件 1款到发货 2货到付款(包含部分货到付款) 3分期付款 4挂账单
fenxiao_type	分销类别		0 非分销订单 1 转供销 2 代销 3经销
fenxiao_nick	分销商ID		分销订单的分销商id,或转供销时供应商id
cod_amount	货到付款金额		货到付款金额
id_card_type	证件类别		1 身份证
receiver_area	收件人地址		省市区空格分隔
shop_remark	店铺备注		店铺备注
modified	最后修改时间		最后修改时间   时间格式：yyyy-MM-dd HH:mm:ss
platform_id	平台id		平台id
trade_id	订单表主键		订单表主键
checker_name	审单员编号		审单员编号
employee_no	审单员编号		审单员编号
operator_name	审核员		审核员
packager_no	打包员编号		打包员编号
packager_name	打包员		打包员
picker_no	拣货员编号		拣货员编号
picker_name	拣货员		拣货员
printer_no	打单员编号		打单员编号
printer_name	打单员		打单员
examiner_no	验货员编号		验货员编号
examiner_name	验货员		验货员
stockout_no	出库单号		出库单号
src_order_type	源单据类别		源单据类别，1 销售订单
wms_status	处理状态		处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功'
error_info	接口处理错误信息		接口处理错误信息
warehouse_type	仓库类别		仓库类别  0不限 1普通仓库 2自动流转外部 3京东仓储 4科捷 5百世物流 6 SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 127其他
warehouse_id	出库仓库id		出库的仓库id
customer_id	客户id		客户id
freeze_reason	冻结原因		冻结原因
is_allocated	是否分配		是否分配stockout_order_detail_position
consign_status	出库状态		出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货 1073741824原始单已完成
ebill_status	电子面单状态		电子面单,获取状态（0 还未获取单号或获取单号和打印信息完毕；1 手动获取物流单号中；100-105 获取打印数据中）
operator_id	制单人		制单人
goods_type_count	货品种类数量		货品种类数量
md5_str	MD5字符串值		MD5字符串值,用于单据排序
custom_type	其他出库自定义子类别		其他出库自定义子类别0，1，2，3，4
receiver_ring	京东三环内		京东三环内
to_deliver_time	配送时间		配送时间，如周末
pre_charge_time	配送中心		配送中心
logistics_id	物流公司ID		物流公司ID
unknown_goods_amount	未知成本销售总额		未知成本销售总额
calc_post_cost	预估邮费成本		预估邮费成本
post_cost	邮费成本		邮费成本
calc_weight	预估重量		预估重量
post_weight	快递重量		快递给的重量
package_id	包装id		包装id
package_cost	包装成本		包装成本
has_invoice	是否包含发票		是否包含发票
printer_id	打单员		打单员
pick_error_count	拣货出错次数		拣货出错次数
picker_id	拣货员id		拣货操作员ID
sorter_id	分拣员id		包裹分拣员id
examiner_id	验货员id		验货操作员id
consigner_id	发货人id		发货人id
packager_id	打包员id		打包id
pack_score	打包积分		打包积分
pick_score	拣货积分		拣货积分
checkouter_id	签出员工id		签出员工id
watcher_id	监视员id		监视员
picklist_no	分拣单编号		分拣单编号
picklist_seq	分拣序号		订单在分拣单中序号
invoice_print_status	发票打印状态		发票打印状态
flag_id	颜色		颜色
logistics_template_id	物流单模板id		物流单模板id
sendbill_template_id	发货单模板id		发货单模板id
pos_allocate_mode	货位分配方式		货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 3其它出库优化使用出库货位 4按批次出库
note_count	便签条数		便签条数
reason_id	其他出库原因		其他出库原因
lock_id	锁定策略id		锁定策略id
reserve	保留		保留
batch_no	打印批次		打印批次
discount	优惠金额		优惠金额
src_tids	原始单号		原始单号，平台订单号
tax	税额		税额
tax_rate	税率		税率
currency	币种		币种
id_card	证件号码		证件号码
stock_check_time	出库单审核时间		出库单审核时间    时间格式：yyyy-MM-dd HH:mm:ss
bad_reason	异常状态		需要通过异或的方式判断，异常订单(bit位)，1无库存记录 2地址发生变化 4发票变化 8仓库变化16备注变化32平台更换货品64退款…512抢单异常
print_batch_no	打印批次		ERP中的单据的打印批次信息，如需该字段，请升级至2.4.0.8版本及以上
sendbill_print_status	发货单打印状态		0未打印 1打印中 2已打印 3无需打印
logistics_print_status	物流单打印状态		0未打印 1打印中 2已打印 3无需打印
picklist_print_status	分拣单打印状态		0未打印 1打印中 2已打印 3无需打印
details_list	货品列表节点		货品列表节点
details_list.rec_id	出库明细主键		出库明细主键
details_list.stockout_id	出库单主键id		出库单主键id
details_list.spec_no	商家编码		代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
details_list.goods_count	货品数量		货品数量
details_list.sell_price	销售价		销售价,最终交易价格,扣除优惠
details_list.brand_no	品牌编号		品牌编号
details_list.brand_name	品牌名称		品牌名称
details_list.goods_type	货品类型		货品类型： 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产 0其它
details_list.gift_type	是否是赠品		是否是赠品 0非赠品 1自动赠送 2手工赠送
details_list.goods_name	货品名称		货品名称
details_list.goods_no	货品编号		代表货品(spu)所有属性的编号，SPU概念介绍,单击这里
details_list.spec_name	规格名称		规格名称
details_list.spec_code	规格码		规格码
details_list.suite_no	来源组合装编码		来源组合装编码
details_list.cost_price	成本价		成本价
details_list.total_amount	总货款		总货款,sell_price * goods_count=total_amount
details_list.goods_id	货品id		货品id
details_list.spec_id	商品主键		商品主键
details_list.weight	估重		估重
details_list.remark	备注		备注
details_list.paid	已支付金额		已支付金额
details_list.refund_status	退款状态		退款状态
details_list.market_price	零售价		零售价
details_list.discount	总折扣金额		总折扣金额
details_list.share_amount	分摊后合计应收		分摊后合计应收
details_list.tax_rate	税率		税率
details_list.barcode	条码		条码
details_list.unit_name	基本单位		基本单位
details_list.sale_order_id	订单详情表主键		订单详情表主键
details_list.share_post	邮费分摊		邮费分摊
details_list.src_oid	原始子订单号		原始子订单号
details_list.src_tid	原始订单号		原始订单号
details_list.from_mask	单据内部来源		1手机订单 2聚划算 4服务子订单 8家装 16二次付款 32开具电子发票 1024库存不足 2048当日达 4096次日达 8192预约时效
details_list.src_order_type	源单据类别		源单据类别 以主单为准
details_list.src_order_detail_id	sales_trade_order表的主键		sales_trade_order表的主键
details_list.base_unit_id	基本单位		基本单位
details_list.unit_id	辅助单位		辅助单位
details_list.unit_ratio	单位换算		单位换算
details_list.num	货品数量		货品数量
details_list.num2	辅助数量		辅助数量
details_list.price	最终价格		最终价格，share_price删掉，取代share_price
details_list.batch_id	指定出库批次		指定出库批次
details_list.is_examined	是否验货		是否验货，用于挂起，已标记为验货的不需要再验货
details_list.is_package	是否包装		是否包装
details_list.is_zero_cost	是否允许0成本		是否允许0成本
details_list.scan_type	扫描方式		0未验货,1扫描验货,2手工验货,3快速验货,4无需验货
details_list.good_prop1	货品档案自定义属性1		货品档案自定义属性1
details_list.good_prop2	货品档案自定义属性2		货品档案自定义属性2
details_list.good_prop3	货品档案自定义属性3		货品档案自定义属性3
details_list.good_prop4	货品档案自定义属性4		货品档案自定义属性4
details_list.good_prop5	货品档案自定义属性5		货品档案自定义属性5
details_list.good_prop6	货品档案自定义属性6		货品档案自定义属性6
details_list.prop1	单品列表自定义属性1		单品列表自定义属性1
details_list.prop2	单品列表自定义属性2		单品列表自定义属性2
details_list.prop3	单品列表自定义属性3		单品列表自定义属性3
details_list.prop4	单品列表自定义属性4		单品列表自定义属性4
details_list.prop5	单品列表自定义属性5		单品列表自定义属性5
details_list.prop6	单品列表自定义属性6		单品列表自定义属性6
details_list.batch_no	批次号		批次号
details_list.batch_remark	批次备注		批次备注
details_list.expire_date	有效期		有效期，时间格式：yyyy-MM-dd HH:mm:ss
details_list.position_list	货位节点列表		货位节点列表
details_list.position_id	货位ID		货位ID
details_list.position_no	货位编号		货位编号
details_list.stockout_order_detail_id	出库单明细id		出库单明细id
details_list.rec_id	货位主键id		货位主键id
details_list.stockin_detail_id	入库单明细id		入库单明细id
details_list.num	货品数量		货品数量
details_list.stock_spec_detail_id	入库单号明细id		入库单号明细id
details_list.batch_id	批次id		批次id
details_list.batch_no	批次号		批次号
details_list.modified	最后更新时间		最后更新时间
details_list.cost_price	成本价		成本价
details_list.position_goods_count	货位出库数量		货位出库数量

用友BIP接口明细

• 接口：/yonbip/scm/salesout/single/save
• 接口名称：销售出库单个保存
• 接口方法：POST

请求参数

字段	名称	类型	描述
receiveAccountingBasis	立账开票依据	string	立账开票依据, voucher_order:销售订单、voucher_delivery:销售发货单、st_salesout:销售出库单、unsettle:不结算、    示例：st_salesout
salesoutAccountingMethod	出库立账方式	string	出库立账方式, salesoutEstimate:出库暂估应收、salesoutConfirm:出库确认应收、invoiceConfirm:开票确认应收、    示例：salesoutConfirm
accountOrg	会计主体id或编码	string	会计主体id或编码    示例：guanlong_001
org	发货组织id或编码	string	发货组织id或编码    示例：guanlong_001
salesOrg	销售组织id或编码	string	销售组织id或编码    示例：guanlong_001
invoiceOrg	开票组织id或编码	string	开票组织id或编码    示例：guanlong_001
vouchdate	单据日期	string	单据日期    示例：2020-11-30 00:00:00
code	单据编号	string	单据编号    示例：XSCK20201130000002
bustype	交易类型id或编码	string	交易类型id或编码    示例：A30001
warehouse	仓库id或编码	string	仓库id或编码    示例：Z001
stockMgr	库管员ID或编码	string	库管员ID或编码    示例：A000005
invoiceCust	开票客户ID或编码	string	开票客户ID或编码，如果使用信用服务则必输    示例：001000002
cust	客户id或编码	string	客户id或编码    示例：_001000002
srcBillType	来源类型	string	来源类型, 0:无来源、st_purinrecord:采购入库单、1:发货单、2:销售订单、3:退货单、tradeorder:电商订单、refundorder:电商退换货订单、retailvouch:零售单、mallvouch:商城发货单、    示例：0
retailInvestors	是否散户	boolean	是否散户, true:是、false:否、    示例：false
natCurrency	本币id或编码	string	本币id或编码    示例：CNY
currency	币种id或编码	string	币种id或编码    示例：CNY
exchRateType	汇率类型id	string	汇率类型id    示例：lzu07egu
exchRate	汇率	long	汇率    示例：1
modifyInvoiceType	发票类型是否可改	string	发票类型是否可改："1"可改；“0”不可改    示例：1
invoiceUpcType	发票类型	string	发票类型，"0":收据 "1":增值税专用发票 "2":增值税普通发票 "3":增值税电子普通发票 "4":机动车销售销售统一发票 "5":增值税电子普通发票(成品油) "6":增值税普通发票(成品油) "7":增值税专用发票(成品油) "8":电子收购发票 "9":增值税电子专用发票    示例：0
invoiceTitleType	抬头类型	string	抬头类型，"0":企业 "1":个人 "2":非营利组织    示例：0
invoiceTitle	发票抬头	string	发票抬头    示例：AA股份有限公司
taxNum	纳税识别号	string	纳税识别号    示例：141241
bankName	开户银行	string	开户银行    示例：招商银行
subBankName	开户支行	string	开户支行    示例：海淀永丰支行
bankAccount	银行账号	string	银行账号    示例：34234234234234234
invoiceTelephone	营业电话	string	营业电话    示例：123324234
invoiceAddress	营业地址	string	营业地址    示例：某区某路34号
operator	销售员id或编码	string	销售员id或编码    示例：A001
iLogisticId	物流公司id或者编码	string	物流公司id或者编码    示例：sf
sourcesys	有来源时必填	string	有来源时必填，来源单据领域，udinghuo:销售，retail：零售，dst：电商
details	销售出库单子表	array	销售出库单子表[st.salesout.SalesOuts]
details.status	操作标识	string	操作标识, Insert:新增、Update:更新    示例：Insert
details.source	来源单据类型	string	来源单据类型, 0:无来源、st_purinrecord:采购入库单、1:发货单、2:销售订单、3:退货单、tradeorder:电商订单、refundorder:电商退换货订单、retailvouch:零售单、mallvouch:商城发货单、    示例：0
details.taxRate	税率	long	税率    示例：0
details.product	物料id或编码	string	物料id或编码    示例：121000089
details.productsku	商品SKUid或编码	string	商品SKUid或编码    示例：121000089
details.invExchRate	换算率	long	换算率    示例：1
details.qty	数量	long	数量    示例：12
details.stockUnit	库存单位id或编码	string	库存单位id或编码    示例：fgl_004
details.saleStyle	商品售卖方式	string	商品售卖方式, SALE:销售品、GIFT:赠品、REBATE:返利商品、    示例：SALE
details.oriSum	含税金额	long	含税金额    示例：24
details.priceUOM	计价单位id或编码	string	计价单位id或编码    示例：fgl_004
details.invPriceExchRate	计价换算率	long	计价换算率    示例：1
details.taxUnitPriceTag	价格含税	boolean	价格含税, true:是、false:否、    示例：true
details.unitExchangeType	库存单位转换率的换算方式	long	库存单位转换率的换算方式 0：固定 1：浮动    示例：0
details.orderId	销售订单id	long	销售订单id    示例：564654646546
details.orderDetailId	销售订单行id	long	销售订单行id    示例：543532181358321
details.orderCode	销售订单编码	string	销售订单编码    示例：XSDD1111111
details.sourceid	来源单据主表id	long	来源单据主表id，如果有来源则必输
details.sourceautoid	来源单据行id	long	来源单据行id，有来源必输
details.upcode	来源单据编号	string	来源单据编号，有来源时必输
details.makeRuleCode	单据转换规则	string	单据转换规则，有来源时必输，deliveryTostoreout：发货单生销售出库，salereturnTosalesout：退货单生销售出库，orderTosalesout：销售订单生销售出库
details.batchno	批次号	string	批次号,仓库商品均开启批次管理则必填
details.taxId	税目id或编码	string	税目id或编码    示例：8b99f589-bc47-4c3a-bfqw-13d78cad20b0
details.goodsposition	货位	string	货位，仓库开启货位则必填    示例：whhw2467516
details.salesOutsSNs	销售出库单孙表	array	销售出库单孙表[st.salesout.SalesOutsSN]
details._status	操作标识	string	操作标识, Insert:新增、Update:更新    示例：Insert
details.sn	序列号	string	序列号，仓库商品均开启序列号管理则必填    示例：qwer85
details._status	操作标识	string	操作标识, Insert:新增、Update:更新    示例：Insert

数据对接价值

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。