店铺入驻需求- 原型地址：
# 一、App 端入驻流程字段表
字段顺序按 App 原型页面内顺序排列。
| 流程 | App 端个人 | App 端企业 |
|---|---|---|
| 入驻介绍与方案 | 申请类型（个体经营 / 企业） | 申请类型（个体经营 / 企业） |
| 注册卖家账号 | 国家/地区，邮箱地址，验证码，密码，确认密码，手机号码WhatsApp，入驻协议勾选 | 国家/地区，邮箱地址，验证码，密码，确认密码，手机号码，WhatsApp，入驻协议勾选 |
| 店铺信息 | 店铺名称，店铺Logo，经营类目，省/市/区，详细地址 | 店铺名称，店铺Logo，经营类目，省/市/区，详细地址 |
| 收款账户 | 银行品牌，银行名称，账户名称，账号/卡号，Ecocash账户名称，Ecocash账号 | 银行品牌，银行名称，账户名称，账号/卡号，Ecocash账户名称，Ecocash账号 |
| 资质提交 | 法人姓名，经营名称，证件类型，证件上传，证件号码，生日，地址证明，营业执照，VAT 文件，完税证明，完税时间段，特许经营时段，特许经营协议 | 公司注册名称，公司注册号，增值税号，TIN，法人姓名，职务，生日，证件号码，公司注册证书，CR14，公司章程，VAT 文件，地址证明，证件类型，董事 1 证件，董事 2 证件，完税时间段，完税证明，特许经营时段，特许经营协议 |
# 二、PC 官网入驻流程字段表
字段顺序按 PC 官网步骤内顺序排列。
| 流程 | PC 个人 | PC 企业 |
|---|---|---|
| 邮箱验证 | 邮箱地址，验证码 | 邮箱地址，验证码 |
| 申请信息 | 申请类型（个体经营 / 企业），国家/地区，手机号码，密码，确认密码，WhatsApp，入驻协议勾选 | 申请类型（个体经营 / 企业），国家/地区，手机号码，密码，确认密码，WhatsApp，入驻协议勾选 |
| 更多信息 | 店铺名称，店铺 Logo，经营类目，省/市/区，详细地址，银行品牌，银行名称，账户名称，账号/卡号，Ecocash 账户名称，Ecocash 账号 | 店铺名称，店铺 Logo，经营类目，省/市/区，详细地址，银行品牌，银行名称，账户名称，账号/卡号，Ecocash 账户名称，Ecocash 账号 |
| 资质提交 | 法人姓名，经营名称，证件类型，证件号码，生日，证件上传，地址证明，营业执照，VAT 文件，完税时间段，完税证明，特许经营时段，特许经营协议 | 公司注册名称，公司注册号，增值税号，TIN，法人姓名，职务，生日，证件类型，证件号码，公司注册证书，CR14，公司章程，VAT 文件，地址证明，董事 1 证件，董事 2 证件，完税时间段，完税证明，特许经营时段，特许经营协议 |
# 三、字段定义表
| 字段（中文） | 英文标签 | 类型 | 输入方式 | 必填 |
|---|---|---|---|---|
| 申请类型 | Business type | 单选（个体经营 / 企业） | 分段按钮点击切换，默认个体经营 | 是 |
| 邮箱地址 | 文本，邮箱格式，最长 64 字符，全局唯一 | 键盘输入 | 是 | |
| 验证码 | OTP | 文本，6 位数字，5 分钟内有效 | 键盘输入，配「发送验证码」按钮，60 秒重发倒计时 | 是 |
| 国家/地区 | Country / Region | 下拉单选（11 项） | 点击下拉选择，默认津巴布韦 | 是 |
| 密码 | Password | 文本，8–20 位，含字母、数字、符号 | 键盘输入，密文，可切换明文 | 是 |
| 确认密码 | Confirm Password | 文本，需与密码一致 | 键盘输入，密文，可切换明文 | 是 |
| 手机号码 | Mobile number | 数字文本，区号 + 号码，全局唯一 | 键盘输入 | 是 |
| 文本，号码格式 | 键盘输入，用于平台审核与运营联系 | 否 | ||
| 店铺名称 | Store name | 文本，2–50 字符，全局唯一 | 键盘输入 | 是 |
| 店铺 Logo | Store Logo | 图片，建议 800×800 以上，≤ 3MB，JPG / PNG | 点击上传；App 支持拍照 / 相册 / 文件，PC 为文件选择 | 是 |
| 经营类目 | Business category | 多选，三级类目，最多 10 个 | App 为弹层三级联动多选、可删标签；PC 为级联多选 | 是 |
| 省/市/区 | Province / City / District | 三级级联单选 | 点击级联选择（省 → 市 → 区） | 是 |
| 详细地址 | Street Address | 文本，最长 200 字符 | 键盘输入，支持谷歌地址自动补全 | 是 |
| 银行品牌 | Bank Brand | 文本，最长 50 字符 | 键盘输入 | 是 |
| 银行名称 | Bank Name | 文本，最长 100 字符 | 键盘输入 | 是 |
| 账户名称 | Account Name | 文本，最长 100 字符，需与法人姓名或经营名称一致 | 键盘输入 | 是 |
| 账号/卡号 | Account / Card Number | 文本，最长 34 字符，全局唯一 | 键盘输入，仅允许数字与字母 | 是 |
| Ecocash 账户名称 | Ecocash Account Name | 文本，最长 100 字符 | 键盘输入 | 否 |
| Ecocash 账号 | Ecocash Account | 文本，最长 20 字符 | 键盘输入 | 否 |
| 法人姓名 | Legal name | 文本，最长 50 字符，需与证件一致 | 键盘输入 | 是 |
| 经营名称 | Trading name | 文本，最长 50 字符 | 键盘输入 | 否 |
| 证件类型 | ID Type | 单选（身份证 / 护照） | 点击切换，默认身份证；切换后证件上传项联动 | 是 |
| 证件上传 | ID Document upload | 文件，身份证 = 正 + 反；护照 = 1 个 | 点击上传，JPG / PNG / PDF，单个 ≤ 5MB | 是 |
| 证件号码 | ID Number | 文本，最长 50 字符，全局唯一，格式随证件类型校验 | 键盘输入 | 是 |
| 生日 | Date of birth | 日期 YYYY-MM-DD 格式字符串，需满 18 周岁 | 日历选择或键盘输入 | 是 |
| 地址证明 | Proof of address | 文件，如水电账单、租赁合同 | 点击上传，JPG / PNG / PDF | 是 |
| 营业执照 | Business License | 文件 | 点击上传，JPG / PNG / PDF | 是 |
| VAT 文件 | VAT Document | 文件 | 点击上传，JPG / PNG / PDF | 是 |
| 完税时间段 | Tax clearance period | 日期区间（起止） | 两个日期选择，起始不得晚于结束 | 是 |
| 完税证明 | Tax Clearance Certificate | 文件 | 点击上传，JPG / PNG / PDF | 是 |
| 特许经营时段 | Franchise period | 日期区间（起止） | 两个日期选择，起始不得晚于结束 | 否 |
| 特许经营协议 | Franchise agreement | 文件 | 点击上传，JPG / PNG / PDF | 否 |
| 公司注册名称 | Registered company name | 文本，最长 100 字符，需与注册证书一致 | 键盘输入 | 是 |
| 公司注册号 | Company registration number | 文本，最长 30 字符，全局唯一，格式如 1234/2023 | 键盘输入 | 是 |
| 增值税号 | VAT | 文本，最长 30 字符 | 键盘输入 | 是 |
| TIN | TIN | 文本，最长 30 字符（纳税人识别号） | 键盘输入 | 是 |
| 职务 | Role | 文本，最长 50 字符，如 Managing Director | 键盘输入 | 是 |
| 公司注册证书 | Certificate of Incorporation | 文件 | 点击上传，JPG / PNG / PDF | 是 |
| CR14 | CR14 | 文件 | 点击上传，JPG / PNG / PDF | 是 |
| 公司章程 | Articles of Association | 文件 | 点击上传，JPG / PNG / PDF | 是 |
| 董事 1 证件 | Director 1 ID | 文件，身份证 = 正 + 反；护照 = 1 个 | 点击上传，JPG / PNG / PDF | 是 |
| 董事 2 证件 | Director 2 ID | 文件，身份证 = 正 + 反；护照 = 1 个 | 点击上传，JPG / PNG / PDF | 是 |
# 四、入驻填写资料字段映射
# 1.1 通用入驻字段
| 字段定义表中文名 | 接口字段名 | 对应类型 | 说明 |
|---|---|---|---|
| 申请类型 | store_owner | 直接对应 | 0-企业，1-个人。不要使用 store_type，该字段不是个人/企业申请类型。 |
| 邮箱地址 | user_account | 直接对应 | 注册账号邮箱。store_email 为店铺邮箱，contacts_email 为联系人邮箱。 |
| 验证码 | otp_password | 直接对应 | 接口文档中已有该字段；当前接口文档说明不在本接口内校验验证码。 |
| 国家/地区 | subsite_ids | 直接对应 | 商家所在地。 |
| 密码 | user_password | 直接对应 | 用户密码。 |
| 确认密码 | confirm_password | 直接对应 | 确认密码。 |
| 手机号码 | store_intl、store_tel | 拆分对应 | store_intl 保存手机区号，store_tel 保存手机号。 |
whatsapp_account | 直接对应 | WhatsApp 账号。 | |
| 店铺名称 | store_name | 直接对应 | 店铺名称。 |
| 店铺 Logo | store_logo | 直接对应 | Logo 文件或地址。 |
| 经营类目 | store_category_id | 直接对应 | 店铺经营类目。 |
| 省/市/区 | store_district_id | 直接对应 | 省市区选择结果对应的区域 ID。 |
| 详细地址 | store_address | 直接对应 | 详细地址。 |
| 银行品牌 | bank_code | 直接对应 | 接口字段注释为“银行品牌”。 |
| 银行名称 | bank_name | 直接对应 | 开户银行名称。 |
| 账户名称 | bank_account_name | 直接对应 | 接口字段注释为“持卡人姓名”。 |
| 账号/卡号 | bank_account_number | 直接对应 | 银行账号或卡号。 |
| Ecocash 账户名称 | ecocash_account | 直接对应 | Ecocash 账户名。 |
| Ecocash 账号 | ecocash_number | 直接对应 | Ecocash 账号。 |
| 法人姓名 | legal_person | 直接对应 | 个人入驻和企业入驻均使用该字段。 |
# 1.2 个人入驻资质字段
| 字段定义表中文名 | 接口字段名 | 对应类型 | 说明 |
|---|---|---|---|
| 证件类型 | certificate_type | 直接对应 | 0-身份证，1-护照。 |
| 证件上传 | card_front_image、card_back_image | 拆分对应 | 身份证正面和反面分别传入。 |
| 护照上传 | passport_electronic | 直接对应 | 证件类型为护照时使用。 |
| 证件号码 | legal_person_number | 直接对应 | 个人或法人证件号码。 |
| 生日 | birthday | 直接对应 | 本期新增字段，按 String 传递，具体格式由前端确定。 |
| 地址证明 | certified_proof_of_business_address | 直接对应 | 接口字段注释为“商业地址认证证明”。 |
| 营业执照 | business_license_electronic | 暂按此字段对应 | 接口字段注释为“企业执照电子版”，目前是最接近的营业执照文件字段。 |
| VAT 文件 | tax_registration_certificate_electronic | 直接对应 | 接口字段注释为“税务登记证号电子版”，需确认是否就是产品定义的 VAT 文件。 |
| 完税时间段 | tax_payment_start_time、tax_payment_end_time | 拆分对应 | 分别保存完税开始时间和结束时间。 |
| 完税证明 | tax_payment_certificate_electronic | 直接对应 | 完税证明电子版。 |
| 特许经营时段 | franchise_start_time、franchise_end_time | 拆分对应 | 分别保存特许经营开始时间和结束时间。 |
| 特许经营协议 | franchise_agreement_form | 直接对应 | 特许经营协议文件。 |
兼容旧证件传递方式时，legal_person_electronic 也可以保存证件图片地址；该字段接口注释为“证件正反面照片，逗号分隔”，不建议作为新的独立字段继续扩展。
# 1.3 企业入驻资质字段
| 字段定义表中文名 | 接口字段名 | 对应类型 | 说明 |
|---|---|---|---|
| 公司注册名称 | company_name | 直接对应 | 接口字段注释为“企业全称”。 |
| 公司注册号 | business_license_number | 直接对应 | 接口字段注释为“企业执照号”。 |
| TIN | company_taxnum | 直接对应 | 接口字段注释明确为“纳税人识别号（TIN）”。 |
| 法人姓名 | legal_person | 直接对应 | 企业法人姓名。 |
| 法人证件类型 | certificate_type | 直接对应 | 身份证或护照。 |
| 法人证件号码 | legal_person_number | 直接对应 | 法人证件号码。 |
| 法人生日 | birthday | 直接对应 | 本期新增字段，String 类型。 |
| 公司注册证书 | company_registration_certificate | 直接对应 | 公司注册证书文件。 |
| CR14 | cr14_electronic | 直接对应 | CR14 电子版。 |
| 公司章程 | articles_of_association | 直接对应 | 公司章程文件。 |
| 董事1证件 | director1_electronic、director1_back_electronic | 拆分对应 | 董事1身份证正面和反面。 |
| 董事1护照 | director1_passport_electronic | 直接对应 | 董事1使用护照时传入。 |
| 董事2证件 | director2_electronic、director2_back_electronic | 拆分对应 | 董事2身份证正面和反面。 |
| 董事2护照 | director2_passport_electronic | 直接对应 | 董事2使用护照时传入。 |
| 地址证明 | certified_proof_of_business_address | 直接对应 | 商业地址认证证明。 |
| VAT 文件 | tax_registration_certificate_electronic | 暂按此字段对应 | 需确认是否与产品定义的 VAT 文件含义一致。 |
| 完税时间段 | tax_payment_start_time、tax_payment_end_time | 拆分对应 | 完税开始时间和结束时间。 |
| 完税证明 | tax_payment_certificate_electronic | 直接对应 | 完税证明电子版。 |
| 特许经营时段 | franchise_start_time、franchise_end_time | 拆分对应 | 特许经营开始时间和结束时间。 |
| 特许经营协议 | franchise_agreement_form | 直接对应 | 特许经营协议文件。 |
| 字段定义表中文名 | 当前情况 |
|---|---|
| 经营名称 | 写入company_name` “企业全称” |
| VAT | 对应tax_registration_certificate |
| 职务 | 对应 contacts_position |
| VAT 文件 | 对应 tax_registration_certificate_electronic |
# 五、审核通过后：店铺工作台与店铺付费项目（App）
# （一）进入条件与状态流转
| 店铺状态 | 触发条件 | 工作台徽章 | 商家可执行操作 |
|---|---|---|---|
| 待激活 | 平台审核通过 | 待激活 | 缴纳店铺保证金、购买或续费店铺租金、激活店铺 |
| 营业中 | 保证金已缴纳 + 店铺有效期有效，商家在工作台手动激活 | 营业中 | 处理销售订单、续费店铺租金 |
- 进入路径：App → 我的 → 商家中心；退出商家中心返回「我的」。
- 平台审核通过后通过 App 消息中心推送「审核通过」通知，点击通知进入商家中心。
- 激活店铺为必经步骤：未激活时店铺不对外展示，已发布商品也不会被客户看到和下单。
# （二）店铺工作台
| 区域 | 字段 / 待办项 | 说明 |
|---|---|---|
| 店铺信息卡 | 店铺 LOGO | 取入驻申请提交的店铺 Logo |
| 店铺信息卡 | 店铺名称 | 取入驻申请填写的店铺名称 |
| 店铺信息卡 | 状态徽章 | 待激活 / 营业中，由激活状态决定 |
| 店铺信息卡 | 店铺ID | 审核通过后由系统生成，不可修改 |
| 店铺信息卡 | 经营类目 | 取入驻申请选择的经营类目 |
| 店铺信息卡 | 店铺有效期至 | 由已购买租金套餐的天数累计，格式 YYYY-MM-DD |
| 店铺信息卡 | 店铺费用 | 入口，点击进入店铺付费项目 |
| 待办区 | 缴纳店铺保证金 | 未缴纳时展示，含「USD 1,000.00 · 未缴纳，缴纳后才可激活店铺」，点击进入店铺付费项目 |
| 待办区 | 店铺租金续费 | 未续费时展示，含当前店铺有效期与「续费后有效期顺延」，点击进入店铺付费项目 |
| 待办区 | 激活店铺 | 未激活时展示；条件不满足时展示「待完成：未完成项」，条件满足时展示「立即激活」 |
| 功能列表 | 销售订单 | 展示待发货订单数量角标，点击进入销售订单列表 |
| 功能列表 | 更多功能 | 商品、店铺装修、数据、财务等模块陆续开放 |
- 待办区常驻展示，无待办事项时显示「暂无待办事项」，不整块隐藏。
- 商家点击「激活店铺」时先校验激活条件（保证金已缴、店铺有效期未过期）；不满足时以提示说明需先完成的项，不进入确认弹窗。
- 条件满足时点击「立即激活」弹出二次确认，说明「激活后店铺开始正式经营：已发布的商品会对外展示，客户可以看到并下单购买」；确认后店铺状态变为「营业中」，工作台徽章同步更新，并提示可开始上架商品。
- 保证金缴纳与店铺租金购买均在店铺付费项目内完成，完成后返回工作台，对应待办自动消失。
# （三）店铺付费项目
| 付费项目 | 金额 | 计费周期 | 激活店铺是否必需 | 状态 | 说明 |
|---|---|---|---|---|---|
| 店铺保证金 | USD 1,000.00（额度） | 一次性，支持追加 | 必需 | 未缴纳 / 已缴纳 | 保证金额度固定；已缴纳后展示可用余额与「追加保证金」入口；提供「保证金规则」说明入口 |
| 店铺租金套餐 | 见套餐表 | 按套餐天数计费 | 必需（店铺有效期需有效） | 有效 / 已过期 | 购买后店铺有效期按套餐天数顺延；展示当前店铺有效期至与当前使用套餐 |
店铺租金套餐：取店铺经营类目的套餐提供选择，和店铺后台的租金套餐购买功能一致。
- 商家点击保证金的「立即支付 USD 1,000.00」，或点击任一租金套餐的「购买」发起支付。
- 点击套餐卡片或「权益说明」打开套餐详情抽屉，展示套餐完整说明、当前店铺有效期至与购买后延长至的日期，并提供「立即购买 USD xxx」。
- 点击「购买 / 立即购买」打开确认支付抽屉，展示支付金额、所选套餐与支付方式；支付方式有 EcoCash、Visa、Mastercard，默认 EcoCash，可切换。
- 点击「确认支付 USD xxx」后进入支付结果抽屉，展示支付状态、支付金额、支付方式、支付单号，以及保证金可用余额（保证金）或店铺有效期延长至（租金）。
- 支付成功后：保证金状态变为「已缴纳」并计入可用余额（可用余额 = 保证金额度），工作台「缴纳店铺保证金」待办消失，商家仍需返回工作台手动完成「激活店铺」；店铺租金支付成功后店铺有效期按套餐天数延长，工作台「店铺租金续费」待办消失。
- 支付方式与金额口径：金额币种为 USD，保留 2 位小数（如 USD 1,000.00）；店铺有效期按自然日累加。
- 「追加保证金」、「保证金规则」、「购买记录」为入口占位，点击仅提示待补充。
# （四）与其他模块的关系
- 与商户端 PC 的口径：付费项目对齐商户端 PC「店铺设置 → 平台合作」的店铺保证金（USD 1,000.00）与店铺租金套餐 4 档；同一店铺的保证金缴纳状态与店铺有效期必须为同一份数据，需明确在任意端缴纳后另一端同步，避免重复缴纳或有效期不一致。
- 与入驻流程的衔接：店铺信息（店铺 Logo、店铺名称、店铺ID、经营类目）来自入驻申请，平台审核通过后才进入本流程；审核未通过或商家撤回时不进入商家中心。
- 与店铺经营有效期到期与续费：工作台「店铺有效期至」与「店铺租金续费」待办与该需求共用有效期口径（见 1.25 需求：https://www.yuque.com/liujiong-xqbo3/yzlmall/oun56c2g84voz698）。
- 与销售订单：激活店铺后方可处理销售订单，当前商家中心仅开放「销售订单」一个功能模块。