Back to Gidas

EDIT_N72

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

latest7.1 KB
Original Source

PDF

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

EDIT_N72

Aprašymas

Automobilio kortelės koregavimas.

Specifikacija

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

Body
  • method : EDIT_N72

  • params :

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

    • N72 - atitinkamos lentelės laukai (N72)

pvz application/xml:

xml
<body>
    <method>EDIT_N72</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <N72>
            <N72_KODAS_AU>AU001</N72_KODAS_AU>
            <N72_PAV>Automobilio pavadinimas 001</N72_PAV>
        </N72>
    </data>
</body>

pvz application/json:

json
{
    "method": "EDIT_N72",
    "params": {
        "oper": "I"
    },
    "data": {
        "N72": {
            "N72_KODAS_AU": "AU001",
            "N72_PAV": "Automobilio pavadinimas 001"
        }
    }
}
Response (status 200 OK)

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

pvz :

xml
<RET_DOK>
    <N72>
      <N72_KODAS_AU>AU001 </N72_KODAS_AU>
      <N72_VAL_NR> </N72_VAL_NR>
      <N72_PAV>Automobilio pavadinimas 001 </N72_PAV>
      <N72_KODAS_IS> </N72_KODAS_IS>
      <N72_KODAS_GS> </N72_KODAS_GS>
      <N72_GARAZAS> </N72_GARAZAS>
      <N72_PRIKL>1</N72_PRIKL>
      <N72_KODAS_MS> </N72_KODAS_MS>
      <N72_KODAS_PP> </N72_KODAS_PP>
      <N72_AMOR_KM>0.00</N72_AMOR_KM>
      <N72_AMOR_1H>0.00</N72_AMOR_1H>
      <N72_VERTE>0.00</N72_VERTE>
      <N72_AUKSTIS>0.00</N72_AUKSTIS>
      <N72_ILGIS>0.00</N72_ILGIS>
      <N72_PLOTIS>0.00</N72_PLOTIS>
      <N72_SVORIS>0.000</N72_SVORIS>
      <N72_PASTABOS></N72_PASTABOS>
      <N72_POZ_DATE>0</N72_POZ_DATE>
      <N72_BEG_DATE>2024-10-01T00:00:00</N72_BEG_DATE>
      <N72_END_DATE>2024-10-01T00:00:00</N72_END_DATE>
      <N72_USERIS>WS </N72_USERIS>
      <N72_R_DATE>2024-10-01T00:00:00</N72_R_DATE>
      <N72_ADDUSR>WS </N72_ADDUSR>
      <N72_PG_DATA>2024-10-01T00:00:00</N72_PG_DATA>
      <N72_SPALVA> </N72_SPALVA>
      <N72_VAR_NR> </N72_VAR_NR>
      <N72_VAZ_NR> </N72_VAZ_NR>
      <N72_KEB_NR> </N72_KEB_NR>
      <N72_MASE>0</N72_MASE>
      <N72_KODAS_KS> </N72_KODAS_KS>
      <N72_TURIS>0.00</N72_TURIS>
      <N72_KODAS_LS_1> </N72_KODAS_LS_1>
      <N72_KODAS_LS_2> </N72_KODAS_LS_2>
      <N72_KODAS_LS_3> </N72_KODAS_LS_3>
      <N72_KODAS_LS_4> </N72_KODAS_LS_4>
      <N72_RUSIS>1</N72_RUSIS>
      <N72_AUT_TIPAS1>1</N72_AUT_TIPAS1>
      <N72_AUT_TIPAS2>1</N72_AUT_TIPAS2>
      <N72_KODAS_SM> </N72_KODAS_SM>
      <N72_TIR>0</N72_TIR>
      <N72_CEMT>0</N72_CEMT>
      <N72_ADR>0</N72_ADR>
      <N72_ORO_PAG>0</N72_ORO_PAG>
    </N72>
