Lieferanten können ihre Online Kataloge über die TecCom Portal Schnittstelle verbinden. Artikel können im Katalog ausgewählt und im TecCom Portal kopiert werden, wenn der Katalog an die Schnittstelle angepasst wurde. Der TecAlliance Support bietet weitere Informationen zu dieser Funktion.
Parameter können in beliebiger Reihenfolge und Kombination angegeben werden, bei Angabe von Menge und Mengeneinheit muss jedoch die richtige Reihenfolge und Angabe dieser Werte in der URL-Abfragezeichenfolge beachtet werden. Weitere Info siehe Punkt Ergänzung Menge und Mengeneinheit.
Unabhängig welchen Wert Sie benutzen, die Start-URL bleibt immer gleich:
https://teccom.tecalliance.net/newapp/requestorder/basket?
Nach der Start-URL wird der Parameter, Gleichheitszeichen und der gewünschte Wert angegeben.
Es können in der URL-Abfragezeichenfolge die folgenden Parameter angegeben werden:
| Parametername | Parameter | Link zum Beispiel |
|---|---|---|
| Produkt ID | p | Beispiel 1, 2, 3, 4, 5, 6 und 7 |
| Lieferantennummer | q | Beispiel 2 und 7 |
| Auftragskennung | u | Beispiel 3, 6 und 7 |
| Menge | s | Beispiel 4, 5, 6 und 7 |
| UoM / ME | o | Beispiel 4, 5, 6 und 7 |
Um mehr als einen Parameter anzugeben, muss ein &-Zeichen an den Anfang jedes zusätzlichen Parameters gesetzt werden.
Beispiele
Beispiel 1 - Ergänzung Produkt-ID
| Produkt-ID (p) | 123 |
URL-Abfragezeichenfolge:
https://teccom.tecalliance.net/newapp/requestorder/basket?p=123
Mit Hilfe der Lieferantennummer wird der entsprechende Lieferant ausgewählt.
| Produkt-IDs (p) | 123 + 456 |
| Lieferantennummer (s) | ABC |
URL-Abfragezeichenfolge:
https://teccom.tecalliance.net/newapp/requestorder/basket?p=123&p=456&s=ABC
| Auftragskennung (o) | Or1245 |
| Produkt-IDs (p) | 123 + 456 |
URL-Abfragezeichenfolge:
https://teccom.tecalliance.net/newapp/requestorder/basket?o&=Or1245&p=123&p=456
Damit die beiden Parameter dem richtigen Artikel zugeordnet werden, muss nach der Start-URL der Parameter products= und in den eckigen Klammern die Artikel sowie dazugehörigen Details ergänzt werden. Danach können weitere Parameter (wie z. B. Auftragskennung) angegeben werden.
Die Angaben in der eckigen Klammer müssen URL-codiert sein, die Reihenfolge von den Parametern in dieser sind jedoch egal und die Menge oder Mengeneinheit kann entfernt werden.
Aufgeschlüsselte Symbole:
| Zeichen | URL codiert |
|---|---|
| { | %7B |
| " | %22 |
| } | %7D |
Der gewünschte Artikel mit den dazugehörigen Details wird in den geschweiften Klammern angegeben. Danach erfolgt der Paramter in Anführungszeichen, im Anschluss Doppelpunkt und erneut in Anführungszeichen der Wert. Um einen weiteren Paramter zu ergänzen, muss ein Komma erfolgen und danach die Schritte wiederholt werden.
Sobald man mit den Angaben fertig ist, wird durch das Symbol ] die Angabe zum Artikel beendet.
Beispiel 4 - 1 Artikel + dazugehörige Menge und Mengeneinheit
| Produkt-ID (p) | 123 |
| Menge (q) | 10 |
| Mengeneinheit (u) | PCE |
Serialisierte Array:
[{"p":"123","q":10,"u":"PCE"}]
Vollständige URL-Abfragezeichenfolge:
https://teccom.tecalliance.net/newapp/requestorder/basket?products=[%7B%22p%22:%22123%22,%22q%22:%2210%22,%22u%22:%22PCE%22%7D]
Beispiel 5 - 2 Artikel + dazugehörige Menge und Mengeneinheit
Bei Angaben von mehreren Artikel wird nach dem Inhalt der ersten geschweiften Klammer ein Komma ergänzt, wieder eine geschweifte Klammer eröffnet und nach der Art wie bei der ersten befüllt.
| Produkt 1 | Produkt 2 | |
|---|---|---|
| Produkt-IDs (p) | 123 | 456 |
| Menge (q) | 10 | 100 |
| Mengeneinheit (u) | PCE | LTR |
Serialisierte Array:
[{"p":"123","q":10,"u":"PCE"},{"p":"456","q":100,"u":"LTR"}]
Vollständige URL-Abfragezeichenfolge:
https://teccom.tecalliance.net/newapp/requestorder/basket?products=[%7B%22p%22:%22123%22,%22q%22:%2210%22,%22u%22:%22PCE%22%7D,%7B%22p%22:%22456%22,%22q%22:%22100%22,%22u%22:%22LTR%22%7D]
Zusätzliche Parameter wie z. B. Auftragskennung können nach der eckigen Klammer wie gewohnt angegeben werden.
| Produkt 1 | Produkt 2 | |
|---|---|---|
| Produkt-IDs (p) | 123 | 456 |
| Menge (q) | 10 | 100 |
| Mengeneinheit (u) | PCE | LTR |
Serialisierte Array:
[{"p":"123","q":10,"u":"PCE"},{"p":"456","q":100,"u":"LTR"}]
| Auftragskennung (o) | Or1245 |
Vollständige URL-Abfragezeichenfolge:
https://teccom.tecalliance.net/newapp/requestorder/basket?products=[%7B%22p%22:%22123%22,%22q%22:%2210%22,%22u%22:%22PCE%22%7D,%7B%22p%22:%22456%22,%22q%22:%22100%22,%22u%22:%22LTR%22%7D]&o=Or1245
| Produkt 1 | Produkt 2 | |
|---|---|---|
| Produkt-IDs (p) | 123 | 456 |
| Menge (q) | 10 | 100 |
| Mengeneinheit (u) | PCE | LTR |
Serialisierte Array:
[{"p":"123","q":10,"u":"PCE"},{"p":"456","q":100,"u":"LTR"}]
| Auftragskennung (o) | Or1245 |
| Lieferantenkennung (s) | ABC |
Vollständige URL-Abfragezeichenfolge:
https://teccom.tecalliance.net/newapp/requestorder/basket?products=[%7B%22p%22:%22123%22,%22q%22:%2210%22,%22u%22:%22PCE%22%7D,%7B%22p%22:%22456%22,%22q%22:%22100%22,%22u%22:%22LTR%22%7D]&o=Or1245&s=ABC