地址、区域、承运商时效专题

本文整理省市区、服务站地址、仓库地址、退货地址、承运商时效、区域指导价和供货区域。地址和区域数据影响采购配送、销售配送、报价、价格、退货和报表。

业务目标

• 维护服务站、客户、供应商、仓库、退货地址。
• 支持省市区、区域、战区、大区关系。
• 支持承运商时效、配送范围和物流信息。
• 支持区域指导价和供货区域限制。

入口文件

• 地区：application/controllers/basedata/Area.php、Region.php
• 仓库：application/controllers/basedata/Stores.php、Stock.php
• 客户/供应商地址：application/controllers/basedata/Contact.php、DeliveryAddr.php
• 地址服务：application/Services/KzAddress/*
• 区域服务：application/Services/Area/*
• 仓库服务：application/Services/Storage/*
• 价格区域：application/controllers/inner/GuidePrice.php
• 商品中心区域变更：ItemCenterNotify.php

核心表

| 表 | 用途 | | --- | --- | | t_sys_area_address | 地区信息 | | t_bs_cities | 省市区 | | t_sys_region | 大区关系 | | t_bs_contact_addr | 供应商/客户收货地址 | | t_bs_area_return_address | 采购退货地址 | | kzcp_address | 快准仓库地址 | | t_bs_storage / t_bs_storage_location | 仓库和定位 | | t_sys_carrier | 物流承运商时效 | | t_sa_guide_price_plan* | 区域指导价 |

主流程

flowchart TD
  A["维护地址/区域"] --> B["采购/销售选择地址"]
  B --> C["匹配仓库、承运商、时效"]
  C --> D["影响配送、退货、价格和报表区域"]
  D --> E["区域变更触发缓存或价格同步"]

异常流程

• 地址显示错误：查省市区 id 和文本是否一致。
• 退货地址错误：查采购退货地址和供应商地址。
• 配送承运商错误：查仓库地址、承运商时效、配送中心返回。
• 区域指导价不生效：查指导价方案、省份、服务站、价格同步。
• 区域变更后商品不可买：查商品中心供货区域变更消息。

常用 rg 命令

rg -n "BS_CITIES|SYS_REGION|BS_AREA_RETURN_ADDRESS|KZCP_ADDRESS|SYS_CARRIER" application/config/tables.php application
rg -n "KzAddress|StorageArea|StorageSer|GuidePrice|supplier_area|shipper_region" application/Services application/controllers
rg -n "TYPE_ITEMCENTER_SUPPLIER_AREA_CHANGE|OPSCENTER_SHIPPER_REGION_CONFIG" application/KzData/Enums application/controllers/tasks

改动风险和回归清单

• 客户地址、供应商地址、仓库地址、退货地址。
• 采购下单、采购退货、销售配送、三方配送。
• 区域指导价和供货区域。
• 报表按省、市、大区、战区筛选。