InnVoice Ügyviteli Szoftver Kft.
            Help Center innvoice InnVoice Felhő kézikönyv API hozzáférés

            Megrendelések létrehozása (POST)

            API URL

            POST - megrendelés létrehozására szolgál.

            api.innvoice.hu/%regnev%/order

            POST paraméter:

            data - a küldött adatcsomag XML formátumban

            Mezők (orders / order)

            VevoNev

            vevő neve

            VevoIrsz

            vevő számlázási cím irányítószám

            VevoTelep

            vevő számlázási cím település

            VevoUtcaHsz

            vevő számlázási cím utca, házszám

            MegrendelestombID

            megrendeléstömb azonosítója

            MegrendelesKelte

            megrendelés kelte (éééé.hh.nn.)

            Hatarido

            megrendelés szállítási határidő (éééé.hh.nn.)

            Devizanem

            megrendelés devizaneme

            FizetesiMod

            megrendelés fizetési módja (szöveg)

            Megjegyzes

            a megrendelés megjegyzése

            Email

            a megrendelő e-mail címe

            Telefon

            a megrendelő telefonszáma

            tetel

             

            TetelNev

            tétel megnevezése

            AfaSzoveg

            ÁFA kulcs szövegesen (pl: 27%)

            Brutto

            0, vagy 1, az egységár nettó, vagy bruttó értékben van megadva?

            EgysegAr

            a tétel egységára
            Mennyiseg

            mennyiség (szám) 

            MennyisegEgyseg

            mennyiségegység (szabad szöveg)

             
             

            Példa:

            <orders>
            <order>
            <VevoNev><![CDATA[Gipsz Jakab]]></VevoNev>
            <VevoIrsz><![CDATA[1119]]></VevoIrsz>
            <VevoTelep><![CDATA[Budapest]]></VevoTelep>
            <VevoUtcaHsz><![CDATA[Próba u. 2.]]></VevoUtcaHsz>
            <MegrendelestombID><![CDATA[1]]></MegrendelestombID>
            <MegrendelesKelte><![CDATA[2016.10.12.]]></MegrendelesKelte>
            <Hatarido><![CDATA[2016.10.12.]]></Hatarido>
            <Devizanem><![CDATA[Ft]]></Devizanem>
            <tetel>
            <TetelNev>Próba tétel</TetelNev>
            <AfaSzoveg>27%</AfaSzoveg>
            <Brutto>1</Brutto>
            <EgysegAr>1200</EgysegAr>
            <Mennyiseg>2</Mennyiseg>
            <MennyisegEgyseg>db</MennyisegEgyseg>
            </tetel>
            </order>
            <order>
            <VevoNev><![CDATA[Gipsz Jakab]]></VevoNev>
            <VevoIrsz><![CDATA[1119]]></VevoIrsz>
            <VevoTelep><![CDATA[Budapest]]></VevoTelep>
            <VevoUtcaHsz><![CDATA[Próba u. 2.]]></VevoUtcaHsz>
            <MegrendelestombID><![CDATA[1]]></MegrendelestombID>
            <MegrendelesKelte><![CDATA[2016.10.12.]]></MegrendelesKelte>
            <Hatarido><![CDATA[2016.10.12.]]></Hatarido>
            <Devizanem><![CDATA[Ft]]></Devizanem>
            <tetel>
            <TetelNev>Próba tétel</TetelNev>
            <AfaSzoveg>27%</AfaSzoveg>
            <Brutto>1</Brutto>
            <EgysegAr>1200</EgysegAr>
            <Mennyiseg>2</Mennyiseg>
            <MennyisegEgyseg>db</MennyisegEgyseg>
            </tetel>
            </order>
            </orders>

             

            Válasz:



            <?xml version="1.0" encoding="UTF-8"?>
            <response>

            <order>
            <error>200</error>
            <message>
            <![CDATA[ Record created ]]>
            </message>
            <TABLE_ID>
            <![CDATA[11]]>
            </TABLE_ID>
            <techid>
            <![CDATA[8081612881]]>
            </techid>
            <PrintUrl>
            <![CDATA[https://....................]]>
            </PrintUrl>
            </order>
            <order>
            <error>200</error>
            <message>
            <![CDATA[ Record created ]]>
            </message>
            <TABLE_ID>
            <![CDATA[12]]>
            </TABLE_ID>
            <techid>
            <![CDATA[1334932212]]>
            </techid>
            <PrintUrl>
            <![CDATA[https://....................]]>
            </PrintUrl>
            </order>
            </response>

            Válaszként számlánként megkapjuk az új megrendelés TABLE_ID-jét (amit GET lekérdezés esetén az id paraméterben használhatunk), a techid egyedi technikai azonosítóját (ami GET lekérdezés esetén a techid paraméterben használhatunk), valamint a PrintUrl nyomtatási URL-jét is (PDF URL).

            Minden beküldött megrendelés rekord saját válasszal tér vissza.

            error kódok a következők lehetnek:

            200 - Record Created - minden rendben, a megrendelés létrehozásra került.

            202 - Order already locked - a megrendelés már zárolt, olyan számlát próbáltunk menteni, felülírni, ami már zárolt, sorszámozott

            202 - Invalid MegrendelestombID - érvénytelen MegrendelestombID hivatkozás, nincs ilyen sorszámú megrendeléstömb

            202 - Missing VevoNev - hiányző VevoNev

            202 - Missing VevoIrsz - hiányző VevoIrsz

            202 - Missing VevoTelep - hiányző VevoTelep

            202 - Missing VevoUtcaHsz - hiányző VevoUtcaHsz

            202 - Missing MegrendelesKelte- hiányző MegrendelesKelte

            202 - Invalid MegrendelesKelte - érvénytelen MegrendelesKelte dátum

            202 - MegrendelesKelte cannot be less than xxxx - MegrendelesKelte nem lehet korábbi, mint xxxx

            202 - Missing Hatarido - hiányző Hatarido

            202 - Invalid Hatarido - érvénytelen Hatarido dátum

            202 - Invalid Devizanem - érvénytelen Devizanem, nincs ilyen devizanem

            202 - Invalid AfaKulcs in tetel xxxx - érvénytelen ÁFA kulcs az xxxx. tételben

            202 - Missing tetel - hiányző tetel, nincsenek tételek a megrendelésben

            Ha az error mező nem 200-at tartalmaz, akkor hiba történt, melynek leírása a message mezőben található.


            Updated: 29 Aug 2018 12:05 PM
            Helpful?  
            Help us to make this article better
            0 0