# 微信物流服务 接口列表

# 查询组件

接口名称请求路径描述
查询运单/cgi-bin/express/delivery/open_msg/query_trace商户在调用完trace_waybill接口后,可以使用本接口查询到对应运单的详情信息
获取运力id列表/cgi-bin/express/delivery/open_msg/get_delivery_list商户使用此接口获取所有运力id的列表
传运单/cgi-bin/express/delivery/open_msg/trace_waybill商户使用此接口向微信提供某交易单号对应的运单号
更新物流信息/cgi-bin/express/delivery/open_msg/update_waybill_goods该接口用于更新物品信息

# 消息组件

接口名称请求路径描述
更新物品信息接口/cgi-bin/express/delivery/open_msg/update_follow_waybill_goods更新物品信息
查运单/cgi-bin/express/delivery/open_msg/query_follow_trace商户在调用完trace_waybill接口后,可以使用本接口查询到对应运单的详情信息
传运单/cgi-bin/express/delivery/open_msg/follow_waybill商户使用此接口向微信提供某交易单号对应的运单号
获取运力id列表/cgi-bin/express/delivery/open_msg/get_delivery_list商户使用此接口获取所有运力id的列表

# 无忧退货

接口名称请求路径描述
开通无忧退货/wxa/business/insurance_freight/open本接口用于开通无忧退货
查询开通状态/wxa/business/insurance_freight/query_open本接口用于查询开通状态
发货时投保/wxa/business/insurance_freight/createorder本接口用于发货时投保
无忧退理赔/wxa/business/insurance_freight/claim本接口用于无忧退理赔,收到用户退货后再触发
申请充值订单号/wxa/business/insurance_freight/createchargeid本接口用于申请充值订单号 (支持自定义金额)
申请支付/wxa/business/insurance_freight/applypay本接口用于无忧退货申请支付
拉取充值订单信息/wxa/business/insurance_freight/getpayorderlist本接口用于拉取充值订单信息
充值保费退款/wxa/business/insurance_freight/refund本接口用于充值保费退款
拉取理赔摘要/wxa/business/insurance_freight/getsummary本接口可用于查询当前保费、投保单量、理赔单量、账号余额等信息
拉取保单信息/wxa/business/insurance_freight/getorderlist本接口用于拉取保单信息
设置保费告警余额/wxa/business/insurance_freight/update_notify_funds开发者可通过接口自定义余额为xx时通知小程序管理员(余额xx无改动情况下24h内通知一次)

# 退货组件

接口名称请求路径描述
解绑退货ID/cgi-bin/express/delivery/no_worry_return/unbind当商家同意退货申请之后,与用户达成协商「无需退货」时,可以通过本接口可以接触商家退货单与退货 ID的绑定
查询退货ID状态/cgi-bin/express/delivery/no_worry_return/get本接口用于商家查询用户退货状态(是否填写退货信息)及追踪用户退货物流,方便仓库收货
创建退货ID/cgi-bin/express/delivery/no_worry_return/add商家在同意用户退货之后,通过本接口创建退货ID,shoporderid和退货 ID 一一对应

# 同城配送

接口名称请求路径描述
开通门店权限/cgi-bin/express/intracity/apply在使用门店相关接口前需要先开通门店权限,开通门店权限前可以使用页面或者使用此API开通门店(无加密,可直接调用)
创建门店/cgi-bin/express/intracity/createstore创建门店时需要传入自定义的门店编号,自定义的门店编号需要唯一,确保不重复创建 门店创建后系统生成全局唯一门店编号wxstoreid,后续创建运力订单时需要该门店
查询门店/cgi-bin/express/intracity/querystore获取本小程序所创建的门店,不传wxstoreid和outstoreid则返回本小程序所有门店信息
更新门店/cgi-bin/express/intracity/updatestore更新门店信息
门店运费充值/cgi-bin/express/intracity/storecharge返回微信服务市场的充值页面地址,通过该页面可以为门店充值指定运力的运费,充值后运费有使用有效期,默认有效期为1个月,超期未使用的运费降原路退回
门店运费退款/cgi-bin/express/intracity/storerefund该接口可以将门店指定运力的运费余额退还,如果门店有在途的配送订单,需要等配送完成或者取消配送订单之后才可以操作退款;操作退款后,退款金额五分钟内到账
门店运费流水查询/cgi-bin/express/intracity/queryflow查询门店运力资金流水
门店余额查询/cgi-bin/express/intracity/balancequery查询门店运力余额
查询运费/cgi-bin/express/intracity/preaddorder商家通过该接口传入配送单的相关信息,同城配送后台将根据配送信息向运力查询并返回实时的运费和配送距离
创建配送单/cgi-bin/express/intracity/addorder创建同城配送单,会根据门店设置的运力偏好来选择运力公司下单
查询配送单/cgi-bin/express/intracity/queryorder通过该接口查询订单是否创建成功,以及订单创建后的状态更新
取消配送单/cgi-bin/express/intracity/cancelorder通过该接口可以取消已创建的订单,取消配送中的订单需要扣减违约金
设置扣费主体/cgi-bin/express/intracity/setpaymode默认扣费主体和充值主体都是门店,该接口可以让开发者设置门店的扣费主体,接口调用成功后,小程序的管理员会收到模板消息,点击模板消息确认更改门店扣费主体后,修改生效
查询扣费主体/cgi-bin/express/intracity/getpaymode查询小程序的扣费主体
查询支持同城配送的城市/cgi-bin/express/intracity/getcity用于查询全国可以使用微信同城配送的城市
模拟回调接口/cgi-bin/express/intracity/mocknotify由于测试订单没有快递员接单,不会自动推送订单状态变化回调,为了方便开发者在沙箱环境联调,我们提供了模拟回调接口,针对测试订单开发者可以通过该接口触发其他说明中订

# 消息推送

接口名称请求路径描述
用户手机状态查询/cgi-bin/express/delivery/userquery运力方可以调用此接口来获取某手机号是否绑定
推送已绑定物流轨迹信息/cgi-bin/express/delivery/pathnotify运力方可以调用此接口来推送物流轨迹消息