A Vegyes könyvelés fogadása elnevezésű API elem segítségével lehetőség van Vegyes könyveléseket felvenni a sERPa-ba egy külső rendszerből. További információ a swaggerben és az Interfész funkcióban található.
a sERPa-ban a könyvelés tétel egy irányt vehet fel, ezért az alábbi módon kezeljük a beküldött tételeket:
Tartozik Főkönyvi szám / Követel Főkönyvi szám mezőket átadásakor két tétel keletkezik 1 tétel elemből, melyeknek mindene azonos kivéve a főkönyvi szám és irány mezőik.
HTTP metódus / Végpont
POST / vegyeskonyvesles
Használt eredményhalmaz
Vegyes könyvelés fogadás eredmény |
|
|
|
|
Használt művelet
Vegyes könyvelés felvétel fogadás |
dbo.VKonyvFelvetelMuv |
Bejövő adatok
A Bejövő adat és a Bejövő adat kezdőértékkel algoritmussal használt paraméterek.
Művelet paraméter |
Azonosító (JSON path) |
Leírás |
Ügyfél |
$.Ugyfel_ID |
|
Ügyfél kód |
$.PartnerCode |
|
Ügyfél név |
$.PartnerName |
|
Ügyfél hosszú név |
$.PartnerLongName |
|
Irányítószám |
$.PartnerPostalCode |
|
Helység |
$.PartnerPlace |
|
Utca, Házszám |
$.PartnerAdress |
|
Ország |
$.Country_ID |
|
Ország kód |
$.CountryCode |
alpha3; pl.: HUN, ESP |
Belföldi vevő |
$.DomesticCustomer |
|
Külföldi vevő |
$.ForeignCustomer |
|
Belföldi szállító |
$.DomesticSupplier |
|
Külföldi szállító |
$.ForeignSupplier |
|
Típus |
$.Type |
|
Bankszamlaszám |
$.BankAccountNo |
|
Európai Únió tag |
$.PartOfEu |
|
Cégjegyzékszám |
$.CompanyRegistrationNumber |
|
Deviza |
$.Currency |
|
Deviza kód |
$.CurrencyCode |
pl HUF |
Levelezési nyelv |
$.Language |
|
Levelezési nyelv név |
$.LanguageName |
|
Posta név |
$.PostalName |
|
Posta helység |
$.PostalPlace |
|
Posta utca, házszám |
$.PostalAdress |
|
Posta irányítószám |
$.PostalCode |
|
Ügynök |
$.Agent |
|
Ügynök kód |
$.AgentCode |
|
Saját ügyintéző |
$.OwnAdministratorName |
|
Saját ügyintéző kód |
$.OwnAdministratorCode |
|
GLN szám |
$.GlobalLocationNo |
|
ÁFA csoportazonosító száma |
$.VATGroupIDNo |
|
Számla példányszám |
$.InvoiceCopies |
|
KSH szám |
$.StatisticNo |
|
Pénzforgalmi áfa |
$.VATPayment |
|
Kisadózó |
$.SmallTaxpayer |
|
Gyűjtőszámla telephelyenként |
$.CollectionInvoicePerSite |
|
Átadás példányszám |
$.TransferNoteCopies |
|
FELIR szám |
$.FELIRNo |
|
Szállítólevél példányszám |
$.DeliveryNoteCopies |
|
Adószám |
$.TaxRegistrationNo |
|
EU adószám |
$.EUTaxRegistrationNo |
|
Külföldi adószám |
$.ForeignTaxNumber |
|
Jövedéki engedélyszám |
$.ExciseLicenceNo |
|
Működési engedélyszám |
$.OperationLicenceNo |
|
Vámhatósági engedélyszám |
$.TaxAuthoritiesPermitNo |
|
Adóazonosító jel |
$.TaxID |
|
E-számlázás |
$.EInvoicing |
|
Hivatali telefon |
$.PhoneNo |
|
Hivatali mobil |
$.MobilePhoneNo |
|
Hivatali fax |
$.Fax |
|
Hivatali email |
|
|
Megjegyzés |
$.Note |
|
Paraméterek
Címke |
Leírás |
Üzemmód |
FM ütemmód választható. CSAK felvétel |
Azonosítás |
Választható értékeke Kód/ID |
Törlés esetén nem használhatóra állítás |
Törlés esetén ha a mező értéke igaz nem kerül ténylegesen törlésre, csak a használhatósága állítódik Igazról Hamisra |
Ügyfél kód prefix |
Megadható prefix |
Paraméterezési lehetőségek
Paraméter |
Leírás |
||
Üzemmód |
|
Kimenő adatok
Címke |
Leírás |
ErrorCode |
Hibakód |
ErrorMessage |
Hibaüzenet |
AccountingNumber |
Könyvelési szám(sERPa iktatószám) |
BizonylatSzam |
Könyvelés Bizonylatszáma |
|
|
Használt eredményhalmaz
Vegyes könyvelés fogadás eredmény |
|
Ellenőrzések
1.50363 Érvénytelen költséghely!
2.50364 Érvénytelen témaszám!
3.50365 Érvénytelen pozíciószám!
4.50368 Nincsenek tételek!
5.50490 A dátum megadása kötelező!
6.50707 Ismeretlen deviza
7.50748 A sERPában nem szereplő főkönyvi szám:
8.50999 Hibás adatformátum.
9.51000 Hiányzó főkönyvi szám!
10.51043 Az öszeg megadása kötelező
11.51045 A naplójel analítika csak vegyes lehet.
12.59044 Érvénytelen f.szám!
13.59067 A könyvelés kelte nem esik bele az aktuális pénzügyi évbe!
14.59068 A könyvelés kelte Lezárás előtti dátumra esik!
15.51046 Érvénytelen könyvelési dimenzió kombináció
Például, érvénytelen pozíciószám esetén ilyen üzenet kapunk vissza:
{ "Eredemeny": [ { "ErrorCode": 50365, "ErrorMessage": "Érvénytelen pozíciószám! [poz3756]", "AccountingNumber": null, "BizonylatSzam": null } ] }
Dimenziók megadása opcionális, de helyes kell legyen sERPa szabályai szerint.
{ "Eredemeny": [ { "ErrorCode": 51046, "ErrorMessage": "Érvénytelen könyvelési dimenzió kombináció!\r\nKöltséghely:K004,!!Témaszám:w555!!,Pozíciószám:2014d000002", "AccountingNumber": null, "BizonylatSzam": null } ] }
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/vegyeskonyveles
Body
[
{
"ManualJournals": {
"Documentno": "string",
"Date": "2023-09-11",
"Currency": "string",
"Decription": "string",
"Item": [
{
"Direction": 0,
"Accountno": 0,
"Amoun": 0,
"Customer": "string",
"Costcenter": "string",
"Subjectno": "string",
"Positionno": "string",
"Note": "string"
}
]
}
}
]
Eredmény
{
"Eredemeny": [
{
"ErrorCode": 0,
"ErrorMessage": "string",
"AccountingNumber": "string",
"BizonylatSzam": "string",
"AccountingID": 0 ,
}
]
}
Minta
[
{
"ManualJournals": {
"Documentno": "string202311224-1",
"Date": "2023-12-24",
"Currency": "HUF",
"Description": "fejléc megjegyzese",
"Item": [
{
"Direction": 0,
"Accountno": "038492",
"Amount": 110,
"Customer": "progen001",
"Costcenter": "K004",
"Subjectno": "2015a",
"Positionno": "d02",
"Note": "tétel szovege"
},
{
"Direction": 1,
"Accountno": "038491",
"Amount": 110,
"Customer": "5741abc",
"Costcenter": "K004",
"Subjectno": "2015a",
"Positionno": "2002",
"Note": "tétel szovege"
}
]
}
}
]
