Angebotsanfrage-API

Verwaltung eingehender Angebotsanfragen von Kunden — Abruf, Erstellung, Änderung, Abschluss und Dokumenten-Download

Basis-URL

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

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

GET /api/offer_request/get

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

Query-Parameter

ParameterTypPflichtfeldBeschreibung
idintEindeutige ID der Angebotsanfrage

Beispielanfrage

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

Paginierter Abruf der Liste der Angebotsanfragen mit Filtermöglichkeiten.

Query-Parameter

ParameterTypPflichtfeldBeschreibung
list_offsetintPaginierungs-Offset (Standard: 0)
list_countintAnzahl der Datensätze pro Seite
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 — von (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}
POST /api/offer_request/save

Erstellung oder Änderung einer Angebotsanfrage. Für einen neuen Datensatz data[id] = 0.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
idint0 = neue Angebotsanfrage, >0 = Änderung
company_idintID des Unternehmens
company_user_idintID des zuständigen Mitarbeiters
company_address_idintID des Unternehmensstandorts
currency_idintID der Währung
partner_idintID des Partners/Kunden
comment_topstringKommentar
comment_bottomstringInterner Kommentar
itemarrayArray der Positionen

Positionsfelder — data[item][]

FeldTypPflichtfeldBeschreibung
product_idintID des Produkts
quantityfloatAngeforderte Menge
pricefloatEmpfohlener Einzelpreis
tax_idintID des MwSt.-Satzes
removeint1 = Position beim Ändern löschen

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,
    "item": [
      { "product_id": 5, "quantity": 10 }
    ]
  }
}
POST /api/offer_request/delete

Löschen einer Angebotsanfrage. Es kann nur ein Datensatz mit offenem Status gelöscht werden.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
receipt_idintID der zu löschenden Angebotsanfrage

Beispielanfrage

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

{ "data": { "receipt_id": 8 } }
POST /api/offer_request/close

Abschluss einer Angebotsanfrage. Es kann nur ein offener Datensatz (status_id=1) abgeschlossen werden.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
receipt_idintID der abzuschließenden Angebotsanfrage

Beispielanfrage

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

{ "data": { "receipt_id": 8 } }
GET /api/offer_request/download

Download des Dokuments einer Angebotsanfrage in verschiedenen Formaten.

Query-Parameter

ParameterTypPflichtfeldBeschreibung
receipt_idintID der Angebotsanfrage
file_typestringpdf, pdf-string, pdf-string-sample, stream
languagestringName des Sprachordners der Vorlage
template_idintID der individuellen Druckvorlage

Beispielanfrage

GET /api/offer_request/download?receipt_id=8&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!