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

            Számlák létrehozása (POST)

            API URL

            POST - számla létrehozására szolgál.

            api.innvoice.hu/%regnev%/invoice

            POST paraméter:

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

            Mezők (invoices / invoice)

            VevoNev

            vevő neve

            VevoIrsz

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

            VevoOrszag

            vevő számlázási cím ország (iso 3166, kétbetűs országkód)

            VevoTelep

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

            VevoUtcaHsz

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

            SzamlatombID

            számlatömb azonosítója (szám)

            SzamlaKelte

            számla kelte (éééé.hh.nn.)

            TeljesitesKelte

            számla teljesítés kelte (éééé.hh.nn.)

            Hatarido

            számla fizetési határidő (éééé.hh.nn.)

            Devizanem

            számla devizaneme

            FizetesiMod

            számla fizetési módja (szöveg)

            Megjegyzes

            a számla megjegyzése

            Nyelv1

            a számla 1. nyelve (értéke: magyar, angol, nemet, francia, lengyel, szlovak, szloven, roman)

            Nyelv2

            a számla 2. nyelve (értéke: magyar, angol, nemet, francia, lengyel, szlovak, szloven, roman)

            Arfolyam

            a 2. devizanemre vonatkozó árfolyam

            ArfolyamDeviza

            a 2. devizanem (ha nincs megadva, akkor Ft)

            Fizetve

            0, vagy 1, aktuális dátummal fizetve-e, vagy sem

            Eszamla

            0, vagy 1, papír, vagy elektronikus számla

            VevoAdoszam

            vevő adószáma

            Telefon

            vevő telefonszáma

            Email

            vevő e-mail címe

            MegrendelesSzamStr

            megrendelés sorszáma

            MegrendelesIdopontStr

            megrendelés időpontja

            Felretett

            0, vagy 1, félretett számla, vagy lezárt számla

            Proforma
            0, vagy 1, számla, vagy díjbekérő
            Eloleg
            0, vagy 1, normál, vagy előlegszámla
            Sendmail

            0, vagy 1, számla, vagy díjbekérő levélben történő kiküldése megtörténjen?

            MailSubject

            Kiküldendő levél tárgya (makrók használhatók)

            MailBody

            Kiküldendő levél törzse (makrók használhatók)

            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)

            KedvezmenyOsszeg

            kedvezmény összege (Brutto mezőtől függően nettó, vagy bruttó)

            TermekID

            a termék egyedi azonosítója (ha van), elhagyható

            Megjegyzes

            a tétel megjegyzése

            Példa:

            <invoices>
            <invoice>
            <VevoNev><![CDATA[Gipsz Jakab]]></VevoNev>
            <VevoIrsz><![CDATA[1119]]></VevoIrsz>
            <VevoTelep><![CDATA[Budapest]]></VevoTelep>
            <VevoOrszag><![CDATA[HU]]></VevoOrszag>
            <VevoUtcaHsz><![CDATA[Próba u. 2.]]></VevoUtcaHsz>
            <SzamlatombID><![CDATA[1]]></SzamlatombID>
            <SzamlaKelte><![CDATA[2016.10.12.]]></SzamlaKelte>
            <TeljesitesKelte><![CDATA[2016.10.12.]]></TeljesitesKelte>
            <Hatarido><![CDATA[2016.10.12.]]></Hatarido>
            <Devizanem><![CDATA[Ft]]></Devizanem>
            <FizetesiMod><![CDATA[átutalás]]></FizetesiMod>
            <tetel>
            <TetelNev><![CDATA[Próba tétel]]></TetelNev>
            <AfaSzoveg>27%</AfaSzoveg>
            <Brutto>1</Brutto>
            <EgysegAr>1200</EgysegAr>
            <Mennyiseg>2</Mennyiseg>
            <MennyisegEgyseg>db</MennyisegEgyseg>
            </tetel>
            </invoice>
            </invoices>

             

            Válasz:


            <?xml version="1.0" encoding="UTF-8"?>
            <response>
            <invoice>
            <error>200</error>
            <message>
            <![CDATA[ Record created ]]>
            </message>
            <TABLE_ID>
            <![CDATA[125]]>
            </TABLE_ID>
            <techid>
            <![CDATA[183648284]]>
            </techid>
            <PrintUrl>
            <![CDATA[https://.......................]]>
            </PrintUrl>
            </invoice>
            </response>

            Válaszként számlánként megkapjuk az új számla 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 számla rekord saját válasszal tér vissza.

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

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

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

            202 - Invalid SzamlatombID - érvénytelen SzamlatombID hivatkozás, nincs ilyen sorszámú számlatömb

            202 - Missing VevoNev - hiányző VevoNev

            202 - Missing VevoIrsz - hiányző VevoIrsz

            202 - Missing VevoTelep - hiányző VevoTelep

            202 - Missing VevoOrszag - hiányző VevoOrszag

            202 - Invalid VevoOrszag - iso3166-ban nem szereplő kétbetűs országkód

            202 - Missing VevoUtcaHsz - hiányző VevoUtcaHsz

            202 - Missing TeljesitesKelte - hiányző TeljesitesKelte

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

            202 - Missing SzamlaKelte - hiányző SzamlaKelte

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

            202 - SzamlaKelte cannot be less than xxxx - SzamlaKelte 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 számlában

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


            Updated: 07 Feb 2019 11:54 PM
            Helpful?  
            Help us to make this article better
            1 0