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

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

 

 

 

 

 

 

 

 

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

Van még kérdése? Kérelem beküldése

0 Megjegyzések

Kérjük, Belépés után hagyjon megjegyzést.
Üzemelteti a Zendesk