pyiikocloudapi 0.0.20

Python services for convenient work with iiko Transport

pyiikocloudapi - python iikoCloud API сервис

Установка

Пользуем pip:

pip install pyiikocloudapi

###Зависимости

requests
pydantic

Как использовать

Все названия методов соответствуют названию в ссылке (смотрите документацию iiko Transport).

Пример названия метода:

• /api/1/auth/ - access_token
• /api/1/order/create - order_create

Если вам нужно чтобы ответ был в dict то либо

api = IikoTransport(api_login, return_dict=True)

# Либо
api.return_dict = True

Example

from pyiikocloudapi import IikoTransport
from pyiikocloudapi.models import CouriersModel

# инициализация класса 
api = IikoTransport(api_login)

# получаем организации получить из можно api.organizations_ids: dict or api.organizations_ids_models: OrganizationsModel
api.organizations()

# получаю список курьеров организации
couriers: CouriersModel = api.couriers(api.organizations_ids)

Каждый метод проверяет время жизни маркера доступа, если время жизни маркера прошло то будет автоматически запрошен заново.

Время жизни маркера доступа равно ~60 минутам.

###Доп. инфа iiko Transport(iiko Cloud API) по словам разработчиков это по сути горячие хранилище без доступа к данным БД

sourceKey это "Источник заказа" из настроек в iikoWeb

Реализованные методы iiko Transport(iiko Cloud API)

• Authorization
  • Retrieve session key for API user.
• Notifications
  • Send notification to external systems (iikoFront and iikoWeb).
• Organizations
  • Returns organizations available to api-login user.
• Terminal groups
  • Method that returns information on groups of delivery terminals.
  • Returns information on availability of group of terminals.
• Dictionaries
  • Delivery cancel causes.
  • Order types.
  • Discounts / surcharges.
  • Payment types.
  • Removal types (reasons for deletion).
  • Get tips tipes for api-login`s rms group.
• Menu
  • Menu.
  • External menus with price categories.
  • Retrieve external menu by ID.
  • Out-of-stock items.
  • Get combos info
  • Calculate combo price
  • WebHook notification about stop list update. Webhook ???
• Operations
  • Get status of command.
• Deliveries: Create and update
  • Create delivery.
  • Update order problem.
  • Update delivery status.
  • Update order courier.
  • Add order items.
  • Close order.
  • Cancel delivery order.
  • Change time when client wants the order to be delivered.
  • Change order's delivery point information.
  • Change order's delivery type.
  • Change order's payments.
  • Change delivery comment.
  • Print delivery bill.
  • Confirm delivery.
  • Cancel delivery confirmation.
  • Assign/change the order operator.
  • WebHook notification about delivery order update. Webhook ???
  • WebHook notification about delivery order saving error. Webhook ???
• Deliveries: Retrieve
  • Retrieve orders by IDs.
  • Retrieve list of orders by statuses and dates.
  • Retrieve list of orders changed from the time revision was passed.
  • Retrieve list of orders by telephone number, dates and revision.
  • Search orders by search text and additional filters (date, problem, statuses and other).
• Addresses
  • Regions.
  • Cities.
  • Streets by city.
• Delivery restrictions
  • Retrieve list of delivery restrictions.
  • Update delivery restrictions.
  • Get suitable terminal groups for delivery restrictions.
• Employees
  • Method of obtaining drivers' coordinates history.
  • Returns list of all employees which are delivery drivers in specified restaurants.
  • Returns list of all employees which are delivery drivers in specified restaurants, and checks whether each employee has passed role.
  • Returns list of all active (courier session is opened) courier's locations which are delivery drivers in specified restaurant and are clocked in on specified delivery terminal.
  • Returns list of all active (courier session is opened) courier's locations which are delivery drivers in specified restaurants.
  • Returns employee info.
• wMarketing sources
  • Marketing sources.
• Drafts
  • Retrieve order draft by ID.
  • Retrieve order drafts list by parameters.
  • Store order draft changes to DB.
  • Admit order draft changes and send them to Front.
• Orders
  • Create order.
  • Retrieve orders by IDs.
  • Retrieve orders by tables.
  • Add order items.
  • Close order.
  • Change table order's payments.
  • Init orders, created in the front.
  • WebHook notification about table order update. Webhook ???
  • WebHook notification about table order saving error. Webhook ???
• Banquets/reserves
  • Returns all organizations of current account (determined by Authorization request header) for which banquet/reserve booking are available.
  • Returns all terminal groups of specified organizations, for which banquet/reserve booking are available.
  • Returns all restaurant sections of specified terminal groups, for which banquet/reserve booking are available.
  • Returns all banquets/reserves for passed restaurant sections.
  • Create banquet/reserve.
  • Retrieve banquets/reserves statuses by IDs.
  • WebHook notification about reserve update. Webhook ???
  • WebHook notification about reserve saving error. Webhook ???
• Discounts and promotions
  • Calculate discounts and other loyalty items for an order.
  • Get all organization's manual conditions.
  • Get all loyalty programs for organization.
  • Get information about the specified coupon.
  • Get a list of coupon series in which there are not deleted and not activated coupons.
  • Get list of non-activated coupons.
• Customers
  • Get customer info by specified criterion.
  • Create or update customer info by id or phone or card track.
  • Add new customer for program.
  • Add new card for customer.
  • Delete existing card for customer.
  • Hold customer's money in loyalty program. Payment will be process on POS during processing of an order.
  • Refill customer balance.
  • Withdraw customer balance.
• ....