Überblick

Folgen Sie diesen Schritten, um mit der Backlog API Suite von TI zu beginnen: 

1. Voraussetzungen für Zugang und Entwicklung erfüllen 
2. Kundenidentifikationscodes erhalten 
3. Den typischen Bestellablauf mit der Backlog API Suite überprüfen
4. Authentifizieren, um ein Zugriffstoken zu erhalten
5. Erfahren Sie, wie Sie Angebote für TI-Produkte erstellen und abrufen können
6. Erfahren Sie, wie Sie eine Testbestellung erstellen können
7. Erfahren Sie, wie Sie auf Ihre Bestellinformationen zugreifen können
8. Erfahren Sie, wie eine Bestellung geändert werden kann 
9. Erfahren Sie, wie Sie die Sendungsverfolgung abrufen können
10. Erfahren Sie, wie ein Finanzdokument abgerufen werden kann.
11. Erfahren Sie, wie Sie einen Überweisungshinweis erstellen
12. Support erhalten

 

Schritt 1: Voraussetzungen für die Einrichtung und Überprüfung des Onboarding-Prozesses

Nur zugelassene Kunden können Anwendungen mit der Backlog API Suite erstellen. Um eine Genehmigung zu erhalten:

1. Legen Sie ein myTI-Konto an, oder melden Sie sich bei Ihrem bestehenden myTI-Konto an.
2. Verknüpfen Sie Ihr myTI-Konto mit einem Firmenkonto  
3. Melden Sie sich im API Portal an
4. Überprüfen Sie den Prozess zum Onboarding von Kunden
5. Senden Sie das Kunden-Onboarding-Formular ab und überprüfen Sie es
6. Richten Sie TI als Lieferant in Ihrem internen System ein
7. Prüfen Sie das API-Geschäftshandbuch für Geschäfts- und Prozesswissen

 

Schritt 2: Kundenidentifikationscodes erhalten.

1. Nach dem Ausfüllen des Onboarding-Formulars stellt TI die Kundenidentifikationscodes für Ihre Website bereit. Diese Codes werden für die Backlog-API-Verbindung für Aufträge, Änderungsaufträge und Angebote verwendet. Diese Codes erscheinen auch auf verschiedenen ausgehenden Dokumenten, die an den Kunden gesendet werden:
   1. Die Lieferadresse(n) gibt an, wohin TI das Produkt versendet.
   2. Der Endkunden-Identifikationscode ist nur für zugelassene Vertragshersteller (Contract Manufacturers, CM) oder Kunden, die im Auftrag eines anderen Kunden einkaufen.
2. Die Verkäuferinformationen von TI mit den Bankdaten werden zusammen mit den Kundenidentifizierungscodes per E-Mail-Benachrichtigung übermittelt.
   1. Der Kunde kann über eine verlinkte PDF-Datei auf die Lieferanten- und Finanzinformationen von TI zugreifen. Dies dient dazu, die Einrichtung des Lieferanten in Ihrem System zu erleichtern. Die PDF-Datei enthält die Postanschrift von TI, den NAICS-Code, die Bundessteueridentifikationsnummer, den Jahresumsatz und die Standardzahlungsinformationen. Die PDF-Datei enthält auch den Link zu unseren Jahresberichten, dem Bericht zum gesellschaftlichen und sozialen Engagement und den Qualitätszertifizierungen. Abhängig von der Antwort, die Sie bei der Kundeneinführung gegeben haben, geben wir in dieser E-Mail-Benachrichtigung das Land unserer Bank an, das Sie bei der Einrichtung des Händlers verwenden müssen.

 

Schritt 3: Übersicht über den Bestellablauf

1. Das Standard-API-Format von TI wird abgerufen. Wenn API-Push bevorzugt wird, lesen Sie das API-Geschäftshandbuch
2. Authentifizieren Sie sich mit Ihrem zugewiesenen API-Schlüssel und -Geheimnis.
3. Vergewissern Sie sich, dass das/die Teil(e), das/die Sie bestellen möchten, in Ihrer TI-Preisvereinbarung enthalten ist/sind. Andernfalls könnten Sie ein Angebot erstellen
4. Erstellen Sie Ihren Auftrag mit dem gewünschten Payload und senden Sie ihn an die Backlog API für Bestellungen.
5. Die API antwortet mit dem Statuscode 201 Created und einer JSON-Datei, die die Auftragsbestätigung enthält.
6. Abfrage der Backlog API für Bestellungen nach dem Auftragsstatus und zusätzlichen Auftragsdetails.
7. Nach dem Versand der Bestellung können Sie die Sendungsverfolgung über die ASN-API (Advanced Ship Notice)-Abfrage-API und Rechnungen über die Finanzdokumente-API abrufen.
8. Die API für Überweisungshinweise ist obligatorisch. Rufen Sie die Remittance Advice API ab, um Überweisungsinformationen an TI zu senden.
9. Möchten Sie Beispielcode für jeden dieser Schritte sehen? Laden Sie unseren Beispielcode herunter.

 

