Regisztráció Belépés

Partnertörzs API

Partnerek (vevők, szállítók) kezelése — lekérés, létrehozás és módosítás

Végpontok

GET Egyed lekérése
GET Lista lekérése
POST Mentés / létrehozás
POST Törlés

Authentikáció

Minden API kéréshez szükséges az X-API-KEY header küldése.

X-API-KEY: {az_api_kulcsod}

Maradt még kérdésed?

Írj ticketet nekünk, vagy nézz körbe a keresőnkben.

Alap URL

https://{tenant}.logzi.com/api/partner/

Minden kérés JSON választ ad vissza. Sikeres válasz esetén result.code == 1, hiba esetén result.code == 0.

GET /api/partner/get

Egyetlen partner lekérése azonosító, cégnév vagy adószám alapján, teljes részletekkel (cím, kapcsolattartók).

Query paraméterek

Paraméter	Típus	Leírás
`id`	int	Partner egyedi azonosítója
`company_name`	string	Cégnév (LIKE keresés)
`taxcode`	string	Adószám alapján keresés
`identify`	string	Egyedi azonosító kód
`full`	int	1 = teljes adatokkal (tranzakciók, statisztika)

Példa kérés

GET /api/partner/get?id=42
X-API-KEY: {az_api_kulcsod}

GET /api/partner/list

Partnerek lapozható listájának lekérése szűrési lehetőségekkel.

Query paraméterek

Paraméter	Típus	Leírás
`list_offset`	int	Lapozás eltolása (alapértelmezett: 0)
`list_count`	int	Oldalanként megjelenő rekordok száma
`list_condition[company_name]`	string	Szűrés cégnévre (LIKE)
`list_condition[taxcode]`	string	Szűrés adószámra
`list_condition[bank_account]`	string	Szűrés bankszámlaszámra
`list_condition[company_email]`	string	Szűrés e-mail címre (LIKE)
`list_condition[partner_user_telephone]`	string	Szűrés telefonszámra

Példa kérés

GET /api/partner/list?list_offset=0&list_condition[company_name]=Kft
X-API-KEY: {az_api_kulcsod}

POST /api/partner/save

Partner létrehozása vagy módosítása. Új partnerhez data[id] = 0.

POST mezők — data objektum

Mező	Típus	Leírás
`id`	int	0 = új partner, >0 = módosítás
`company_name`	string	Cégnév / partner neve
`type_id`	int	Partner típus azonosítója (vevő, szállító stb.)
`legal_entity_type_id`	int	Jogi entitás típusa
`paymod_id`	int	Alapértelmezett fizetési mód azonosítója
`taxcode`	string	Belföldi adószám
`taxcode_international`	string	Közösségi adószám (EU VAT)
`taxcode_group`	string	Csoportos adószám
`bank_account`	string	Bankszámlaszám
`iban`	string	IBAN bankszámlaszám
`swift`	string	SWIFT/BIC kód
`registration_number`	string	Cégjegyzékszám
`company_email`	string	Cég e-mail cím
`identify`	string	Egyedi azonosítókód — ha üres, a rendszer automatikusan generálja
`enolve_id`	string	Külső rendszer azonosítója
`pay_limit`	float	Hitelkeret összege (alapértelmezett: 0)
`language_id`	int	Nyelv azonosítója
`currency_out_id`	int	Kimenő (kiállított) bizonylatok devizája
`currency_in_id`	int	Bejövő bizonylatok devizája
`tax_id`	int	Alapértelmezett kimenő ÁFA sablon azonosítója
`tax_in_id`	int	Alapértelmezett bejövő ÁFA sablon azonosítója
`ledger_number_in_id`	int	Bejövő főkönyvi szám azonosítója
`ledger_number_out_id`	int	Kimenő főkönyvi szám azonosítója
`commission_percent`	float	Jutalék százalék (alapértelmezett: 0)
`relationship_id`	int	Kapcsolat típusának azonosítója
`satisfaction_id`	int	Elégedettségi szint azonosítója
`source_id`	int	Forrás azonosítója (lead eredete)
`loss_reason`	string	Elvesztés oka
`paymod_forbidden`	object	Tiltott fizetési módok — kulcs-érték objektum (pl. `{"1": true, "3": true}`), a kulcsok vesszővel tárolódnak
`sms_enable`	int	SMS küldés engedélyezve (0 = nem, 1 = igen). Alapértelmezett: 0. Ha nincs megadva, a meglévő érték nem változik
`email_enable`	int	E-mail küldés engedélyezve (0 = nem, 1 = igen). Alapértelmezett: 1. Ha nincs megadva, a meglévő érték nem változik
`address`	array	Cím(ek) tömbje (ld. alább)
`user`	array	Kapcsolattartó(k) tömbje (ld. alább)

