API - Projekte und Produktion

api_get_qr - Gibt eine Liste aller Projekte

Erforderliche Parameter: 

Token

Konkretes Beispiel:

http://meinServer:8080/4DAction/api_get_qr?token=5E05A427CD134432A28F2DAF11EC500E

Es wird eine Übersicht von allen Projekten, einschließlich Bauvorhaben, Kommission und Status zurück gegeben.

api_put_project (Alle API) - Projekt anlegen

Erforderliche Parameter: 

Bauvorhaben, Bezeichnung

Ausgeschlossene Parameter:

PKUUID_20

Optionale Parameter:

response - (true|false) bestimmt ob der API-Aufruf eine Response zurückgibt

textupdatemode - bestimmt wie Textbausteine für den gegebenen Kunden aktualisiert werden können

default: Standardtexte aus Voreinstellungen, customer: Texte wie im Kunden hinterlegt, none: Texte lassen

paymentupdatemode - bestimmt ob die Zahlungskonditionen des Projekts oder des Kunden maßgeblich sind

default: Zahlungsbedingungen mit den aus dem Kunden hinterlegten Werten überschreiben, none: Werte aus dem Projekt stehen lassen

update - (true|false) - bestimmt ob ein bestehender Datensatz aktualisiert wird, hierbei ist der zusätzliche Parameter AuftragsNr (ProjektNr e.g. PK-0003) zwingend erforderlich

Konkretes Beispiel:

http://meinServer:8080/4DAction/api_put_project?token=41356A67726F4D219330ED924AE68E63&AuftragsNr=S019&update=true&Bauvorhaben=Altbau&Bezeichnung=kleines%20Nebenprojekt&textupdatemode=0&paymentupdatemode=1&response=true

In der JSON-Rückmeldung wird auch die neue vergebene AuftragsNr zurückgeliefert:

{"success":true,"error":"","wasUpdate":false,"AuftragsNr":"S014","processingTime":7819,"errorMsg":""}

api_put_projectpos - Projektposition anlegen

Erforderliche Parameter: 

AuftragsNr, PositionsNr, Anzahl

Optionale Parameter:

response, update ArtikelNr, Bezeichnung, Breite, Höhe, Tiefe, Einzelpreis, Rabatt, Gesamtpreis, Alt, DokumentNr, Status, Hopsasa, Suchfeld2, Suchfeld3, Suchfeld4

Konkretes Beispiel:

http://meinserver:8080/4DAction/api_put_projectpos?token=41356A67726F4D219330ED924AE68E63&response=true&AuftragsNr=08/15&PositionsNr=5&Anzahl=5

In der Response steht dann im Erfolgsfall die AuftragsNr und die PositionsNr wie übergeben:

{"success":true,"error":"","wasUpdate":false,"AuftragsNr":"08/15","PositionsNr":5,"processingTime":28575,"errorMsg":""}

api_getposdelta - Ermittelt die für das übergebene Projekt seit dem als zweiten Parameter gegebenen Zeitstempel erfolgten Änderungen an Projektpositionen

Erforderliche Parameter: 

projectnr, sinceutc

Optionale Parameter:

responseikelNr, Bezeichnung, Breite, Höhe, Tiefe, Einzelpreis, Rabatt, Gesamtpreis, Alt, DokumentNr, Status, Hopsasa, Suchfeld2, Suchfeld3, Suchfeld4

Konkretes Beispiel:

http://meinserver:8080/4DAction/api_getposdelta?token=41356A67726F4D219330ED924AE68E63&response=true&projectnr=08/15&sinceutc=0

In der Response steht dann ob das Projekt gefunden wurde und die Positionen ab dem gegebenen Zeitpunkt:

{"project": true,"givenprojectnr": "M003","error": "no_posdeltas_found"}