A Vevőszámla fogadás elnevezésű API elem segítségével lehetőség van vevőszámlákat érkeztetni a sERPá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 Vevő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. 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ó.
HTTP metódus / Végpont
POST / invoice
Használt eredményhalmaz
Vevőszámla fogadás eredményhalmaz - API |
|
Használt művelet
Vevőszámla fogadás |
|
Bejövő adatok
Lehetséges mezők leírása |
Azonosító |
|---|---|
Külső azonosító |
$.Invoice.ExternalID |
Év |
$.Invoice.Year |
Sorozat |
$.Invoice.Series |
Sorszám |
$.Invoice.Number |
Állapot1 |
$.Invoice.Status1 |
Állapot2 |
$.Invoice.Status2 |
Számla típus |
$.Invoice.InvoiceType |
Előleg típus |
$.Invoice.ProformaType |
Helyesbítés típus |
$.Invoice.AdvanceType |
Helyesbített vevőszámla év |
$.Invoice.CorrectedInvoiceYear |
Helyesbített vevőszámla sorozat |
$.Invoice.CorrectedInvoiceSeries |
Helyesbített vevőszámla sorszám |
$.Invoice.CorrectedInvoiceNumber |
Helyesbített számla külső azonosító |
$.Invoice.CorrectedInvoiceExternalID |
Kézi Számlaszám |
$.Invoice.InvoiceNumber |
Ügyfél kód |
$.Invoice.CustomerCode |
Ügyfél Telephely kód |
$.Invoice.CustomerPremise |
Ügyfél ügyintéző név |
$.Invoice.CustomerAdministrator |
Ügynök kód |
$.Invoice.AgentCode |
Ügyfél EU adószám |
$.Invoice.CustomerEUTaxNumber |
Saját ügyintéző kód |
$.Invoice.SuppliersAdministrator |
Számla dátum |
$.Invoice.InvoiceDate |
Teljesítés dátum |
$.Invoice.PerformanceDate |
Vámolás dátum |
$.Invoice.CustomsClearanceDate |
Vámhatározatszám |
$.Invoice.CustomsDecisionNo |
Tagország név |
$.Invoice.MemberCountry |
Fizetési mód név |
$.Invoice.PaymentType |
Ügyfél bankszámlaszám |
$.Invoice.CustomerBankAccount |
Esedékesség dátum |
$.Invoice.DueDate |
Számlázás alapja |
$.Invoice.Reference |
Kötésszám kód |
$.Invoice.Bondnumber |
Szállítási mód név |
$.Invoice.ShippingMethod |
Szállítási feltétel név |
$.Invoice.Delivery terms |
Deviza kód |
$.Invoice.Currency |
Fizetési feltétel név |
$.Invoice.PaymentTerms |
Végösszeg |
$.Invoice.GrandTotal |
Megjegyzés |
$.Invoice.Note |
Megjegyzés nyomtatás |
$.Invoice.PrintNote |
Elszámolási főkönyvi szám kód |
$.Invoice.ReconsiliationLedgerNo |
Kerekítés |
$.Invoice.Rounding |
Kerekítés eltérés |
$.Invoice.RoundingDifference |
Áfa dátum |
$.Invoice.VATDate |
Késedelmi kamat számítás név |
$.Invoice.LatePaymentCalc |
Könyvelés dátum |
$.Invoice.AccountingDate |
Pénzforgalmi áfa |
$.Invoice.VATPayment |
Kisadózó |
$.Invoice.SmallTAXPayer |
Áthárított áfa |
$.Invoice.PassedVAT |
Elszámolt időszak kezdete |
$.Invoice.StartAccountingPeriod |
Elszámolt időszak vége |
$.Invoice.EndAccountingPeriod |
Tételek |
$.Invoice.Item |
Tétel sorrend |
$.Invoice.Item.Sequence |
Tétel típus |
$.Invoice.Item.Type |
Szöveg |
$.Invoice.Item.ProductName |
Termék kód |
$.Invoice.Item.ProductCode |
Mennyiség |
$.Invoice.Item.Quantity |
Mennyiség egység név |
$.Invoice.Item.Unit |
Nettó tömeg |
$.Invoice.Item.NetWeight |
Besorolási szám kód |
$.Invoice.Item.ClassificationCode |
Vámtarifa kód |
$.Invoice.Item.CustomsTariffCode |
Származási hely név |
$.Invoice.Item.PlaceOfOrigin |
Származási ország név |
$.Invoice.Item.CountryofOrigin |
Ügyletkód kód |
$.Invoice.Item.TransactionCode |
Közvetített szolgáltatás |
$.Invoice.Item.IntermediaryService |
Nettó egységár |
$.Invoice.Item.NetPrice |
Engedmény százalék |
$.Invoice.Item.DiscountPercentage |
Engedmény összeg |
$.Invoice.Item.DiscountAmount |
Nettó érték |
$.Invoice.Item.NetAmount |
Áfa analitika 1 |
$.Invoice.Item.VATAnalysis1 |
Áfa analitika 2 |
$.Invoice.Item.VATAnalysis2 |
Áfa analitika 3 |
$.Invoice.Item.VATAnalysis3 |
Áfa kulcs |
$.Invoice.Item.VATRate |
Áfa érték |
$.Invoice.Item.VATAmount |
Tétel Megjegyzés nyomtatás |
$.Invoice.Item.Note |
Tétel Megjegyzés |
$.Invoice.Item.PrintNote |
Stornó tétel |
$.Invoice.Item.StornoItem |
Költséghely kód |
$.Invoice.Item.CostCenter |
Témaszám kód |
$.Invoice.Item.Subjectno |
Pozíciószám kód |
$.Invoice.Item.Positionno |
Főkönyvi szám kód |
$.Invoice.Item.GeneralLedger Account |
Áfa Főkönyvi szám kód |
$.Invoice.Item.VATLedgerno |
Iratok |
$.Invoice.Attachment |
Irat típus |
$.Invoice.Attachment.Type |
Irat sorrend |
$.Invoice.Attachment.Sequence |
Irat külső azonosító |
$.Invoice.Attachment.ExternalID |
Tárgy |
$.Invoice.Attachment.Subject |
Link |
$.Invoice.Attachment.Link |
Path |
$.Invoice.Attachment.Path |
Paraméterek
Az Időpont és a Paraméter algoritmussal használt paraméterek.
Paraméter |
Paraméter érték |
Leírás |
Üzemmód |
Felvétel |
A művelet üzemmódja felvétel. |
Felhasználó |
Felhasznalo_ID, Felhasznalo_IDNev |
sERPa felhasználó |
Paraméterezési lehetőségek
Paraméter |
Leírás |
||
Üzemmód |
|
Kimenő adatok
Címke |
Leírás |
|---|---|
InvoiceNumber |
Bizonylatszám (sERPa iktatószám) |
Date |
Felvétel dátum |
ErrorMessage |
Hibaüzenet |
Ellenőrzések
59115: "Létező külső azonosító (%1)"
59114: "Termék kód megadása kötelező Cikk / Szolgáltatás típusú terméknél"
50876: "A megadott ÁFA analitika hibás! A bizonylat nem menthető!"
51007: "Az ügyfél dolgozó nem létezik!"
50243: "Hiányzó vagy érvénytelen termékkód! [%1]"
50999: "Hibás adatformátum."
50368: "Nincsenek tételek!"
50241: "Hiányzó vagy érvénytelen ügyfélkód!"
60001: "A következő mező(k) kitöltése kötelező: %1"
59144: "Nem létező külső azonosító"
50618: "A telephely kód nem használható! %1"
50367: "Érvénytelen fizetési mód! [%1]"
50224: "A fizetési mód nem lehet üres!"
52001: "Érvénytelen Kötésszám kód."
52001: "Érvénytelen Szállítási feltétel."
50489: "Érvénytelen személy! [%1]"
50362: "Érvénytelen besorolási szám! [%1]"
51035: "Nem létező mennyiség egység."
50363: "Érvénytelen költséghely! [%1]"
50363: "Érvénytelen pozíciószám! [%1]"
50364: "Érvénytelen témaszám! [%1]
50365: "Érvénytelen pozíciószám! [%1]"
59145: "Nem létező ország [%1]"
50748: "A sERPában nem szereplő főkönyvi szám: %1"
59030: "Nem létező ügyfélkód."
59030: "Nem létező vámtarifa."
59109: "A számlasorozat nem létezik!"
50242: "Hiányzó vagy érvénytelen ügynökkód! %1"
Példák és folyamatok:
1.) 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
2.) Helyesbítő számla felvételére is van lehetőség. A hívás fejlécében meg kell adni a Helyesbítés típus, a Helyesbített számla külső azonosítót és a tételeknél a Helyesbített tétel azonosítót. Fontos, hogy a jelenlegi működés szerint fel kell venni - előjellel az eredeti tételt és az új helyesbített tételt is (Mivel össze tartoznak, mind a két tételnél ugyanazt a helyesbített tétel azonosítót kell megadni).
Az eredeti vevőszámlán 10 db tétel szerepelt, amit 5-re helyesbítünk.
POST
URL
sERPaMintaAPI/invoice
Body
[
{
"Invoice": {
"ExternalID": "20231123020",
"CorrectedInvoiceExternalID":"20231123019",
"Year": 2023,
"Series": "HUGO",
"Status": 0,
"InvoiceType": 0,
"AdvanceType": 0,
"CorrectionType": 2,
"InvoiceNumber": "Tesztkéziszámlaszám",
"CustomerCode": "ND123",
"SzamlaDatum": "2023-11-23",
"TeljesitesDatum": "2023-11-23",
"FizMod": "Átutalás",
"EsedekessegDatum": "2023-11-23",
"Deviza": "HUF",
"AfaDatum": "2023-11-23",
"KonyvelesDatum": "2023-11-23",
"Item": [
{
"Azonosito": 1,
"HelyesbitettTetelAzonosito" : 1,
"Sorrend": 1,
"Tipus": 1,
"Kod": "HUGOcikk01",
"Mennyiseg": -10,
"MennyisegEgyseg": "darab",
"NettoEgysegar": 1000,
"TetelMegjegyzesNyomtatas": 1,
"TetelMegjegyzes": "TESZT TESZT",
"KHely": "HUGO",
"TSzam": "HUGO001",
"PSzam": "000000_19",
"AfaFSzam": "000BV"
},
{
"Azonosito": 2,
"HelyesbitettTetelAzonosito" : 1,
"Sorrend": 2,
"Tipus": 1,
"Kod": "HUGOcikk01",
"Mennyiseg": 5,
"MennyisegEgyseg": "darab",
"NettoEgysegar": 1000,
"TetelMegjegyzesNyomtatas": 1,
"TetelMegjegyzes": "TESZT TESZT",
"KHely": "HUGO",
"TSzam": "HUGO001",
"PSzam": "000000_19",
"AfaFSzam": "000BV"
}
],
"Attachments": [
{
"IratTipus": 0,
"IratSorrend": 1,
"IratExternalID": "IRAT20231123020",
"Link": "https://www.progen.hu/wp-content/uploads/2022/07/Tanusitvany-2023.-apr-5-ig.pdf",
"Targy": "Teszt Teszt Teszt Teszt Teszt Teszt Teszt Teszt Teszt Teszt"
}
]
}
}
]
3.) A példa hívás két tétel és egy csatolmány importálását mutatja be.
POST
URL
sERPaMintaAPI/invoice
Body
[
{
"Invoice": {
"ExternalID": "20231117003",
"Year": 2023,
"Series": "HUGO",
"Status": 0,
"InvoiceType": 3,
"AdvanceType": 0,
"CorrectionType": 0,
"InvoiceNumber": "Tesztkéziszámlaszám",
"CustomerCode": "ND123",
"SzamlaDatum": "2023-11-17",
"TeljesitesDatum": "2023-11-17",
"FizMod": "Átutalás",
"EsedekessegDatum": "2023-11-17",
"Deviza": "EUR",
"AfaDatum": "2023-11-17",
"KonyvelesDatum": "2023-11-17",
"Item": [
{
"Azonosito": 1,
"Sorrend": 1,
"Tipus": 0,
"Szoveg": "TesztTétel1",
"Mennyiseg": 2,
"MennyisegEgyseg": "darab",
"NettoEgysegar": 100,
"AfaAnalitika1": 0,
"AfaAnalitika2": 0,
"AfaKulcs": 13
},
{
"Azonosito": 2,
"Sorrend": 2,
"Tipus": 0,
"Szoveg": "TesztTétel2",
"Mennyiseg": 2,
"MennyisegEgyseg": "darab",
"NettoEgysegar": 200,
"AfaAnalitika1": 0,
"AfaAnalitika2": 0,
"AfaKulcs": 13
}
],
"Attachments": [
{
"IratTipus": 0,
"IratSorrend": 1,
"IratExternalID": "IRAT20231117003",
"Path": "E:\\temp\\Kiegeszitesek\\generalodik.txt",
"Targy": "Teszt Teszt Teszt Teszt Teszt Teszt Teszt Teszt Teszt Teszt"
}
]
}
}
]
Eredmény
{
"Eredmeny": [
{
"ErrorNumber": 0,
"ErrorMessage": null,
"InvoiceNumber": "2023-HUGO/000131"
}
]
}