Cím mezők — data[address][]

Mező	Típus	Leírás
`partner_address_id`	int	0 = új cím, >0 = meglévő cím módosítása
`country_id`	int	Ország azonosítója
`zip`	string	Irányítószám
`city`	string	Város
`address`	string	Utca, házszám
`partner_address_type_id`	int	Cím típus azonosítója (számlázási, szállítási stb.)
`partner_address_status_id`	int	Cím állapot azonosítója
`address_user_name`	string	Fogadó neve
`address_number`	string	Házszám (max 50 karakter)
`address_building`	string	Épület (max 50 karakter)
`address_stairwell`	string	Lépcsőház (max 50 karakter)
`address_floor`	string	Emelet (max 50 karakter)
`address_door`	string	Ajtó (max 50 karakter)
`district`	string	Kerület
`address_comment`	string	Megjegyzés a címhez
`remove`	int	1 = cím törlésének jelölése

Kapcsolattartó mezők — data[user][]

Mező	Típus	Leírás
`partner_user_id`	int	0 = új kapcsolattartó, >0 = meglévő módosítása
`name`	string	Kapcsolattartó neve
`email`	string	E-mail cím
`telephone`	string	Telefonszám
`partner_user_status_id`	int	Státusz azonosítója
`invocation`	string	Megszólítás / titulus
`fax`	string	Fax szám
`remove`	int	1 = kapcsolattartó törlésének jelölése

Példa kérés

POST /api/partner/save
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "company_name": "Minta Kft.",
    "type_id": 1,
    "legal_entity_type_id": 1,
    "paymod_id": 1,
    "taxcode": "12345678-2-41",
    "taxcode_international": "HU12345678",
    "bank_account": "12345678-12345678-12345678",
    "iban": "HU42117730161111101800000000",
    "registration_number": "01-09-123456",
    "company_email": "info@minta.hu",
    "pay_limit": 500000,
    "currency_out_id": 1,
    "address": [
      {
        "partner_address_id": 0,
        "country_id": 1,
        "zip": "1234",
        "city": "Budapest",
        "address": "Fő utca 1.",
        "partner_address_type_id": 1,
        "partner_address_status_id": 1
      }
    ],
    "user": [
      {
        "partner_user_id": 0,
        "name": "Minta János",
        "email": "janos@minta.hu",
        "telephone": "+36301234567",
        "partner_user_status_id": 1,
        "invocation": "Tisztelt Uram",
        "fax": ""
      }
    ]
  }
}

POST /api/partner/delete

Partner törlése (logikai törlés). Csak olyan partner törölhető, amelyhez nincs aktív bizonylat.

POST mezők — data objektum

Mező	Típus	Kötelező	Leírás
`id`	int		A törlendő partner azonosítója

Példa kérés

POST /api/partner/delete
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{ "data": { "id": 42 } }

Vedd fel a kapcsolatot velünk

Érdeklődsz a szoftverünkkel kapcsolatban, írj bátran!

Érdeklődés küldése

Segítségre van szükséged?

Ha nem találod a választ és szükséged van segítségre

Nézz körbe a help centerben

Regisztrációdat hozd létre most,
fizess később!

Próbáld ki 3 napig ingyen, kockázatok és kötöttségek nélkül!

Regisztráció