Belegdatei API

Verwaltung von Dateien, die an Belege angehängt sind — Hochladen, Abrufen und Löschen

Basis-URL

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

Jede Anfrage liefert eine JSON-Antwort zurück. Bei Erfolg ist result.code == 1, im Fehlerfall result.code == 0. Die Belegdatei ist eine an einen Beleg (Rechnung, Bestellung, Vertrag usw.) angehängte Binärdatei — gespeichert mit base64-kodiertem Inhalt.

GET /api/receipt_file/get

Abrufen einer einzelnen Belegdatei anhand der ID.

Query-Parameter

ParameterTypPflichtfeldBeschreibung
idintID des Dateidatensatzes

Beispielanfrage

GET /api/receipt_file/get?id=10
X-API-KEY: {ihr_api_schluessel}
GET /api/receipt_file/list

Paginierbare Liste der Belegdateien mit Filtermöglichkeiten.

Query-Parameter

ParameterTypPflichtfeldBeschreibung
list_offsetintPaginierungs-Offset (Standard: 0)
list_condition[receipt_id]intFilterung nach Beleg-ID
list_condition[receipt_type_id]intFilterung nach Belegtyp
list_condition[partner_id]intFilterung nach allen Belegdateien eines Partners

Beispielanfrage

GET /api/receipt_file/list?list_condition[receipt_id]=150&list_condition[receipt_type_id]=8
X-API-KEY: {ihr_api_schluessel}
GET /api/receipt_file/list_light

Kompakte Liste der Belegdateien — ohne Dateiinhalt (file_source), nur mit Metadaten.

Query-Parameter

ParameterTypPflichtfeldBeschreibung
list_offsetintPaginierungs-Offset (Standard: 0)
list_conditionobjectFilterbedingungen (wie beim /list-Endpunkt)

Beispielanfrage

GET /api/receipt_file/list_light?list_condition[receipt_id]=150&list_condition[receipt_type_id]=8
X-API-KEY: {ihr_api_schluessel}
POST /api/receipt_file/save

Hochladen einer Datei oder Ändern einer bestehenden. Für eine neue Datei data[id] = 0.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
idint0 = neue Datei, >0 = Änderung
receipt_type_idintID des Belegtyps
receipt_idintBeleg-ID
file_namestringDateiname mit Erweiterung (z. B. szamla.pdf)
file_sourcestringDateiinhalt base64-kodiert
file_type_idintID des Dateityps (Standard: 1)
file_classification_idintID der Dateiklassifizierung

Beispielanfrage

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

{
  "data": {
    "id": 0,
    "receipt_type_id": 8,
    "receipt_id": 150,
    "file_name": "szamla_150.pdf",
    "file_source": "JVBERi0x..."
  }
}
POST /api/receipt_file/delete

Löschen einer Belegdatei anhand der ID.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
idintID der zu löschenden Datei

Beispielanfrage

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

{ "data": { "id": 10 } }

Nimm Kontakt mit uns auf

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

Brauchst du Hilfe?

Wenn du keine Antwort findest und Unterstützung brauchst

Jetzt registrieren,
später bezahlen!

Teste es 3 Tage kostenlos, ohne Risiko und Verpflichtungen!