EDIT_N72

Aprašymas

Automobilio kortelės koregavimas.

Specifikacija

Address

POST https://api.manorivile.lt/client/v2

Header

ApiKey : Privalomas. Unikalus API raktas išduodamas užsakant paslaugą
Content-Type : Privalomas. Kokiu formatu paduodami parametrai ir duomenys (request):
- application/xml
- application/json
Accept: Neprivalomas. Gražinamo rezultato (response) formatas
- application/xml(default)
- application/json (veikia nuo Manorivile-Gateway-1.1.0 versijos)

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)

Vienu metu veiksmai atliekami tik su vienu įrašu.

Pirmi 7 ApiKey simboliai (pvz USERABC.JQKPG1d7Pkjxj37ObsgdfEkvfEfvF1oL7h7UMOLo -> USERABC) yra vartotojo vardas Rivile GAMA programoje, kuriuo bus kuriami ar koreguojami įrašai.

pvz application/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:

{
    "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:

<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 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>

Response (status 401)

Blogai nurodytas adresas / neteisingai nurodytas API raktas / nenurodytas API raktas / pasibaigęs API rakto galiojimas, pvz

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>Api key is not valid</errorMessage>
</RET_DOK>

Response (status 502)

Nepaleistas MANO Rivile Gateway arba kitaip sutrikusi jo veikla

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>Rivile GAMA database is unavailable. Please check if the gateway is running and is set up correctly.</errorMessage>
</RET_DOK>

Response (status 504)

Laiku nebuvo gautas Rivile API užklausos atsakymas, pavyzdžiui, apkrauta GAMA duomenų bazė

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>No response received from client gateway</errorMessage>
</RET_DOK>

Response (status 500)

Bendrinė sistemos klaida, pvz

<?xml version='1.0' encoding='UTF-8'?>
<Map>
    <timestamp>2020-02-05T12:34:26.890+0000</timestamp>
    <status>500</status>
    <error>Internal Server Error</error>
    <message>No message available</message>
    <path>/v2</path>
</Map>

Koregavimas ir išmetimas

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

Koreguojant informaciją bus koreguojami tik perduodami laukai.

pvz koregavimas:

<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:

<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
$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

Laukas	Tipas	Aprašymas
N72_KODAS_AU	char(12)	Automobilio kodas
N72_VAL_NR	char(16)	Automobilio valstybinis numeris
N72_PAV	char(60)	Aprašymas
N72_KODAS_IS	char(12)	Padalinys į kurį bus pilamas kuras (Resursas-automobilio bakas)
N72_KODAS_GS	char(12)	Automobilių grupė
N72_GARAZAS	char(12)	Garažo Nr.
N72_PRIKL	numeric(1,0)	Automobilio priklausomybe:1-firmos;2-kito juridinio asmens;3-kito fizinio asmens
N72_KODAS_MS	char(12)	Vairuotojo kodas
N72_KODAS_PP	char(12)	Inventorinis numeris pagrindinėse priemonėse
N72_AMOR_KM	numeric(6,2)	Amortizacinė norma 1000 km.
N72_AMOR_1H	numeric(6,2)	Amortizacinė norma nuo laiko
N72_VERTE	numeric(12,2)	Mašinos vertė
N72_AUKSTIS	numeric(6,2)	Krovinio max aukštis
N72_ILGIS	numeric(6,2)	Krovinio max plotis
N72_SVORIS	numeric(8,3)	Krovinio maksimalus svoris
N72_PASTABOS	char(max)	Pastabos
N72_POZ_DATE	numeric(1,0)	Galiojimo požymis
N72_BEG_DATE	datetime	Galiojimo pradžios data
N72_END_DATE	datetime	Galiojimo pabaigos data
N72_USERIS	char(12)	Kas koregavo
N72_R_DATE	datetime	Kada koregavo
N72_ADDUSR	char(12)	Kas sukūrė
N72_PG_DATA	datetime	Pagaminimo data
N72_SPALVA	char(30)	Spalva
N72_VAR_NR	char(30)	Variklio numeris
N72_VAR_NR	char(30)	Važiuoklės numeris
N72_KEB_NR	char(30)	Kėbulo numeris
N72_MASE	numeric(6,0)	Masė Kg
N72_KODAS_KS	char(12)	Klientas
N72_TURIS	numeric(6,2)	Tūris
N72_KODAS_LS_1	char(12)	Pirmas logistikos kodas
N72_KODAS_LS_2	char(12)	Antras logistikos kodas
N72_KODAS_LS_3	char(12)	Trečias logistikos kodas
N72_KODAS_LS_4	char(12)	Ketvirtas logistikos kodas
N72_RUSIS	numeric(2,0)	A/m rūšis
N72_AUT_TIPAS1	numeric(2,0)	A/m tipas 1
N72_AUT_TIPAS2	numeric(2,0)	A/m tipas 2
N72_KODAS_SM	char(12)	Asmuo
N72_TIR	numeric(1,0)	TIR
N72_CEMT	numeric(1,0)	CEMT
N72_ADR	numeric(1,0)	ADR
N72_ORO_PAG	numeric(1,0)	Oro pagalvės