Back to Gidas

EDIT_N41

internetiniai-underscore-moduliai-api-underscore-rest-edit-underscore-n41.md

latest6.0 KB
Original Source

PDF

Pradžia Internetiniai moduliai Rivile API v2 (REST web servisai) EDIT_N41

EDIT_N41

Aprašymas

Ilgalaikio turto grupės koregavimas.

Specifikacija

Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai

Body
  • method : EDIT_N41

  • params :

    • oper :
      • I - naujo įrašo sukūrimas
      • U - įrašo koregavimas
      • D - įrašo ištrynimas
  • data: perduodami duomenys:

    • N41 - atitinkamos lentelės laukai (N41)

pvz application/xml:

xml
<body>
    <method>EDIT_N41</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <N41>
            <N41_KODAS_GP>GP_API_001</N41_KODAS_GP>
            <N41_KODAS_SS_V>7</N41_KODAS_SS_V>
            <N41_KODAS_SS_N>7</N41_KODAS_SS_N>
            <N41_KODAS_SS_I>7</N41_KODAS_SS_I>
            <N41_KODAS_SS_P>7</N41_KODAS_SS_P>
            <N41_KOEF>33</N41_KOEF>
        </N41>
    </data>
</body>

pvz application/json:

json
{
    "method": "EDIT_N41",
    "params": {
        "oper": "I"
    },
    "data": {
        "N41": {
            "N41_KODAS_GP": "GP_API_001",
            "N41_KODAS_SS_V": "7",
            "N41_KODAS_SS_N": "7",
            "N41_KODAS_SS_I": "7",
            "N41_KODAS_SS_P": "7",
            "N41_KOEF": "33"
        }
    }
}
Response (status 200 OK)

Grąžinama informacija XML formate tarp tag'ų <RET_DOK>..</RET_DOK>.

pvz :

xml
<RET_DOK>
    <N41>
        <N41_KODAS_GP>GP_API_001</N41_KODAS_GP>
        <N41_PAV></N41_PAV>
        <N41_KOEF>33.0000</N41_KOEF>
        <N41_KODAS_SS_V>7</N41_KODAS_SS_V>
        <N41_KODAS_SS_N>7</N41_KODAS_SS_N>
        <N41_KODAS_SS_I>7</N41_KODAS_SS_I>
        <N41_KODAS_SS_P>7</N41_KODAS_SS_P>
        <N41_POZ_DATE>0</N41_POZ_DATE>
        <N41_BEG_DATE>2026-06-30 08:49:32.000</N41_BEG_DATE>
        <N41_END_DATE>2026-06-30 08:49:32.000</N41_END_DATE>
        <N41_USERIS>WS</N41_USERIS>
        <N41_R_DATE>2026-06-30 00:00:00.000</N41_R_DATE>
        <N41_ADDUSR>WS</N41_ADDUSR>
        <N41_KOEF_VAS>0.0000</N41_KOEF_VAS>
        <N41_KODAS_SS_V_VAS></N41_KODAS_SS_V_VAS>
        <N41_KODAS_SS_N_VAS></N41_KODAS_SS_N_VAS>
        <N41_KODAS_SS_I_VAS></N41_KODAS_SS_I_VAS>
        <N41_PAV_K1></N41_PAV_K1>
        <N41_PAV_K2></N41_PAV_K2>
        <N41_PAV_K3></N41_PAV_K3>
    </N41>
</RET_DOK>
Response (status 400)

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

xml
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id>4959678410.1eaec526.1782799200294</id>
    <durationMs>48</durationMs>
    <errorMessage>Nepavyko įvykdyti metodo</errorMessage>
    <document/>
    <errors>
        <error>
            <data>&lt;N41>&lt;num_row>1&lt;/num_row>&lt;N41_KODAS_SS_I>7&lt;/N41_KODAS_SS_I>&lt;N41_KOEF>33.0000&lt;/N41_KOEF>&lt;N41_KODAS_SS_V>7s&lt;/N41_KODAS_SS_V>&lt;N41_KODAS_SS_P>7&lt;/N41_KODAS_SS_P>&lt;N41_KODAS_GP>GP_API_001&lt;/N41_KODAS_GP>&lt;N41_KODAS_SS_N>7&lt;/N41_KODAS_SS_N>&lt;/N41></data>
            <dataErrors>
                <dataError>
                    <tag>N41_KODAS_SS_V</tag>
                    <code>32011</code>
                    <message>Nerasta sąskaita [7s]</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>
Koregavimas ir išmetimas

Koregavimas, išmetimas vyksta pagal lentelės raktą (Primary Key)

Koreguojant informaciją bus koreguojami tik perduodami laukai.

pvz koregavimas :

xml
<body>
    <method>EDIT_N41</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <N41>
            <N41_KODAS_GP>GP_API_001</N41_KODAS_GP>
            <N41_PAV>Koreguota</N41_PAV>
        </N41>
    </data>
</body>

pvz išmetimas :

xml
<body>
    <method>EDIT_N41</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <N41>
            <N41_KODAS_GP>GP_API_001</N41_KODAS_GP>
        </N41>
    </data>
</body>

PHP pvz

php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: abcdef.12345678910',
      'Content-Type: application/json',
      ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
    "method": "EDIT_N41",
    "params": {
        "oper": "I"
    },
    "data": {
        "N41": {
            "N41_KODAS_GP": "GP_API_001",
            "N41_KODAS_SS_V": "7",
            "N41_KODAS_SS_N": "7",
            "N41_KODAS_SS_I": "7",
            "N41_KODAS_SS_P": "7",
            "N41_KOEF": "33"
        }
    }
}');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

N41

Ilgalaikio turto grupės informacija

LaukasTipasAprašymas
N41_KODAS_GPchar(12)Ilgalaikio turto grupės kodas
N41_PAVchar(40)Ilgalaikio turto grupės pavadinimas
N41_KOEFnumeric(8,4)Nusidėvėjimo koeficientas
N41_KODAS_SS_Vchar(12)Pradinės vertės sąskaitos kodas
N41_KODAS_SS_Nchar(12)Nusidėvėjimo sąskaitos kodas
N41_KODAS_SS_Ichar(12)Išlaidų sąskaitos kodas
N41_KODAS_SS_Pchar(12)Pelno sąskaitos kodas
N41_POZ_DATEnumeric(1,0)Terminuotas:0-ne,1-taip
N41_BEG_DATEdatetimePradžios data
N41_END_DATEdatetimePabaigos data
N41_USERISchar(12)Kas koregavo
N41_R_DATEdatetimeKada koregavo
N41_ADDUSRchar(12)Kas sukūrė
N41_KOEF_VASnumeric(8,4)Nusidėvėjimo koeficientas pagal VAS
N41_KODAS_SS_V_VASchar(12)Pradinės vertės sąskaitos kodas pagal VAS
N41_KODAS_SS_N_VASchar(12)Nusidėvėjimo sąskaitos kodas pagal VAS
N41_KODAS_SS_I_VASchar(12)Išlaidų sąskaitos kodas pagal VAS
N41_PAV_K1char(100)Pavadinimas kita kalba 1
N41_PAV_K2char(100)Pavadinimas kita kalba 2
N41_PAV_K3char(100)Pavadinimas kita kalba 3