api.nisa.digital
2025-08-28

Comprehensive guide to our Pohoda/Pamica endpoints

/v1/reports/general_ledger/:uid

List general ledger summary.
Example
/v1/reports/general_ledger/88899460-4d0b-421b8d67-2023?from=2024-01-01&to=2024-12-31
Params
:uid - accounting unit identifier
Request
GET
Response
200text/json

{
   Ucet: string, account number
   Nazev: string, account name
   typ: number
   zmd: number, opening debit
   zdal: number, opening credit
   md: number, debit
   dal: number, credit
   kmd: number, closing debit
   kdal: number, closing credit
   Datum: string, YYYY-MM-DD
}[]
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/general_ledger/:uid/:account

List general ledger entries for an account.
Example
/v1/reports/general_ledger/88899460-4d0b-421b8d67-2023/311?from=2024-01-01&to=2024-12-31
Params
:uid - accounting unit identifier
:account - account number
Request
GET
Response
200text/json

{
   Datum?: string, YYYY-MM-DD
   Cislo: string, document number
   PDoklad?: number|null, internal id
   Firma?: string, company
   SText?: string, description
   UD: string, debit account
   UMD: string, credit account
   Kc: number, amount
   Dir?: string, direction
}[]
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/journal/:uid

List journal entries with server-side filtering and pagination.
Example
/v1/reports/journal/88899460-4d0b-421b8d67-2023
Params
:uid - accounting unit identifier
Request
POSTtext/json
{
  from?: number,       // default 0
  size?: number,       // default 30
  ids?: number[],      // optional: restrict to IDs
  asc?: string,        // optional: sort asc, e.g. "Datum;ID"
  desc?: string,       // optional: sort desc, e.g. "Datum;ID"
  on?: string[]        // optional filters, tokens "Field;search;from;to"
}
Response
200text/json
{
  total: number,
  filtered: number,
  fields: DField[],
  data: any[],
  summary: { [key: string]: number },
  query: DQuery
}

DField = {
  name: string,
  text?: string,
  sort?: 'asc'|'desc'|'',
  // simple values (one of these may be present)
  string?: string|null,
  number?: number|null,
  numbers?: number[],
  date?: string|null,          // ISO YYYY-MM-DD
  checkbox?: boolean|null,
  select?: { // select-like inputs
    type: 'number'|'date'|'string',
    value?: any|null,
    options: { value: any, text: string }[]
  },
  checkbuttons?: { // select-like inputs
    type: 'number'|'string',
    value?: any|null,
    options: { value: any, text: string }[]
  },
  checkboxes?: { // select-like inputs
    type: 'number'|'date'|'string'|'number[]'|'string[]',
    values?: any[],
    options: { value: any, text: string }[],
    classInput?: string
  },
  range?: { // ranges and validity
    type: 'number'|'date',
    nullable?: boolean,
    from?: number|string|Date|null,
    to?: number|string|Date|null
  },
  valid_until?: {
    type: 'date',
    nullable?: boolean,
    value?: string|Date|null
  }
}

DQuery = {
  from: number,
  size: number,
  init?: number,
  fields: DField[]
}
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/costs_revenues_by_account/:uid

List costs and revenues by account.
Example
/v1/reports/costs_revenues_by_account/88899460-4d0b-421b8d67-2023?account=5&from=2024-01-01&to=2024-12-31
Params
:uid - accounting unit identifier
Request
GET
Response
200text/json

{
   Datum: string, YYYY-MM-DD
   RelTpFak?: number, invoice type
   PDoklad?: number, internal id
   Cislo?: string, document number
   SKPP_Cislo?: string
   SKPP_SText?: string
   SKPV_Cislo?: string
   SKPV_SText?: string
   Firma?: string
   Jmeno?: string
   SText?: string
   UD: string
   UMD: string
   Kc: number
   RelUdAg: number
   Dir?: string
}[]
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/monthly_statement/:uid

Compute monthly statement for selected accounts.
Example
/v1/reports/monthly_statement/88899460-4d0b-421b8d67-2023
Params
:uid - accounting unit identifier
Request
POSTtext/json
{
  from?: string,       // ISO date YYYY-MM-DD
  to?: string,         // ISO date YYYY-MM-DD
  ucty: string[],      // required: account numbers/prefixes
  stredisko?: number,  // optional: centre ID
  cinnost?: number,    // optional: activity ID
  zakazka?: string     // optional: order number
}
Response
200text/json

{
   Datum: string, YYYY-MM-DD
   UD: string
   UMD: string
   Kc: number
}[]
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/highest_bank/:uid

Get bank summary for current and previous month.
Example
/v1/reports/highest_bank/88899460-4d0b-421b8d67-2023
Params
:uid - accounting unit identifier
Request
GET
Response
200text/json

{
   Bank: string, bank name
   Bank_ID: number|string, bank id
   CurrentMonthTotal: number
   PreviousMonthTotal: number
   period_to: string, YYYY-MM-DD
}
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/highest_cash/:uid

Get cash summary for current and previous month.
Example
/v1/reports/highest_cash/88899460-4d0b-421b8d67-2023
Params
:uid - accounting unit identifier
Request
GET
Response
200text/json

{
   Cash: string, cash name
   Cash_ID: number|string, cash id
   CurrentMonthTotal: number
   PreviousMonthTotal: number
   period_to: string, YYYY-MM-DD
}
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/statistics/:uid

Get company statistics.
Example
/v1/reports/statistics/88899460-4d0b-421b8d67-2023?current_year_db=true
Params
:uid - accounting unit identifier
Request
GET
Response
200text/json

