Registrieren Anmelden

Wareneingang API

Verwaltung von Wareneingängen — Abfrage, Erstellung, Änderung, Abschluss und Dokumentendownload

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/booking/

Jede Anfrage liefert eine JSON-Antwort zurück. Bei einer erfolgreichen Antwort gilt result.code == 1, bei einem Fehler result.code == 0.

GET /api/booking/get

Abruf eines einzelnen Wareneingangs anhand der ID, mit vollständigen Details (Positionen, Seriennummern, Projekt).

Query-Parameter

Parameter Typ Erforderlich Beschreibung
id int Eindeutige Kennung des Wareneingangs

Beispielanfrage

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

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 42,
    "identify": "BK-2024-0042",
    "date_create": "2024-05-01 10:00:00",
    "date_perform": "2024-05-10",
    "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/booking/list

Paginierte Abfrage der Liste der Wareneingänge mit Filtermöglichkeiten.

Query-Parameter

Parameter Typ Erforderlich Beschreibung
list_offset int Paginierungs-Offset (Standard: 0)
list_condition[identify] string Filterung nach Kennung (LIKE)
list_condition[company_name] string Filterung nach Partnername (LIKE)
list_condition[status_id] int Filterung 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 Filterung nach Partner-ID

Beispielanfrage

GET /api/booking/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": "BK-2024-0042",
      "date_create": "2024-05-01",
      "status_name": "Nyitott",
      "partner_company_name": "Minta Kft.",
      "price_brutto": 127000
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 87
  }
}
POST /api/booking/save

Erstellung oder Änderung eines Wareneingangs. Für einen neuen Wareneingang data[id] = 0, für eine Änderung die bestehende ID angeben.

POST-Felder — data-Objekt

Feld Typ Erforderlich Beschreibung
id int 0 = neuer Wareneingang, >0 = Änderung
company_id int Kennung des Unternehmens
company_user_id int ID des zuständigen Mitarbeiters
company_address_id int ID der Unternehmensniederlassung
date_perform datetime Ausführungsdatum (YYYY-MM-DD HH:MM:SS)
currency_id int Kennung der Währung
partner_id int Kennung des Partners/Kunden
partner_shipping_id int ID der Lieferadresse des Partners
comment_top string Für den Kunden sichtbare Anmerkung
comment_bottom string Interne Anmerkung
jobnumber_id int Kennung der Auftragsnummer
project_id int Kennung des Projekts
item array Array der Positionen (siehe unten)

Positionsfelder — data[item][]

Feld Typ Erforderlich Beschreibung
product_id int Kennung des Produkts
store_id int Kennung des Lagers
quantity float Menge
tax_id int Kennung des Steuersatzes
price float Netto-Einzelpreis
price_discount float Rabatt in Prozent
remove int 1 = Position bei Änderung löschen

POST-Felder — params-Objekt (optional)

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

Beispielanfrage

POST /api/booking/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,
    "date_perform": "2024-06-15 09:00:00",
    "partner_id": 12,
    "currency_id": 1,
    "comment_top": "Kérjük csomagolt szállítást.",
    "item": [
      {
        "product_id": 5,
        "store_id": 1,
        "quantity": 3,
        "tax_id": 2,
        "price": 15000
      }
    ]
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Beispielantwort

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

Löschung eines Wareneingangs. Nur ein offener (status_id=1) oder abgeschlossener (status_id=2) Wareneingang kann gelöscht werden, sofern die Seriennummern nicht verwendet wurden.

POST-Felder — data-Objekt

Feld Typ Erforderlich Beschreibung
receipt_id int Kennung des zu löschenden Wareneingangs

Beispielanfrage

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

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

Beispielantwort

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

Abschluss eines offenen Wareneingangs. Der Abschluss führt eine Bestandsbewegung und eine Mengenvalidierung durch. Nur ein Wareneingang mit status_id = 1 (offen) kann abgeschlossen werden.

POST-Felder — data-Objekt

Feld Typ Erforderlich Beschreibung
receipt_id int Kennung des abzuschließenden Wareneingangs

Beispielanfrage

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

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

Beispielantwort

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

Herunterladen/Erzeugen des Dokuments zum Wareneingang in verschiedenen Formaten (PDF, Base64-String, Stream).

Query-Parameter

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

Mögliche Werte für file_type

Wert Beschreibung
pdf Rückgabe des Base64-kodierten PDFs mit Metadaten
pdf-string Identisch mit pdf — Base64-String + Metadaten
pdf-string-sample Erzeugung einer Vorschau-PDF
stream Direkter Dateistream (Download im Browser)

Beispielanfrage

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

Beispielantwort (file_type=pdf)

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "name": "BK-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