生鲜商城-单商户(kxmall)开发指南 生鲜商城-单商户(kxmall)开发指南
首页
  • 开发指南
  • 功能介绍
常见问题
在线体验
案例
GitHub (opens new window)
首页
  • 开发指南
  • 功能介绍
常见问题
在线体验
案例
GitHub (opens new window)
  • 开发指南

    • 介绍
    • 本地启动部署教程
    • 目录结构
    • 开源版VS商业版
    • 线上部署教程
    • docker部署教程
    • 一键部署
    • 接口文档
  • 功能介绍

    • 版本更新记录
    • 订单流程图
    • 扫码识别仓库
    • 上架商品流程
    • 图片minio配置
    • 地图key配置
    • 前置仓资料编辑
    • 客户端地址管理
    • 小程序微信登录配置
    • 微信支付
    • 仓库选择
    • 逆向工程使用
    • 首页菜单布局指引
    • 微信公众号(服务号)
    • 微信公众号消息推送订阅引导
    • 云打印(订单打印)
    • 接口文档(两种方式)
    • 小程序订单中心Path设置
    • app打包选择地图空白
    • 小程序订单推送
    • 骑手小程序配置
    • 图片本地磁盘配置
    • 图片本地数据库配置
    • 图片华为obs配置
    • 图片腾讯cos配置
    • 店铺装修
    • 系统配置
    • 家常菜功能
    • 预警值设置
    • 骑手端登录审核中
    • 小程序地图使用介绍及配置
    • 低代码报表
    • 分销使用手册
    • 第三方配送
      • 目录
      • 配送模板配置
      • 顺丰同城接入步骤
        • 第一步:申请接口账号
        • 第二步:配置回调URL
        • 第三步:绑定仓库与店铺
        • 第四步:账户充值
      • 订单配送操作
      • 配送状态查询
      • 常见问题
  • 开发指南
  • 功能介绍
zhixing
2025-10-03
目录

第三方配送

提示

该功能为商业版本授权功能

# 生鲜商城第三方配送(顺丰同城)使用指南

# 目录

  • 配送模板配置
  • 顺丰同城接入步骤
  • 订单配送操作
  • 配送状态查询

# 配送模板配置

  1. 进入系统后台 → 调度管理 → 第三方配送
  2. 点击「新建配送模板」
  3. 选择配送类型:顺丰同城

  1. 填写配置信息:
    • API Key(从顺丰开放平台获取)
    • 店铺ID(绑定仓库后获取)
    • 经纬度也需要注意一下

# 顺丰同城接入步骤

# 第一步:申请接口账号

  1. 访问 顺丰开放平台 (opens new window)
  2. 完成企业认证(需1-3个工作日审核)
  3. 获取开发者账号和API权限

# 第二步:配置回调URL

请提供以下回调地址给顺丰技术支持:

回调URL(配送状态更改) https://1q713u4954.oicp.vip/sftc/status 回调URL(订单完成) https://1q713u4954.oicp.vip/sftc/complete 回调URL(顺丰原因取消) https://1q713u4954.oicp.vip/sftc/sf_cancel 回调URL(订单配送异常) https://1q713u4954.oicp.vip/sftc/exception 回调URL(骑士撤单) https://1q713u4954.oicp.vip/sftc/rider_cancel 回调URL(授权回调) https://1q713u4954.oicp.vip/sftc/auth 回调URL(自动建店回调) https://1q713u4954.oicp.vip/sftc/auto_shop 回调URL(取消授权回调) https://1q713u4954.oicp.vip/sftc/cancel_auth

# 第三步:绑定仓库与店铺

  1. 登录顺丰商家后台
  2. 进入「店铺管理」→「仓库绑定」
  3. 将系统仓库ID与顺丰店铺ID进行关联

# 第四步:账户充值

  1. 通过顺丰官方充值入口进行预存
  2. 建议首次充值不少于500元(具体根据业务量调整)
  3. 余额不足时将无法发起配送

# 订单配送操作

  1. 进入 订单管理 模块
  2. 选择待配送订单 → 点击「第三方配送」
  3. 选择已配置的「顺丰同城」模板
  4. 确认配送信息:
    • 取货地址(系统自动填充仓库地址)
    • 收货人信息
    • 商品重量/体积(影响运费计算)

# 配送状态查询

  1. 在订单详情页查看「配送状态」卡片
  2. 实时显示:
    • 骑手接单状态
    • 预计到达时间
    • 当前位置(地图展示)
  3. 异常状态提示:
    • 订单取消
    • 配送延迟
    • 联系骑手按钮

# 常见问题

Q:为什么无法选择顺丰配送? A:请检查:

  1. 账户余额是否充足
  2. 店铺ID是否绑定成功
  3. API Key是否有效

Q:回调配置失败怎么办? A:请联系技术人员检查:

  1. 服务器外网访问权限
  2. HTTPS证书有效性
  3. 接口返回格式是否符合要求
分销使用手册

← 分销使用手册

Theme by Vdoing | Copyright © 2024-2025 zhixing | MIT License
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式