Schritt 4: Authentifizieren

TI hat seine API-Suiten mit OAuth 2.0 gesichert. Bevor Sie die API-Suite verwenden, müssen Sie sich authentifizieren und ein Zugriffstoken erhalten.  Weitere Details finden Sie auf der Seite Authentifizierung  .

curl --request POST \   
       --url https://transact.ti.com/v1/oauth/accesstoken \   
       --header 'Content-Type: application/x-www-form-urlencoded' \   
       --data grant_type=client_credentials \   
       --data client_id=<<INSERT YOUR CLIENT KEY>> \   
       --data client_secret=<<INSERT YOUR SECRET>>

Schritt 5: Erstellen und Abrufen von Angeboten für TI-Produkte

Mit der Angebots-API können autorisierte Kunden ein Angebot innerhalb des TI-Unternehmenssystems erstellen. Ein Angebot kann für mehrere Teile und Mengen aufgegeben werden. Sie erhalten eine Angebotsnummer als Referenz.  Die Antworten auf Angebote sind in der Regel innerhalb von 30 Minuten bis 24 Stunden nach Einreichung eines Angebots verfügbar. „quoteStatus“ gibt an, ob ein Angebot angenommen, abgelehnt oder geändert wird; „Status“ gibt an, ob eine Bestellposition „Ausstehend“, „Angebot“ oder „kein Angebot“ ist. Weitere Informationen finden Sie auf der Backlog-API-Seite für Angebote.

Beispiel für das Erstellen einer Angebotsanfrage:

curl --request POST \
--url 'https://transact-pre.ti.com/v2/backlog/quotes' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "quote": {
    "customerQuoteNumber": "TEST-AW-20200224-G115",
    "quoteReason": "CD",
    "contactName": "John Smith",
    "contactEmailAddress": "john-smith@test-customer123.com",
    "contactPhoneNumber": "888-888-8888",
    "endCustomerCompanyName": "Company XYZ",
    "endCustomerNumber": "",
    "endCustomerWebsite": "https://www.companyxyz.com",
    "lineItems": [
      {
        "tiPartNumber": "SN74LS00N",
        "quantity": 2500,
        "requestedUnitPrice": 1.2,
        "requestedUnitPriceCurrencyCode": "USD",
        "competitorName": "Competitor N",
        "competitorPartNumber": "SNKLLPO23",
        "competitorUnitPrice": 1.43,
        "competitorCurrencyCode": "USD"
      }
    ]
  }
}
DATA

Beispiel für das Erstellen einer Angebotsantwort:

{
	"customerQuoteNumber": "TEST-AW-20200224-G115",
	"quoteNumber": "26645389",
	"quoteReason": "CD",
	"endCustomerCompanyName": "Company XYZ",
	"quoteStatus": "Accept",
	"quoteStartDate": "2023-03-28T00:00:00Z",
	"quoteEndDate": "2023-09-24T00:00:00Z",
	"lineItems": [
		{
			"tiLineItemNumber": 10,
			"tiPartNumber": "SN74LS00N",
			"quantity": 2500,
			"requestedUnitPrice": 1.2,
			"status": "Pending"
		}
	]
}

Beispiel für das Abrufen einer Angebotsanfrage:

curl --request GET \   
--url 'https://transact-pre.ti.com/v2/backlog/quotes/?quoteNumber={quoteNumber}' \
--header 'Authorization: Bearer {access_token}' \

Beispiel für das Abrufen einer Angebotsantwort:

{
	"customerQuoteNumber": "TEST-AW-20200224-G115",
	"quoteNumber": "26645389",
	"quoteReason": "CD",
	"endCustomerCompanyName": "Company XYZ",
	"quoteStatus": "Accept",
	"quoteStartDate": "2023-03-28T00:00:00Z",
	"quoteEndDate": "2023-09-24T00:00:00Z",
	"lineItems": [
		{
			"tiLineItemNumber": 10,
			"tiPartNumber": "SN74LS00N",
			"quantity": 2500,
			"requestedUnitPrice": 1.2,
			"status": "Pending"
		}
	]
}

Schritt 6: Test-Bestellung erstellen

Backlog- Testaufträge werden in unserer Vorserien-Testumgebung simuliert und dienen speziell der Unterstützung bei der Entwicklung Ihrer Anwendung.  Bei den zurückgegebenen Informationen handelt es sich um simulierte Testdaten, die nur zu Demonstrationszwecken dienen und keine verarbeiteten Informationen darstellen.  

Rückstand Testauftrag erstellen url: https://transact-pre.ti.com/v2/backlog/orders (Vorserie)

1. Um eine Bestellung aufgeben zu können (Test- oder Produktionsauftrag), muss der Kunde genehmigt werden, die Einstellungen konfiguriert und den Einführungsprozess abgeschlossen haben.
2. Sobald der Kunde erfolgreich einen Test für die Auftragserfassung und -änderung durchgeführt hat, folgen Sie den Szenarien für Benutzerakzeptanztests im API-Geschäftshandbuch, um die Testphase abzuschließen

