Az interface elem segítségével létező számlaérkeztetés bizonylatokhoz lehet felvenni további adat típusokat és hozzájuk tartozó szöveget.
Egyszerre egy továbbiadat importálható.
Csak olyan további adatot engedünk felvenni, mely Szállítószámla paraméter / Nyomtatás fülönlévő táblázatban meg van adva. (egyéb esetben hibát küldünk vissza "Ez a További adat típus nem vehető fel, mert nincs megadva a bizonylat paraméterében!"
Az importtal nem módosítható a Külső azonosítóként használt további adat típus.
Törölni továbbiadat típust nem lehet, csak üres értékre módosítani, ha átadják a jsonben.
Amennyiben van olyan kötelező további adat, ami nincs felvéve, akkor addig visszadobjuk, amíg nem veszik fel, akár üres értékkel.
Ilyen akkor fordulhat elő, ha időközben kötelezővé tettek egyet,a mit még nem vettek fel arra a számlaérkeztetésre.
(Az alábbi kötelező további adat típusok nincsenek felvéve a bizonylatra: 1,2,3, elöször ezeket vegyék fel!).
HTTP metódus / Végpont
put /supplierinvoice/
Swagger - SupplierInvoice "Doc"
Használt művelet
Szállítószámla fogadás |
dbo.SzallSzTovadatFelvetelMuv |
Művelet paraméterek
Címke |
Leírás |
Számlaérkeztetés külső azonosító |
Külső azonosító |
További adat típus |
sERPaban létező további adat típus neve |
További adat szöveg |
Szabadon megadható szöveg |
Paraméterezési lehetőségek
Paraméter |
Leírás |
||||||
Üzemmód |
|
||||||
|
|
||||||
|
|
||||||
|
|
Body mező formátum
Lehetséges mezők leírása |
Azonosító |
Mező típus |
Számlaérkeztetés külső azonosító |
InvoiceExternaIID |
string 25 |
További adat típus |
Type |
string 50 |
További adat szöveg |
Text |
string 50 |
Használt eredményhalmaz
Számlaérkeztetés fogadás eredményhalmaz |
|
Kimenő adatok
Címke |
Leírás |
InvoiceNr |
Bizonylatszám (sERPa iktatószám), melyben a módosítás megtörtént |
ExternalID |
Külső azonosító további adat típus |
AdditionalInformationType |
Felvett / módosított további adat típus |
AdditionalInformationText |
Felvett / Módosított további adat szöveg |
ErrorCode |
Hibakód (lehetséges hibakódok: 50103, 50117, 50224) |
ErrorMessage |
Hibaüzenet |
Hibaüzenet:
59124 - "Az External ID nincs kitöltve" - A hibaüzenet akkor jön, ha nem adunk meg a hívásban Külső bizonylatazonosítót.
59125 - "A Type nincs kitöltve" - A hibaüzenet akkor jön, ha a típus nem lett megadva a hívásban.
59126 - Hibás External ID. - A hibaüzenet akkor jön, ha hibásan adjuk meg a Külső bizonylatazonosítót a hívásban.
59127 - Hibás további adat típus. - A hibaüzenet akkor jön, ha hibásan adjuk meg a további adattípust a hívásban.
59128 - A Type nem egyezhet meg a Külső bizonylatazonosítóval. - A hiba akkor jön, ha a hívásban azt a további adat típust adnánk át, ami a sERPa Általános paraméter funkciójában meg lett adva a Külső bizonylatazonosító mezőben.
59129 - Nincs minden kötelező további adat típus kitöltve - A hiba akkor jön, ha a sERPában már van egy számlaérkeztetés felvéve, amihez még beküldésre kerül tovadat módosítást, de időközben a paraméterbe került egy új kötelező további adat típus.
59130 - A további adat típus nem vehető fel a sorozathoz. - A hiba akkor jön, ha a sERPában a Szállítószámla paraméter funkció / Nyomtatás fül / További adat táblázatban nem lett felvéve a további adat típus és a hívásban hivatkozunk rá.
59131 - Az Extenal ID több számlaérkeztetésben szerepel - A hiba akkor jön, ha a sERPában több számlaérkeztetéshez is ugyanaz a Külső bizonylatazonosító került megadásra és a hívásban ezt adjuk meg.
Példa
POST
URL
sERPaAPI/additionalinfo
Body
{
"AdditionalInfo" : {
"InvoiceExternalID" : "SI-202306001-P",
"Type" : "Additional Info Type",
"Text" : "Additional Info Text",
}
}
Eredmény
{
"InvoiceNr": "2023-BS/000001",
"AdditionalInformationType": "További adat típus",
"AdditionalInformationText": "További adat típusszövege",
"ErrorCode": "0",
"ErrorMessage": "Additional information data import successful"
}
