Overview
Popis connects to your business software (ERP, accounting, web shop) through a REST API, so you don't enter the codebooks twice and count results reach your software by themselves. There are two ways; the company administrator picks one in the portal under Settings → API Sync.
| Way | Who calls whom | What is exchanged | Guide |
|---|---|---|---|
| They access our API | Your software calls Popis | Your software sends items, fixed assets, locations and warehouses and reads count results | The Popis API |
| We pull from their API | Popis calls your software | Popis fetches the codebooks from your API and, optionally, sends a report as soon as a count is completed | Your API |
If your software already has an API, the second way is usually quicker to start with: your API only has to return data in the format Popis expects. If your software can send data by itself (e.g. a nightly job), use the first way.
API reference
Every call of the Popis API, and every call Popis makes to your API, with all the fields, examples and a Try it button for test calls, is on apidocs.popis.pro. The same description in machine-readable form (OpenAPI 3.1, e.g. for Postman): https://apidocs.popis.pro/en/openapi.json.
Warning
The API token reaches the company's data with the rights of the main user. Keep it like a password: don't email it and don't put it in code that is public. If you think it has leaked, click Regenerate Token in the portal — the old one stops working at once.

