Back to Gidas

EDIT_N13

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

latest6.1 KB
Original Source

PDF

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

EDIT_N13

Aprašymas

Prekės akcijų įrašų koregavimas.

Specifikacija

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

Body
  • method : EDIT_N13

  • params :

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

    • N13 - atitinkamos lentelės laukai (N13)

pvz application/xml:

xml
<body>
    <method>EDIT_N13</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <N13>
            <N13_KODAS_PS>PREKE</N13_KODAS_PS>
            <N13_KODAS_US>VNT</N13_KODAS_US>
            <N13_KODAS_IS>PAD2</N13_KODAS_IS>
            <N13_KAINA1>100</N13_KAINA1>
        </N13>
    </data>
</body>

pvz application/json:

json
{
    "method": "EDIT_N13",
    "params": {
        "oper": "I"
    },
    "data": {
        "N13": {
            "N13_KODAS_PS": "PREKE",
            "N13_KODAS_US": "VNT",
            "N13_KODAS_IS": "PAD2",
            "N13_KAINA1": 100
        }
    }
}
Response (status 200 OK)

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

pvz :

xml
<?xml version='1.0'?>
<RET_DOK>
     <N13>
         <N13_KODAS_PS>477040522708</N13_KODAS_PS>
         <N13_KODAS_US>VNT </N13_KODAS_US>
         <N13_KODAS_IS>PAD1 </N13_KODAS_IS>
         <N13_EIL_NR>2</N13_EIL_NR>
         <N13_DATE_PR>2020-02-27 00:00:00.000</N13_DATE_PR>
         <N13_DATE_PB>2020-02-27 00:00:00.000</N13_DATE_PB>
         <N13_PAV>TEST1 </N13_PAV>
         <N13_POZ_KAINA>0</N13_POZ_KAINA>
         <N13_KAINA1>.0000</N13_KAINA1>
         <N13_KIEKIS2K>0</N13_KIEKIS2K>
         <N13_KAINA2>.0000</N13_KAINA2>
         <N13_KIEKIS3K>0</N13_KIEKIS3K>
         <N13_KAINA3>.0000</N13_KAINA3>
         <N13_KIEKIS4K>0</N13_KIEKIS4K>
         <N13_KAINA4>.0000</N13_KAINA4>
         <N13_POZ_NUOLAIDA>0</N13_POZ_NUOLAIDA>
         <N13_NUOLAIDA1>.00</N13_NUOLAIDA1>
         <N13_KIEKIS2N>0</N13_KIEKIS2N>
         <N13_NUOLAIDA2>.00</N13_NUOLAIDA2>
         <N13_KIEKIS3N>0</N13_KIEKIS3N>
         <N13_NUOLAIDA3>.00</N13_NUOLAIDA3>
         <N13_KIEKIS4N>0</N13_KIEKIS4N>
         <N13_NUOLAIDA4>.00</N13_NUOLAIDA4>
         <N13_KODAS_LS_1> </N13_KODAS_LS_1>
         <N13_KODAS_LS_2> </N13_KODAS_LS_2>
         <N13_KODAS_LS_3> </N13_KODAS_LS_3>
         <N13_KODAS_LS_4> </N13_KODAS_LS_4>
         <N13_ADDUSR>MASTER </N13_ADDUSR>
         <N13_USERIS>3 </N13_USERIS>
         <N13_R_DATE>2020-03-15 16:52:15.000</N13_R_DATE>
         <N13_REZERVAS> </N13_REZERVAS>
     </N13>
 </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;N13>&lt;/N13></data>
            <dataErrors>
                <dataError>
                    <tag>N13_KODAS_PS</tag>
                    <code>5001</code>
                    <message>Nenurodytas prekės kodas</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_N13</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <N13>
            <N13_KODAS_PS>PREKE</N13_KODAS_PS>
            <N13_KODAS_US>VNT</N13_KODAS_US>
            <N13_KODAS_IS>PAD2</N13_KODAS_IS>
            <N13_EIL_NR>1</N13_EIL_NR>
            <N13_KAINA1>100</N13_KAINA1>
        </N13>
    </data>
</body>

pvz išmetimas :

xml
<body>
    <method>EDIT_N13</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <N13>
            <N13_KODAS_PS>PREKE</N13_KODAS_PS>
            <N13_KODAS_US>VNT</N13_KODAS_US>
            <N13_KODAS_IS>PAD2</N13_KODAS_IS>
            <N13_EIL_NR>1</N13_EIL_NR>
        </N13>
    </data>
</body>

Lentelės

N13

Prekės akcijų informacijos lentelė.

LaukasTipasAprašymasPastabos naudojant EDIT metodus
N13_KODAS_PSC(12)Prekės kodasPrivalomas
N13_KODAS_USC(12)Mat.vnt.Privalomas
N13_KODAS_ISC(12)PadalinysPrivalomas
N13_EIL_NRN(6)Eilutės nr.Privalomas, kai oper=U,D
N13_DATE_PRT(8)Pradžios data
N13_DATE_PBT(8)Pabaigos data
N13_PAVC(60)Aprašymas
N13_POZ_KAINAN(1)Kainos parinkimas: 0-ne; 1-taip
N13_KAINA1N(12,4)Kaina1
N13_KIEKIS2KN(14)Kainos kiekis2
N13_KAINA2N(12,4)Kaina2
N13_KIEKIS3KN(14)Kainos kiekis3
N13_KAINA3N(12,4)Kaina3
N13_KIEKIS4KN(14)Kainos kiekis4
N13_KAINA4N(12,4)Kaina4
N13_POZ_NUOLAIDAN(1)Nuolaidos parinkimas: 0-ne; 1-taip.
N13_NUOLAIDA1N(6,2)Nuolaida1
N13_KIEKIS2NN(14)Nuolaidos kiekis2
N13_NUOLAIDA2N(6,2)Nuolaida2
N13_KIEKIS3NN(14)Nuolaidos kiekis3
N13_NUOLAIDA3N(6,2)Nuolaida3
N13_KIEKIS4NN(14)Nuolaidos kiekis4
N13_NUOLAIDA4N(6,2)Nuolaida4
N13_KODAS_LS_1C(12)Logistika 1
N13_KODAS_LS_2C(12)Logistika 2
N13_KODAS_LS_3C(12)Logistika 3
N13_KODAS_LS_4C(12)Logistika 4
N13_ADDUSRC(12)Kas sukūrėNeperduodamas. Pildomas automatiškai (oper=I), ApiKey - pirmi 7 simboliai
N13_USERISC(12)Kas koregavoNeperduodamas. Pildomas automatiškai, ApiKey - pirmi 7 simboliai
N13_R_DATET(8)Kada koregavoNeperduodamas. Pildomas automatiškai, Current Datetime
N13_REZERVASC(12)Rezervas