Registrieren Anmelden

Partnerstamm-API

Verwaltung von Partnern (Kunden, Lieferanten) — Abruf, Erstellung und Änderung

Endpunkte

GET Einzelnen Datensatz abrufen
GET Liste abrufen
POST Speichern / Anlegen
POST Löschen

Authentifizierung

Für jede API-Anfrage muss der X-API-KEY-Header gesendet werden.

X-API-KEY: {ihr_api_schluessel}

Haben Sie noch Fragen?

Schreiben Sie uns ein Ticket oder durchsuchen Sie unser Hilfe-Center.

Basis-URL

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

Jede Anfrage liefert eine JSON-Antwort zurück. Bei Erfolg ist result.code == 1, im Fehlerfall result.code == 0.

GET /api/partner/get

Abruf eines einzelnen Partners anhand von ID, Firmenname oder Steuernummer, mit vollständigen Details (Adresse, Ansprechpartner).

Query-Parameter

Parameter	Typ	Beschreibung
`id`	int	Eindeutige Kennung des Partners
`company_name`	string	Firmenname (LIKE-Suche)
`taxcode`	string	Suche nach Steuernummer
`identify`	string	Eindeutiger Identifikationscode
`full`	int	1 = mit vollständigen Daten (Transaktionen, Statistik)

Beispielanfrage

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

GET /api/partner/list

Abruf einer paginierten Liste von Partnern mit Filtermöglichkeiten.

Query-Parameter

Parameter	Typ	Beschreibung
`list_offset`	int	Versatz für die Seitenblätterung (Standard: 0)
`list_count`	int	Anzahl der pro Seite angezeigten Datensätze
`list_condition[company_name]`	string	Filter nach Firmenname (LIKE)
`list_condition[taxcode]`	string	Filter nach Steuernummer
`list_condition[bank_account]`	string	Filter nach Bankkontonummer
`list_condition[company_email]`	string	Filter nach E-Mail-Adresse (LIKE)
`list_condition[partner_user_telephone]`	string	Filter nach Telefonnummer

Beispielanfrage

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

POST /api/partner/save

Anlegen oder Ändern eines Partners. Für einen neuen Partner data[id] = 0.

POST-Felder — data-Objekt

Feld	Typ	Beschreibung
`id`	int	0 = neuer Partner, >0 = Änderung
`company_name`	string	Firmenname / Name des Partners
`type_id`	int	Kennung des Partnertyps (Kunde, Lieferant usw.)
`legal_entity_type_id`	int	Art der juristischen Person
`paymod_id`	int	Kennung der Standard-Zahlungsart
`taxcode`	string	Inländische Steuernummer
`taxcode_international`	string	Gemeinschafts-Steuernummer (EU-USt-IdNr.)
`taxcode_group`	string	Gruppen-Steuernummer
`bank_account`	string	Bankkontonummer
`iban`	string	IBAN-Kontonummer
`swift`	string	SWIFT-/BIC-Code
`registration_number`	string	Handelsregisternummer
`company_email`	string	E-Mail-Adresse des Unternehmens
`identify`	string	Eindeutiger Identifikationscode — wenn leer, wird er automatisch vom System generiert
`enolve_id`	string	Kennung des externen Systems
`pay_limit`	float	Höhe des Kreditlimits (Standard: 0)
`language_id`	int	Sprachkennung
`currency_out_id`	int	Währung der ausgehenden (ausgestellten) Belege
`currency_in_id`	int	Währung der eingehenden Belege
`tax_id`	int	Kennung der Standard-USt-Vorlage für ausgehende Belege
`tax_in_id`	int	Kennung der Standard-USt-Vorlage für eingehende Belege
`ledger_number_in_id`	int	Kennung der Sachkontonummer für eingehende Belege
`ledger_number_out_id`	int	Kennung der Sachkontonummer für ausgehende Belege
`commission_percent`	float	Provisionsprozentsatz (Standard: 0)
`relationship_id`	int	Kennung des Beziehungstyps
`satisfaction_id`	int	Kennung der Zufriedenheitsstufe
`source_id`	int	Kennung der Quelle (Herkunft des Leads)
`loss_reason`	string	Grund für den Verlust
`paymod_forbidden`	object	Gesperrte Zahlungsarten — Schlüssel-Wert-Objekt (z. B. `{"1": true, "3": true}`), die Schlüssel werden mit Komma gespeichert
`sms_enable`	int	SMS-Versand aktiviert (0 = nein, 1 = ja). Standard: 0. Wird nichts angegeben, bleibt der vorhandene Wert unverändert
`email_enable`	int	E-Mail-Versand aktiviert (0 = nein, 1 = ja). Standard: 1. Wird nichts angegeben, bleibt der vorhandene Wert unverändert
`address`	array	Array von Adresse(n) (siehe unten)
`user`	array	Array von Ansprechpartner(n) (siehe unten)

Adressfelder — data[address][]

Feld	Typ	Beschreibung
`partner_address_id`	int	0 = neue Adresse, >0 = Änderung einer bestehenden Adresse
`country_id`	int	Länderkennung
`zip`	string	Postleitzahl
`city`	string	Stadt
`address`	string	Straße, Hausnummer
`partner_address_type_id`	int	Kennung des Adresstyps (Rechnungsadresse, Lieferadresse usw.)
`partner_address_status_id`	int	Kennung des Adressstatus
`address_user_name`	string	Name des Empfängers
`address_number`	string	Hausnummer (max. 50 Zeichen)
`address_building`	string	Gebäude (max. 50 Zeichen)
`address_stairwell`	string	Treppenhaus (max. 50 Zeichen)
`address_floor`	string	Stockwerk (max. 50 Zeichen)
`address_door`	string	Tür (max. 50 Zeichen)
`district`	string	Bezirk
`address_comment`	string	Anmerkung zur Adresse
`remove`	int	1 = Kennzeichnung zum Löschen der Adresse

Ansprechpartner-Felder — data[user][]

Feld	Typ	Beschreibung
`partner_user_id`	int	0 = neuer Ansprechpartner, >0 = Änderung eines bestehenden
`name`	string	Name des Ansprechpartners
`email`	string	E-Mail-Adresse
`telephone`	string	Telefonnummer
`partner_user_status_id`	int	Statuskennung
`invocation`	string	Anrede / Titel
`fax`	string	Faxnummer
`remove`	int	1 = Kennzeichnung zum Löschen des Ansprechpartners

Beispielanfrage

POST /api/partner/save
X-API-KEY: {ihr_api_schluessel}
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

Löschen eines Partners (logisches Löschen). Es kann nur ein Partner gelöscht werden, zu dem kein aktiver Beleg existiert.

POST-Felder — data-Objekt

Feld	Typ	Pflichtfeld	Beschreibung
`id`	int		Kennung des zu löschenden Partners

Beispielanfrage

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

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

Nimm Kontakt mit uns auf

Interessierst du dich für unsere Software? Schreib uns einfach!

Anfrage senden

Brauchst du Hilfe?

Wenn du keine Antwort findest und Unterstützung brauchst

Im Help Center stöbern

Jetzt registrieren,
später bezahlen!

Teste es 3 Tage kostenlos, ohne Risiko und Verpflichtungen!

Registrieren