</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>4641133481.8ec4537a.1716271246499</id>
    <durationMs>569</durationMs>
    <errorMessage>Nepavyko įvykdyti metodo</errorMessage>
    <document/>
    <errors>
        <error>
            <data>&lt;N72>&lt;/N72></data>
            <dataErrors>
                <dataError>
                    <tag>N72_KODAS_AU</tag>
                    <code>5009</code>
                    <message>Kodas nerastas</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_N72</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <N72>
            <N72_KODAS_AU>AU001</N72_KODAS_AU>
            <N72_PAV>Automobilio pavadinimas naujas</N72_PAV>
        </N72>
    </data>
</body>

pvz išmetimas :

xml
<body>
    <method>EDIT_N72</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <N72>
            <N72_KODAS_AU>AU001</N72_KODAS_AU>
        </N72>
    </data>
</body>

PHP pvz

php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: 9999999.12345678910',
      'Content-Type: application/json',
      ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
        "method": "EDIT_N72",
        "params": {
            "oper": "I"
        },
        "data": {
            "N72": {
                "N72_KODAS_AU": "AU001",
                "N72_PAV": "Automobilio pavadinimas 001"
            }
    }
    }');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

N72

Automobilio informacija

LaukasTipasAprašymas
N72_KODAS_AUchar(12)Automobilio kodas
N72_VAL_NRchar(16)Automobilio valstybinis numeris
N72_PAVchar(60)Aprašymas
N72_KODAS_ISchar(12)Padalinys į kurį bus pilamas kuras (Resursas-automobilio bakas)
N72_KODAS_GSchar(12)Automobilių grupė
N72_GARAZASchar(12)Garažo Nr.
N72_PRIKLnumeric(1,0)Automobilio priklausomybe:1-firmos;2-kito juridinio asmens;3-kito fizinio asmens
N72_KODAS_MSchar(12)Vairuotojo kodas
N72_KODAS_PPchar(12)Inventorinis numeris pagrindinėse priemonėse
N72_AMOR_KMnumeric(6,2)Amortizacinė norma 1000 km.
N72_AMOR_1Hnumeric(6,2)Amortizacinė norma nuo laiko
N72_VERTEnumeric(12,2)Mašinos vertė
N72_AUKSTISnumeric(6,2)Krovinio max aukštis
N72_ILGISnumeric(6,2)Krovinio max plotis
N72_SVORISnumeric(8,3)Krovinio maksimalus svoris
N72_PASTABOSchar(max)Pastabos
N72_POZ_DATEnumeric(1,0)Galiojimo požymis
N72_BEG_DATEdatetimeGaliojimo pradžios data
N72_END_DATEdatetimeGaliojimo pabaigos data
N72_USERISchar(12)Kas koregavo
N72_R_DATEdatetimeKada koregavo
N72_ADDUSRchar(12)Kas sukūrė
N72_PG_DATAdatetimePagaminimo data
N72_SPALVAchar(30)Spalva
N72_VAR_NRchar(30)Variklio numeris
N72_VAR_NRchar(30)Važiuoklės numeris
N72_KEB_NRchar(30)Kėbulo numeris
N72_MASEnumeric(6,0)Masė Kg
N72_KODAS_KSchar(12)Klientas
N72_TURISnumeric(6,2)Tūris
N72_KODAS_LS_1char(12)Pirmas logistikos kodas
N72_KODAS_LS_2char(12)Antras logistikos kodas
N72_KODAS_LS_3char(12)Trečias logistikos kodas
N72_KODAS_LS_4char(12)Ketvirtas logistikos kodas
N72_RUSISnumeric(2,0)A/m rūšis
N72_AUT_TIPAS1numeric(2,0)A/m tipas 1
N72_AUT_TIPAS2numeric(2,0)A/m tipas 2
N72_KODAS_SMchar(12)Asmuo
N72_TIRnumeric(1,0)TIR
N72_CEMTnumeric(1,0)CEMT
N72_ADRnumeric(1,0)ADR
N72_ORO_PAGnumeric(1,0)Oro pagalvės