HTTP metódus / Végpont
post / partner
Használt művelet
Ügyfél alapadat fogadás - API |
|
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. |
Azonosítás |
|
Azonosítás kód vagy ID alapján |
Ü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. |
Paraméterezési lehetőségek
Paraméter |
Leírás |
||||||
Üzemmód |
|
||||||
Azonosítás |
Kód, ID |
||||||
Törlés üzemmód esetén csak nem használhatóra állítás |
Logikai, csak Üzemmód = Törlés esetén van értelmezve. A nem használhatóra állítás a Belföldi vevő, Belföldi szállító, Külföldi vevő, Külföldi szállító logikai mező hamisra állítását jelenti. |
||||||
Ügyfél kód prefix |
|
Body mező formátum
Lehetséges mezők leírás |
Címke |
Megjegyzé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 - alapértelmezett érték felvétel esetén: Magyarország |
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 |
Banszá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 |
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 kód |
AgentCode |
|
Saját ügyintéző név |
OwnAdministratorName |
|
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 |
Kimenő adatok
SubjectNo |
|
Címke |
Leírás |
Code |
Ügyfél kód |
Name |
Ügyfél név |
Date |
Felvétel dátum |
ErrorCode |
Hibakód - lehetséges hibakódok: 50999, 51003, 51004 |
ErrorMessage |
Hibaüzenet |
Példa
PUT
URL
sERPaAPI/partner/basedata
Body
{
"PartnerName" : "KMC nonprofit",
"PhoneNo" : "+3682241",
"DomesticCustomer": true
}
Eredmény
{
"PartnerResult": {
"Result": [
{
"Partner_ID": 1003494,
"PartnerCode": "2017031624",
"PartnerName": "bv interfész teszt",
"ErrorCode": 0
}
]
}
}
POST
URL
.sERPaAPI/partner/basedata
Body
{
"PartnerName" : "MS1112",
"PhoneNo" : "+3682241",
"PartnerCode" : "KDA9",
"DomesticSupplier":true
}
Eredmény
{
"PartnerResult": {
"Result": [
{
"Partner_ID": 1003434,
"PartnerCode": "KDA9",
"PartnerName": "MS1112",
"ErrorCode": 0
}
]
}
}
DELETE
URL
.sERPaAPI/partner/basedata
Body
{
"PartnerCode" : "KDA9"
}
Eredmény
{
"PartnerResult": {
"Result": [
{
"Partner_ID": 1003434,
"PartnerCode": "KDA9",
"PartnerName": "MS1112",
"ErrorCode": 0
}
]
}
}
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 |
