A Számlaérkeztetés fogadása elnevezésű API elem segítségével lehetőség van szállítószámlákat érkeztetni a sERPa-ba egy külső rendszerből. Egy hívásban lehetőség van egy vagy több tételt is felvenni, Cikk, Normál, Szolgáltatás típussal. Csatolmányt is iktathatunk, ha a Szállítószámla sorozatban megadásra került iratgyűjtő. A hívásban a csatolmány útvonalát "Path" vagy "Link" URL paraméterrel kell felvenni. Számlaérkeztetéskor a csatolmány a Fejlécen található Kapcsolódó iratok táblázatban lesz látható. További információ a swaggerben és az Interfész funkcióban található.
2023.09.12-től: Módosításra került az irat ellenőrzés és a csatolmány importálásának folyamata.
Vizsgálatra kerül, hogy van-e csatolmánya az importált számlának.
Ha van csatolmány:
Ellenőrzésre kerül, hogy az irat létezik-e. Ha nem, akkor eredményben visszaadásra kerül egy hiba, hogy az iratoldal felvétele nem sikerült. (Ismeretlen elem!)
Ellenőrizzük és ha lehet felvételre kerül az irat és az iratoldal
Ha nincs csatolmány:
Tovább megy a folyamat és további ellenőrzés nem történik
Amennyiben egy mező enum típusú, ottminden esetben az elem számát kell átadni, nem a nevét.
pl.:InvoiceType integer($uint8)
nullable: true
Számla típus
0 - Normál
1 - Folyószámla nélküli (ü.t.-)
2 - Import
3 - Devizás
4 - Folyószámla nélküli (ü.t.+)
6 - Faktor számla
7 - Devizás faktor számla
8 - Gyűjtőszámla
10 - Felvásárlási jegy
null
Enum:
[ 0, 1, 2, 3, 4, 6, 7, 8, 10, null ]
További enum (felsorolt) típusú mezők:
előleg típus, helyesbítés típus, Könyvelhető, Tétel típus, Áfa analitika1, Áfa analitika2, Áfa analitika3, Áfa kulcs, Irat típus
POST / incomingsupplierinvoice
Swagger - SupplierInvoice "Doc"
Számlaérkeztetés fogadás eredményhalmaz - API |
Bemenőparaméter változat = Alapértelmezett |
Szállítószámla érkeztetés fogadás |
|
Művelet paraméter |
Azonosító (JSON path) |
Leírás |
Külső azonosító |
$.Invoice.ExternalID |
Külső azonosító |
Év |
$.Invoice.Year |
Iktatószám év részét fogja megadni |
Sorozat |
$.Invoice.Series |
Az itt megadott létező sorozatra kerül a bizonylat felvételre |
Sorszám |
$.Invoice.SoNumber |
Csak akkor érdemes megadni, ha biztosan tudjuk hogy az a következő, üres esetén felvételkor generáljuk a megfelelőt |
Állapot |
$.Invoice.State |
Számla állapota |
Számla típus |
$.Invoice.InvoiceType |
Számla típusa (pl Normál) 0 - Normál 1 - Folyószámla nélküli (ü.t.-) 2 - Import 3 - Devizás 4 - Folyószámla nélküli (ü.t.+) 6 - Faktor számla 7 - Devizás faktor számla 8 - Gyűjtőszámla 10 - Felvásárlási jegy null |
Előleg típus |
$.Invoice.DownPaymentType |
Előlegszámla típust adhatjuk meg, amennyiben az importálni kívánt bizonylat előleg típusú 0 - Normál 1 - Folyószámla nélküli (ü.t.-) |
Helyesbítés típus |
$.Invoice.CorrectionType |
Helyesbítés típusa |
Helyesbített számla külső azonosító |
$.Invoice.CorrectedInvoiceExternalID |
Külső azonosító |
Számlaszám |
$.Invoice.InvoiceNumber |
Az érkeztetett számla számlaszáma |
Ügyfél kód |
$.Invoice.CustomerCode |
A bizonylatban szereplő ügyfél kódja |
Ügyfél Telephely kód |
$.Invoice.CostumerSiteCode |
A bizonylatban szereplő ügyfél telephelyének kódja |
Ügyfél ügyintéző név |
$.Invoice.CustomerAdministrator |
A bizonylatban szereplő ügyfél üngyintézője/ dolgozója |
Ügyfél EU adószám |
$.Invoice.CustomerEUTaxNumber |
Abban az esetben kell, ha EU beszerzés van |
Saját ügyintéző kód |
$.Invoice.OwnAdministratorCode |
Saját ügyintéző kódja |
Számla dátum |
$.Invoice.InvoiceDate |
Bizonylat kiállításának dátuma |
Teljesítés dátum |
$.Invoice.CompletionDate |
Bizonylat teljesítésének dátuma |
Vámolás dátum |
$.Invoice.CustomsClearenceDate |
Vámolás dátuma |
Vámhatározatszám |
$.Invoice.CustomsDecisionNo |
Vámhatározatszám |
Tagország név |
$.Invoice.MemberCountryName |
Tagország neve |
Fizetési mód név |
$.Invoice.PaymentMethod |
Fizetési mód neve (sERPa-ban létező fizetési módot kell megadni (pl.: "Kp") |
Esedékesség dátum |
$.Invoice.DueDate |
Bizonylat esedékességének dátuma |
Számlázás alapja |
$.Invoice.RefNo |
Számlázás alapja |
Kötésszám kód |
$.Invoice.ContractNoCode |
Kötésszám kódja |
Szállítási mód név |
$.Invoice.DeliveryMethod |
Szállítási mód név (sERPa-ban létező mód kell) |
Szállítási feltétel név |
$.Invoice.TermsOfDeliveryName |
|
Deviza kód |
$.Invoice.Currency |
Deviza kód (HUF, EUR) |
Fizetési feltétel név |
$.Invoice.PaymentTermsName |
Fizetési feltétel neve |
Végösszeg |
$.Invoice.TotalAmount |
Opcionális, Tételek bruttó értékéből is kiszámolhatjuk, mindkettő megadása esetén ellenőrzünk és eltérés esetén nem importálunk (Normál tételű számla esetén kötelező) |
Megjegyzés |
$.Invoice.Comment |
Számla Fejléc Megjegyzés |
Beérkezés dátum |
$.Invoice.ArrivalDate |
Beérkezés dátuma |
Kiadás dátum |
$.Invoice.GiveOutDate |
Kiadás dátum |
Visszavétel dátum |
$.Invoice.BackingDate |
Visszavétel dátum |
Könyvelhető |
$.Invoice.Processable |
Könyvelhető |
Szállítószámla biztonylatszám |
$.Invoice.SupplierInvoiceNo |
Szállítószámla bizonylatszám |
Elszámolási főkönyvi szám kód |
$.Invoice.SettlementAccNo |
Elszámolási főkönyvi szám kód |
Áfa dátum |
$.Invoice.VATDate |
Áfa dátum |
Késedelmi kamat számítás név |
$.Invoice.IntOnarrCalculationName |
Késedelmi kamat számítás név |
Könyvelés dátum |
$.Invoice.AccountingDate |
Könyvelés dátum |
Pénzforgalmi áfa |
$.Invoice.VATpayment |
Opcionális, alapértelmezetten 0, ha a számlán szerepel, akkor kell 1-el átadni az adatokat. |
Kisadózó |
$.Invoice.SmallTaxPayer |
Opcionális, alapértelmezetten 0, ha a számlán szerepel, akkor kell 1-el átadni az adatokat. |
Áthárított áfa |
$.Invoice.ShiftedVAT |
Opcionális, Devizás számla esetén a fejlécen az áthárított áfa mezőbe kerül az itt megadott érték. |
Elszámolt időszak kezdete |
$.Invoice.AccountedAmount |
|
Elszámolt időszak vége |
$.Invoice.AccountingPeriodEnd |
|
Tételek |
$.Invoice.Items |
|
Tétel azonosító |
$.Invoice.Items.ItemID |
Tétel azonosító |
Tétel sorrend |
$.Invoice.Items.Sequence |
Tétel sorrend |
Tétel típus |
$.Invoice.Items.Type |
Tétel típus (0-Normál, 1-Cikk, 2-Szolgáltatás) |
Szöveg |
$.Invoice.Items.Name |
Normál típus esetén kell megadni, ez lesz az adott tétel neve |
Termék kód |
$.Invoice.Items.ProductCode |
Csak Cikk, vagy Szolgáltatás típus esetén kell használni. |
Mennyiség |
$.Invoice.Items.Quantity |
Tétel mennyisége |
Mennyiség egység név |
$.Invoice.Items.Unit |
Tétel mennyiség egysége (pl.: darab, az adatbázisban létezőnek kell lenni.) |
Nettó tömeg |
$.Invoice.Items.NetWeight |
Nettó tömeg |
Besorolási szám kód |
$.Invoice.Items.VATIDCode |
Besorolási szám kód |
Vámtarifa kód |
$.Invoice.Items.CustomsTariffCode |
Vámtarifa kód |
Származási hely név |
$.Invoice.Items.ProvenancePlaceNév |
Származási hely név |
Származási ország név |
$.Invoice.Items.CountryOfOriginName |
Származási ország név |
Ügyletkód kód |
$.Invoice.Items.TransactionCodeCode |
Ügyletkód kód |
Tényleges vámtétel |
$.Invoice.Items.RealClearanceItem |
Tényleges vámtétel |
Nettó egységár |
$.Invoice.Items.NetUnitPrice |
Nettó egységár |
Engedmény százalék |
$.Invoice.Items.DiscountPercent |
Engedmény százalék |
Engedmény összeg |
$.Invoice.Items.Discount |
Engedmény összeg |
Nettó érték |
$.Invoice.Items.NetAmount |
Nettó érték |
Áfa analitika 1 |
$.Invoice.Items.VATAnalytics1 |
Áfa analitika 1 |
Áfa analitika 2 |
$.Invoice.Items.VATAnalytics2 |
Áfa analitika 2 |
Áfa analitika 3 |
$.Invoice.Items.VATAnalytics3 |
Áfa analitika 3 |
Áfa kulcs |
$.Invoice.Items.VATRate |
Áfa kulcs |
Áfa érték |
$.Invoice.Items.VATAmount |
Áfa érték |
Bruttó érték |
$.Invoice.Items.GrossAmount |
Bruttó érték |
Tétel Megjegyzés nyomtatás |
$.Invoice.Items.Comment |
Tétel Megjegyzés |
Stornó tétel |
$.Invoice.Items.StornoItem |
Stornó tétel |
Helyesbített számlaérkeztetés tétel |
$.Invoice.Items.CorrectedInvoiceItem |
Helyesbített számlaérkeztetés tétel |
Költséghely kód |
$.Invoice.Items.CostCenterCode |
Költséghely kód |
Témaszám kód |
$.Invoice.Items.SubjectNoCode |
Témaszám kód |
Pozíciószám kód |
$.Invoice.Items.PositionNoCode |
Pozíciószám kód |
Főkönyvi szám kód |
$.Invoice.Items.GenLedAccNoCode |
Főkönyvi szám kód |
KK Főkönyvi szám kód |
$.Invoice.Items.KKGenLedAccNoCode |
KK Főkönyvi szám kód |
Áfa Főkönyvi szám kód |
$.Invoice.Items.VATDateNoCode |
Áfa Főkönyvi szám kód |
Iratok |
$.Invoice.Attachments |
|
Irat típus |
$.Invoice.Attachments.Type |
Irat típus |
Irat sorrend |
$.Invoice.Attachments.Sequence |
Irat sorrend |
Irat külső azonosító |
$.Invoice.Attachments.ExternalID |
Irat külső azonosító |
Tárgy |
$.Invoice.Attachments.Subject |
Tárgy |
Link |
$.Invoice.Attachments.Link |
A hívásban a csatolmány útvonalát "Link" URL paraméterrel lehet felvenni. pl. Weboldalról dokumentum |
Path |
$.Invoice.Attachments.Path |
A hívásban a csatolmány útvonalát "Path" URL paraméterrel lehet felvenni. pl. Szerver mappából elérhető dokumentum |
Paraméter |
Paraméter érték |
Leírás |
Ügyfél azonosítás |
Kód |
Kód, Idegen azonosító |
Termék azonosítás |
Kód |
Kód, Idegen azonosító |
Ügyfél idegen azonosító típus |
|
Ezzel az idegen azonosító típussal történik az ügyfél azonosítás (struktura.idegenazonositotipus) |
Termék idegen azonosító típus |
|
Ezzel az idegen azonosító típussal történik a termék azonosítás (struktura.idegenazonositotipus) Szükséges, hogy ügyfél is meg legyen adva a Termék idegen azonosító fülén, azaz ügyfél nélküli idegen kódot nem vizsgálunk, egyezőség kell mind termékről mind ügyfélről. |
Számla paraméter |
Normál |
Szállítószámla paraméter. Alapértelmezésben Normál, ha ettől eltérőt akarunk használni, akkor kell megadni az interfészben. |
Azonosító |
Leírás |
ErrorCode |
Hibakód |
ErrorMessage |
Hibaüzenet |
InvoiceNumber |
Bizonylatszám (sERPa iktatószám) |
50243: Hiányzó vagy érvénytelen termékkód! %1
50241: Hiányzó vagy érvénytelen ügyfélkód! %1
59046: Érvénytelen elszámolási f.szám! %1
Példa
A példa hívás egy tétel és két csatolmány importálását mutatja be.
sERPaMintaAPI/szamlaerkeztetes
[
{
"Invoice": {
"ExternalID": "HSZ20230414001",
"Year": 2023,
"Sorozat": "NDÖ",
"InvoiceNumber": "220220332323999",
"CustomerCode": "ND123",
"InvoiceDate": "2023-04-14",
"CompletionDate": "2023-04-14",
"CustomsClearenceDate": "2023-04-14",
"PaymentMethod": "Átutalás",
"DueDate": "2023-04-14",
"Currency": "HUF",
"TotalAmount": 127000,
"VATDate": "2023-04-14",
"AccountingDate": "2023-04-14",
"PenzforgalmiAfa": false,
"Kisadozo": false,
"Items": [
{
"ItemID": 2,
"Sorrend": 2,
"Type": 1,
"ProductCode": "ND",
"Quantity": 5,
"Unit": "darab",
"BesorolasiSzamKod": "ND3",
"NetUnitPrice": 10000,
"GrossAmount": 63500
}
],
"Attachments": [
{
"Type": 0,
"ExternalID": "HSZIR0120230414001",
"Subject": "Tárgy0001",
"Link": "https://www.progen.hu/wp-content/uploads/2022/07/Tanusitvany-2023.-apr-5-ig.pdf",
"Sorrend": 1
},
{
"Type": 0,
"ExternalID": "HSZIR0220230414001",
"Subject": "Tárgy0002",
"Path": "D:\\Temp\\OlvasandoFile.pdf",
"Sorrend": 2
}
]
}
}
]
[
{
"ErrorCode": 0,
"ErrorMessage": null,
"InvoiceNumber": "2023-NDÖ/000109"
}
]