---
title: "GET_T03_LIST"
url: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest/get_t03_list"
updated: "2026-02-10"
parent: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest.md"
---

# GET_T03_LIST

### Aprašymas

Suminių klientų/tiekėjų skolų informacija

### Specifikacija

> **Informacija:** Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: **[Rivile API v2 naudojimo pagrindai](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/naudojimo_pagrindai.md)**

##### Body

* `method` : `GET_T03_LIST`
* `params` :
  * `list`: gražinamų duomenų detalumas
      - `H` - kliento lygyje
      - `A` - kliento, dok.nr., datos, valiutos lygyje
  * `fil` :  filtravimo sąlyga. T-SQL tipo where sąlygos užklausa iš lentelės [T03](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/get_t03_list.md#t03) nenurodant pačio where tag'o. Neprivaloma
  * `pagenumber`: įrašų puslapio numeris. GET_LIST metodai rezultatus grąžina puslapiais po 100 įrašų, `pagenumber` parametras nurodo kelintą puslapį grąžinti. Jei nenurodomas, tuomet grąžinamas pirmas puslapis su 100 naujausių įrašų. Neprivaloma

> **Informacija:** Sąraše su daugiau nei 1 įrašu informacija visada grąžinama surūšiuota pagal atitinkamos lentelės raktą (Primary Key)

> **Dėmesio:** GET_LIST metodų apribojima 100 įrašų, todėl norint gauti visą sąrašą, turite naudoti filtrus, kurie grąžins rezultatą dalimis per kelis kartus, filtruojant pagal paskutinio gauto įrašo rakto reikšmę.

**pvz** `application/xml`:

```xml
<body>
    <method>GET_T03_LIST</method>
    <params>
        <list>H</list>
    	<fil>t03_kodas_ks=' 110065392 '</fil>
    </params>
</body>
```

**pvz ** `application/json`:

```json
{
    "method": "GET_T03_LIST",
    "params": {
        "list":"H",
        "fil": "t03_kodas_ks=' 110065392 '"
    }
}
```

##### Response (status 200 OK)

Grąžinama informacija XML formate tarp tag'ų `<RET_DOK>..</RET_DOK>`. 
Jeigu įrašų nerasta pagal užduotas sąlygas, tuomet gražinama status=200 bei tuščias <RET_DOK> tag'as

**pvz**, kai `list='A'`:

Esant daugiau nei vienam įrašui informacija rūšiuojama (order) pagal lentelės raktinį lauką `t03_kodas_ks,t03_dok_nr,t03_data_mok,t03_kodas_vl`

```xml
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
    <T03>
        <Row_number>1</Row_number>
        <t03_kodas_ks> 110065392 </t03_kodas_ks>
        <t03_dok_nr>LIKUTIS </t03_dok_nr>
        <t03_data_mok>2008-12-31T00:00:00</t03_data_mok>
        <t03_kodas_vl>LIT </t03_kodas_vl>
        <t03_suma_db_vl>0.00</t03_suma_db_vl>
        <t03_suma_cr_vl>7200.00</t03_suma_cr_vl>
        <t03_suma_db>0.00</t03_suma_db>
        <t03_suma_cr>7200.00</t03_suma_cr>
    </T03>
</RET_DOK>
```

**pvz**, kai `list='H'`:

Esant daugiau nei vienam įrašui informacija rūšiuojama (order) pagal lentelės raktinį lauką `t03_kodas_ks`

```xml
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
	<T03>
        <Row_number>1</Row_number>
		<t03_kodas_ks> 110065392 </t03_kodas_ks>
		<t03_suma_db_vl>0.00</t03_suma_db_vl>
		<t03_suma_cr_vl>7200.00</t03_suma_cr_vl>
		<t03_suma_db>0.00</t03_suma_db>
		<t03_suma_cr>7200.00</t03_suma_cr>
	</T03>
</RET_DOK>
```

##### Response (status 400)

Klaida paduodant duomenis / SQL sintaksės klaidos / kitos DB klaidos

```xml
<RET_DOK type="error">
    <id>2552c6d.dd81a1c1580324646507</id>
    <durationMs>53</durationMs>
    <errorMessage>Invalid column name 't03_kodas_k'.</errorMessage>
</RET_DOK>
```



### Lentelės

#### T03

Suminė skolų klientų/tiekėjų informacija.

| Laukas           | Tipas  | Aprašymas                           | Pastabos |
| ---------------- | ------ | ----------------------------------- | ------------------------------- |
|T03_KODAS_KS|C(12)|Kliento kodas| |
|T03_DOK_NR|C(20)|Dokumento numeris| Gražinamas, kai list=`A` |
|T03_DATA_MOK|T(8)|Mokėjimo data| Gražinamas, kai list=`A` |
|T03_KODAS_VL|C(12)|Valiutos kodas| Gražinamas, kai list=`A` |
|T03_SUMA_DB_VL|N(18,2)|Suma debete valiuta| |
|T03_SUMA_CR_VL|N(18,2)|Suma kredite valiuta| |
|T03_SUMA_DB|N(12,2)|Suma debete| |
|T03_SUMA_CR|N(12,2)|Suma kredite| |