简体中文

English

简体中文

English

显示模式

关于 店铺 ​

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

店铺管理是 Genstore 商家运营的基础组成部分，它提供了完整的店铺信息管理能力。通过该模块，商家可以配置店铺的基础信息与地点信息，包含店铺名称、域名、联系电话、地址、时区等相关信息，实现统一的店铺信息管理。

核心功能

  • 查询店铺信息：获取店铺的基础信息，包括店铺名称、访问域名、联系电话等。
  • 查询地点详情：获取单个店铺地点的详细信息。
  • 创建店铺地点：添加新的店铺地点信息。
  • 更新地点信息：编辑已有店铺地点的信息。
  • 删除店铺地点：移除指定的店铺地点信息。
  • 获取地点列表：滚动分页获取店铺地点列表。
  • 统计地点数量：获取当前店铺的地点总数。

应用场景

  • 智能通知管理：商家可基于店铺时区，在合适的时间发送通知和奖励，避免打扰客户，提升客户满意度。
  • 店铺信息配置：运营团队可维护店铺基础信息，确保客户能获取准确的店铺信息。
  • 多地点管理：商家可创建和管理多个店铺地点，实现高效的多店运营。

接口

EVENT shop/update: 店铺信息变更

EVENT shop/redact: 请求删除店铺数据

店铺 对象 ​

一个店铺对象

属性 ​

shopobject
表示店铺信息
- 收起属性
shopIdnumber
店铺的唯一标识，64位数值。
shopNamestring
店铺的名称。
domainstring
店铺的域名。
descriptionstring
店铺的简介。
logostring
店铺的Logo，在C端展示。
mailstring
店铺的邮箱地址，可以用此来联系商户。
countrystring
店铺的国家地区编码（2位）。
currencystring
店铺的主货币，采用ISO_4217标准的3位字符。
timezonestring
店铺的时区。
ianaTimezonestring
店铺的IANA时区。
weightUnitstring
店铺的重量单位，可选值lb、oz、g、kg。
bash
{
  "shop": {
    "country": "US",
    "mail": "[email protected]",
    "timezone": "-4",
    "domain": "online-shop.genstore.com",
    "shopName": "Sun's Shop",
    "description": "This is a test shop descirption",
    "logo": "https://statics.genstore.com/folder/qefadfasdfafwerw.png",
    "currency": "USD",
    "shopId": "1234567890",
    "ianaTimezone": "America/New_York",
    "weightUnit": "kg"
  }
}

EVENT 店铺信息变更 ​

通知外部服务店铺的信息发生变更。

访问范围

需要以下任意访问权限: read_shops write_shops

消息

EVENT shop/update 

消息数据

shopobject
店铺的信息。
- 收起属性
shopIdnumber
店铺的ID。64位数值。
shopNamestring
店铺的名称。
domainstring
店铺的域名。
descriptionstring
店铺的简介。
logostring
店铺的Logo，在C端展示。
mailstring
店铺的邮箱地址，可以用此来联系商户。
countrystring
店铺的国家地区编码(2位)。
currencystring
店铺的主货币，采用ISO_4217标准的3位字符。
timezonestring
店铺的时区。
ianaTimezonestring
店铺的IANA时区。
weightUnitstring
店铺的重量单位，可选值lb oz g kg。
shopStatusnumber
店铺的状态。 枚举值：0 - 停用, 1 - 试用版, 2 - 付费版本, 3 - 欠费
json
{
  "shop": {
    "country": "US",
    "shopStatus": "",
    "mail": "[email protected]",
    "timezone": "-4",
    "domain": "online-shop.genstore.com",
    "shopName": "Sun's Shop",
    "description": "This is a test shop descirption",
    "logo": "https: //statics.genstore.com/folder/qefadfasdfafwerw.png",
    "currency": "USD",
    "shopId": "1234567890",
    "ianaTimezone": "America/New_York",
    "weightUnit": "kg"
  }
}

EVENT 请求删除店铺数据 ​

请求删除店铺数据。

访问范围

需要以下任意访问权限: read_shops write_shops

消息

EVENT shop/redact 

消息数据

shopIdnumber
店铺的id, Long类型, 64位的数值。
shopDomainstring
店铺的初始化域名。{shopCode}.genmystore.com 格式数据。
json
{
  "shopDomain": "aaaa.genmystore.com",
  "shopId": "1234"
}