Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

api_get

Diese generische Methode ist hier dokumentiert: API & OTA-Integration#Datenlesenmitapi_get

Die Optionen innerhalb der Projekte Kunden API sind hier gelistet

Verfügbare Tabellen

gesperrte Felder

KundenPKUUID_12
Ansprechpartner

PKUUID_90

KundengruppePKUUID_92
KundenRabattPKUUID_111
KundenstatusPKUUID_4
AnsprechstatusPKUUID_28

Hilfreiche api_get-Aufrufe für Kunden

...

Wir haben auf GitHub und unseren FTP-Servern Templates bereitgestellt mit denen Sie die APIs von profacto ausprobieren können. Mit dem Kunden API Template können Sie schnell und unkompliziert Aufrufe der API durchführen und das Ergebnis begutachten.

Kunden - API-Methoden

Kundenliste über api_getkundenImage Added

api_getkunden - Holt alle Kundendatensätze und gibt sie als Webseite aus

...

In der JSON-Rückmeldung wird eine Liste aller verfügbaren Kundendatensätze zurückgegeben die für den durch den Token definierten Nutzer zugänglich sind:

...

api_put_customer (API Kunden) - Schreibt einen Kundendatensatz.

...

http://meinServer:8080/4DAction/api_put_customer?token=5E05A427CD134432A28F2DAF11EC500E&Name1=Schreinerei%20Meier&PLZ=48149&Strasse=Hauptstr.%201&response=trueJSON

In der JSON-Rückmeldung wird auch die neue vergebene Kundennummer rückgeliefert:

{"success":true,"wasUpdate":false,"mainKey":"n20-01170","processingTime":54,"errorMsg":""}

api_put_contact (API Kontakte) - Schreibt einen Kontakt zu einem vorhandenden Kunden oder Lieferanten.

Erforderliche Parameter: 

VorName, Name, TypNr, Typ

Ausgeschlossene Parameter:

PKUUID_90

Optionale Parameter:

Telefon, Telefax, response, update

Konkretes Beispiel:

http://meinserver:8080/4DAction/api_put_contact?token=5223EE4D186449B0BDBE9ED7EC53F747&VorName=Heinz&Name=Ruehmann&TypNr=_0573&Typ=1&Telefon=089&Telefax=0891

Zu Beachten ist, daß die TypNr je nach Ansprechpartner der KundenNr, LieferantenNr oder PersonalNr entsprechen muß.

In der JSON-Rückmeldung haben Sie beispielhaft folgenden Inhalt:

{"success":true,"error":"","processingTime":6996,"errorMsg":""}

api_get

Diese generische Methode ist hier dokumentiert: API & OTA-Integration#Datenlesenmitapi_get

Die Optionen innerhalb der Projekte API sind hier gelistet

Verfügbare Tabellen

gesperrte Felder

KundenPKUUID_12
AnsprechpartnerPKUUID_90

Hilfreiche api_get-Aufrufe für Kunden

Kunden abrufen

mit KundenNr, Anrede, Name1, Name2, PLZ, Ort, Telefon und Kundengruppe, sowie email.

http://meinserver:8080/4DAction/api_get?token=6BB20FDAAA5F45DD9B7197876B398398&table=Kunden&fields=KundenNr,Anrede,Name1,Name2,PLZ,Ort,Telefon,Kundengruppe,email

Kunden - API-Methoden

api_getkunden - Holt alle Kundendatensätze und gibt sie als Webseite aus

Erforderliche Parameter: 

Token

Konkretes Beispiel:

http://meinserver:8080/4DAction/api_getkunden?token=31FC6A14217241929BA959F92E2B66B7

In der JSON-Rückmeldung wird eine Liste aller verfügbaren Kundendatensätze zurückgegeben die für den durch den Token definierten Nutzer zugänglich sind:

Kundenliste über api_getkundenImage Removed

api_put_customer (API Kunden) - Schreibt einen Kundendatensatz.

Erforderliche Parameter: 

Name1, PLZ

Ausgeschlossene Parameter:

PKUUID_12

Konkretes Beispiel:

http://meinServer:8080/4DAction/api_put_customer?token=5E05A427CD134432A28F2DAF11EC500E&Name1=Schreinerei%20Meier&PLZ=48149&Strasse=Hauptstr.%201&response=true

In der JSON-Rückmeldung wird auch die neue vergebene Kundennummer rückgeliefert:

{"success":true,"wasUpdate":false,"mainKey":"n20-01170","processingTime":54,"errorMsg":""}

api_put_contact (API Kontakte) - Schreibt einen Kontakt zu einem vorhandenden Kunden oder Lieferanten.

Erforderliche Parameter: 

VorName, Name, TypNr, Typ

Ausgeschlossene Parameter:

PKUUID_90

Optionale Parameter:

Telefon, Telefax, response, update

Konkretes Beispiel:

http://meinserver:8080/4DAction/api_put_contact?token=5223EE4D186449B0BDBE9ED7EC53F747&VorName=Heinz&Name=Ruehmann&TypNr=_0573&Typ=1&Telefon=089&Telefax=0891

Zu Beachten ist, daß die TypNr je nach Ansprechpartner der KundenNr, LieferantenNr oder PersonalNr entsprechen muß.

In der JSON-Rückmeldung haben Sie beispielhaft folgenden Inhalt:

...


Wird über den Aufruf auch das Feld "Status" mitgeliefert, verhält sich profacto, als wenn der Anwender den Status in der Erfassung über das Popup-Menü ausgewählt hätte: Die vom Status abhängigen Felder werden dann ebenfalls passend gesetzt.