Back to Gidas

EDIT_N07

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

latest7.5 KB
Original Source

PDF

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

EDIT_N07

Aprašymas

Objekto kortelės koregavimas.

Specifikacija

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

Body
  • method : EDIT_N07

  • params :

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

    • N07 - atitinkamos lentelės laukai (N07)

pvz application/xml:

xml
<body>
    <method>EDIT_N07</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <N07>
            <N07_KODAS_IS>01</N07_KODAS_IS>
            <N07_PAV>UAB Rivilė Vilnius</N07_PAV>
        </N07>
    </data>
</body>

pvz application/json:

json
{
    "method": "EDIT_N07",
    "params": {
        "oper": "I"
    },
    "data": {
        "N07": {
            "N07_KODAS_IS": "01",
            "N07_PAV": "UAB Rivilė Vilnius"
        }
    }
}
Response (status 200 OK)

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

pvz :

xml
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
    <N07>
        <Row_number>1</Row_number>
        <N07_KODAS_IS>01</N07_KODAS_IS>
        <N07_PAV>UAB Rivilė Vilnius</N07_PAV>
        <N07_RESURSAS>0</N07_RESURSAS>
        <N07_KODAS_RE> </N07_KODAS_RE>
        <N07_PAD_TIP> </N07_PAD_TIP>
        <N07_PAD_GR1> </N07_PAD_GR1>
        <N07_PAD_GR2> </N07_PAD_GR2>
        <N07_EIL1> </N07_EIL1>
        <N07_EIL2> </N07_EIL2>
        <N07_EIL3> </N07_EIL3>
        <N07_NUTOLES>0</N07_NUTOLES>
        <N07_FIX_POZ>0</N07_FIX_POZ>
        <N07_PVM_KAIN>0</N07_PVM_KAIN>
        <N07_IM_ID>00</N07_IM_ID>
        <N07_NUOLAIDOS>1</N07_NUOLAIDOS>
        <N07_KAINA_POZ>0</N07_KAINA_POZ>
        <N07_KODAS_SS> </N07_KODAS_SS>
        <N07_POZ_DATE>0</N07_POZ_DATE>
        <N07_BEG_DATE>2020-09-25 00:00:00.000</N07_BEG_DATE>
        <N07_END_DATE>2020-09-25 00:00:00.000</N07_END_DATE>
        <N07_ADDUSR>USERABC </N07_ADDUSR>
        <N07_USERIS>USERABC </N07_USERIS>
        <N07_R_DATE>2020-09-25 11:23:08.000</N07_R_DATE>
        <N07_KODAS_VS> </N07_KODAS_VS>
        <N07_KODAS_LS_1> </N07_KODAS_LS_1>
        <N07_KODAS_LS_2> </N07_KODAS_LS_2>
        <N07_KODAS_LS_3> </N07_KODAS_LS_3>
        <N07_KODAS_LS_4> </N07_KODAS_LS_4>
        <N07_KODAS_TM> </N07_KODAS_TM>
        <N07_REZERVAS>0 </N07_REZERVAS>
        <N07_KODAS_LS_5> </N07_KODAS_LS_5>
        <N07_KODAS_LS_6> </N07_KODAS_LS_6>
        <N07_KODAS_LS_7> </N07_KODAS_LS_7>
        <N07_KODAS_LS_8> </N07_KODAS_LS_8>
        <N07_VADOVAS> </N07_VADOVAS>
        <N07_TELEF> </N07_TELEF>
        <N07_FAX> </N07_FAX>
        <N07_EIL4> </N07_EIL4>
        <N07_EIL5> </N07_EIL5>
        <N07_EIL6> </N07_EIL6>
        <N07_KODAS_FR_LNF> </N07_KODAS_FR_LNF>
        <N07_KODAS_TM_P> </N07_KODAS_TM_P>
        <N07_KODAS_ZN> </N07_KODAS_ZN>
        <N07_GLN> </N07_GLN>
    </N07>
</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>14433105830.9def1bf4.1584217427751</id>
    <durationMs>45</durationMs>
    <errorMessage>nepavyko įvykdyti metodo</errorMessage>
    <errors>
        <error>
            <data>&lt;N07>&lt;/N07></data>
            <dataErrors>
                <dataError>
                    <tag>N06_KODAS_IS</tag>
                    <code>2029</code>
                    <message>Nenurodytas padalinio kodas</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
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>Api key is not valid</errorMessage>
</RET_DOK>
Koregavimas ir išmetimas

