Agent Mobile API
Base URL: https://erp-api.qoshdev.work
Web preview: https://erp-agent-mobile.qoshdev.work
Auth: Bearer only — без HttpOnly cookie
Тестовый агент (dev)
POST /auth/signin
{ "login": "agent1783453", "password": "agent123" }
Auth
| Method | Path | Описание |
|---|
| POST | /auth/signin | login + password → tokens |
| POST | /auth/refresh | header token (refresh) |
Профиль
| GET/PATCH | /me/employees/me |
|---|
Клиенты
| GET | /client | page, limit, search, havent_pay |
|---|
| GET/POST/PATCH | /client/:id |
|---|
| GET | /client/receipt/:id | PDF URL |
|---|
Заказы
| GET | /order | clientId, page, limit |
|---|
| GET/POST/PATCH | /order, /order/:id |
|---|
| PATCH | /order/status, /order/comment/:id |
|---|
| GET | /order/order-sum/:employeeId |
|---|
| GET | /order/pdf/:id |
|---|
Оплаты
| GET | /order/payment?clientId= | история оплат клиента |
|---|
| POST | /order/payment | создание оплаты |
|---|
| GET | /order/transaction/receipt/:id | чек PDF |
|---|
| GET | /finance/transactions | fallback: clientId, type=payment |
|---|
Маршрут / визиты
| GET | /field/stores |
|---|
| GET | /field/visits | page, limit |
|---|
| POST | /field/stores/:id/check-in | { notes? } |
|---|
| PUT | /field/visits/:id/check-out |
|---|
Отчёты (§10.7)
| GET | /agent/reports/sales | dateFrom, dateTo, days |
|---|
| GET | /agent/reports/receivables | дебиторка моих клиентов |
|---|
| GET | /agent/reports/visits | план/факт визитов |
|---|
| GET | /agent/reports/bonuses | история бонусов |
|---|
Товары и справочники
| GET | /product, /product/:id |
|---|
| POST | /product/many |
|---|
| GET | /category, /settings/currency |
|---|
| POST | /file-storage | multipart file |
|---|
Swagger: https://erp-api.qoshdev.work/api