Registrieren Anmelden

Rechnungs-API

Verwaltung ausgehender Rechnungen — Abrufen, Erstellen, Bearbeiten, Abschließen und NAV-Integration

Endpunkte

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.

Wenn es Ihnen gefallen hat, teilen Sie es mit anderen

Basis-URL

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

Der Rechnungs-Endpunkt verwaltet ausgehende Rechnungen, Anzahlungsrechnungen, manuelle Rechnungen und Zahlungsaufforderungen. Jede Anfrage liefert eine JSON-Antwort zurück. Bei Erfolg ist result.code == 1, bei einem Fehler result.code == 0.

GET /api/invoice/get

Abruf einer einzelnen ausgehenden Rechnung anhand der ID, mit vollständigen Details (Positionen, Partner, Summen).

Query-Parameter

Parameter Typ Erforderlich Beschreibung
id int Eindeutige Kennung der Rechnung
identify string Kann auch anhand der Belegnummer abgerufen werden (z. B. SZ-2024-0042)

Beispielanfrage

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

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 42,
    "identify": "SZ-2024-0042",
    "date_create": "2024-05-01 10:00:00",
    "date_perform": "2024-05-10",
    "date_pay": "2024-05-24",
    "status_id": 1,
    "partner_company_name": "Minta Kft.",
    "price_brutto": 127000,
    "price_netto": 100000,
    "price_tax": 27000,
    "currency_name": "HUF",
    "item": [
      {
        "product_id": 5,
        "quantity": 2,
        "price": 50000,
        "price_brutto": 63500
      }
    ]
  }
}
GET /api/invoice/list

Paginierter Abruf der Liste ausgehender Rechnungen mit Filter- und Sortiermöglichkeiten.

Query-Parameter

Parameter Typ Erforderlich Beschreibung
list_offset int Versatz für die Seitennummerierung (Standard: 0)
list_count int Anzahl der Treffer pro Seite (Standard: 10)
list_sort[field] string Name des Sortierfelds
list_sort[sort] string ASC oder DESC
list_condition[identify] string Filter nach Belegnummer (LIKE)
list_condition[company_name] string Filter nach Partnername (LIKE)
list_condition[status_id] int Filter nach Status (1 = offen, 2 = abgeschlossen)
list_condition[date_create_from] date Erstellungsdatum — von (YYYY-MM-DD)
list_condition[date_create_to] date Erstellungsdatum — bis (YYYY-MM-DD)
list_condition[partner_id] int Filter nach Partner-ID

Beispielanfrage

GET /api/invoice/list?list_offset=0&list_condition[status_id]=1
X-API-KEY: {ihr_api_schluessel}

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 42,
      "identify": "SZ-2024-0042",
      "date_create": "2024-05-01",
      "date_pay": "2024-05-24",
      "status_name": "Nyitott",
      "partner_company_name": "Minta Kft.",
      "price_brutto": 127000
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 156
  }
}
POST /api/invoice/save

Erstellen oder Bearbeiten einer ausgehenden Rechnung. Für eine neue Rechnung data[id] = 0 angeben, für eine Bearbeitung die vorhandene ID.

POST-Felder — data-Objekt

Feld Typ Erforderlich Beschreibung
id int 0 = neue Rechnung, >0 = Bearbeitung
company_id int Kennung des Unternehmens
company_user_id int ID des zuständigen Mitarbeiters
company_address_id int ID des Unternehmensstandorts
currency_id int Kennung der Währung
date_perform date Leistungsdatum (YYYY-MM-DD)
partner_id int Kennung des Partners/Kunden
partner_shipping_id int ID der Lieferadresse des Partners
date_pay date Zahlungsfrist (YYYY-MM-DD)
paymod_id int Kennung der Zahlungsart
comment_top string Auf der Rechnung angezeigter Kopftext
comment_bottom string Auf der Rechnung angezeigter Fußtext
jobnumber_id int Kennung der Auftragsnummer
project_id int Kennung des Projekts
item array Array der Positionen — mindestens eine Position ist erforderlich (siehe unten)

Positionsfelder — data[item][]

Feld Typ Erforderlich Beschreibung
product_id int Kennung des Produkts
quantity float Menge
price float Netto-Einzelpreis
tax_id int Kennung des Steuersatzes
price_discount float Rabattprozentsatz
remove int 1 = Position bei Bearbeitung löschen

POST-Felder — params-Objekt (optional)

Feld Typ Erforderlich Beschreibung
close int 1 = automatischer Abschluss nach dem Speichern
download int 1 = PDF-Generierung nach dem Speichern

Beispielanfrage

POST /api/invoice/save
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "company_address_id": 1,
    "currency_id": 1,
    "partner_id": 12,
    "date_perform": "2024-06-15",
    "date_pay": "2024-06-29",
    "paymod_id": 2,
    "comment_top": "Köszönjük a megrendelést!",
    "item": [
      {
        "product_id": 5,
        "quantity": 2,
        "price": 50000,
        "tax_id": 2
      }
    ]
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 43,
    "identify": "SZ-2024-0043"
  }
}
POST /api/invoice/delete

Löschen einer ausgehenden Rechnung. Es kann nur eine offene (status_id = 1) Rechnung gelöscht werden.

POST-Felder — data-Objekt

Feld Typ Erforderlich Beschreibung
receipt_id int Kennung der zu löschenden Rechnung

Beispielanfrage

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

{
  "data": {
    "receipt_id": 42
  }
}

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
POST /api/invoice/close

Abschließen einer offenen ausgehenden Rechnung. Beim Abschluss wird die Rechnung finalisiert und kann an die NAV gemeldet werden (Online-Rechnung). Es kann nur eine Rechnung mit status_id = 1 (offen) abgeschlossen werden.

POST-Felder — data-Objekt

Feld Typ Erforderlich Beschreibung
receipt_id int Kennung der abzuschließenden Rechnung

Beispielanfrage

POST /api/invoice/close
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json

{
  "data": {
    "receipt_id": 42
  }
}

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
GET /api/invoice/download

Herunterladen/Generieren des Rechnungsdokuments in verschiedenen Formaten (PDF, Base64-String, Stream).

Query-Parameter

Parameter Typ Erforderlich Beschreibung
receipt_id int Kennung der Rechnung
file_type string Ausgabeformat (siehe unten)
language string Name des Sprachordners der Vorlage (z. B. hungarian)
language_id int Kennung der Sprache (für die ID-basierte Suche)
template_id int ID der individuellen Druckvorlage

file_type mögliche Werte

Wert Beschreibung
pdf Rückgabe eines Base64-kodierten PDFs mit Metadaten
pdf-string Identisch mit pdf — Base64-String + Metadaten
pdf-string-sample Generierung einer Vorschau-PDF
stream Direkter Datei-Stream (Browser-Download)

Beispielanfrage

GET /api/invoice/download?receipt_id=42&file_type=pdf
X-API-KEY: {ihr_api_schluessel}

Beispielantwort (file_type=pdf)

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "name": "SZ-2024-0042.pdf",
    "content": "JVBERi0xLjQK...",
    "receipt": { ... }
  }
}

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!
Registrierung erstellen
Registrieren