Lagerausgang API

Verwaltung von Lagerausgängen — Abrufen, Erstellen, Bearbeiten, Abschließen und Dokumenten-Download

Basis-URL

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

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

GET /api/outgoing/get

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

Query-Parameter

Parameter Typ Pflichtfeld Beschreibung
id int Eindeutige Kennung des Lagerausgangs
item_params[include_pictures] int 1 = Produktbilder bei den Positionen zurückgeben
item_params[include_items_stock_serial] int 1 = Seriennummerdaten zurückgeben
item_params[include_items_product_parts] int 1 = Produktbestandteile zurückgeben
item_params[include_receipt_cr] int 1 = verknüpfte Belege zurückgeben

Beispielanfrage

GET /api/outgoing/get?id=17&item_params[include_items_stock_serial]=1
X-API-KEY: {ihr_api_schluessel}

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 17,
    "identify": "OUT-2024-0017",
    "date_create": "2024-05-03 11:20:00",
    "date_perform": "2024-05-10",
    "status_id": 1,
    "partner_company_name": "Minta Kft.",
    "price_brutto": 63500,
    "price_netto": 50000,
    "price_tax": 13500,
    "currency_name": "HUF",
    "item": [
      {
        "product_id": 5,
        "quantity": 2,
        "price": 25000,
        "price_brutto": 31750
      }
    ]
  }
}
GET /api/outgoing/list

Paginierter Abruf der Liste der Lagerausgänge mit Filter- und Sortiermöglichkeiten.

Query-Parameter

Parameter Typ Pflichtfeld Beschreibung
list_offset int Paginierungs-Offset (Standard: 0)
list_count int Anzahl der Treffer pro Seite (Standard: 10)
list_condition[identify] string Filter nach Kennung (LIKE)
list_condition[company_name] string Filter nach Partnername (LIKE)
list_condition[status_id] int Filter nach Status (1 = offen, 2 = abgeschlossen)
list_condition[status_ids] array Filter nach mehreren Status gleichzeitig
list_condition[date_create_from] date Erstellungsdatum — von (YYYY-MM-DD)
list_condition[date_create_to] date Erstellungsdatum — bis (YYYY-MM-DD)
list_condition[date_perform_from] date Leistungsdatum — von (YYYY-MM-DD)
list_condition[date_perform_to] date Leistungsdatum — bis (YYYY-MM-DD)
list_condition[partner_id] int Filter nach Partner-ID
list_condition[company_user_id] int Filter nach ID des zuständigen Mitarbeiters
list_condition[partnumber] string Filter nach Artikelnummer oder Barcode (LIKE)
list_condition[serial_number] string Filter nach Seriennummer
list_sort[field] string Name des Sortierfelds
list_sort[sort] string ASC oder DESC

Beispielanfrage

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

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 17,
      "identify": "OUT-2024-0017",
      "date_create": "2024-05-03",
      "status_name": "Nyitott",
      "partner_company_name": "Minta Kft.",
      "price_brutto": 63500
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 34
  }
}
POST /api/outgoing/save

Erstellen oder Bearbeiten eines Lagerausgangs. Für einen neuen Ausgang data[id] = 0, für eine Bearbeitung die vorhandene ID angeben.

POST-Felder — data-Objekt

Feld Typ Pflichtfeld Beschreibung
id int 0 = neuer Lagerausgang, >0 = Bearbeitung
company_id int Firmen-ID
company_user_id int ID des zuständigen Mitarbeiters
company_address_id int ID des Firmenstandorts
date_perform datetime Leistungsdatum (YYYY-MM-DD HH:MM:SS)
currency_id int Währungs-ID
partner_id int Partner-/Kunden-ID
partner_user_id int ID des Partner-Ansprechpartners
partner_shipping_id int ID der Partner-Lieferadresse
currency_exchange decimal Wechselkurs (Standard: 1)
comment_top string Für den Kunden sichtbarer Kommentar
comment_bottom string Interner Kommentar
jobnumber_id int Arbeitsnummer-ID
departmentnumber_id int Abteilungsnummer-ID
project_id int Projekt-ID
source_receipt_id int ID des Quellbelegs
source_receipt_type_id int ID des Quellbelegtyps
item array Array der Positionen — mindestens eine Position ist erforderlich (siehe unten)

Positionsfelder — data[item][]

Feld Typ Pflichtfeld Beschreibung
id int 0 = neue Position, >0 = Bearbeitung einer vorhandenen Position
product_id int Produkt-ID
store_id int Lager-ID
store_locality_id int Lagerplatz-ID
quantity decimal Menge
tax_id int MwSt.-Satz-ID
price decimal Netto-Einzelpreis
price_discount decimal Rabatt-/Aufschlagsprozentsatz
stock_change int Kennzeichen für Bestandsbewegung
comment_top string Kommentar zur Position
remove int 1 = Position beim Bearbeiten löschen

POST-Felder — params-Objekt (optional)

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

Beispielanfrage

POST /api/outgoing/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,
    "item": [
      {
        "id": 0,
        "product_id": 5,
        "store_id": 1,
        "quantity": 2,
        "tax_id": 2,
        "price": 25000
      }
    ]
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 18,
    "identify": "OUT-2024-0018"
  }
}
POST /api/outgoing/delete

Löschen eines Lagerausgangs. Es können nur Belege mit status_id = 1 (offen) oder status_id = 2 (abgeschlossen) gelöscht werden.

POST-Felder — data-Objekt

Feld Typ Pflichtfeld Beschreibung
receipt_id int ID des zu löschenden Lagerausgangs

Beispielanfrage

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

{
  "data": {
    "receipt_id": 17
  }
}

Beispielantwort

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

Abschließen eines offenen Lagerausgangs. Führt eine Bestandsbewegung und eine Mengenvalidierung für Produkte durch, die im Lagerbestand geführt werden. Es kann nur ein Beleg mit status_id = 1 (offen) abgeschlossen werden.

POST-Felder — data-Objekt

Feld Typ Pflichtfeld Beschreibung
receipt_id int ID des abzuschließenden Lagerausgangs

Beispielanfrage

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

{
  "data": {
    "receipt_id": 17
  }
}

Beispielantwort

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

Erzeugung des Dokuments für einen Lagerausgang in verschiedenen Formaten (PDF, Base64-String, Stream).

Query-Parameter

Parameter Typ Pflichtfeld Beschreibung
receipt_id int ID des Lagerausgangs
file_type string Ausgabeformat (siehe unten)
language string Name des Sprachordners für die Vorlage (z. B. hungarian)
language_id int Sprach-ID (Standard: 1)
template_id int ID der individuellen Druckvorlage

Mögliche Werte für file_type

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

Beispielanfrage

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

Beispielantwort (file_type=pdf)

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

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!