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.
/api/offer_request/get
Abruf einer einzelnen Lieferanten-Angebotsanfrage anhand der ID, mit allen Details.
Abfrageparameter
| Parameter | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
id | int | Eindeutige 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 }
]
}
}
/api/offer_request/list
Paginierter Abruf der Liste der Lieferanten-Angebotsanfragen mit Filtermöglichkeiten.
Abfrageparameter
| Parameter | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
list_offset | int | Offset für die Seitenanzeige (Standard: 0) | |
list_count | int | Anzahl der Datensätze pro Seite | |
list_sort[field] | string | Name des Sortierfelds | |
list_sort[sort] | string | Sortierrichtung: ASC oder DESC | |
list_condition[identify] | string | Filter nach Bezeichner (LIKE) | |
list_condition[company_name] | string | Filter nach Partnername (LIKE) | |
list_condition[status_id] | int | Filter nach Status | |
list_condition[date_create_from] | date | Erstellungsdatum — ab (YYYY-MM-DD) | |
list_condition[date_create_to] | date | Erstellungsdatum — 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 }
}
/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
| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
id | int | 0 = neue Angebotsanfrage, >0 = Änderung | |
company_id | int | Unternehmens-ID | |
company_user_id | int | ID des zuständigen Mitarbeiters | |
company_address_id | int | ID des Unternehmensstandorts | |
currency_id | int | Kennung der Währung | |
partner_id | int | Kennung des Lieferantenpartners | |
date_perform | date | Fälligkeitsdatum (YYYY-MM-DD) | |
comment_top | string | Für den Lieferanten sichtbare Anmerkung | |
comment_bottom | string | Interne Anmerkung | |
jobnumber_id | int | Kennung der Auftragsnummer | |
project_id | int | Projektkennung | |
item | array | Array der Positionen (siehe unten) |
Positionsfelder — data[item][]
| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
product_id | int | Produktkennung | |
quantity | float | Menge | |
price | float | Informativer Netto-Einzelpreis | |
tax_id | int | Kennung des Steuersatzes | |
price_discount | float | Rabatt in Prozent | |
remove | int | 1 = Position bei Änderung löschen |
POST-Felder — params-Objekt (optional)
| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
close | int | 1 = automatischer Abschluss nach dem Speichern | |
download | int | 1 = 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" }
}
/api/offer_request/delete
Löschen einer Lieferanten-Angebotsanfrage. Nur ein offener Datensatz (status_id=1) kann gelöscht werden.
POST-Felder — data-Objekt
| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
receipt_id | int | Kennung 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": {} }
/api/offer_request/close
Abschluss einer offenen Lieferanten-Angebotsanfrage. Nur ein Datensatz mit status_id = 1 (offen) kann abgeschlossen werden.
POST-Felder — data-Objekt
| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
receipt_id | int | Kennung 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": {} }
/api/offer_request/download
Herunterladen des Dokuments der Lieferanten-Angebotsanfrage in verschiedenen Formaten.
Abfrageparameter
| Parameter | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
receipt_id | int | Kennung der Angebotsanfrage | |
file_type | string | pdf, pdf-string, pdf-string-sample, stream | |
language | string | Name des Sprachordners der Vorlage (z. B. hungarian) | |
template_id | int | ID der individuellen Druckvorlage |
Beispielanfrage
GET /api/offer_request/download?receipt_id=15&file_type=pdf
X-API-KEY: {ihr_api_schluessel}
Interessierst du dich für unsere Software? Schreib uns einfach!
Jetzt registrieren,
später bezahlen!