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)
|
VevoID |
vevő azonosítója (0, vagy üres, ha új vevőről van szó, egyébként felülírásra kerül) |
|
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 |
|
VevoEPNev |
vevő egészségpénztár név |
|
VevoEPKod |
vevő egészségpénztár kód |
|
SzallNev |
szállítási cím név |
|
SzallIrsz |
szállítási cím irányítószám |
|
SzallTelep |
szállítási cím település |
|
SzallUtcaHsz |
szállítási cím utca, házszám |
|
SzallOrszag |
szállítási cím ország |
|
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 |
|
VevoCsAdoszam |
vevő csoportos adószáma |
|
Telefon |
vevő telefonszáma |
|
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ő
|
| AutomatikusAr |
0, vagy 1. Ha 1-es, akkor az Innvoiceban beállított eladási ár kerül beemelésre. Ha van az Innvoiceban van egyedi eladási ár az adott partnerhez (VevoID, vagy adószám minta alapján történik az egyezés vizsgálat), akkor az kerül a tételhez. A termék kikeresése TermekID, vagy annak hiányában cikkszám alapján történik. Ez a funkció csak a konkrét árakra vonatkozik, százalékos, egyéb kedvezményekre nem. 1-es érték esetén a tételek eladási árainak megadása nem kötelező. |
|
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 |
| CikkSzam |
tétel cikkszáma |
| VTSZSZJ |
tétel VTSZ/SZJ szám |
| ElolegSzamlaTABLE_ID |
ha a tétel egy korábbi előlegszámlához kapcsolódik, akkor itt adható meg az előlegszámla TABLE_ID-je, így az itt megadott előlegszámla felhasznált állapotú lesz |
| ElolegSzamlaSorszam |
ha a tétel egy korábbi előlegszámlához kapcsolódik, akkor itt adható meg az előlegszámla sorszáma (ilyenkor a ElolegSzamlaTABLE_ID figyelmen kívül hagyható), így az itt megadott előlegszámla felhasznált állapotú lesz |
Példa:
Válasz:
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ó.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.