Lieferanten-Angebotsanfrage API

Verwaltung von Angebotsanfragen an Lieferanten — Abruf, Erstellung, Änderung und Abschluss

Basis-URL

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

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

GET /api/offer_request/get

Abruf einer einzelnen Lieferanten-Angebotsanfrage anhand der ID, mit allen Details.

Abfrageparameter

ParameterTypPflichtfeldBeschreibung
idintEindeutige Kennung der Angebotsanfrage

Beispielanfrage

GET /api/offer_request/get?id=15
X-API-KEY: {ihr_api_schluessel}

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 15,
    "identify": "AK-2024-0015",
    "date_create": "2024-05-01 09:00:00",
    "date_perform": "2024-05-15",
    "status_id": 1,
    "partner_company_name": "Minta Szállító Kft.",
    "price_netto": 80000,
    "price_brutto": 101600,
    "currency_name": "HUF",
    "item": [
      { "product_id": 3, "quantity": 2, "price": 40000, "tax_id": 2 }
    ]
  }
}
GET /api/offer_request/list

Paginierter Abruf der Liste der Lieferanten-Angebotsanfragen mit Filtermöglichkeiten.

Abfrageparameter

ParameterTypPflichtfeldBeschreibung
list_offsetintOffset für die Seitenanzeige (Standard: 0)
list_countintAnzahl der Datensätze pro Seite
list_sort[field]stringName des Sortierfelds
list_sort[sort]stringSortierrichtung: ASC oder DESC
list_condition[identify]stringFilter nach Bezeichner (LIKE)
list_condition[company_name]stringFilter nach Partnername (LIKE)
list_condition[status_id]intFilter nach Status
list_condition[date_create_from]dateErstellungsdatum — ab (YYYY-MM-DD)
list_condition[date_create_to]dateErstellungsdatum — bis (YYYY-MM-DD)

Beispielanfrage

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

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": [
    { "id": 15, "identify": "AK-2024-0015", "partner_company_name": "Minta Szállító Kft.", "status_id": 1, "price_brutto": 101600 }
  ],
  "params": { "list_count": 20, "list_offset": 0, "list_all": 42 }
}
POST /api/offer_request/save

Erstellung oder Änderung einer Lieferanten-Angebotsanfrage. Für einen neuen Datensatz data[id] = 0, für eine Änderung die bestehende ID angeben.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
idint0 = neue Angebotsanfrage, >0 = Änderung
company_idintUnternehmens-ID
company_user_idintID des zuständigen Mitarbeiters
company_address_idintID des Unternehmensstandorts
currency_idintKennung der Währung
partner_idintKennung des Lieferantenpartners
date_performdateFälligkeitsdatum (YYYY-MM-DD)
comment_topstringFür den Lieferanten sichtbare Anmerkung
comment_bottomstringInterne Anmerkung
jobnumber_idintKennung der Auftragsnummer
project_idintProjektkennung
itemarrayArray der Positionen (siehe unten)

Positionsfelder — data[item][]

FeldTypPflichtfeldBeschreibung
product_idintProduktkennung
quantityfloatMenge
pricefloatInformativer Netto-Einzelpreis
tax_idintKennung des Steuersatzes
price_discountfloatRabatt in Prozent
removeint1 = Position bei Änderung löschen

POST-Felder — params-Objekt (optional)

FeldTypPflichtfeldBeschreibung
closeint1 = automatischer Abschluss nach dem Speichern
downloadint1 = PDF-Generierung nach dem Speichern

Beispielanfrage

POST /api/offer_request/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-30",
    "comment_top": "Kérjük az ajánlatot 15 napon belül visszaküldeni.",
    "item": [
      { "product_id": 5, "quantity": 10, "tax_id": 2 }
    ]
  },
  "params": { "close": 0, "download": 0 }
}

Beispielantwort

{
  "result": { "code": 1, "message": "success" },
  "data": { "id": 16, "identify": "AK-2024-0016" }
}
POST /api/offer_request/delete

Löschen einer Lieferanten-Angebotsanfrage. Nur ein offener Datensatz (status_id=1) kann gelöscht werden.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
receipt_idintKennung der zu löschenden Angebotsanfrage

Beispielanfrage

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

{ "data": { "receipt_id": 15 } }

Beispielantwort

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

Abschluss einer offenen Lieferanten-Angebotsanfrage. Nur ein Datensatz mit status_id = 1 (offen) kann abgeschlossen werden.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
receipt_idintKennung der abzuschließenden Angebotsanfrage

Beispielanfrage

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

{ "data": { "receipt_id": 15 } }

Beispielantwort

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

Herunterladen des Dokuments der Lieferanten-Angebotsanfrage in verschiedenen Formaten.

Abfrageparameter

ParameterTypPflichtfeldBeschreibung
receipt_idintKennung der Angebotsanfrage
file_typestringpdf, pdf-string, pdf-string-sample, stream
languagestringName des Sprachordners der Vorlage (z. B. hungarian)
template_idintID der individuellen Druckvorlage

Beispielanfrage

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

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!