Recon act

INFO

Every response arrives in the shared envelope — code, message, messages, status_code, time — with the payload in data. The tables below describe what is inside data.

GET /recon-act/get-by-id/{id}

Get a reconciliation act by its _id.

Path parameters

Parameter	Type	Required	Description
id	string	Yes

Request body

No request body.

Response

Field	Type	Description
_id	string
number	string
organization_id	string
customer_id	string
supplier_id	string
employee_id	string
person_id	string
type	string	One of: debt, credit
balance_action	string	One of: separated, merged
state	string	One of: new, done, canceled
amount	number
currency_id	string
after_balance	object	Per-currency balance snapshot map.
invoice	object
invoice._id	string
invoice.number	string
payment_type	object
payment_type._id	string
payment_type.name	string
created_at	string (date-time)
updated_at	string (date-time)

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "_id": "string",
    "number": "string",
    "organization_id": "string",
    "customer_id": "string",
    "supplier_id": "string",
    "employee_id": "string",
    "person_id": "string",
    "type": "debt",
    "balance_action": "separated",
    "state": "new",
    "amount": 0,
    "currency_id": "string",
    "after_balance": {},
    "invoice": {
      "_id": "string",
      "number": "string"
    },
    "payment_type": {
      "_id": "string",
      "name": "string"
    },
    "created_at": "2025-05-01T12:00:00Z",
    "updated_at": "2025-05-01T12:00:00Z"
  },
  "time": "2025-05-01T12:00:00Z"
}

POST /recon-act/get-all

Get reconciliation acts for a customer / supplier / employee / person within a date range.

Request body

Field	Type	Required	Description
page	number	Yes	Default: 1
limit	number	Yes	Default: 20
organization_id	string	No
customer_id	string	No	One of customer_id / supplier_id / employee_id / person_id must be set.
supplier_id	string	No
employee_id	string	No
person_id	string	No
date_from	string (date-time)	No
date_to	string (date-time)	No
states	string[]	No
locale	string	No	One of: uz, ru, en, kk, ky, tg

{
  "page": 1,
  "limit": 20,
  "organization_id": "64b7f4d9e2b3b6a0b7c5d80a",
  "customer_id": "string",
  "supplier_id": "string",
  "employee_id": "string",
  "person_id": "string",
  "date_from": "2025-05-01T12:00:00Z",
  "date_to": "2025-05-01T12:00:00Z",
  "states": [
    "new"
  ],
  "locale": "uz"
}

Response

Field	Type	Description
data	any[]
before_balance	object	Per-currency balance at date_from.
after_balance	object	Per-currency balance at date_to.

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "data": [],
    "before_balance": {},
    "after_balance": {}
  },
  "time": "2025-05-01T12:00:00Z"
}

POST /recon-act/get-all/export

Export reconciliation acts as XLSX/CSV. Returns a download path.

Request body

Field	Type	Required	Description
page	number	Yes	Default: 1
limit	number	Yes	Default: 20
organization_id	string	No
customer_id	string	No	One of customer_id / supplier_id / employee_id / person_id must be set.
supplier_id	string	No
employee_id	string	No
person_id	string	No
date_from	string (date-time)	No
date_to	string (date-time)	No
states	string[]	No
locale	string	No	One of: uz, ru, en, kk, ky, tg
ext_type	string	Yes	One of: xlsx, csv

{
  "page": 1,
  "limit": 20,
  "organization_id": "64b7f4d9e2b3b6a0b7c5d80a",
  "customer_id": "string",
  "supplier_id": "string",
  "employee_id": "string",
  "person_id": "string",
  "date_from": "2025-05-01T12:00:00Z",
  "date_to": "2025-05-01T12:00:00Z",
  "states": [
    "new"
  ],
  "locale": "uz",
  "ext_type": "xlsx"
}

Response

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": "string",
  "time": "2025-05-01T12:00:00Z"
}

---

This page is generated from the OpenAPI spec.