Skip to content
On this page

/paydocument

Кінцева точка /paydocument відповідає за роботу з платіжними документами (банківські платежі та касові операції).

Методи

  • /paydocument/index - завантажити перелік платіжних документів
  • /paydocument/load - завантажити платіжний документ
  • /paydocument/update - створити або оновити платіжний документ

GET /paydocument/index/?{from}&{to}&{pageSize=100}&{offset=0}

Завантажує перелік платіжних документів за період.

Параметри запиту:

  • from - початок періоду (дата документа), формат 2026-01-01. Обов'язковий.
  • to - кінець періоду. Обов'язковий.
  • pageSize - розмір сторінки (1-100).
  • offset - зміщення ( > 0)
  • dateModified - необов'язковий фільтр: тільки документи, змінені починаючи з вказаної дати/часу. Зручно для інкрементальної синхронізації.
  • agent - необов'язковий фільтр: UID контрагента. Повертаються тільки платіжні документи цього контрагента. Якщо контрагента з таким UID немає - повертається пустий перелік.

Приклад: /paydocument/index?from=2026-09-01&to=2026-09-30&agent=d362cdfd-72d5-4906-889c-44152121c8b4

Повертає стандартну відповідь для індексу об'єктів PayDocument.

javascript
{
   "success" : true, 
   "totalCount": 10,
   "data": [ /* PayDocument */
		{ "uid": "...." }
	]
};
{
   "success" : true, 
   "totalCount": 10,
   "data": [ /* PayDocument */
		{ "uid": "...." }
	]
};

Зверніть увагу, що поле totalCount поверне загальну кількість платіжних документів за період (з урахуванням фільтрів dateModified та agent).

GET /paydocument/load/{uid}

Завантажує платіжний документ по його UID.

Параметри запиту:

  • uid - UID документа (в URL)

Повертає стандартну відповідь з об'єктом PayDocument.

json
{
   "success" : true, 
   "data": { /* PayDocument */
		"uid": "...."
	}
};
{
   "success" : true, 
   "data": { /* PayDocument */
		"uid": "...."
	}
};

POST /paydocument/update

Створює або оновлює властивості платіжного документа.

Тіло запита має бути обєктом PayDocument:

json
{
    "uid":"C259B17B-BFC8-48B9-A6A7-CEB1FD054413",
    "date":"2023-02-23",
    "type": "payFromCustomer",
    "no":"string",
    "sum": 100,
    "memo": "string",
    "agent": {
        "uid": "d362cdfd-72d5-4906-889c-44152121c8b4",
        "name": "string",
    }
}
{
    "uid":"C259B17B-BFC8-48B9-A6A7-CEB1FD054413",
    "date":"2023-02-23",
    "type": "payFromCustomer",
    "no":"string",
    "sum": 100,
    "memo": "string",
    "agent": {
        "uid": "d362cdfd-72d5-4906-889c-44152121c8b4",
        "name": "string",
    }
}

Зверніть увагу:

Повертає стандартну відповідь з об'єктом PayDocument.

Платіжний документ можна пов'язати зі звичайним документом (наприклад, оплату з рахунком) методом /document/linkto, а перевірити проведеність - методом /document/getdone.