1. 联通OMS

BBC联通OMS方式为，BBC通过队列的方式将BBC中的订单 售后 退款等相关消息推送到prism， galaxy通过监听prism消息，获取订单，售后，退款等相关数据推送到OMS，目前只支持自营店铺进行联通

1.1. 相关软件安装

在BBC联通OMS的过程中，涉及到BBC，prism，galaxy，OMS四个软件或系统，这里不再进行BBC、OMS系统安装部署文档说明。 在查看该文档的情况下默认BBC、OMS系统已经安装完成！

1.1.1. prism安装部署(本文档基于Centos 6.5，64位)

  • 安装mongodb，提供给prism使用

    sudo yum install mongo-10gen.x86_64

  • 安装prism，shopex提供的prism的rpm安装包

    rpm -ivh prism-3.0.8b-shopex.x86_64.rpm

  • 安装erlang，rabbitmq需要使用erlang

    yum install erlang.x86_64

  • 安装rabbitmq，提供给prism消息队列使用

    yum install rabbitmq_server.x86_64

  • 开启rabbitmq的web服务

    rabbitmq-plugins enable rabbitmq_management

  • 配置 vim /usr/local/prism/conf/app.conf 确保15672端口，8080端口能够访问

    [default]
appname = prism
debug = prod
mongodb = 127.0.0.1
mongodb_pool_size = 4096
webapp_listen = :8080
# saas地址
super_listen = :8081
masterdomain = .local:8080
# mongo中相关的collection名称
db_base = prism
db_stat = prism_stat
db_token = prism_token

# oauth后台，OauthMysql或者OauthApi
oauth_backend = OAuthApi

# 独立部署模式
single_mode = yes

# 禁止追踪api调用记录
disable_tracing = false
# 禁止saas记录各个站点的api调用log
disable_site_log = false
# 禁止api频率限制
disable_flow_control = false

# 消息队列软件 defualt = rabbitmq
backend_queue = default

[notify]
# rabbitmq相关设置
notify_support = true
rabbitmq_server = amqp://127.0.0.1:5672
rabbitmq_user = admin
rabbitmq_password = idney837hdhs
rabbitmq_vhost = prism
rabbitmq_web = http://127.0.0.1:15672/

[proxy]
# 全内网代理设置
# 用户中心用户oms申请证书的服务器
user_center = http://service.shopex.cn/
# oms设置绑定关系的服务器
bind = http://www.matrix.ecos.shopex.cn/
# prism外网地址
domain = http://prism.shopex.cn:8080/
# 内网galaxy bbc相关api的前缀
galaxy = http://127.0.0.1:6980/api/ecos.ome-bbc/
# 矩阵服务器
matrix = http://matrix.ecos.shopex.cn/

  • 启动

    /etc/init.d/prism [start|restart|stop]

  • 日志文件

    /usr/local/prism/logs/

    注意 重装prism后需要重新配置BBC联通OMSprism

1.1.2. galaxy安装部署

  • 安装galaxy，准备galaxy的rpm源，服务器要求 Centos6.5

    rpm -ivh galaxy-2.4.5-shopex.x86_64.rpm（如有就版本需要卸载旧版本）

  • 配置

    安装完成后，将BBC中的script/galaxy/erp-bbc-2文件夹放入/usr/local/galaxy/data/下，并做如下配置

    打开文件：vim /usr/local/galaxy/data/erp-bbc-2/node/prism.amq.json

    galaxy读取prism队列的相关配置

    {
    "title": "test",
    "type": "prism_amq",
    "config": {
        "host": "http://127.0.0.1:8080/api",  //prism的api地址 格式为http://xxx.xxx/api
        "key": "47ekkd3x",   //读取prism队列的key BBC绑定prism后开通的开发者账号的key
        "secret": "htzu32hyjqoryatn4o3l"  //读取prism队列的secret BBC绑定prism后开通的开发者账号的secret
    }
}

    打开文件:vim /usr/local/galaxy/data/erp-bbc-2/node/shopex_certi.json

    galaxy读取oms绑定信息的相关配置

     {
   "title": "test",
   "type": "mongo", //mongo的服务器地址 prism
   "config": {
       "server":"127.0.0.1:27017",
       "database":"shopex_certi", //存储绑定信息的collection 不可修改
       "user":"",  //mongo用户名
       "password":"" //mongo密码
   }
}

  • 启动

    /etc/init.d/galaxy start

重启 killgalaxy的进程再启动

    注意事项 prism服务重新启动后，galaxy也需要重新启动

  • 日志文件

    /usr/local/galaxy/log/

1.2. 配置