Koregavimas, išmetimas vyksta pagal lentelės raktą (Primary Key). Negalima išmesti įrašo, jeigu jis jau dalyvauja apskaitoje.

Koreguojant informaciją bus koreguojami tik perduodami laukai.

pvz koregavimas :

xml
<body>
    <method>EDIT_N07</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <N07>
            <N07_KODAS_IS>01</N07_KODAS_IS>
            <N07_PAV>UAB Rivilė Vilnius 01</N07_PAV>
        </N07>
    </data>
</body>

pvz išmetimas :

xml
<body>
    <method>EDIT_N07</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <N07>
            <N07_KODAS_IS>01</N07_KODAS_IS>
        </N07>
    </data>
</body>

Lentelės

N07

LaukasTipasAprašymasPastabos
N07_KODAS_ISC(12)Padalinio kodasPrivalomas
N07_PAVC(40)Padalinio pavadinimas
N07_RESURSASN(1)Resurso požymis:0-Ne,1-Taip (default=0)
N07_KODAS_REC(12)Resurso kodas
N07_PAD_TIPC(2)Padalinio tipas(informacinis)
N07_PAD_GR1C(2)Padalinio grupė 01(informacinė)
N07_PAD_GR2C(2)Padalinio grupė 02(informacinė)
N07_EIL1C(40)Aprašymo eilutė 1
N07_EIL2C(40)Aprašymo eilutė 2
N07_EIL3C(40)Aprašymo eilutė 3
N07_NUTOLESN(1)Padalinio požymis:0-nenutolęs,1-nutolęs (default=0)
N07_FIX_POZN(1)Pardavimo kainų automatinis keitimas:0-Ne,1-Taip (default=0)
N07_PVM_KAINN(1)Pardavimo kainų požymis:0-be PVM,1-su PVM (default=0)
N07_IM_IDC(2)Įmonės identifikacijaPrivalomas, kai oper=I. Jeigu nepaduodamas, imamas pagal įmonės kurioje dirbama. Nekoreguojamas laukas.
N07_NUOLAIDOSN(1)Nuolaidų požymis:0-Netaikomos,1-Taikomos (default=0)
N07_KAINA_POZN(1)Pardavimo kainos pagal serijas: 0-ne,1-taip (default=0)
N07_KODAS_SSC(12)Nutolusio padalinio sąskaitos kodas
N07_POZ_DATEN(1)Terminuotas:0-Ne,1-Taip (default=0)
N07_BEG_DATET(8)Pradžios data (default=Current Date)
N07_END_DATET(8)Pabaigos data (default=Current Date)
N07_ADDUSRC(12)Kas sukūrėNeperduodamas. Pildomas automatiškai (oper=I), ApiKey - pirmi 7 simboliai
N07_USERISC(12)Kas koregavoNeperduodamas. Pildomas automatiškai, ApiKey - pirmi 7 simboliai
N07_R_DATET(8)Koregavimo laikasNeperduodamas. Pildomas automatiškai, Current Datetime
N07_KODAS_VSC(12)Vietovės kodas
N07_KODAS_LS_1C(12)Logistika 1
N07_KODAS_LS_2C(12)Logistika 2
N07_KODAS_LS_3C(12)Logistika 3
N07_KODAS_LS_4C(12)Logistika 4
N07_KODAS_TMC(12)Terminalas
N07_REZERVASC(40)Rezervas
N07_KODAS_LS_5C(12)Logistika 5
N07_KODAS_LS_6C(12)Logistika 6
N07_KODAS_LS_7C(12)Logistika 7
N07_KODAS_LS_8C(12)Logistika 8
N07_VADOVASC(60)Vadovas
N07_TELEFC(40)Telefonai
N07_FAXC(40)Faksai
N07_EIL4C(60)Aprašymo eilutė 4
N07_EIL5C(60)Aprašymo eilutė 5
N07_EIL6C(60)Aprašymo eilutė 6
N07_KODAS_FR_LNFC(12)Formulė lokacijų generavimui
N07_KODAS_TM_PC(12)Priėmimo terminalas
N07_KODAS_ZNC(12)Zona
N07_GLNC(20)GLN kodas