A Ügyfél alapadat felvétel elnevezésű API elem segítségével lehetőség van ügyfelek alapadatait felvenni a sERPá-ban.
HTTP metódus / Végpont
post / partner
Használt művelet
Ügyfél alapadat felvétel, módosítás, törlés |
|
Használt eredményhalmaz
Ügyfél bevitel eredmény - API |
Bemenőparaméter változat = Alapértelmezett |
Bejövő adatok
A lehetséges mezők típusai az Ügyfél funkcióban lévő beviteli mezők típusaival egyeznek meg - kivételes esetek a táblázat Megjegyzés oszlopában.
Művelet paraméter |
Azonosító (JSON path) |
Leírás |
Kód |
$.PartnerCode |
|
Név* |
$.PartnerName |
|
Hosszúnév |
$.PartnerLongName |
|
Irányítószám |
$.PartnerPostalCode |
|
Helység |
$.PartnerPlace |
|
Utca, házszám |
$.PartnerAdress |
|
Ország |
$.CountryCode |
Alpha3 kód pl.: HUN, ESP - alapértelmezett érték felvétel esetén: Magyarország |
Ország_ID |
$.CountryID |
|
Belföldi vevő |
$.DomesticCustomer |
logikai mező - alapértelmezett érték felvétel esetén: igaz |
Külföldi vevő |
$.ForeignCustomer |
logikai mező |
Belföldi szállító |
$.DomesticSupplier |
logikai mező - alapértelmezett érték felvétel esetén: igaz |
Külföldi szállító |
$.ForeignSupplier |
logikai mező |
Ügyfél típus |
$.Type |
felsorolt típus ID** - alapértelmezett érték felvétel esetén: 0 |
Bankszámlaszám |
$.BankAccountNo |
|
EU tag |
$.PartOfEu |
logikai mező - alapértelmezett érték felvétel esetén: igaz |
Cégjegyzékszám |
$.CompanyRegistrationNumber |
|
Deviza |
$.Currency |
Deviza kód - alapértelmezett érték felvétel esetén: HUF |
Deviza kód |
$.CurrencyCode |
|
Nyelv_ID |
$.LanguageID |
|
Nyelv |
$.LanguageCode |
ISO kód - - alapértelmezett érték felvétel esetén: hu |
Posta cím név |
$.PostalName |
|
Posta cím helység |
$.PostalPlace |
|
Posta utca, házszám |
$.PostalAdress |
|
Posta cím irányítószám |
$.PostalCode |
|
Ügynök |
$.AgentID |
|
Ügynök kód |
$.AgentCode |
|
Saját ügyintéző kód |
$.OwnAdministratorCode |
|
GLN szám |
$.GlobalLocationNo |
|
ÁFA csoportazonosító száma |
$.VATGroupIDNo |
|
Számla példányszáma |
$.InvoiceCopies |
|
KSH szám |
$.StatisticNo |
|
Pénzforgalmi áfa |
$.VATPayment |
logikai mező |
Kisadózó |
$.SmallTaxpayer |
logikai mező |
Gyűjtőszámla telephelyenként |
$.CollectionInvoicePerSite |
logikai mező |
Átadás bizonylat 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 |
|
Jövedéki engedélyszám |
$.ExciseLicenceNo |
|
Külföldi adószám |
$.ForeignTaxNumber |
|
Működési engedélyszám |
$.OperationLicenceNo |
|
Vámhatósági engedélyszám |
$.TaxAuthoritiesPermitNo |
|
Adóazonosító |
$.TaxID |
|
Megjegyzés |
$.Note |
|
E-számlázás |
$.EInvoicing |
logikai mező |
Telefon |
$.PhoneNo |
->Hivatali telefon |
Mobil |
$.MobilePhoneNo |
->Hivatali mobil |
Fax |
$.Fax |
->Hivatali fax |
->Hivatali e-mail |
Paraméterek
Paraméter |
Paraméter érték |
Leírás |
Üzemmód |
Felvétel |
A művelet üzemmódja felvétel. |
Ügyfél kód prefix |
|
Szöveges bemeneti mező, az ügyfél kódot ezzel a prefixel képezzük felvételkor. Amennyiben nem adunk meg felvételnél sem prefixet, sem pedig kódot, akkor egy generált számsor lesz a kód. |
Központi ügyfél |
Felvétel |
Ha megadjuk a központi ügyfelet (KozpontiUgyfel_ID), akkor a felvett új ügyfél automatikusan telephelye lesz ennek az ügyfélnek. Ilyenkor a bevitel automatikusan bepipálja az Ügyfél funkcióban Telephely mezőt igaznak. |
Kimenő adatok
Azonosító |
Leírás |
Partner_ID |
Ügyfél ID |
PartnerCode |
Ügyfél kód |
PartnerName |
Ügyfél név |
ErrorCode |
Hibakód - lehetséges hibakódok: 50999, 51003, 51004 |
ErrorMessage |
Hibaüzenet |
Példa
POST
URL
sERPaMintaAPI/partner
Body
[{
"PartnerCode":"bvInterfesz",
"PartnerName": "bv interfész teszt11",
"PhoneNo" : "+3682241",
"BankAccountNo":"142342342423424242342423",
"DomesticCustomer": true
}]
Eredmény
[
{
"Partner_ID": 43745,
"PartnerCode": "bvInterfesz3",
"PartnerName": "bv interfész teszt113",
"ErrorCode": 0,
"ErrorMessage": null
}
]
Egyéb adatok
**Ügyfél típus:
ID |
Név |
Kód |
0 |
Cég |
JogiSzemely |
1 |
Magánszemély |
Maganszemely |
2 |
Őstermelő |
Ostermelo |
3 |
Alapítvány |
Alapitvany |
4 |
Nagykövetség |
Nagykovetseg |
5 |
Társasház |
Tarsashaz |
6 |
Külföldi cég |
KulfoldiCeg |
7 |
Nem adóalany |
NemAdoalany |
