API-Geschäftshandbuch

Die API-Aufrufe erfolgen über die API für die Backlog Order Create API, die Backlog Order Change API, die Backlog-API für Angebote, die Backlog Retrieve-API zur Versandbenachrichtigung (ASN), die Backlog Retrieve-API für Finanzdokumente und die Backlog-API für Überweisungshinweise.

1. API-Push-Benachrichtigungen sind standardmäßig nicht aktiviert.
   1. Folgen Sie den nachstehenden Anweisungen, wenn Sie API-Push-Benachrichtigungen für Lieferankündigungen, Finanzdokumente und Angebote erhalten möchten.
      1. Zu TI.com/support
      2. „Neue Supportanfrage öffnen“ auswählen
      3. „Direkte Kundenabwicklung“ auswählen
      4. Füllen Sie das API-Push-Formularaus, fügen Sie es hinzu und senden Sie es ab


2. Durchgehender Auftragsablauf
    


3. API-Ersteinrichtung
   1. Fehler in einem API-Aufruf
      1. Der Kunde muss die Fehler beheben.
      2. Das Kundensystem wird eine vollständige Liste der Fehlerdetails im selben API-Aufruf abrufen.
      3. 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.
   2. Teilbestellungen zulässig
      1. Korrekte API-Bestelleingabe wird akzeptiert, während Ablehnungen nicht eingegeben werden.
      2. API-Bestellungsänderung wird immer auf der Ebene der einzelnen Posten durchgeführt.
   3. Synchrone Antwort
      1. Die synchrone Antwort ist die Standardeinstellung
      2. 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.
   4. Für Ihre Verbindung benötigte Kundendaten
      1. TI sendet Ihnen eine E-Mail-Benachrichtigung mit den für die Bestellung erforderlichen Angaben, wie z. B. die Identifikation des Verkäufers und des Warenempfängers (wenn Sie ein Auftragshersteller (Contract Manufacturer, CM) sind, wird die Identifikation des Endkunden angegeben)


4. Anforderungen an die Erstellung von API-Bestellungen   

   Auftragselemente	Obligatorisch/Optional	Zeichenbeschränkungen
   Bestellnummer (PO)	Obligatorisch	GROSSBUCHSTABEN; 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

   1. Für jede Bestellposition ist nur EINE einzelne CRD zulässig.
   2. Für jede Bestellposition unter derselben Bestellnummer sollte die Artikelnummer nicht dupliziert werden, da andernfalls die Bestelländerung  fehlschlägt.
   3. Für jede Bestellung werden mehrere Bestellpositionen mit derselben oder unterschiedlichen TI-Teilenummern akzeptiert.
   4. Bei Bestellungen mit „Endkunden“ können nur Materialien für denselben Endkunden unter derselben Bestellnummer akzeptiert werden.
   5. 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.

5. Ablaufdiagramm und Highlights zur Erstellung und Änderung von Aufträgen:
   
   1. Auftrag erstellt mit Ausgabe
      1. Wenn die Preise von CDP und der Preisvereinbarung (Pricing agreement, PA) von TI nicht übereinstimmen, ist das Ergebnis eine unvollständige Bestellung, die von TI überprüft wird.
      2. Wenn der CDP korrekt ist, wird TI den Preis aktualisieren – der Kunde muss nichts unternehmen.
      3. 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.
         1. Um Preisabweichungen zu überprüfen, sehen Sie sich die Datei des Kundenrückstandsberichts an, Registerkarte „Preisabweichungen“.
      4. 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.

6. Zeitraum für Stornierungen oder Änderungen von Bestellungen
   1. Änderungsauftragsfenster (Change Order Window, COW) definiert den Zeitraum, in dem Änderungen oder Stornierungen nicht mehr verarbeitet werden dürfen.
   2. DIE COW-Regeln hängen von der Art der Teile ab.
   3. Es gilt ab unserem geschätzten Versanddatum (Estimated Ship Date, ESD).
   4. TI lehnt alle Änderungen innerhalb der KUH ab, mit Ausnahme von CRD-Pull-in und Preisänderungen

      Teiletyp	Änderungszeitraum
      Standard (STD)	30 Tage ab dem geschätzten Versanddatum
      Benutzerspezifisch (Custom, CST)	90 Tage ab dem geschätzten Versanddatum
      Nicht stornierbar nicht rückgabefähig (Non- Cancellable Non-Returnable, NCNR)	Kann nicht storniert werden

       

7. Arten von zulässigen Bestellungsänderungen
   1. Kundenanforderungsdatum (Customer Request Date, CRD) Ausschieben oder Einziehen.
   2. Preisaktualisierung für Bestellposition.
   3. Verringerung der Menge der Bestellposition.
   4. Stornierung der Bestellposition.


8. Tipps zur Bestellungsänderung:
   1. Erstellen Sie eine neue Bestellung, um die Menge der Bestellposition zu erhöhen.
   2. Bestellpositionen, die vollständig mit einer Versandvorabmitteilung (Advanced Ship Notice, ASN) versendet wurden, können nicht geändert werden.
   3. Bestellposition oder Stornierung der Bestellung können zum Verlust des geschätzten Versanddatums (Estimated Ship Date, ESD) führen.
   4. Behalten Sie die ursprünglich bestellte Menge in der Bestellposition bei, wenn Sie das CRD, den Preis oder die Stornierung einer Bestellposition ändern.
   5. Beim Wechsel des CRD ist COW nicht zu vergessen
   6. Push-Outs innerhalb von COW führen zu Ablehnungen und Fehlern.
   7. Der Kunde muss den Preis der ursprünglichen Bestellposition über eine Auftragsänderung aktualisieren, um den neuen Effektivpreis zu erhalten.
   8. Behalten Sie die gleiche PO-und-PO-Positionsnummernstruktur im Änderungsantrag bei.


9. Tipps zu Überweisungshinweisen:
   1. Verwenden Sie die Finanzrechnungsnummer von TI
      1. Falls nicht verfügbar, verwenden Sie die Lieferscheinnummer oder die Nummer der Handelsrechnung, die Sie über die ASN erhalten haben.
      2. TI stellt die Zahler-Kennung des Kunden nach Einreichung des Formulars für das Kunden-Onboarding zur Verfügung.


10. 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.