{
   PayablesTotal: number
   PayablesIn3Days: number
   PayablesOverduted30Days: number
   ReceivablesTotal: number
   ReceivablesIn3Days: number
   ReceivablesOverduted30Days: number
   danNaVystupe: number
   danNaVstupe: number
   predbeznaDPH: number
   bank_name: string
   bank_id: string|number
   bank_current_total: number
   bank_previous_total: number
   bank_period_to: string, YYYY-MM-DD
   cash_name: string
   cash_id: string|number
   cash_current_total: number
   cash_previous_total: number
   cash_period_to: string, YYYY-MM-DD
   period_to: string, YYYY-MM-DD
   is_current_year_or_newer: 'True'|'False'
}
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/income_tax/:uid

List corporate income tax inputs.
Example
/v1/reports/income_tax/88899460-4d0b-421b8d67-2023?from=2024-01-01&to=2024-12-31
Params
:uid - accounting unit identifier
Request
GET
Response
200text/json

{
   revenues: { ID: number, account: string, name: string }[]
   expenses: { ID: number, account: string, name: string }[]
   revenues_ud: { ID: number, sum: number, UD: string }[]
   revenues_umd: { ID: number, sum: number, UMD: string }[]
   cost_ud: { ID: number, sum: number, UD: string }[]
   cost_umd: { ID: number, sum: number, UMD: string }[]
}
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/income_tax/:uid/:account

List corporate income tax entries for an account.
Example
/v1/reports/income_tax/88899460-4d0b-421b8d67-2023/518?from=2024-01-01&to=2024-12-31
Params
:uid - accounting unit identifier
:account - account number
Request
GET
Response
200text/json

{
   Datum: string, YYYY-MM-DD
   Firma: string
   SText: string
   UD: string
   UMD: string
   Cislo: string
   Kc: number
   Dir?: string
}[]
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/overview/:uid

Compute profitability overview.
Example
/v1/reports/overview/88899460-4d0b-421b8d67-2023
Params
:uid - accounting unit identifier
Request
POSTtext/json
{
  centre?: number,              // optional: centre ID
  cinnost?: number,             // optional: activity ID
  cislo_zak?: string,           // optional: order number
  RelTpFak?: number[],          // optional: invoice types [1,2,3,4,5,6,11,12,13,14,15,16]
  InvoiceType?: number,         // optional: one of RelTpFak (affects sign)
  dateTo?: string,              // optional: ISO date YYYY-MM-DD
  dateFrom?: string,            // optional: ISO date YYYY-MM-DD
  from?: number,                // optional: days lower bound, default 0
  to?: number                   // optional: days upper bound, default 100
}
Response
200text/json
{ sum: number, count: number }
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/overview/:uid/items

List items contributing to profitability overview.
Example
/v1/reports/overview/88899460-4d0b-421b8d67-2023/items
Params
:uid - accounting unit identifier
Request
POSTtext/json
{
  centre?: number,
  cinnost?: number,
  cislo_zak?: string,
  RelTpFak?: number[],
  InvoiceType?: number,
  dateTo?: string,             // ISO date YYYY-MM-DD
  dateFrom?: string,           // ISO date YYYY-MM-DD
  percentage: string           // one of: '30','360','720','1080'
}
Response
200text/json

{
   Cislo: string, document number
   PDoklad: string, internal id
   Datum: string, YYYY-MM-DD
   DatSplat: string, due date YYYY-MM-DD
   Days: number, overdue days
   Firma: string
   SText: string
   KcCelkem: number, total
   KcLikv: number, paid
   Taxable: number
}[]
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/selected_services/:uid

Compute KPIs for selected services.
Example
/v1/reports/selected_services/88899460-4d0b-421b8d67-2023
Params
:uid - accounting unit identifier
Request
POSTtext/json
{
  centre?: number,
  cinnost?: number,
  cislo_zak?: string,
  RelTpFak?: number[],         // invoice types [1,2,3,4,5,6,11,12,13,14,15,16]
  InvoiceType?: number,
  dateTo?: string,             // ISO date YYYY-MM-DD
  dateFrom?: string,           // ISO date YYYY-MM-DD
  type: 'N'|'P'|'S'|'C'|'l'    // required: service code
}
Response
200text/json
{ sum: number }
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later

/v1/reports/selected_services/:uid/items

List items for selected services KPIs.
Example
/v1/reports/selected_services/88899460-4d0b-421b8d67-2023/items
Params
:uid - accounting unit identifier
Request
POSTtext/json
{
  centre?: number,
  cinnost?: number,
  cislo_zak?: string,
  RelTpFak?: number[],
  InvoiceType?: number,
  dateTo?: string,             // ISO date YYYY-MM-DD
  dateFrom?: string,           // ISO date YYYY-MM-DD
  type: 'N'|'P'|'S'|'C'|'l'    // required: service code
}
Response
200text/json

{
   Cislo: string, document number
   PDoklad: string, internal id
   Datum: string, YYYY-MM-DD
   DatSplat: string, due date YYYY-MM-DD
   Firma: string
   SText: string
   KcCelkem: number, total
   KcLikv: number, paid
   Taxable: number
}[]
Error Codes
400 Bad Request
Your request doesn't meet the required input format
401 Not Authorized
Your request doesn't meet authorization requirements
404 Not Found
The entity you're looking for is missing
460 Request Error
Requested operation wasn't performed, or XML import failed
500 Internal Error
We encountered an internal server error
503 Not Available
Requested entity is offline and cannot be reached, try again later