Skip to main content

Python SDK for OnlineKacca

Project description

Библиотека для интеграции вашего сайта с с облачным сервисом распределенной печати чеков OnlineКасса

https://img.shields.io/travis/Motmom/komtet-kassa-python-sdk.svg?style=flat-square

Установка

С помощью pip:

# pip install komtet_kassa_sdk

Вручную:

$ git clone https://github.com/Motmom/komtet-kassa-python-sdk
$ cd komtet-kassa-python-sdk
# python setup.py install

Использование

  1. При старте вашего веб-приложения необходимо сконфигурировать пакет, подобно следующему коду:
from komtet_kassa_sdk import configure

configure({
    'shop_key': 'YoUr_sHOp_Key',
    'shop_secret': 'yoUR_sHop_SecReT',
    'named_queues': {
        '__default__': 231,
        'first': 123,
        'second': 231
    }
})

Здесь основными двумя настройками являются shop_key и shop_secret, которые выдаются вам при регистрации интернет магазина на сервисе OnlineКасса. Третий необязательный параметр named_queues, с помощью которого вы можете задать очередь для печати по умолчанию или их человекочетаемые именования.

  1. Создание чека для отправки на печать
from komtet_kassa_sdk import Check

check = Check(
    task_id='t00123',
    positions=[{
        'name': 'капуста',
        'price': 150
    }, {
        'name': 'молоко',
        'price': 152.5,
        'quantity': 2
    }],
    payment=455,
    user_email='user_email_to_send_check@mail.ru'
)

Основные параметры чека:

ключ тип описание
task_id string уникальный идентификатор предоставляемый интернет магазином
user_email string email клиента интернет магазина, на который будет отправлено письмо с электронным чеком
positions list позиции в чеке
payment int, float, dict итоговая сумма расчета
intent one of: SELL, SELL_RETURN признак расчета чека: приход или возврат, по умолчанию SELL
is_print bool параметр отвечающий за печать чека, по умолчанию False

Параметры итоговой суммы расчета:

ключ тип описание
type one of: CARD, CASH форма расчета, по умолчанию CARD
sum int, float сумма расчета

Параметры позиции по чеку:

ключ тип описание
name string наименование товара или услуги
price int, float цена за единицу
quantity int, float количество, по умолчанию 1
total int, float сумма по позиции, по умолчанию price * quantity
vat dict система налогооблажения

Параметры налога:

ключ тип описание
number one of: WITHOUT_VAT, VAT0, VAT10, VAT18, VAT110, VAT118 тип налогооблажения
sum int, float сумма налога

Примечание: по умолчанию налог на позицию

from cloud_kassa_sdk import WITHOUT_VAT
{
    'number': WITHOUT_VAT,
    'sum': 0
}
  1. Отправка чека на печать
check.print_out(123)

Требуется указать идентификатор очереди печати. Если пакет был сконфигурирован с ключом named_queues, то можно воспользоваться одним из следующих вариантов:

  • отправка в очередь по умолчанию, при условии что указан ключ __default__
check.print_out()
  • отправка в очередь с человекочитаемым названием
check.print_out('first')

Changelog

0.1.0 (19.06.2017)

  • Первый релиз

Project details


Release history Release notifications

History Node

0.4.0

History Node

0.3.0

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.6

History Node

0.1.4

History Node

0.1.1

This version
History Node

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
komtet_kassa_sdk-0.1.0.tar.gz (9.1 kB) Copy SHA256 hash SHA256 Source None Jun 19, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page