1.2.1. 初始化，BBC联通prism

  • 检查prism是否为API代理OAuth

    登录prism后台，点击OAuth菜单->后端参数，保证OAuth服务的后端模式为API代理OAuth。如图：

    如果为mysql模式，对于saas prism来说在申请修改OAuth服务的后端模式，独立部署的prism，请根据prism部署手册安装

  • 打开prism后台，获取admin用户的key和secret。点击进入我的账号查看，如图：

  • BBC中将config/prism.php复制到config/production/prism.php，并且修改以下提示的参数

      /*
  |--------------------------------------------------------------------------
  | 是否将系统消息推送到prism
  |--------------------------------------------------------------------------
  | 如果开启则创建订单，退款等消息会推送到prism，改为true
  */
  'prismNotify' => false,

  /*
  |--------------------------------------------------------------------------
  | Prism服务器的Host地址
  |--------------------------------------------------------------------------
  |
  | prism服务器的地址，URL地址最后不要加 "/"
  |
  */
  'prismHostUrl' => 'http://prism.bryant.onex.software:8080',

  /*
  |--------------------------------------------------------------------------
  | Prism管理员的Key和Secret
  |--------------------------------------------------------------------------
  |
  | prism第一次启动时会在命令行显示，如果忘记，在prism后台的用户中心可以看到
  |
  */
  'prismAdminKey' => '5ioviqux',
  'prismAdminSecret' => 'qzafphmi4tppgzncafdb',

  /*
  |--------------------------------------------------------------------------
  | Prism api和应用的提供者的email和密码
  |--------------------------------------------------------------------------
  |
  | api提供者的账号密码，要求账号不存在，否则会报错。
  | 最好修改该默认账号和密码
  |
  */
  'prismUserEmail' => 'test@test.cn',
  'prismUserPassword' => 'demo123',

    注意：需要修改prismUserEmail，prismUserPassword，防止泄露

  • 执行BBC的CMD命令将BBC配置参数和联通所需的API推送到prism

      #将BBC的api在prism的映射初始化
  ./cmd system:prism forceupdate

  #进行Oauth的自动化配置
  ./cmd system:prism oauthUpdate

  #初始化BBC消息推送到prism设置
  ./cmd system:prism initNotify

  #初始化店铺消息路由
  ./system:prism initShopRouting

  • 检查初始化是否成功

    • 检查Api调用权限是否配置成功

      打开prism后台，进入应用菜单，在应用列表中的点击进入bbcopenstandard的应用， 查看联通所需的API是否在API调用权限列表内，如图：

      BBC联通OMS所需API

      //售后退款相关API
aftersales.refundapply.shop.check # 商家审核，更新退款申请单
aftersales.refundapply.shop.add   # 添加退款申请单
aftersales.refundapply.get        # 获取退款申请单详情
aftersales.get                    # 获取单个售后申请单详情
aftersales.status.update          # 更改售后单状态

//商品相关API
item.shop.store.update  # 库存回写
item.search             # 搜索商品信息
item.list.get           # 根据多个商品item_id组分别获取商品以及商品下的规格货品信息
item.get                # 根据单个商品id获取商品以及商品下的规格货品信息
item.sku.get            # 根据sku_id获取货品的信息

//订单联通相关API
trade.shop.get    # 获取单个订单详情
trade.cancel      # 取消未付款订单
trade.delivery    # 发货

      如果调用API权限不足可通过prism页面(上图)进行授权

1.2.2. BBC开放API权限申请流程

一套OMS有且只能对应一个BBC的开发者账号。如果OMS需要绑定多个BBC的店铺。
所有需要绑定的BBC的店铺绑定同一个开发者账号的Key和Secret。
  • 打开BBC运营平台开放开发者列表->新增开发者账号，新增一个开发者账号
  • 将新增的开发者账号的Key和Secret提供给galaxy，将用于galaxy监听prism消息队列使用
  • 打开BBC商家中心(必须为自营店铺)店铺->开发者中心，输入开发者账号的Key和Secret申请开通
  • 商家申请后到运营平台开发者中心->商家列表申请开通绑定
  • 运营平台通过申请后，进入商家中心的开发者中心开启开发者模式

1.2.3. 检测配置是否有问题

  • 检测是否可以OAuth登录

    打开prism后台，进入OAuth 检测用户是否存在，通过则表示正常。
如果返回null，可进入到BBC后台查看API调用日志

  • 检测BBC是否有推送到prism消息权限

    在检查Api调用权限是否配置成功页面是否有messages消息队列权限

1.2.4. OMS和BBC的绑定。

  • 只要在OMS端单项绑定即可。

  • OMS添加店铺

  • 绑定类型是BBC商城

  • 地址填写prism的地址（注意，域名后面不要有'''/'''符号）

  • 输入开发者账号的key和Secret，打开oauth登录页面，使用BBC店铺账号登录即可。

results matching ""

    No results matching ""