// ********************************
// **** [C] Operative Requests ****
// ********************************
// **** Liste der Niederlassungen ****
getHeadquartersList
29142dea6c4002cc7bf88714ca4238a0b9531281ac23820dcc509a6f
100
314282
// **** Kontaktliste auf Basis des Suchbegriffs ****
// Request
getContactList
HASH
100
23
Suchbegriff
1
Niederlassungs-ID // Muss gesetzt sein
cs // cs = customer => (Alle) Kontakte mit einem Kundenbezug
77 // z.B. eine konkrete "cs_id" bei Typ "cs" => Kontakte nur dieses Kunden
yes // Wenn nur eine Präfix-Suche initiert werden soll, dann "YES" oder "1"
// Response
Bezeichnung
Bezeichnung
....
Wert
Wert
....
....
....
// **** Kundenliste auf Basis des Suchbegriffs ****
// Request
getCustomerList
HASH
100
23
Suchbegriff
Niederlassungs-ID
// Response
ID des Datensatzes
Kundennummer
....
....
// **** Daten eines Kunden ****
// Request
getCustomerSpecial
HASH
100
23
ID des Kundendatensatzes // (Entweder oder gesetzt)
Kundennummer (EID)
Niederlassungs-ID
// Response
ID des Datensatzes
Kundennummer
Hausnummer
PLZ
// **** Kostenstellen eines Kunden ****
// Request
getCostcenterListOfCustomer
HASH
100
23
ID des Kundendatensatzes // (Entweder oder gesetzt)
Kundennummer (EID)
// Response
Kostenstellen-ID des Datensatzes
ID des zugehörigen Kunden
Kundennummer
ID der übergeordneten Kostenstelle im Kostenstellenbaum
ID der Niederlassung
....
....
// **** Kostenstellenadressen einer Kostenstelle ****
// Request
getCostcenterAddressList
HASH
100
23
ID der Kostenstelle
// Response
Kostenstellen-ID
Firma
Firma2
Firma3
Firma4
// ID der Adresse
ID des Adresstyps // 1 = Postanschrift, 2 = Rechnungsanschrift, 3 = Rechnungsversandanschrift, 4 = Abhol-/Lieferadresse
....
....
// **** Transporteursliste auf Basis des Suchbegriffs ****
// Request
getCourierList
HASH
100
23
Suchbegriff
Niederlassungs-ID
// Response
ID des Datensatzes
Kundennummer
....
....
// **** Daten eines Transporteurs ****
// Request
getCourierSpecial
HASH
100
23
ID des Kundendatensatzes // (Entweder oder gesetzt)
Kundennummer (EID)
Niederlassungs-ID
// Response
ID des Datensatzes
Kundennummer
Hausnummer
PLZ
// **** Fahrzeugliste auf Basis des Suchbegriffs ****
// Request
getVehicleList
HASH
100
23
Suchbegriff
// Response
(Interne) ID des Datensatzes
(Externe) Fahrzeugnummer
(Interne) ID des Fahrers, dem das Fahrzeug zugeordnet ist
....
....
// **** Daten eines Fahrzeugs ****
// Request
getVehicle
HASH
100
23
(Interne) ID des Fahrzeugdatensatzes
// Response
(Interne) ID des Datensatzes
Nummer des Fahrzeugtypes // Erfordert Mapping !!!!
(Externe) Fahrzeugnummer
// *****************
// **** Termine ****
// *****************
// **** Initial folgend die Termin-Kategorien laden (!) ****
// Request
getApEnvironment
HASH
groupware
100
23
NL-ID
// Response
....
....
....
....
....
....
// **** Termine anfragen (eines Monats, einer Woche, eines Tages) ****
// Request (Monat)
getAppointmentsOfOneMonth
HASH
100
23
groupware // Statischer Text "groupware"
4
2017
NL-ID
23
Kunden-ID // (Entweder beides leer (default) oder oder gesetzt)
Kundennummer
// Request (Tag)
getAppointmentsOfOneDay
HASH
100
23
groupware // Statischer Text "groupware"
7
4
2017
.... siehe "getAppointmentsOfOneMonth" ....
// Request (KW)
getAppointmentsOfOneWeek
HASH
100
23
groupware // Statischer Text "groupware"
15
2017
.... siehe "getAppointmentsOfOneMonth" ....
// Response (für alle Intervalle)
2017
04
dd
ID des Termins
Terminstart
(Company(!)-)ID des Kunden, der dem Termin zugeordnet ist
Kundennummer
Terminende
ID des Erstellers
Termin bestätigt?
Telefon Kunde
Telefon Kunde
Zuordnung zur Kategorie 1
Zuordnung zur Kategorie 2
Zuordnung zur Kategorie 3
Zuordnung zur Kategorie 4
....
....
....
// **** Termin erzeugen (insert), ändern (update), entfernen (delete) ****
// Request
actionAppointment
HASH
DB
USR_ID
// "insert"|"update"|"delete"
// ID Termin, erforderlich bei "update" und "delete"
// Startzeitpunkt des Termins
// Endezeitpunkt des Termins
// Wert für Terminkategorie 1 (=> "getApEnvironment")
// Wert für Terminkategorie 2 (=> "getApEnvironment")
// Wert für Terminkategorie 3 (=> "getApEnvironment")
// Wert für Terminkategorie 4 (=> "getApEnvironment")
// Termin mit Kunden
// Teilnehmer (kommaseparierte Liste mit mit "usr_id")
// Berichtstext
// **** Berichte (eines Kunden oder eines Transporteurs) für einen spezifizierten Zeitraum ****
// Request
getReportList
HASH
DB
USR_ID
groupware // Statischer Text "groupware"
JJJJ-MM-TT
JJJJ-MM-TT
cs // Statisch "cs" wenn Kundenberichte ODER "cr" wenn Transporteursberichte
// => Vorerst Kunden
CS_ID // Interne Kunden-ID (= "cs_id") ODER Interne Transporteurs-ID (= "cr_id")
// Optional aus vorher geladenen Termin-Kategorien per "getApEnvironment":
// 1="Verschiedenes", 2="Abschluss", 3="Angebotserstellung", ... 10="Konferenz/Seminar/Urlaub", ...
// Response
Berichts-ID
Berichtstyp (numerisch)
Berichtstext
// Wenn "1", dann "vertraulich"
Ersteller-ID // DEPRICATED, "" nutzen
Ersteller-ID
// Name des Erstellers
// Vorname des Erstellers
// Telefonnr. des Erstellers
// EID des Kunden oder Transporteurs
// Firma des Kunden oder Transporteurs
// Firma2 des Kunden oder Transporteurs
// Niederlassungs-ID
// Name der Niederlassung
....
// **** Einzelner Bericht (eines Kunden oder eines Transporteurs) ****
// Request
getReport
HASH
DB
USR_ID
groupware // Statischer Text "groupware"
Berichts-ID // ID des Berichts (für den spezifizierten Objekttyp)
cs // Statisch "cs" wenn Kundenberichte ODER "cr" wenn Transporteursberichte
// => Vorerst Kunden
// Response
Berichts-ID
Berichtstyp (numerisch)
Berichtstext
// Wenn "1", dann "vertraulich"
Ersteller-ID // DEPRICATED, "" nutzen
Ersteller-ID
// Name des Erstellers
// Vorname des Erstellers
// Telefonnr. des Erstellers
// EID des Kunden oder Transporteurs
// Firma des Kunden oder Transporteurs
// Firma2 des Kunden oder Transporteurs
// Niederlassungs-ID
// Name der Niederlassung
// **** Bericht erzeugen (insert), ändern (update), entfernen (delete) ****
// Request
actionReport
HASH
DB
USR_ID
// "insert"|"update"|"delete"
// ID Bericht, erforderlich bei "update" und "delete"
// Berichtstyp, erforderlich bei "insert", optional bei "update"
// "cs"|"cr" (Bericht für Kunde|Transporteur...)
// ID Kunde/Transporteur
// Berichtstext
// Kennzeichen für "vertraulich" (= "1")
BEISPIELE:
- Bsp.: Bericht neu (insert)
actionReport
HASH
DB
USR_ID
insert
// ID Bericht wird automatisch generiert
8 // Berichtstyp wird überschrieben (=> Typen wie bei Terminen)
cs // hier Kunde
789 // ID Kunde (cs_id)
// Berichtstext
// leer, nicht "vertraulich"
- Bsp.: Bericht ändern (update)
actionReport
HASH
DB
USR_ID
update
12345 // ID Bericht, erforderlich bei "update"
4 // Berichtstyp wird überschrieben (=> Typ wie bei Termin)
// leer
// leer
// Berichtstext
1 // hier "vertraulich"
- Bsp.: Bericht entfernen (delete)
actionReport
HASH
DB
USR_ID
delete
12345 // ID Bericht, erforderlich bei "delete"
// Response
// Angeforderte Aktion ("insert"|"update"|"delete")
// Angeforderte oder erzeugte Berichts-ID
\n";
\n";
// **** Statistik eines Kunden für einen spezifizierten Zeitraum ****
// Request
getCsStatistic
HASH
DB
USR_ID
Kunden-ID // (Entweder beides leer (default) oder oder gesetzt)
Kundennummer
JJJJ-MM-TT
JJJJ-MM-TT
// Response
CS_ID
CS_EID
WERT