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

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