Wenn Sie bereit sind, eine Produktions-Backlog-Bestellung aufzugeben, überprüfen Sie alle Parameter, die Sie im Payload der Anfrage senden möchten, und verwenden Sie die Produktionsversionen der API-URLs für Authentifizierung und Backlog-Bestellung: https://transact.ti.com/v1/oauth and https://transact.ti.com/v2/backlog/orders).   Wenn es bei der Verbindung zu Timeouts kommt, insbesondere bei Bestellungen mit mehr als 30 Bestellpositionen, sollten Sie die Zeitüberschreitung für die Verbindung auf 5 Minuten einstellen, um Timeout-Fehler zu vermeiden.

Weitere Informationen zu Test- und Produktionsbestellungen finden Sie auf der Dokumentationsseite der Backlog API für Bestellungen.

Beispiel: Backlog-Testbestellung – Anfrage erstellen: 

curl --request POST \
--url 'https://transact-pre.ti.com/v2/backlog/orders' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "order": {
    "customerPurchaseOrderNumber": "TestPO-230405-01",
    "shipToAccountNumber": "12354978",
    "endCustomerCompanyName": "Company B",
    "lineItems": [
      {
        "customerLineItemNumber": "1",
        "tiPartNumber": "SN7407N",
        "customerPartNumber": "TILMNOP",
        "customerAnticipatedUnitPrice": 0.30,
        "customerCurrencyCode": "USD",
        "schedules": [
          {
            "requestedQuantity": 2000,
            "requestedDeliveryDate": "2023-05-01"
          }
        ]
      },
      {
        "customerLineItemNumber": "2",
        "tiPartNumber": "DRV8304SRHAR",
        "customerPartNumber": "TIABCDEF",
        "customerAnticipatedUnitPrice": 1.00,
        "customerCurrencyCode": "USD",
        "schedules": [
          {
            "requestedQuantity": 5000,
            "requestedDeliveryDate": "2023-06-01"
          }
        ]
      },
      {
        "customerLineItemNumber": "3",
        "tiPartNumber": "SN7407DR",
        "customerPartNumber": "TIABCDEF",
        "customerAnticipatedUnitPrice": 0.22,
        "customerCurrencyCode": "USD",
        "schedules": [
          {
            "requestedQuantity": 7500,
            "requestedDeliveryDate": "2023-06-01"
          }
        ]
      }
    ]
  }
}

Beispiel: Backlog-Testbestellung – Antwort erstellen: 

