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 sERPá-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 - API |
Bemenőparaméter változat = Alapértelmezett |
Használt művelet
Vegyes könyvelés felvétel fogadás |
|
Bejövő adatok
Művelet paraméter |
Azonosító (JSON path) |
Leírás |
VKonyv ID |
$.BookingSignID |
|
Bizonylatszám |
$.DocumentNo |
Vegyes könyvelés bizonylatszáma |
Dátum |
$.Date |
Vegyes könyvelés dátuma |
Deviza ID |
$.CurrencyID |
Vegyes könyvelés deviza ID-ja |
Deviza |
$.Currency |
Vegyes könyvelés devizája |
Leírás |
$.Note |
Vegyes könyvelés Leírás adata |
Tétel |
$.Item |
Tételek táblázat |
Irány |
$.Item.Direction |
Irány, Felsorolt típus = KonyvelesiIrany (Tartozik / Követel) |
Főkönyvi szám |
$.Item.Accountno |
Főkönyvi szám |
Összeg |
$.Item.Amount |
Könyvelendő összeg |
Ügyfél_ID |
$.Item.CustomerID |
Ügyfél ID-ja |
Ügyfél kód |
$.Item.CustomerCode |
Ügyfél kódja |
Költséghely |
$.Item.Costcenter |
Költséghely |
Témaszám |
$.Item.Subjectno |
Témaszám |
Pozíciószám |
$.Item.Positionno |
Pozíciószám |
Szöveg |
$.Item.Note |
Könyvelés tétel szövege |
Paraméter |
Paraméter érték |
Leírás |
Naplójel |
A keletkező vegyes könyvelés naplójele (pl.: VEGY-1) |
|
Kimenő adatok
Azonosító |
Leírás |
ErrorCode |
Hibakód |
ErrorMessage |
Hibaüzenet |
AccountingNumber |
Könyvelési szám (sERPa iktatószám) |
Documentno |
Könyvelés Bizonylatszáma |
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/manualjournals
Body
[
{
"Documentno": "string202311224-1",
"Date": "2024-01-25",
"Currency": "HUF",
"Description": "fejléc leírása",
"Item": [
{
"Direction": 0,
"Accountno": "5111",
"Amount": 110,
"Customer": "progen001",
"Costcenter": "K004",
"Subjectno": "bv",
"Positionno": "300",
"Note": "tétel szövege"
},
{
"Direction": 1,
"Accountno": "519",
"Amount": 110,
"Customer": "5741abc",
"Costcenter": "K004",
"Subjectno": "bv",
"Positionno": "300",
"Note": "tétel szövege"
}
]
}
]
Eredmény
{
"Eredemeny": [
{
"ErrorCode": 0,
"ErrorMessage": null,
"AccountingNumber": "VEGY1\/24.01.25\/000071",
"Documentno": "string202311224-1"
}
]
}
