...
...
api_get
Diese generische Methode ist hier dokumentiert: API & OTA-Integration#Datenlesenmitapi_get
Die Optionen innerhalb der Kunden API sind hier gelistet
Verfügbare Tabellen | gesperrte Felder |
|---|---|
| Kunden | PKUUID_12 |
| Ansprechpartner | PKUUID_90 |
| Kundengruppe | PKUUID_92 |
| KundenRabatt | PKUUID_111 |
| Kundenstatus | PKUUID_4 |
| Ansprechstatus | PKUUID_28 |
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,emailKunden
...
API testen
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
api_getkunden - Holt alle Kundendatensätze und gibt sie als Webseite aus
Erforderliche Parameter:
...
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.
Erforderliche Parameter:
...
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=0891Zu 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.