API-Geschäftshandbuch

Die TI Backlog API Suite für Bestellungen besteht aus: APIs für Angebote, Auftragsverwaltung, Abrufen von Versandvorabmitteilungen (Advanced Ship Notice, ASN), Abrufen von Finanzdokumenten und Überweisungshinweisen. Push-Benachrichtigungs-APIs sind ebenfalls verfügbar, um die Dateneingabe in das System des Kunden zu automatisieren. Folgen Sie den Anweisungen unten für weitere Details.

Durchgehender Auftragsablauf
API-Standardeinrichtung
1. Synchrone Antwort
  1. Mit einem einzigen API-Aufruf würde das Kundensystem wissen, ob TI die Anfrage vollständig bearbeitet hat und der tatsächliche Kundenauftrag im TI-System erfolgreich geändert wurde.
2. Teilweise PO-Erstellung und -Änderung zulässig
  1. Korrekte API-PO-Bestellpositionseingabe wird akzeptiert, während Ablehnungen nicht eingegeben werden.
  2. API-Bestellungsänderung wird immer auf der Ebene der einzelnen Posten durchgeführt.
3. Fehlerbehandlung
  1. Alle Fehlermeldungen oder Informationswarnungen werden in der API-Antwort zurückgegeben, entweder auf Auftragsebene oder auf Einzelpostenebene
  2. Mit einer vollständigen Liste von Warn- oder Fehlerdetails wird der Kunde besser kontrollieren, wie und wann der Fehler behoben und die Anfrage bei Bedarf erneut gesendet werden soll.
Push-APIs
1. API-Push-Benachrichtigungen sind nicht standardmäßig aktiviert, werden aber benötigt, um die TI-APIs in vollem Umfang nutzen zu können.
2. Um API-Push-Benachrichtigungen für Bestellungen, erweiterte Versandbenachrichtigungen und Finanzdokumente einzurichten, folgen Sie den untenstehenden Anweisungen
  1. Zu TI.com/support
  2. „Neue Supportanfrage öffnen“ auswählen
  3. „Direkte Kundenauftragsabwicklung“ auswählen
  4. Füllen Sie das API-Push-Formularaus, fügen Sie es hinzu und senden Sie es ab
Angebots-API
1. Mit der Backlog Angebots-API können Kunden Angebote erstellen und Antworten für TI-Produkte erhalten. Kunden können ebenfalls zuvor erstellte Angebote abrufen
2. Angebots-APIs können verwendet werden, um mehrere Angebotspositionen gleichzeitig für verschiedene Hersteller-Teilenummern (Manufacturer Part Numbers, MPNs) anzufordern. Wenn der Kunde ein Angebot mit derselben MPN für mehrere Positionen einreicht, verarbeitet TI nur die erste Instanz der MPN
3. Wenn die bei der Angebotsabgabe angeforderte Menge nicht den Mindestbestellwert, die Mindestbestellmenge (MOQ) oder die Standardpackungsmenge (SPQ) um ein Vielfaches erfüllt, rundet TI in der Angebotsantwort auf das nächstgelegene MOQ auf

API – Bestellungsmanagement

Ablaufdiagramm und Highlights der Auftragserstellung:

Anforderungen an die Erstellung von API-Bestellungen

Obligatorische und optionale Felder für die Auftragserstellung

Auftragselemente	Obligatorisch/Optional	Zeichenbeschränkungen
Bestellnummer (PO)	Obligatorisch	Nicht mehr als 35 Zeichen; Kein Leerzeichen in der Bestellnummer
Bestellposition	Obligatorisch
Hersteller-Teilenummer (Manufacturer part number, MPN)	Obligatorisch
Direkter Preis für den Kunden (Customer direct price, CDP)	Obligatorisch	Nicht mehr als fünf (5) Dezimalstellen
Vom Kunden gewünschtes Datum (Customer requested date, CRD)	Obligatorisch
Menge	Obligatorisch
Teilenummer des Kunden (Customer part number, CPN)	Optional
Endkunde	Optional (erforderlich für CM)	GROSSBUCHSTABEN

Für jede PO-Bestellposition ist nur EINE einzelne CRD zulässig
Für jede PO-Bestellposition unter derselben Auftragsnummer sollte die Artikelnummer nicht dupliziert werden, da andernfalls die PO-Änderung fehlschlägt.
Für jede Bestellung werden mehrere PO-Bestellpositionen mit derselben oder unterschiedlichen TI-Teilenummern akzeptiert.
Bei Bestellungen mit „Endkunden“ können nur Materialien für denselben Endkunden unter derselben Bestellnummer akzeptiert werden.
Die Menge sollte ein Vielfaches der TI-Standardpackungsmenge (Standard pack quantity, SPQ) sein und sowohl den Mindestbestellwert (Minimum order requirement, MOQ) als auch den Mindestartikelwert (Minimum item value, MIV) erfüllen, wie im TI-Produktkatalog definiert.

Regeln für die Angebotsantwort
1. Für Kunden, bei denen eine Teillieferung zulässig ist, erhalten Sie je nach Verfügbarkeit des Produkts möglicherweise mehrere Einteilungen/Voraussichtliches Versanddatum (Estimated Ship Date, ESD) pro Bestellposition

Anforderungen an die Änderungen von API-Bestellungen

