update version matrix (#38)

* update python versions test matrix
* fix workflow file
* fix missing key tests

.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - '**'
+    tags-ignore:
+      - '*.*'
+  pull_request:
+
+env:
+  RETAILCRM_URL: https://test.retailcrm.pro
+  RETAILCRM_KEY: key
+
+jobs:
+  tests:
+    name: Tests
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.8', '3.9', '3.10', '3.11']
+        include:
+          - python-version: '3.12'
+            coverage: 1
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Cache pip
+        uses: actions/cache@v2
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+            ${{ runner.os }}-
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install flake8
+          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+      - name: Lint with flake8
+        run: |
+          # stop the build if there are Python syntax errors or undefined names
+          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+          # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+          flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics --ignore=F401
+      - name: Tests
+        env:
+          COVERAGE: ${{ matrix.coverage }}
+        if: env.COVERAGE != 1
+        run: python -m unittest tests/*.py
+      - name: Tests with coverage
+        env:
+          COVERAGE: ${{ matrix.coverage }}
+        if: env.COVERAGE == 1
+        run: |
+          coverage run -m unittest tests/*.py
+      - name: Coverage
+        env:
+          COVERAGE: ${{ matrix.coverage }}
+        if: env.COVERAGE == 1
+        run: |
+          bash <(curl -s https://codecov.io/bash)
+          rm .coverage coverage.xml

.gitignore

@@ -4,4 +4,8 @@
 /*.egg-info
 /dist/
 /venv/
-/.vscode/
+/.vscode/
+/build/
+.python-version
+.coverage
+coverage.xml

.travis.yml

@@ -1,9 +0,0 @@
-language: python
-python:
-  - '3.4'
-  - '3.5'
-  - '3.6'
-before_install:
-  - pip install -r requirements.txt
-script:
-  - nosetests -v

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2018 RetailDriver LLC
+Copyright (c) 2015-2021 RetailDriver LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README

@@ -0,0 +1,70 @@
+RetailCRM python API client
+===========================
+
+This is python RetailCRM API client. This library allows to use all
+available API versions.
+
+Install
+-------
+
+::
+
+    pip3 install retailcrm
+
+Usage
+-----
+
+
+.. code:: python
+
+    # coding utf-8
+
+    import retailcrm
+
+
+    client = retailcrm.v3('https://demo.retailcrm.pro', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
+
+    order = {
+      'firstName': 'John',
+      'lastName': 'Doe',
+      'phone': '+79000000000',
+      'email': 'john@example.com',
+      'orderMethod': 'call-request',
+    }
+
+    result = client.order_create(order)
+
+
+.. code:: python
+
+    # coding utf-8
+
+    import retailcrm
+
+
+    client = retailcrm.v4('https://demo.retailcrm.pro', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
+
+    result = client.customers_history(filter={'sinceId': '1500', 'startDate': '2018-03-01'})
+
+    print(result['pagination']['totalCount'])
+
+
+.. code:: python
+
+    # coding utf-8
+
+    import retailcrm
+
+
+    client = retailcrm.v5('https://demo.retailcrm.pro', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
+    site = 'example-com'
+    task = {
+      'text': 'Product availability problem',
+      'commentary': 'Take a look ASAP',
+      'order': {
+        'externalId': '100500'
+      },
+      'performerId': 1
+    }
+
+    result = client.task_create(task, site)

README.md

@@ -1,17 +1,18 @@
-[![Build Status](https://img.shields.io/travis/retailcrm/api-client-python/master.svg?style=flat-square)](https://travis-ci.org/retailcrm/api-client-python)
-[![PyPI](https://img.shields.io/pypi/v/retailcrm.svg?style=flat-square)](https://pypi.python.org/pypi/retailcrm)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/retailcrm.svg?style=flat-square)](https://pypi.python.org/pypi/retailcrm)
+[![Build Status](https://github.com/retailcrm/api-client-python/workflows/ci/badge.svg)](https://github.com/retailcrm/api-client-python/actions)
+[![Coverage](https://img.shields.io/codecov/c/gh/retailcrm/api-client-python/master.svg?logo=codecov&logoColor=white)](https://codecov.io/gh/retailcrm/api-client-python)
+[![PyPI](https://img.shields.io/pypi/v/retailcrm.svg?logo=pypi&logoColor=white)](https://pypi.python.org/pypi/retailcrm)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/retailcrm.svg?logo=python&logoColor=white)](https://pypi.python.org/pypi/retailcrm)
 
 
-retailCRM python API client
+RetailCRM python API client
 ===========================
 
-This is python retailCRM API client. This library allows to use all available API versions.
+This is Python RetailCRM API client. This library allows to use all available API versions.
 
 ## Install
 
 ```
-pip install retailcrm
+pip3 install retailcrm
 ```
 
 ## Usage
@@ -24,7 +25,7 @@ pip install retailcrm
 import retailcrm
 
 
-client = retailcrm.v3('https://demo.retailcrm.ru', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
+client = retailcrm.v3('https://demo.retailcrm.pro', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
 
 order = {
   'firstName': 'John',
@@ -45,9 +46,9 @@ result = client.order_create(order)
 import retailcrm
 
 
-client = retailcrm.v4('https://demo.retailcrm.ru', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
+client = retailcrm.v4('https://demo.retailcrm.pro', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
 
-result = client.customers_history(filter={'sinceId': '1500', 'startDate': '2018-03-01'})
+result = client.customers_history(filters={'sinceId': '1500', 'startDate': '2018-03-01'})
 
 print(result['pagination']['totalCount'])
 ```
@@ -60,7 +61,7 @@ print(result['pagination']['totalCount'])
 import retailcrm
 
 
-client = retailcrm.v5('https://demo.retailcrm.ru', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
+client = retailcrm.v5('https://demo.retailcrm.pro', 'uLxXKBwjQteE9NkO3cJAqTXNwvKktaTc')
 site = 'example-com'
 task = {
   'text': 'Product availability problem',
@@ -73,8 +74,3 @@ task = {
 
 result = client.task_create(task, site)
 ```
-
-## Documentation
-
-* [English](http://www.retailcrm.pro/docs/Developers/Index)
-* [Russian](http://www.retailcrm.ru/docs/Developers/Index)

requirements.txt

@@ -1,3 +1,6 @@
 multidimensional-urlencode==0.0.4
 nose==1.3.7
-requests==2.18.4
+requests==2.32.1
+coverage==4.5.4
+pook==1.3.0
+setuptools==70.0.0

retailcrm/response.py

@@ -42,7 +42,7 @@ class Response(object):
         """
         :return: collection
         """
-        errors = {
-        } if not self.__response_body['errors'] else self.__response_body['errors']
+
+        errors = self.__response_body.get('errors', {})
 
         return errors

retailcrm/versions/__init__.py

@@ -0,0 +1,5 @@
+# coding=utf-8
+
+"""
+Init
+"""

retailcrm/versions/base.py

@@ -11,7 +11,7 @@ from retailcrm.response import Response
 
 
 class Base(object):
-    """retailCRM API client"""
+    """RetailCRM API client"""
 
     def __init__(self, crm_url, api_key, version):
         self.api_url = crm_url + '/api'
@@ -27,22 +27,24 @@ class Base(object):
         :return: Response
         """
         base_url = self.api_url + '/' + self.api_version if version else self.api_url
-        requests_url = base_url + url if not self.parameters else base_url + \
-            url + "?" + query_builder(self.parameters)
+        requests_url = base_url + url if not self.parameters else base_url + url + "?" + query_builder(self.parameters)
         response = requests.get(requests_url, headers={
             'X-API-KEY': self.api_key})
+        self.parameters = {}
 
         return Response(response.status_code, response.json())
 
-    def post(self, url):
+    def post(self, url, version=True):
         """
         Post request
         :return: Response
         """
-        requests_url = self.api_url + url
+        base_url = self.api_url + '/' + self.api_version if version else self.api_url
+        requests_url = base_url + url
         response = requests.post(requests_url, data=self.parameters, headers={
             'X-API-KEY': self.api_key})
-
+        self.parameters = {}
+        
         return Response(response.status_code, response.json())
 
     def api_versions(self):

retailcrm/versions/v3.py

@@ -10,7 +10,7 @@ from retailcrm.versions.base import Base
 
 
 class Client(Base):
-    """retailCRM API client"""
+    """RetailCRM API client"""
 
     apiVersion = 'v3'
 
@@ -19,9 +19,9 @@ class Client(Base):
 
     def customers(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -32,8 +32,8 @@ class Client(Base):
 
     def customer_create(self, customer, site=None):
         """
-        :param customer:
-        :param site:
+        :param customer: object
+        :param site: string
         :return: Response
         """
         self.parameters['customer'] = json.dumps(customer)
@@ -45,8 +45,8 @@ class Client(Base):
 
     def customers_fix_external_ids(self, customers, site=None):
         """
-        :param customers:
-        :param site:
+        :param customers: object
+        :param site: string
         :return: Response
         """
         self.parameters['customers'] = json.dumps(customers)
@@ -58,8 +58,8 @@ class Client(Base):
 
     def customers_upload(self, customers, site=None):
         """
-        :param customers:
-        :param site:
+        :param customers: array of objects
+        :param site: string
         :return: Response
         """
         self.parameters['customers'] = json.dumps(customers)
@@ -71,9 +71,9 @@ class Client(Base):
 
     def customer(self, uid, uid_type='externalId', site=None):
         """
-        :param uid:
-        :param uid_type:
-        :param site:
+        :param uid: string
+        :param uid_type: string
+        :param site: string
         :return: Response
         """
         if uid_type != 'externalId':
@@ -86,9 +86,9 @@ class Client(Base):
 
     def customer_edit(self, customer, uid_type='externalId', site=None):
         """
-        :param customer:
-        :param uid_type:
-        :param site:
+        :param customer: object
+        :param uid_type: string
+        :param site: string
         :return: Response
         """
         self.parameters['customer'] = json.dumps(customer)
@@ -103,7 +103,7 @@ class Client(Base):
 
     def orders(self, filters=None, limit=20, page=1):
         """
-        :param filters: array
+        :param filters: object
         :param limit: integer
         :param page: integer
         :return: Response
@@ -142,11 +142,11 @@ class Client(Base):
 
     def orders_history(self, start=None, end=None, limit=100, offset=0, skip=True):
         """
-        :param start:
-        :param end:
-        :param limit:
-        :param offset:
-        :param skip:
+        :param start: DateTime
+        :param end: DateTime
+        :param limit: integer
+        :param offset: integer
+        :param skip: boolean
         :return: Response
         """
         self.parameters['startDate'] = start
@@ -215,9 +215,9 @@ class Client(Base):
 
     def packs(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -228,7 +228,7 @@ class Client(Base):
 
     def pack_create(self, pack):
         """
-        :param pack:
+        :param pack: object
         :return: Response
         """
         self.parameters['pack'] = json.dumps(pack)
@@ -237,9 +237,9 @@ class Client(Base):
 
     def packs_history(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -250,7 +250,7 @@ class Client(Base):
 
     def pack(self, uid):
         """
-        :param uid:
+        :param uid: integer
         :return: Response
         """
 
@@ -258,7 +258,7 @@ class Client(Base):
 
     def pack_delete(self, uid):
         """
-        :param uid:
+        :param uid: integer
         :return: Response
         """
 
@@ -266,7 +266,7 @@ class Client(Base):
 
     def pack_edit(self, pack):
         """
-        :param pack:
+        :param pack: object
         :return: Response
         """
         self.parameters['pack'] = json.dumps(pack)
@@ -289,7 +289,7 @@ class Client(Base):
 
     def delivery_services_edit(self, delivery_service):
         """
-        :param delivery_service:
+        :param delivery_service: object
         :return: Response
         """
         self.parameters['deliveryService'] = json.dumps(delivery_service)
@@ -305,7 +305,7 @@ class Client(Base):
 
     def delivery_types_edit(self, delivery_type):
         """
-        :param delivery_type:
+        :param delivery_type: object
         :return: Response
         """
         self.parameters['deliveryType'] = json.dumps(delivery_type)
@@ -322,7 +322,7 @@ class Client(Base):
     def order_methods_edit(self, order_method):
         """
 
-        :param order_method:
+        :param order_method: object
         :return: Response
         """
         self.parameters['orderMethod'] = json.dumps(order_method)
@@ -338,7 +338,7 @@ class Client(Base):
 
     def order_types_edit(self, order_type):
         """
-        :param order_type:
+        :param order_type: object
         :return: Response
         """
         self.parameters['orderType'] = json.dumps(order_type)
@@ -354,7 +354,7 @@ class Client(Base):
 
     def payment_statuses_edit(self, payment_status):
         """
-        :param payment_status:
+        :param payment_status: object
         :return: Response
         """
         self.parameters['paymentStatus'] = json.dumps(payment_status)
@@ -370,7 +370,7 @@ class Client(Base):
 
     def payment_types_edit(self, payment_type):
         """
-        :param payment_type:
+        :param payment_type: object
         :return: Response
         """
         self.parameters['paymentType'] = json.dumps(payment_type)
@@ -386,7 +386,7 @@ class Client(Base):
 
     def product_statuses_edit(self, product_status):
         """
-        :param product_status:
+        :param product_status: object
         :return: Response
         """
         self.parameters['productStatus'] = json.dumps(product_status)
@@ -402,7 +402,7 @@ class Client(Base):
 
     def sites_edit(self, site):
         """
-        :param site:
+        :param site: object
         :return: Response
         """
         self.parameters['site'] = json.dumps(site)
@@ -411,7 +411,7 @@ class Client(Base):
 
     def status_groups(self):
         """
-        :return
+        :return: Response
         """
 
         return self.get('/reference/status-groups')
@@ -425,7 +425,7 @@ class Client(Base):
 
     def statuses_edit(self, status):
         """
-        :param status:
+        :param status: object
         :return: Response
         """
         self.parameters['status'] = json.dumps(status)
@@ -441,18 +441,18 @@ class Client(Base):
 
     def stores_edit(self, store):
         """
-        :param store:
+        :param store: object
         :return: Response
         """
-        self.parameters['status'] = json.dumps(store)
+        self.parameters['store'] = json.dumps(store)
 
         return self.post('/reference/stores/' + store['code'] + '/edit')
 
     def inventories(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -461,21 +461,25 @@ class Client(Base):
 
         return self.get('/store/inventories')
 
-    def inventories_upload(self, offers):
+    def inventories_upload(self, offers, site=None):
         """
-        :param offers:
+        :param offers: array of objects
+        :param site: string
         :return: Response
         """
+        if site is not None:
+            self.parameters['site'] = site
+
         self.parameters['offers'] = json.dumps(offers)
 
         return self.post('/store/inventories/upload')
 
     def telephony_call_event(self, phone, call_type, code, status):
         """
-        :param phone:
-        :param call_type:
-        :param code:
-        :param status:
+        :param phone: string
+        :param call_type: string
+        :param code: string
+        :param status: string
         :return: Response
         """
         self.parameters['hangupStatus'] = status
@@ -487,7 +491,7 @@ class Client(Base):
 
     def telephony_calls_upload(self, calls):
         """
-        :param calls:
+        :param calls: array of objects
         :return: Response
         """
         self.parameters['calls'] = json.dumps(calls)
@@ -496,9 +500,9 @@ class Client(Base):
 
     def telephony_manager(self, phone, details=True):
         """
-        :param phone:
-        :param details:
-        :return: Response
+        :param phone: string
+        :param details: string
+        :return: Response string
         """
         self.parameters['phone'] = phone
         self.parameters['details'] = details
@@ -507,12 +511,12 @@ class Client(Base):
 
     def telephony_settings(self, code, client_id, make_call_url, active, name, image):
         """
-        :param code:
-        :param client_id:
-        :param make_call_url:
-        :param active:
-        :param name:
-        :param image:
+        :param code: string
+        :param client_id: string
+        :param make_call_url: string
+        :param active: string
+        :param name: string
+        :param image: string
         :return: Response
         """
         self.parameters['code'] = code
@@ -523,3 +527,10 @@ class Client(Base):
         self.parameters['image'] = image
 
         return self.post('/telephony/settings/' + str(code))
+
+    def statistic_update(self):
+        """
+        :return: Response
+        """
+
+        return self.get('/statistic/update')

retailcrm/versions/v4.py

@@ -10,7 +10,7 @@ from retailcrm.versions.base import Base
 
 
 class Client(Base):
-    """retailCRM API client"""
+    """RetailCRM API client"""
 
     apiVersion = 'v4'
 
@@ -19,9 +19,9 @@ class Client(Base):
 
     def customers(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -32,8 +32,8 @@ class Client(Base):
 
     def customer_create(self, customer, site=None):
         """
-        :param customer:
-        :param site:
+        :param customer: object
+        :param site: string
         :return: Response
         """
         self.parameters['customer'] = json.dumps(customer)
@@ -45,8 +45,8 @@ class Client(Base):
 
     def customers_fix_external_ids(self, customers, site=None):
         """
-        :param customers:
-        :param site:
+        :param customers: array of objects
+        :param site: string
         :return: Response
         """
         self.parameters['customers'] = json.dumps(customers)
@@ -58,9 +58,9 @@ class Client(Base):
 
     def customers_history(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -71,8 +71,8 @@ class Client(Base):
 
     def customers_upload(self, customers, site=None):
         """
-        :param customers:
-        :param site:
+        :param customers: array of objects
+        :param site: string
         :return: Response
         """
         self.parameters['customers'] = json.dumps(customers)
@@ -84,9 +84,9 @@ class Client(Base):
 
     def customer(self, uid, uid_type='externalId', site=None):
         """
-        :param uid:
-        :param uid_type:
-        :param site:
+        :param uid: string
+        :param uid_type: string
+        :param site: string
         :return: Response
         """
         if uid_type != 'externalId':
@@ -99,9 +99,9 @@ class Client(Base):
 
     def customer_edit(self, customer, uid_type='externalId', site=None):
         """
-        :param customer:
-        :param uid_type:
-        :param site:
+        :param customer: object
+        :param uid_type: string
+        :param site: string
         :return: Response
         """
         self.parameters['customer'] = json.dumps(customer)
@@ -116,7 +116,7 @@ class Client(Base):
 
     def delivery_setting(self, code):
         """
-        :param code:
+        :param code: string
         :return: Response
         """
 
@@ -124,17 +124,17 @@ class Client(Base):
 
     def delivery_setting_edit(self, configuration):
         """
-        :param configuration::
+        :param configuration: object
         :return: Response
         """
         self.parameters['configuration'] = json.dumps(configuration)
 
-        return self.post('/delivery/generic/setting/' + str(configuration['code'])) + '/edit'
+        return self.post('/delivery/generic/setting/' + str(configuration['code']) + '/edit')
 
     def delivery_tracking(self, code, status_update):
         """
-        :param code:
-        :param status_update:
+        :param code: string
+        :param status_update: array of objects
         :return: Response
         """
         self.parameters['statusUpdate'] = json.dumps(status_update)
@@ -143,16 +143,16 @@ class Client(Base):
 
     def marketplace_setting_edit(self, configuration):
         """
-        :param configuration::
+        :param configuration: object
         :return: Response
         """
         self.parameters['configuration'] = json.dumps(configuration)
 
-        return self.post('/marketplace/external/setting/' + str(configuration['code'])) + '/edit'
+        return self.post('/marketplace/external/setting/' + str(configuration['code']) + '/edit')
 
     def orders(self, filters=None, limit=20, page=1):
         """
-        :param filters: array
+        :param filters: object
         :param limit: integer
         :param page: integer
         :return: Response
@@ -178,7 +178,7 @@ class Client(Base):
 
     def orders_fix_external_ids(self, orders, site=None):
         """
-        :param orders: object
+        :param orders: array of objects
         :param site: string
         :return: Response
         """
@@ -191,9 +191,9 @@ class Client(Base):
 
     def orders_history(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -215,7 +215,7 @@ class Client(Base):
 
     def orders_upload(self, orders, site=None):
         """
-        :param orders: object
+        :param orders: array of objects
         :param site: string
         :return: Response
         """
@@ -260,9 +260,9 @@ class Client(Base):
 
     def packs(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -273,7 +273,7 @@ class Client(Base):
 
     def pack_create(self, pack):
         """
-        :param pack:
+        :param pack: object
         :return: Response
         """
         self.parameters['pack'] = json.dumps(pack)
@@ -282,9 +282,9 @@ class Client(Base):
 
     def packs_history(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -295,7 +295,7 @@ class Client(Base):
 
     def pack(self, uid):
         """
-        :param uid:
+        :param uid: integer
         :return: Response
         """
 
@@ -303,7 +303,7 @@ class Client(Base):
 
     def pack_delete(self, uid):
         """
-        :param uid:
+        :param uid: integer
         :return: Response
         """
 
@@ -311,8 +311,7 @@ class Client(Base):
 
     def pack_edit(self, pack):
         """
-        :param pack:
-        :param uid:
+        :param pack: object
         :return: Response
         """
         self.parameters['pack'] = json.dumps(pack)
@@ -335,7 +334,7 @@ class Client(Base):
 
     def delivery_services_edit(self, delivery_service):
         """
-        :param delivery_service:
+        :param delivery_service: object
         :return: Response
         """
         self.parameters['deliveryService'] = json.dumps(delivery_service)
@@ -351,7 +350,7 @@ class Client(Base):
 
     def delivery_types_edit(self, delivery_type):
         """
-        :param delivery_type:
+        :param delivery_type: object
         :return: Response
         """
         self.parameters['deliveryType'] = json.dumps(delivery_type)
@@ -368,7 +367,7 @@ class Client(Base):
     def order_methods_edit(self, order_method):
         """
 
-        :param order_method:
+        :param order_method: object
         :return: Response
         """
         self.parameters['orderMethod'] = json.dumps(order_method)
@@ -384,7 +383,7 @@ class Client(Base):
 
     def order_types_edit(self, order_type):
         """
-        :param order_type:
+        :param order_type: object
         :return: Response
         """
         self.parameters['orderType'] = json.dumps(order_type)
@@ -400,7 +399,7 @@ class Client(Base):
 
     def payment_statuses_edit(self, payment_status):
         """
-        :param payment_status:
+        :param payment_status: object
         :return: Response
         """
         self.parameters['paymentStatus'] = json.dumps(payment_status)
@@ -432,7 +431,7 @@ class Client(Base):
 
     def price_types_edit(self, price_type):
         """
-        :param price_type:
+        :param price_type: object
         :return: Response
         """
         self.parameters['priceType'] = json.dumps(price_type)
@@ -448,7 +447,7 @@ class Client(Base):
 
     def product_statuses_edit(self, product_status):
         """
-        :param product_status:
+        :param product_status: object
         :return: Response
         """
         self.parameters['productStatus'] = json.dumps(product_status)
@@ -464,7 +463,7 @@ class Client(Base):
 
     def sites_edit(self, site):
         """
-        :param site:
+        :param site: object
         :return: Response
         """
         self.parameters['site'] = json.dumps(site)
@@ -487,7 +486,7 @@ class Client(Base):
 
     def statuses_edit(self, status):
         """
-        :param status:
+        :param status: object
         :return: Response
         """
         self.parameters['status'] = json.dumps(status)
@@ -503,18 +502,18 @@ class Client(Base):
 
     def stores_edit(self, store):
         """
-        :param store:
+        :param store: object
         :return: Response
         """
-        self.parameters['status'] = json.dumps(store)
+        self.parameters['store'] = json.dumps(store)
 
         return self.post('/reference/stores/' + store['code'] + '/edit')
 
     def inventories(self, filters=None, limit=20, page=1):
         """
-        :param filters:
-        :param limit:
-        :param page:
+        :param filters: object
+        :param limit: integer
+        :param page: integer
         :return: Response
         """
         self.parameters['filter'] = filters
@@ -523,18 +522,22 @@ class Client(Base):
 
         return self.get('/store/inventories')
 
-    def inventories_upload(self, offers):
+    def inventories_upload(self, offers, site=None):
         """
-        :param offers:
+        :param offers: array of objects
+        :param site: string
         :return: Response
         """
+        if site is not None:
+            self.parameters['site'] = site
+
         self.parameters['offers'] = json.dumps(offers)
 
         return self.post('/store/inventories/upload')
 
     def prices_upload(self, prices):
         """
-        :param prices:
+        :param prices: array of objects
         :return: Response
         """
         self.parameters['prices'] = json.dumps(prices)
@@ -543,7 +546,7 @@ class Client(Base):
 
     def products(self, filters=None, limit=20, page=1):
         """
-        :param filters: array
+        :param filters: object
         :param limit: integer
         :param page: integer
         :return: Response
@@ -556,7 +559,7 @@ class Client(Base):
 
     def store_setting(self, code):
         """
-        :param code:
+        :param code: string
         :return: Response
         """
 
@@ -564,16 +567,16 @@ class Client(Base):
 
     def store_setting_edit(self, configuration):
         """
-        :param configuration::
+        :param configuration: object
         :return: Response
         """
         self.parameters['configuration'] = json.dumps(configuration)
 
-        return self.post('/store/setting/' + str(configuration['code'])) + '/edit'
+        return self.post('/store/setting/' + str(configuration['code']) + '/edit')
 
     def telephony_call_event(self, event):
         """
-        :param event:
+        :param event: object
         :return: Response
         """
         self.parameters['event'] = json.dumps(event)
@@ -582,27 +585,29 @@ class Client(Base):
 
     def telephony_calls_upload(self, calls):
         """
-        :param calls:
+        :param calls: array of objects
         :return: Response
         """
         self.parameters['calls'] = json.dumps(calls)
 
         return self.post('/telephony/calls/upload')
 
-    def telephony_manager(self, phone, details=True):
+    def telephony_manager(self, phone, details=True, ignore_status=False):
         """
-        :param phone:
-        :param details:
+        :param phone: string
+        :param details: string
+        :param ignore_status: string
         :return: Response
         """
         self.parameters['phone'] = phone
         self.parameters['details'] = details
+        self.parameters['ignoreStatus'] = ignore_status
 
         return self.get('/telephony/manager')
 
     def telephony_setting(self, code):
         """
-        :param code:
+        :param code: string
         :return: Response
         """
 
@@ -610,12 +615,12 @@ class Client(Base):
 
     def telephony_setting_edit(self, configuration):
         """
-        :param configuration::
+        :param configuration: object
         :return: Response
         """
         self.parameters['configuration'] = json.dumps(configuration)
 
-        return self.post('/telephony/setting/' + str(configuration['code'])) + '/edit'
+        return self.post('/telephony/setting/' + str(configuration['code']) + '/edit')
 
     def user_groups(self, limit=20, page=1):
         """
@@ -630,7 +635,7 @@ class Client(Base):
 
     def users(self, filters=None, limit=20, page=1):
         """
-        :param filters: array
+        :param filters: object
         :param limit: integer
         :param page: integer
         :return: Response
@@ -643,8 +648,15 @@ class Client(Base):
 
     def user(self, uid):
         """
-        :param uid:
+        :param uid: integer
         :return: Response
         """
 
         return self.get('/users/' + str(uid))
+
+    def statistic_update(self):
+        """
+        :return: Response
+        """
+
+        return self.get('/statistic/update')

setup.py

@@ -8,24 +8,24 @@ import os
 from setuptools import setup
 
 
-def read(fname):
+def read(filename):
     """Read readme for long description"""
-    return open(os.path.join(os.path.dirname(__file__), fname)).read()
+    return open(os.path.join(os.path.dirname(__file__), filename)).read()
 
 
 setup(
     name='retailcrm',
-    version='5.0.0',
-    description='retailCRM API client',
-    long_description=read('README.md'),
+    version='5.1.2',
+    description='RetailCRM API client',
+    long_description=read('README'),
     url='https://github.com/retailcrm/api-client-python',
-    author='retailCRM',
-    author_email='integration@retailcrm.ru',
-    keywords='crm, saas, rest, e-commerce',
+    author='RetailCRM',
+    author_email='support@retailcrm.pro',
+    keywords='crm saas rest e-commerce',
     license='MIT',
-    packages=['retailcrm', 'tests'],
+    packages=['retailcrm', 'retailcrm/versions'],
     package_data={},
-    install_requires=['requests', 'multidimensional_urlencode', 'nose'],
+    install_requires=['requests', 'multidimensional_urlencode', 'nose', 'coverage', 'pook', 'setuptools'],
     classifiers=[
         'Development Status :: 5 - Production/Stable',
         'Environment :: Other Environment',
@@ -34,9 +34,11 @@ setup(
         'Operating System :: OS Independent',
         'Programming Language :: Python',
         'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3.4',
-        'Programming Language :: Python :: 3.5',
-        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
         'Programming Language :: Python :: 3 :: Only',
         'Topic :: Software Development :: Libraries :: Python Modules',
     ]