Visual Window - Számlák létrehozása (POST) – InnVoice Ügyviteli Szoftverek

API URL

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

api.innvoice.hu/%regnev%/visual_invoice

POST paraméter:

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

Mezők (invoices / invoice)

OrderNumber	megrendelés száma
Customer / CustomerName *	vevő neve
Customer / CountryCode *	vevő ország, 2 karakter (pl: HU), ISO 3166-nek megfelelő országkódok (https://en.wikipedia.org/wiki/ISO_3166-2)
Customer / PostCode *	vevő irányítószám
Customer / City *	vevő település
Customer / Address *	vevő cím
Customer / TaxNumber	vevő adószáma
Locked	0, vagy 1, a számla piszkozat, félretett számla, vagy lezárt (1)
Proforma	0, vagy 1, a dokumentum számla (0), vagy díjbekérő (1)
Electronic	0, vagy 1, elektronikus számla (1), vagy normál, papír alapú
Advance	0, vagy 1, a számla előlegszámla (1)
PaymentMethod	számla fizetési módja (pl: átutalás)
InvoiceFolder	számlatömb azonosítója (pl: 1), hiányában az első számlatömbbe kerülnek a számlák
Sendmail	0, vagy 1, küldendő e-mailben?
Email	vevő e-mail címe
EmailSubject	e-mail tárgya
EmailBody	e-mail törzse
Phone	vevő telefonszáma
Currency *	devizanem, iso 4217 (https://en.wikipedia.org/wiki/ISO_4217)
DateIssue *	számla kelte (éééé.hh.nn. formátumban)
DateDelivery *	teljesítés kelte (éééé.hh.nn. formátumban)
DatePayment *	fizetési határidő (éééé.hh.nn. formátumban)
Paid	0, vagy 1, fizetve, vagy nem
Comment	számla megjegyzés

Items
Items / ItemName *	tétel megnevezése
Items / Sku	tétel cikkszáma
Items / VTSZSZJ	tétel VTSZSZJ száma
Items / Quantity *	tétel mennyisége
Items / QuantityType	tétel mennyiségegysége
Items / VatKey *	tétel áfa kulcsa (27% formátumban)
Items / ItemPrice *	tétel nettó egységára
Items / Comment	tétel megjegyzés

Példa:

<InvoiceRequests>
<InvoiceRequest>
<Customer>
<CustomerName>Tóth Béla</CustomerName>
<CountryCode>HU</CountryCode>
<PostCode>9700</PostCode>
<City>Szombathely</City>
<Address>Próba u. 2.</Address>
</Customer>
<OrderNumber>ABC124</OrderNumber>
<PaymentMethod>átutalás</PaymentMethod>
<DateDelivery>2022-09-13</DateDelivery>
<DateIssue>2022-09-13</DateIssue>
<DatePayment>2022-09-13</DatePayment>
<Currency>HUF</Currency>
<Items>
<ItemName>proba tetel</ItemName>
<Quantity>1</Quantity>
<VatKey>27%</VatKey>
<ItemPrice>1200</ItemPrice>
</Items>
<Items>
<ItemName>proba tetel2</ItemName>
<Quantity>12</Quantity>
<VatKey>27%</VatKey>
<ItemPrice>1200</ItemPrice>
</Items>
</InvoiceRequest>
</InvoiceRequests>

Válasz:

<?xml version="1.0" encoding="UTF-8" ?>
<response>
<invoice>
<error>200</error>
<message>
<![CDATA[Record created]]>
</message>
<TABLE_ID>
<![CDATA[10]]>
</TABLE_ID>
<VevoID>
<![CDATA[2]]>
</VevoID>
<techid>
<![CDATA[36826011725537410098133969143409]]>
</techid>
<Sorszam>
<![CDATA[2022/000005]]>
</Sorszam>
<PrintUrl>
<![CDATA[.........]]>
</PrintUrl>
</invoice>
<requesttype>post</requesttype>
</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.

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

Kapcsolódó cikkek