{
	"orders": [
		{
			"orderNumber": "1019621260",
			"orderDate": "2023-04-05 14:31:16",
			"customerPurchaseOrderNumber": "TestPO-230405-01",
			"orderStatus": "OPEN",
			"lineItems": [
				{
					"tiLineItemNumber": "000010",
					"tiPartNumber": "SN7407N",
					"customerLineItemNumber": "1",
					"customerPartNumber": "TILMNOP",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 2000,
					"customerAnticipatedUnitPrice": "0.30",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.339,
					"tiCurrencyCode": "USD",
					"messages": [
						{
							"code": "TI-TXT-051",
							"type": "INFO",
							"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": "2000",
							"requestedDeliveryDate": "2023-05-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 2000,
									"estimatedShipDate": "2024-07-24",
									"estimatedDeliveryDate": "2024-07-29",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000020",
					"tiPartNumber": "DRV8304SRHAR",
					"customerLineItemNumber": "2",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 5000,
					"customerAnticipatedUnitPrice": "1.00",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 1.08,
					"tiCurrencyCode": "USD",
					"messages": [
						{
							"code": "TI-TXT-051",
							"type": "INFO",
							"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": "5000",
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 5000,
									"estimatedShipDate": "2024-07-24",
									"estimatedDeliveryDate": "2024-07-29",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000030",
					"tiPartNumber": "SN7407DR",
					"customerLineItemNumber": "3",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 7500,
					"customerAnticipatedUnitPrice": "0.22",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.266,
					"tiCurrencyCode": "USD",
					"messages": [
						{
							"code": "TI-TXT-051",
							"type": "INFO",
							"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": "7500",
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 7500,
									"estimatedShipDate": "2024-07-24",
									"estimatedDeliveryDate": "2024-07-29",
									"shippedQuantity": 0
								}
							]
						}
					]
				}
			]
		}
	]
}

Schritt 7: Abfrage der Auftragsdetails

Mit der Backlog-API zum Abrufen von Bestellungen können Sie anhand der Bestellnummer Ihres Kunden oder von TI auf die Bestelldetails zugreifen.  Weitere Informationen zur Bestellung und zu den verfügbaren Bestelldetails finden Sie auf der Dokumentationsseite zur Backlog API für Bestellungen.

Abruf von Details einer Beispielbestellung anhand der Bestellnummer des Kunden:

curl --request GET \
--url https://transact-pre.ti.com/v2/backlog/orders?customerPurchaseOrderNumber=TestPO-001' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

Abruf von Details einer Beispielbestellung anhand der Bestellnummer des Lieferanten: 

curl --request GET \
--url ' https://transact-pre.ti.com/v2/backlog/orders?orderNumber=1019611092' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

Beispielantwort:

{
	"orders": [
		{
			"orderNumber": "1019610866",
			"orderDate": "2023-04-03 13:44:58",
			"customerPurchaseOrderNumber": "TestPO-001",
			"orderStatus": "OPEN",
			"shipToAccountNumber": "183290",
			"lineItems": [
				{
					"tiLineItemNumber": "000010",
					"tiPartNumber": "SN7407N",
					"customerLineItemNumber": "1",
					"customerPartNumber": "TILMNOP",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 2000,
					"customerAnticipatedUnitPrice": "0.30",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 2000,
							"requestedDeliveryDate": "2023-05-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 2000,
									"estimatedShipDate": "2024-07-22",
									"estimatedDeliveryDate": "2024-07-22",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000020",
					"tiPartNumber": "DRV8304SRHAR",
					"customerLineItemNumber": "2",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 5000,
					"customerAnticipatedUnitPrice": "1.00",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 5000,
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 5000,
									"estimatedShipDate": "2024-07-22",
									"estimatedDeliveryDate": "2024-07-22",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000030",
					"tiPartNumber": "SN7407DR",
					"customerLineItemNumber": "3",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 7500,
					"customerAnticipatedUnitPrice": "0.22",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 7500,
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 7500,
									"estimatedShipDate": "2024-04-08",
									"estimatedDeliveryDate": "2024-04-08",
									"shippedQuantity": 0
								}
							]
						}
					]
				}
			]
		},
		{
			"orderNumber": "1019620643",
			"orderDate": "2023-04-03 13:44:58",
			"customerPurchaseOrderNumber": "TestPO-001",
			"orderStatus": "OPEN",
			"shipToAccountNumber": "183290",
			"lineItems": [
				{
					"tiLineItemNumber": "000010",
					"tiPartNumber": "SN7407N",
					"customerLineItemNumber": "1",
					"customerPartNumber": "TILMNOP",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 2000,
					"customerAnticipatedUnitPrice": "0.30",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 2000,
							"requestedDeliveryDate": "2023-05-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 2000,
									"estimatedShipDate": "2024-07-22",
									"estimatedDeliveryDate": "2024-07-22",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000020",
					"tiPartNumber": "DRV8304SRHAR",
					"customerLineItemNumber": "2",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 5000,
					"customerAnticipatedUnitPrice": "1.00",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 5000,
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 5000,
									"estimatedShipDate": "2024-07-22",
									"estimatedDeliveryDate": "2024-07-22",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000030",
					"tiPartNumber": "SN7407DR",
					"customerLineItemNumber": "3",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 7500,
					"customerAnticipatedUnitPrice": "0.22",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 7500,
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 7500,
									"estimatedShipDate": "2024-04-08",
									"estimatedDeliveryDate": "2024-04-08",
									"shippedQuantity": 0
								}
							]
						}
					]
				}
			]
		}
	]
}

Schritt 8: Erfahren Sie, wie eine Bestellung geändert werden kann 

Wichtige Bestelldatenfelder in der Nutzlast der Änderungsanforderung müssen exakt mit der ursprünglichen Bestellanforderung übereinstimmen. Diese Felder schließen folgende mit ein:

• customerPurchaseOrderNumber
• customerLineItemNumber
• tiPartNumber

Wenden Sie sich an den API-Support, um Hilfe beim Testen der Änderungsauftrag-API mit Ihrem API-Testcode zu erhalten.

Beispiel für eine Testbestellungsanfrage:

{
	"order": {
		"customerPurchaseOrderNumber": "TestPO-230401-01",
		"shipToAccountNumber": "111111",
		"endCustomerCompanyName": "Company B",
		"lineItems": [
			{
				"customerLineItemNumber": "1",
				"tiPartNumber": "SN7407N",
				"customerPartNumber": "TILMNOP",
				"customerAnticipatedUnitPrice": 0.30,
				"customerCurrencyCode": "USD",
				"schedules": [
					{
						"requestedQuantity": 2000,
						"requestedDeliveryDate": "2023-05-01"
					}
				]
			}
		]
	}
}

Testen Sie eines der folgenden Szenarien für Auftragsänderungen mit der URL für Testauftragsänderungen: https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (Vorserie)

1. Kundenanfrage Datum ändern – setzen Sie CustomerItemChangeIndicatorauf „U“ und ändern SieCustomerRequestedDate  nach Bedarf.
2. Kundenanfrage Menge ändern – setzen Sie CustomerItemChangeIndicatorauf „U“ und ändern Sie CustomerRequestedQuanity  nach Bedarf.
3. Kundenanfrage Stückpreis ändern (+/-) – setzen Sie CustomerItemChangeIndicator auf „U“ und ändern Sie CustomerExpectedUnitPrice nach Bedarf.

