Az oldal megtekintéséhez kérjük, engedélyezze a JavaScriptet.

sERPa súgó

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

HTTP metódus / Végpont

POST / incomingsupplierinvoice

Swagger - SupplierInvoice "Doc"

Használt eredményhalmaz

Számlaérkeztetés fogadás eredményhalmaz - API

Bemenőparaméter változat = Alapértelmezett

Használt művelet

Szállítószámla érkeztetés fogadás

 

Bejövő adatok

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éterek

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.

Kimenő adatok

Azonosító

Leírás

ErrorCode

Hibakód

ErrorMessage

Hibaüzenet

InvoiceNumber

Bizonylatszám (sERPa iktatószám)

 

Ellenőrzések:

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.

POST

URL

sERPaMintaAPI/szamlaerkeztetes

 

Body

[

 {

   "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

       }

     ]

   }

 }

]

 

Eredmény

[

   {

       "ErrorCode": 0,

       "ErrorMessage": null,

       "InvoiceNumber": "2023-NDÖ/000109"

   }

]