Arten von zulässigen Bestellungsänderungen
- CRD – Ausschieben oder Einziehen
- Preisaktualisierung für Bestellposition
- Verringerung der Menge der Bestellposition.
- Stornierung der Bestellposition

Zeitraum für Änderungen oder Stornierungen von Bestellungen

Änderungsauftragsfenster (Change Order Window, COW) definiert den Zeitraum, in dem Änderungen oder Stornierungen nicht mehr verarbeitet werden dürfen.
- STD (Standard) COW: 30 Tage
- Nicht-STD (Nicht-Standard) COW: 90 Tage
TI lehnt alle Änderungen innerhalb der KUH ab, mit Ausnahme von CRD-Pull-in und Preisänderungen

Die Regeln für COW-Stornierungen und -Umplanungen hängen von der Art der Teile ab

Für Produkte, Wafer-Produkte und Die-Produkte, kann der Käufer unter Berücksichtigung der folgenden Regeln Bestellungen stornieren oder auf einen neuen Termin verschieben:

Vom Käufer gewünschte Stornierung oder Verschiebung	Standard-Produkte	Nicht-Standard-Produkte
< als 30 Tage vor dem voraussichtlichen Lieferdatum	Nicht zulässig	Nicht zulässig
30–90 Tage vor dem voraussichtlichen Lieferdatum	Zulässig	Nicht zulässig
> als 90 Tage vor dem voraussichtlichen Lieferdatum	Zulässig	Nach Genehmigung durch TI. Es können zusätzliche Kosten anfallen.

Für Evaluierungsartikel: Aufträge für Evaluierungsgegenstände dürfen nicht storniert oder neu terminiert werden.

Unbeschadet der oben genannten Regeln gelten spezielle Stornierungs- und Neuterminierungsbedingungen für bestimmte Artikel, die TI dem Käufer vor Annahme der Bestellung mitteilen muss.

Regeln für Auftragsänderungen
- Auftragsänderungen erfolgen auf Bestellpositionsebene
  - Die Summe der Einteilungsmengen muss mit der Gesamtmenge der Bestellposition übereinstimmen, auch wenn der Kunde nur eine bestimmte Einteilung ändern möchte
  - Die ursprüngliche Menge der vollständigen Bestellposition ist nur dann nicht erforderlich, wenn der Kunde eine Mengenreduzierung in der PO-Bestellposition anfordert
- Erstellen Sie eine neue Bestellung, um die Menge der Bestellposition zu erhöhen.
- Bestellpositionen, die vollständig mit einer Versandvorabmitteilung (Advanced Ship Notice, ASN) versendet wurden, können nicht geändert werden.
- Die Änderung des Versands an die Adresse ist sowohl für die Bestellkopf- als auch für die Einzelpostenebene auf der Ebene des Bestandskundenversands an Adressen innerhalb von TI zulässig
- Der Kunde muss den Preis der ursprünglichen Bestellposition über eine Auftragsänderung aktualisieren, um den neuen Effektivpreis zu erhalten.
- Bei Kunden mit kompletter Liefereinrichtung kann eine Erhöhung der Bestellmenge zu einem Verlust des geschätzten Versanddatums führen

Warnung und Fehlerbehandlung bei der Auftragsverwaltung
1. Wenn die Preise von CDP und der Preisvereinbarung (Pricing agreement, PA) von TI nicht übereinstimmen, ist das Ergebnis eine unvollständige Bestellung, die sowohl vom Kunden als auch von TI überprüft wird.
  - Wenn der CDP korrekt ist, wird TI den Preis aktualisieren – der Kunde muss nichts unternehmen.
  - Wenn der TI-Preis stimmt, müssen Sie CDP über eine Auftragsänderung aktualisieren. Sie erhalten eine Antwort mit der Angabe, ob die Preisabweichung behoben ist.
2. Die Bestellung wird nicht erstellt, wenn SPQ/MOQ/MIV-Fehler vorliegen. Korrigieren Sie die Menge und senden Sie sie erneut an TI, um die Bestellung zu erstellen.
3. Eine vollständige Liste der Fehlerdetails finden Sie in unseren detaillierten Fehlerlisten:

API – Versandvorabmitteilung (ASN)
1. Die Backlog ASN-Retrieve-API ermöglicht es Kunden, detaillierte Informationen zu Ihrer Sendung abzurufen, z. B. Sendungsverfolgungsnummer, Spediteurinformationen und Handelsrechnung
API – Finanzdokument
1. Die Retrieve-API für Backlog-Finanzdokumenten ermöglicht es Kunden, Finanzrechnungsinformationen wie Rechnungsnummer, Rechnungsbetrag und Rechnungsdatum abzurufen
API – Überweisungshinweis
1. Die Backlog-Überweisungshinweis-API bietet autorisierten Kunden die Möglichkeit, Überweisungsinformationen zu senden, die Zahlungsdetails bestätigen.
Benutzerakzeptanztestszenarien (User acceptance testing, UAT), um die Testphase zu bestehen:
1. Sobald der Kunde die Selbstbedienungs-Testszenarien 1.0–2.1 abgeschlossen hat, wird sich unser GBO-Regionalteam mit der Admin-E-Mail in Verbindung setzen, die Zugang zu den API-Schlüsseln hat.

Sidebar - Backlog

API-Geschäftshandbuch