Geändertes Beispiel eines Auftragsänderungsantrags:

curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"order": {
		"customerPurchaseOrderNumber": "TestPO-230401-01",
		"shipToAccountNumber": "111111",
		"endCustomerCompanyName": "Company B",
		"lineItems": [
			{
				"customerLineItemNumber": "1",
				"lineItemChangeIndicator": "U",
				"tiPartNumber": "SN7407N",
				"customerPartNumber": "TILMNOP",
				"customerAnticipatedUnitPrice": 0.30,
				"customerCurrencyCode": "USD",
				"schedules": [
					{
						"requestedQuantity": 2000,
						"requestedDeliveryDate": "2023-06-15"
					}
				]
			}
		]
	}
}
DATA

So stornieren Sie eine Bestellung mit dem Rückstand Testaufträge ändern URL: https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (Vorserie)

4.  Testszenario Bestellung stornieren – Um die gesamte Bestellung zu stornieren, muss der CustomerItemChangeIndicator für alle Artikel (1-n) der Bestellung auf „X“ gesetzt werden. Um einzelne Artikel zu stornieren, listen Sie nur die Artikel auf, bei denen der CustomerItemChangeIndicator auf „X“ gesetzt ist, und entfernen alle anderen Artikel, die Teil der Bestellung bleiben sollen.

Geändertes Beispiel für einen Antrag auf Stornierung von Änderungsaufträgen:

curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"order": {
		"customerPurchaseOrderNumber": "TestPO-230401-01",
		"shipToAccountNumber": "111111",
		"endCustomerCompanyName": "Company B",
		"lineItems": [
			{
				"customerLineItemNumber": "1",
				"lineItemChangeIndicator": "X",
				"tiPartNumber": "SN7407N",
				"customerPartNumber": "TILMNOP",
				"customerAnticipatedUnitPrice": 0.30,
				"customerCurrencyCode": "USD",
				"schedules": [
					{
						"requestedQuantity": 2000,
						"requestedDeliveryDate": "2023-06-15"
					}
				]
			}
		]
	}
}
DATA

Schritt 9: Erfahren Sie, wie Sie die Sendungsverfolgung abrufen können

Nach dem Verpacken Ihrer Bestellung generiert TI bei Versandbereitschaft Informationen zur Sendungsverfolgung, die über die Advanced Ship Notification (ASN)-API zugänglich sind. Die Antwort enthält detaillierte Informationen zu Ihrer Lieferung, wie Sendungsverfolgungsnummer, Spediteurinformationen und Handelsrechnungen. Die API ist in Push oder Retrieve-Implementierungen verfügbar. Wenden Sie sich an den API Support, um weitere Anweisungen zum Testen der Retrieve-ASN mit Ihrem API-Testcode zu erhalten.

Beispiel für eine Anfrage zum Abruf:

curl --request GET \
--url https://transact-pre.ti.com/v2/backlog/advanced-shipment-notices?orderNumber=1111111111111' \
--header 'Authorization: Bearer {access_token}' \

Beispielantwort:

