餐链OpenAPI
===================================

餐链OpenAPI是餐链提供给餐厅软件服务提供商的数据对接方式。

对接流程
===================================

.. image:: workflow1.jpg

步骤描述
---------------

1. 软件服务商自行在网上 `注册 <http://platform.mealcome.cn>`_ 为餐链openapi的用户,获取client_id和client_secret。
2. 联系餐链运营人员或发送邮件到`liutao@mealsci.com`，申请资质审核。
3. 审核通过后，开发者登录开放平台，向餐厅管理员申请授权门店接入。
4. 填写餐链系统的品牌名称及餐厅管理员的手机号，验证有效向管理员发送验证码,开发者向餐厅管理员询问验证码进行授权验证。
5. 验证通过后,获取access_token，每个门店都有单独的access_token。
6. 阅读快速入门之后调试第一个接口。

`快速入门 <quickstart.html>`_


接入方式
---------------
使用OpenAPI可以实现与餐链系统数据对接。我们提供二种不同的对接方式:

1.快速对接
^^^^^^^^^^^^^^^^^^^^^^^

快速对接,软件厂商通过开放平台的同步数据接口，将餐链系统的相关数据，同步到第三方系统中。

.. image:: syn1.jpg

需要建立对应关系的数据:门店,人员,档口,供应商,物料.可根据需要自行增减。

2.深度对接
^^^^^^^^^^^^^^^^^^^^^^^

深度对接,商家可接入餐链主要有七大功能模块，供应商管理相关接口、部门维护接口、订单相关接口、物料维护相关接口、库存相关接口、单位相关接口、人员相关接口。

.. image:: merchant.jpg

1. 按对接流程接入开放平台
2. 读取或写入餐链部门信息
3. 读取或写入餐链商品信息
4. 读取或写入餐链供应商信息，如需使用餐链供应商app，则需登录供应商App，在我的客户完成激活绑定
5. 第三方系统写入采购订单到餐链系统
6. 餐厅通过电子秤、或餐链系统完成收货
7. 第三方系统读取收货数据
8. 读取到收货单后同步价格到餐链系统

`模块业务接口 <merchant.html>`_


如有任何对接问题，请发邮件至 ``liutao@mealsci.com``。

.. note::

	此版本为初稿，仅供参考。不做任何保证。
	应以正式对接开始后的版本为准。

.. toctree::
   :maxdepth: 3
   
   quickstart.rst
   syn.rst
   merchant.rst
   readme.rst