Integrify Clopos
[!Caution] Integrify is unofficial library, even though it is based on official documentation.
Integrify is a library that simplifies API integrations. This library is designed for Clopos integration.
Documentation: https://integrify.mmzeynalli.dev/integrations/clopos/about/
Source code: https://github.com/Integrify-SDK/integrify-clopos-python
Official Documentation (v1.0.1)
Main functionalities
- Library supports both sync and async requests.
- All of the function and classes has been documented.
- As all of the functions/variables/classes has been typed, type-hinting is active
- The flow of the requests has been explained in the documentation.
Installing
pip install integrify-clopos
Usage
To use these requests you need to set these environmental variables:
| Variable Name | Purpose | Header equivalent | Default Value |
|---|---|---|---|
CLOPOS_CLIENT_ID |
Client ID given by Clopos (used only for auth) | - |
- |
CLOPOS_CLIENT_SECRET |
Client Secret given by Clopos (used only for auth) | - |
- |
CLOPOS_BRAND |
Brand that you want to request | x-brand |
- |
CLOPOS_VENUE_ID |
Venue/Branch id that you want to request | x-venue |
- |
Note that, these values MIGHT be unset. In this case, you should send it in header of each request. Let's say you want to request menu categories of two venues separately:
# CLOPOS_CLIENT_ID, CLOPOS_CLIENT_SECRET and CLOPOS_BRAND have been set as env variables
from integrify.clopos.client import CloposClient
venue1_id=1
venue2_id=2
token1 = CloposClient.auth(venue_id=venue1_id).body.token
categories1 = CloposClient.get_categories(headers={'x-token': token1, 'x-venue': venue1_id}).body.data
token2 = CloposClient.auth(venue_id=venue2_id).body.token
categories2 = CloposClient.get_categories(headers={'x-token': token1, 'x-venue': venue2_id}).body.data
If you want to fetch categories from different brand, just manually add x-brand to the header.
For auth, instead of headers, you will just send these as params.
# No env was set
from integrify.clopos.client import CloposClient
client_id='eNUKI04aYJRU6TBhh5bwUrvmEORgQoxM'
client_secret='dqYkWUpDjzvKOgbP3ar8tSNKJbwMyYe1V5R7DHClfSNYkap5C5XxRA6PmzoPv1I2'
brand='openapitest'
venue_id='1'
token = CloposClient.auth(client_id=client_id, client_secret=client_secret, brand=brand, venue_id=venue_id).body.token
List of requests
| Request function | Purpose | Clopos API |
|---|---|---|
auth |
Authenticate, get token | /open-api/auth |
get_venues |
Get list of venues/branches | /open-api/venues |
get_users |
Get list of users | /open-api/users |
get_user_by_id |
Get user by id | /open-api/users/{id} |
get_customers |
Get list of customers | /open-api/customers |
get_customer_by_id |
Get customer by id | /open-api/customers/{id} |
get_customer_groups |
Get list of customer groups | /open-api/customer-group |
get_categories |
Get list of menu categories | /open-api/categories |
get_category_by_id |
Get menu category by id | /open-api/categories/{id} |
get_stations |
Get list of stations | /open-api/stations |
get_station_by_id |
Get station by id | /open-api/stations/{id} |
get_products |
Get list of products | /open-api/products |
get_product_by_id |
Get product by id | /open-api/products/{id} |
get_sale_types |
Get list of sale types | /open-api/sale-types |
get_payment_methods |
Get list of payment methods | /open-api/payment-methods |
get_orders |
Get list of orders | /open-api/orders |
get_order_by_id |
Get order by id | /open-api/orders/{id} |
create_order |
Create new order | /open-api/orders |
get_receipts |
Get list of receipts | /open-api/receipts |
get_receipt_by_id |
Get receipt by id | /open-api/receipts/{id} |
create_receipt |
Create a new receipt | /open-api/receipts |
delete_receipt |
Delete a receipt | /open-api/receipts/{id} |
Note that, each request should have parameter headers={'x-token': token}. For example:
# CLOPOS_CLIENT_ID, CLOPOS_CLIENT_SECRET, CLOPOS_BRAND and CLOPOS_VENUE_ID have been set as env variables
from integrify.clopos.client import CloposClient
token = CloposClient.auth().body.token
user = CloposClient.get_user_by_id(id=1, headers={'x-token': token}).body.data
[!Caution] Integrify is unofficial library, even though it is based on official documentation.
Other supported integrations
| Servis | Əsas sorğular | Bütün sorğular | Dokumentləşdirilmə | Real mühitdə test | Əsas developer |
|---|---|---|---|---|---|
| EPoint | ✅ | Tam | ✅ | Miradil Zeynallı | |
| KapitalBank | ✅ | ✅ | Tam | ✅ | Zaman Kazımov |
| LSIM | ✅ | ✅ | Tam | ✅ | Miradil Zeynallı |
| Posta Guvercini | ✅ | ✅ | Tam | ✅ | Zaman Kazımov |
| Azericard | ✅ | Tam | Miradil Zeynallı | ||
| Clopos | ✅ | ✅ | Full | Miradil Zeynallı | |
| Payriff | Vahid Həsənzadə |
Metadata
Release files for integrify-clopos 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| integrify_clopos-0.1.0.tar.gz | 37.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| integrify_clopos-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 85.4 kB
Release files / integrify_clopos-0.1.0.tar.gz
| Download URL | integrify_clopos-0.1.0.tar.gz |
|---|---|
| Size | 37.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
903b2dffbbf5685674f2a5dc79198afbff9319708ef9465b820f4735a116357a
|
|
BLAKE2b-256 checksum How to use checksums |
5b9bb12b2761e11b731a64f914c1263ea46af036a66b8889308b68c46193a205
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 11, 2026.
Transparency logRelease files / integrify_clopos-0.1.0-py3-none-any.whl
| Download URL | integrify_clopos-0.1.0-py3-none-any.whl |
|---|---|
| Size | 47.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a0e78304f3cb5bcff3be13afc273b30454c2179490980ac15f46e27a3bd47f56
|
|
BLAKE2b-256 checksum How to use checksums |
79c739bdaff98d25abfbf453fe69d25471f205a839a1bb9ff64405142cdb09a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 11, 2026.
Transparency log