{
	"orderNumber": "1111111111111",
	"data": {
		"consolidatedInformation": [
			{
				"estimatedDateOfArrival": "2023-03-28",
				"goodsIssueDate": "2023-03-23",
				"numberOfPallet": "1",
				"grossWeight": "1.200",
				"grossWeightUnitOfMeasure": "KG",
				"numberOfPieces": "1",
				"netWeight": "8.100",
				"netWeightUnitOfMeasure": "KG",
				"carrierShipmentMasterTrackingNumber": "30000001999999",
				"shippingDate": "2023-03-23",
				"shippingPoint": "9920",
				"shippingCondition": "EF",
				"modeOfTransport": "05",
				"buyerCode": "999999",
				"shipTrackReference": "30000001199999",
				"wayBillNumberList": [
					{
						"wayBillNumber": "0423599999",
						"creationDate": "2023-03-23",
						"creationTime": "13:20:27"
					}
				],
				"commercialInvoiceList": [
					{
						"commercialInvoiceNumber": "54901999999",
						"invoiceDate": "2023-03-23",
						"invoiceTime": "13:21:43",
						"incotermCode": "FCA",
						"incotermDescription": "BUYER'S FORWARDER",
						"invoiceValue": "5000.000",
						"currency": "USD"
					}
				],
				"shipToDetails": {
					"plantIdentifier": "0000111111",
					"companyName": "ACME WIDGET SOLUTIONS INC",
					"address1": "1234 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": "TX",
					"postalCode": "99999-9999",
					"countryCode": "US",
					"companyNameAdditionalDetail": "ACME SHIPPING DEPOT ORGANIZATIONS"
				},
				"shipFromDetails": {
					"plantIdentifier": "9990",
					"companyName": "Texas Instruments Southeast Asia PL",
					"contactName": "GEROGE",
					"address1": "No. 56, ACORN Avenue",
					"city": "Singapore",
					"stateRegion": "SGP",
					"postalCode": "99999",
					"countryCode": "SG"
				},
				"crossDockDetails": {
					"plantIdentifier": "0000999999"
				},
				"manifestIdentifierList": {
					"manifestIdentifier": "009999999"
				},
				"bookingOrderDetails": [
					{
						"customerPurchaseOrderNumber": "ABCD_9of10",
						"purchaseOrderDate": "2023-01-13",
						"passThrus": [
							{
								"orderNumber": "1019609117",
								"passThru1": "ZHIC*00001*BP=0000111111",
								"passThru2": "ZHIC*00002*AG=111111",
								"passThru3": "ZHIC*00003*WE=111111"
							}
						],
						"packageDetails": [
							{
								"packageHandlingUnitNumber": "0046677747",
								"packageContainerVolume": "2.116",
								"packageContainerVolumeUnitOfMeasure": "CDM",
								"packageLength": "23.000",
								"packageWidth": "23.000",
								"packageHeight": "4.000",
								"unitOfMeasure": "CM",
								"trackingNumber": "30000001144761",
								"numberOfLineItems": "1",
								"netWeight": "8.100",
								"grossWeight": "1.199",
								"weightUnitOfMeasure": "KG",
								"itemDetails": [
									{
										"tiPartNumber": "SN74LS00N",
										"tiPartDescription": "QUAD 2-INPUT NAND GATE",
										"deliveryLineItemNumber": "000010",
										"deliveryDocumentNumber": "0620549184",
										"orderNumber": "1019609117",
										"lineItemNumber": "000010",
										"customerPurchaseOrderNumber": "ABCD_9of10",
										"customerLineItemNumber": "1",
										"purchaseOrderDate": "2023-01-13",
										"numberOfUnitsShipped": "0000005000",
										"baseUnitOfMeasure": "EA",
										"grossWeight": "1.199",
										"netWeight": "8.100",
										"weightUnitOfMeasure": "KG",
										"commercialInvoiceNumber": "5490149743",
										"commercialInvoiceItem": "000001",
										"commercialInvoiceUnitprice": "1.000000",
										"commercialInvoiceValue": "5000.000000",
										"commercialInvoiceCurrency": "USD",
										"countryOfOriginCode": "CN",
										"countryOfOriginDescription": "China",
										"assemblyCountryOfOriginCode3Character": "CHN",
										"assemblyCountryOfOriginCode2Character": "CN",
										"assemblyCountryOfOriginDescription": "China",
										"harmonizedTariffScheduleExportCode": "85423900",
										"harmonizedTariffScheduleExportDescription": "OTHER ELECTRONIC INTEGRATED CIRCUITS (MIL)",
										"harmonizedTariffScheduleImportCode": "8542390001",
										"harmonizedTariffScheduleImportDescription": "Electronic integrated circuits Other",
										"confirmDate": "2023-03-23",
										"orderType": "TA",
										"deliveryLineItemTotalQuantity": "5000.000",
										"deliveryLineItemTotalQuantityUnitOfMeasure": "EA",
										"goodsIssueDate": "2023-03-23",
										"goodsIssueTime": "13:21:48",
										"shipTrackCodeList": [
											{
												"shipTrackCode": "0444872ZFV",
												"chipCountryOfOriginCode3Character": "CHN",
												"chipCountryOfOriginCode2Character": "CN",
												"chipCountryOfOriginDescription": "China",
												"shipTrackCodeQuantity": "0000005000",
												"batchNumber": "1100044LGH",
												"shipDate": "2023-03-23",
												"dateCode": "2303+5"
											}
										]
									}
								]
							}
						]
					}
				]
			}
		]
	}
}

Schritt 10: Erfahren Sie, wie Sie die Sendungsverfolgung abrufen können

Die Finanzdokument-API liefert Rechnungsinformationen für Zahlungen. Um eine Rechnung über die Finanzdokument-API abzurufen, ist eine der folgenden Voraussetzungen erforderlich: Bestellnummer, Finanzdokumentnummer, Liefernummer oder Bestellnummer des Kunden.  Bei der Abfrage nach Datumsbereich beziehen sich Start- und Enddatum auf das Datum, an dem die Rechnung erstellt wurde. Die Finanzdokumente werden verfügbar, nachdem TI die Lieferung bearbeitet hat.  Die API ist I Push- oder Retrieve-Implementierungen verfügbar.

Um eine PDF-Datei abzurufen, siehe Dokumentation zu den Konfigurationsoptionen.

Wenden Sie sich an den API-Support, um weitere Anweisungen zum Testen der Retrieve-API für Finanzdokumente mit Ihrem PI-Testcode zu erhalten.

Beispiel:

curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/financial-documents?orderNumber=1111111111111' \
--header 'Authorization: Bearer {access_token}' \

Beispielantwort:

{
	"orderNumber": "1111111111111",
	"totalNumberOfDocuments": "2",
	"documents": [
		{
			"documentType": "INVOICE",
			"financialDocumentNumber": "1111111111111",
			"documentCreatedDate": "2023-03-23",
			"status": "CLEARED",
			"currencyCode": "USD",
			"customerPurchaseOrderNumber": "PO_10of10",
			"customerReferenceNumber": "1111111111111",
			"grossWeight": "8100.000",
			"netWeight": "8100.000",
			"weightUnit": "GRM",
			"carrier": "DHL WORLDWIDE EXPRESS",
			"documentValue": {
				"totalAmount": "5,312.50"
			},
			"salesOrder": {
				"orderNumber": "1111111111111",
				"lineItemNumber": "000000",
				"customerPurchaseOrderNumber": "PO_10of10",
				"purchaseOrderDate": "2023-01-13"
			},
			"paymentTerms": {
				"incoterms1": "FCA",
				"incoterms2": "BUYER'S FORWARDER",
				"termsOfDelivery": "FCA BUYER'S FORWARDER",
				"termsOfPayment": "Net 45 Days from Invoice Date",
				"paymentTermsText": [
					{
						"SupplierPaymentTermsText": "Up to 05/07/2023 without deduction"
					}
				]
			},
			"delivery": {
				"deliveryNumber": "1111111111111",
				"deliveryLineItemNumber": "000000",
				"deliveryDate": "2023-04-02",
				"goodsMovementDate": "2023-03-23"
			},
			"waybill": {
				"waybillNumber": "1111111111111",
				"containerIdentifier": "30000001144761",
				"numberOfBoxes": "1"
			},
			"partners": [
				{
					"partnerTypeDescription": "Sender",
					"name1": "Texas Instruments Incorporated",
					"name2": "Semiconductor",
					"streetAddress": "12500 TI Boulevard",
					"city": "Dallas",
					"stateRegion": "TX",
					"postalCode": "75243",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Remit To",
					"name1": "For ACH Transfer send to:",
					"name2": "Texas Instruments, c/o Bank of TI",
					"name3": "Bank Acct 12345987",
					"name4": "ABA 111111111",
					"city": "DALLAS",
					"stateRegion": "TX",
					"postalCode": "75202",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Sold-to Party",
					"partnerIdentifier": "1111111",
					"name1": "ACME WIDGETS INC",
					"name2": " ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "123 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": "TX",
					"postalCode": "12345-1234",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Bill-to Party",
					"name1": "ACME WIDGETS INC",
					"name2": " ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "123 MAIN ST",
					"city": "ELDARAOD",
					"stateRegion": "TX",
					"postalCode": "12345-1234",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Ship-to Party",
					"partnerIdentifier": "11111",
					"name1": "ACME WIDGETS INC",
					"name2": " ACME WIDGETS SHIPIPING DEPOT ORGANIZATIONS",
					"streetAddress": "123 MAIN ST",
					"city": "ELDAROAD",
					"stateRegion": "TX",
					"postalCode": "12345-1234",
					"countryCode": "US"
				}
			],
			"items": [
				{
					"lineItemNumber": "000010",
					"tiPartNumber": "SN74LS00N",
					"tiPartDescription": "QUAD 2-INPUT NAND GATE",
					"quantity": "5000.000",
					"unitPrice": "1.00",
					"netPrice": "5,000.00",
					"grossWeight": "8100.000",
					"netWeight": "8100.000",
					"commercialInvoiceNumber": "5490149745",
					"salesOrder": {
						"orderNumber": "1111111111111",
						"lineItemNumber": "000010",
						"customerPurchaseOrderNumber": "PO_10of10",
						"customerPurchaseOrderLineItemNumber": "1",
						"purchaseOrderDate": "2023-01-13"
					},
					"delivery": {
						"deliveryNumber": "0620549185",
						"deliveryLineItemNumber": "000010",
						"deliveryDate": "2023-04-02",
						"goodsMovementDate": "2023-03-23",
						"grossWeight": "8100.000",
						"netWeight": "8100.000"
					},
					"itemVAT": [
						{
							"taxIndicator": "O1",
							"taxRate": "6.250",
							"taxAmount": "312.50",
							"taxJurisdiction": "USIL0000000000"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012400000"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						}
					]
				}
			]
		},
		{
			"documentType": "CREDIT NOTE",
			"financialDocumentNumber": "11111111111",
			"documentCreatedDate": "2023-03-29",
			"status": "CLEARED",
			"currencyCode": "USD",
			"customerPurchaseOrderNumber": "PO_10of10",
			"customerReferenceNumber": "11111111",
			"grossWeight": "8100.000",
			"netWeight": "8100.000",
			"weightUnit": "GRM",
			"carrier": "SEE CARRIER REFERENCE TABLE",
			"documentValue": {
				"totalAmount": "531.25"
			},
			"salesOrder": {
				"orderNumber": "1111111111",
				"lineItemNumber": "000000",
				"customerPurchaseOrderNumber": "PO_10of10"
			},
			"paymentTerms": {
				"incoterms1": "FCA",
				"incoterms2": "TI's POINT OF SHIPMENT",
				"termsOfDelivery": "FCA TI's POINT OF SHIPMENT",
				"termsOfPayment": "Net 45 Days from Invoice Date",
				"paymentTermsText": [
					{
						"SupplierPaymentTermsText": "Up to 05/13/2023 without deduction"
					}
				]
			},
			"delivery": {
				"deliveryLineItemNumber": "000000"
			},
			"partners": [
				{
					"partnerTypeDescription": "Sender",
					"name1": "Texas Instruments Incorporated",
					"name2": "Semiconductor",
					"streetAddress": "12500 TI Boulevard",
					"city": "Dallas",
					"stateRegion": "TX",
					"postalCode": "75243",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Remit To",
					"name1": "For ACH Transfer send to:",
					"name2": "Texas Instruments, c/o Bank of TI",
					"name3": "Bank Acct 123456879",
					"name4": "ABA 111111111",
					"city": "DALLAS",
					"stateRegion": "TX",
					"postalCode": "75202",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Sold-to Party",
					"partnerIdentifier": "111111",
					"name1": "ACME WIDGETS INC",
					"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "1234 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": “TX”,
					"postalCode": "12345-1234",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Bill-to Party",
					"name1": "ACME WIDGETS INC",
					"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "1234 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": “TX”,
					"postalCode": "12345-1234",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Ship-to Party",
					"partnerIdentifier": "111111",
					"name1": "ACME WIDGETS INC",
					"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "1234 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": “TX”,
					"postalCode": "12345-1234",
					"countryCode": "US"
				}
			],
			"items": [
				{
					"lineItemNumber": "000010",
					"tiPartNumber": "SN74LS00N",
					"tiPartDescription": "QUAD 2-INPUT NAND GATE",
					"quantity": "5000.000",
					"unitPrice": "0.10",
					"netPrice": "500.00",
					"grossWeight": "8100.000",
					"netWeight": "8100.000",
					"salesOrder": {
						"orderNumber": "1111111111",
						"lineItemNumber": "000010",
						"customerPurchaseOrderNumber": "PO_10of10",
						"customerPurchaseOrderLineItemNumber": "00010"
					},
					"delivery": {
						"deliveryLineItemNumber": "000000"
					},
					"itemVAT": [
						{
							"taxIndicator": "O1",
							"taxRate": "6.250",
							"taxAmount": "31.25",
							"taxJurisdiction": "USIL0000000000"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012400000"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						}
					]
				}
			]
		}
	]
}

Schritt 11: Überweisungshinweis erstellen

Das System des Kunden kann die Remittance Advice API aufrufen, um Überweisungsinformationen zu senden, damit ein Avis-Datensatz im TI-Unternehmenssystem erstellt werden kann.

Jeder Anforderung muss sowohl einen Kopf- als auch einen Positionsteil enthalten.  In den Kopfzeilenabschnitten werden die Überweisungsanzeige des Kunden und die Informationen zum Währungscode angegeben.  Der Artikelbereich kann einen oder mehrere detaillierte Datensätze mit spezifischen Informationen zu Zahlungen und zugehörigen Finanzdokumenten enthalten. Weitere Informationen finden Sie auf der Backlog-API-Seite für Überweisungshinweise.

Beispiel für eine Anforderung:

curl --request POST \
  --url 'https://transact-pre.ti.com/v2/backlog/remittance-advice' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'Content-Type: application/json' \
  --data-binary @- <<DATA
{
	"remittanceAdviceNumber": "CustomerRemit100",
	"currencyCode": "USD",
	"lineItems": [
		{
			"paymentAmount": "2000",
			"financialDocumentNumber": "1234567890"
		},
		{
			"paymentAmount": "200",
			"financialDocumentNumber": "234567890"
		}
	]
}
DATA

Beispiel für eine Antwort:

{
	"supplierRemittanceAdviceIdentifier": "06CustomerRemit1",
	"remittanceAdviceNumber": "CustomerRemit100",
	"currencyCode": "USD",
	"message": [
		{
			"code": "TI-TXT-012013",
			"type": "SUCCESS",
			"message": "Remittance Advice 06CustomerRemit1 posted."
		}
	],
	"lineItems": [
		{
			"paymentAmount": "2000",
			"financialDocumentNumber": "1234567890"
		},
		{
			"paymentAmount": "200",
			"financialDocumentNumber": "234567890"
		}
	]
}

Schritt 12: Wo finden Sie technische Unterstützung?

Technische Unterstützung erhalten Sie in den TI E2E™ Design-Support-Foren oder indem Sie eine Frage stellen.