Sidebar - Backlog-V1

概覽

若要開始使用 TI 未交貨訂單 API 套件，請依照下列步驟執行： 

  1. 符合存取和開發的先決條件 
  2. 接收客戶身分代碼 
  3. 使用未交貨訂單 API 套件檢閱一般訂購流程
  4. 驗證以接收存取權杖
  5. 了解如何建立及擷取 TI 產品的報價單
  6. 了解如何建立測試訂單
  7. 了解如何存取您的訂單資訊
  8. 了解如何變更訂單 
  9. 了解如何擷取出貨追蹤
  10. 了解如何擷取財務文件
  11. 了解如何建立匯款通知
  12. 取得支援

 

步驟 1：設定與檢閱上線序的先決條件

只有經核准的客戶才能使用未交貨訂單 API 套件建置應用程式。獲得核准：

  1. 建立 myTI 帳戶或登入您現有的 myTI 帳戶
  2. 將您的 myTI 帳戶與公司帳戶建立關聯  
  3. 登入 API 入口網站
  4. 檢閱客戶上線流程
  5. 提交客戶上線表單並檢閱
  6. 在您的內部系統中將 TI 設定爲廠商
  7. 檢閱 API 業務指南中的業務和流程相關知識

 

步驟 2：接收客戶身分代碼

  1. 填寫客戶上線表單後，TI 將提供您所在網站的客戶身分代碼。這些代碼可用於訂單、變更訂單、報價與匯款通知等未交貨訂單 API 連線。這些代碼也會出現在傳送給客戶的各種輸出文件上：
    1. 買方代碼是購買實體
    2. 收單方代碼是 TI 發票帳單接收的一方
    3. 付款人代碼是支付發票款項的一方
    4. 收貨地址代碼是 TI 產品送達的地址
    5. 最終客戶身分代碼僅適用於已核准的合約製造商 (CM) 或代表另一名客戶購買的客戶
  2. TI 的廠商資訊與銀行詳細資料也會透過電子郵件通知提供客戶身分代碼
    1. 客戶可透過連結的 PDF 存取 TI 的廠商資訊和財務資訊。這是爲了方便在您系統中設定廠商。PDF 將包含 TI 郵寄地址、NAICS 代碼、聯邦稅務 ID 號碼、年收入及標準付款資訊。PDF也包含年度報告、公民報告和品質認證的連結。根據您的首次客戶上線回覆，我們會在本電子郵件通知中指出銀行所在國家/地區，供您在廠商設定中使用。

 

步驟 3：訂購流程概覽

  1. 已擷取 TI 標準 API 格式，若是偏好使用 API 推播，請參閱 API 業務指南
  2. 使用您指定的 API 金鑰和秘密進行驗證
  3. 若無法建立報價，請確認您要訂購的零件已包含在 TI 定價合約中
  4. 使用所需的酬載建立您的訂單，並將訂單發佈到未交貨訂單 API
  5. API 將會回覆狀態代碼 201 Created 及包含訂單確認的 JSON
  6. 查詢未交貨訂單 API 的訂單狀態和其他訂單詳細資料
  7. 在處理訂單後，透過出貨前通知 (ASN) 擷取 API擷取出貨追蹤，並且透過財務文件擷取 API 擷取發票
  8. 匯款通知 API 為必填項。呼叫匯款通知 API 將匯款資訊傳送至 TI
  9. 想要查看這些步驟的範例程式碼嗎？請下載我們的範例程式碼。

 

步驟 4：驗證

TI 已使用 OAuth 2.0 確保其 API 套件的安全。使用您的 API 金鑰和秘密進行驗證。授權後，OAuth2 會傳回您已啟用之套件中 API 所使用的存取權杖。如需詳細資訊，請參閱驗證頁面。  

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

步驟 5：建立及擷取 TI 產品的報價單

報價 API 可讓獲得授權的客戶在 TI 企業系統內建立報價單。可以提交多個零件和數量的報價，客戶將會收到報價編號當參考。通常會在 24 小時內提供報價回覆。如需詳細資訊，請參閱未交貨項目報價 API 頁面。

建立報價請求範例：

curl --request POST \
--url 'https://transact.ti.com/v1/quotes' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"SupplierSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"CustomerContactEmailAddress": "john-smith@test-customer123.com",
		"CustomerContactPhoneNumber": "888-888-8888",
		"CustomerEndCustomerIdentifier": "John Smith",
		"CustomerEndCustomerName": "Company XYZ",
		"CustomerEndCustomerCity": "Dallas",
		"CustomerEndCustomerCountry": "US",
		"CustomerEndCustomerPostalCode": "75208",
		"CustomerIntermediateCustomerName": "Company ABC",
		"CustomerIntermediateCustomerCity": "",
		"CustomerIntermediateCustomerCountry": "",
		"CustomerIntermediateCustomerPostalCode": "",
		"CustomerEndCustomerWebsite": "https://www.companyxyz.com",
		"LineItems": [
			{
				"CustomerQuoteLineItemNumber": 1,
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"CustomerCompetingSupplierName": "Competitor N",
				"CustomerItemComments": "Costdown Quote",
				"CustomerCompetingSupplierMaterial": "SNKLLPO23",
				"CustomerCompetingSupplierUnitPrice": 1.43,
				"CustomerCompetingSupplierCurrency": "USD"
			}
		]
	}
}
DATA

建立報價回覆範例：

{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"SupplierEndCustomerName": "Company XYZ",
		"SupplierEndCustomerWebSite": "https://companyxyz.com",
		"SupplierQuoteStatus": "Accept",
		"SupplierSoldToIdentifier": 114207,
		"SupplierQuoteValidFromDate": "2021-09-15T00:00:00Z",
		"SupplierQuoteValidToDate": "2022-03-14T00:00:00Z",
		"LineItems": [
			{
				"CustomerQuoteLineItemNumber": 1,
				"SupplierQuoteItemStatus": "Pending",
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"CustomerCompetingSupplierName": "Competitor N",
				"SupplierQuoteItemComments": "Costdown Quote",
				"Description": "Quote created with number: 26679695"
			}
		]
	}
}

報價回應通常在提交報價單後 30 分鐘至 24 小時內提供。「SupplierQuoteStatus」指出報價是否被接受、拒絕或更改。「SupplierQuoteItemStatus」指出行項目為「待處理」、「競標價」或「無競標價」。

擷取報價請求範例：

curl --request GET \   
--url 'https://transact.ti.com/v1/quotes/{customerQuoteNumber}' \
--header 'Authorization: Bearer {access_token}' \

擷取報價回覆範例：

{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"CustomerEndCustomerName": "Company XYZ",
		"CustomerEndCustomerWebsite": "https://companyxyz.com",
		"SupplierEndCustomerName": "XYZ CORPORATION",
		"SupplierEndCustomerWebSite": "https://companyxyz.com",
		"SupplierQuoteStatus": "Accept",
		"SupplierSoldToIdentifier": "114207",
		"SupplierSoldToName": "YOUR COMPANY NAME",
		"SupplierQuoteValidFromDate": "2021-09-15T00:00:00Z",
		"SupplierQuoteValidToDate": "2022-03-14T00:00:00Z",
		"LineItems": [
			{
				"SupplierQuoteLineItemNumber": 10,
				"SupplierQuoteItemStatus": "Pending",
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"SupplierUnitPrice": 0,
				"SupplierUnitPriceCurrency": "USD",
				"CustomerCompetingSupplierName": "Competitor N",
				"SupplierQuoteItemComments": "Costdown Quote",
				"SupplierProductLeadTime": 35,
				"SupplierProductMinimumQuantity": 90,
				"SupplierProductNextQuantityIncrement": 90,
				"SupplierProductPackageType": "JEDEC TRAY (5+1)",
				"SupplierProductRestrictionOfHazardousSubstancesCompliant": "Y",
				"SupplierProductCancellationWindowWeeks": 5,
				"SupplierProductRescheduleWindowWeeks": 5,
				"SupplierNonCancellableNonReturnableProduct": false,
				"SupplierProductType": "STD",
				"SupplierProductMoistureLevel": "3",
				"SupplierProductExportControlClassificationNumber": "EAR99",
				"SupplierPaymentTerms": "Per Negotiated Terms"
			}
		]
	}
}

步驟 6：建立測試訂單

在我們的進入生產階段前測試環境中模擬未交貨測試訂單，專門用於協助開發客戶的應用程式。 傳回的資訊僅為供示範之用的模擬測試資料、並不代表已處理的資訊。  

未交貨測試訂單建立 URL：https://transact-pre.ti.com/v1/orders/create (進入生產階段前)  

  1. 若要下單 (測試或生產)，客戶必須獲得核准、配置好設定值，並完成上線程序
  2. 客戶成功完成訂單輸入與變更的測試後，請遵循 API業務指南中的使用者驗收測試案例，以完成測試階段

未交貨測試訂單建立請求範例： 

curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/create' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "Order": {
    "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
    "CustomerPurchaseOrderDate": "YYYY-MM-DD",
    "CustomerSoldToIdentifier": "111111",
    "CustomerShipToIdentifier": "111111",
    "CustomerEndCustomerIdentifier": "",
    "
    "LineItems": [
      {
        "CustomerPurchaseOrderLineItemNumber": "1",
        "SupplierProductIdentifier": "SN74LS00N",
        "CustomerProductIdentifier": "CPN-XXX",
        "CustomerExpectedUnitPrice": "0.987",
        "Schedules": [
          {
            "CustomerRequestedQuantity": "2000",
            "CustomerRequestedDate": "2023-06-15"
          },
          {
            "CustomerRequestedQuantity": "3000",
            "CustomerRequestedDate": "2023-07-15"
          }
        ]
      },
      {
        "CustomerPurchaseOrderLineItemNumber": "2",
        "SupplierProductIdentifier": "SN74LS00N",
        "CustomerProductIdentifier": "",
        "CustomerExpectedUnitPrice": "1",
        "Schedules": [
          {
            "CustomerRequestedQuantity": "4000",
            "CustomerRequestedDate": "2023-08-01"
          }
        ]
      }
    ]
  }
}

未交貨測試訂單建立回應範例： 

{
  "Orders": [
    {
      "AsOfDateTime": "2023-02-24 17:02:11",
      "SupplierOrderStatus": "ACCEPT",
      "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
      "CustomerSoldToIdentifier": "111111",
      "CustomerShipToIdentifier": "111111",
      "LineItems": [
        {
          "CustomerPurchaseOrderLineItemNumber": "1",
          "SupplierProductIdentifier": "SN74LS00N",
          "CustomerExpectedUnitPrice": "0.987",
          "Schedules": [
            {
              "CustomerRequestedQuantity": 2000,
              "CustomerRequestedDate": "2023-06-15"
            },
            {
              "CustomerRequestedQuantity": 3000,
              "CustomerRequestedDate": "2023-07-15"
            }
          ]
        },
        {
          "CustomerPurchaseOrderLineItemNumber": "2",
          "SupplierProductIdentifier": "SN74LS00N",
          "CustomerExpectedUnitPrice": 1,
          "Schedules": [
            {
              "CustomerRequestedQuantity": 4000,
              "CustomerRequestedDate": "2023-08-01"
            }
          ]
        }
      ]
    }
  ]
}

當您準備下生產未交貨訂單時，請檢閱您要在要求酬載中傳送的所有參數，並使用驗證和未交貨訂單的生產版本建立 API URL：https://transact.ti.com/v1/oauth and https://transact.ti.com/v1/orders/create。

若要進一步了解測試和生產訂購，請參閱未交貨訂單 API 文件頁面。

 

步驟 7： 查詢訂單詳細資料

您若使用未交貨訂單擷取 API，即可使用您的客戶採購單號碼或供應商訂單號碼存取訂單詳細資訊。

範例訂單使用客戶採購訂單號擷取詳細資訊：

curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

{
  "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115"
  }​

範例訂單使用供應商訂單號擷取詳細資訊： 

​
curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

{
    "SupplierOrderIdentifier": "1000004607"
}

​

範例回應：

{
  "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
  "SupplierOrderIdentifier": "1000004607",
  "Orders": [
    {
      "AsOfDateTime": "2023-03-27 20:57:06",
      "SupplierOrderIdentifier": "1000000000",
      "SupplierOrderStatus": "OPEN",
      "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
      "CustomerSoldToIdentifier": "111111",
      "CustomerShipToIdentifier": "111111",
      "LineItems": [
        {
          "SupplierOrderLineItemNumber": "000010",
          "CustomerPurchaseOrderLineItemNumber": "1",
          "SupplierOrderItemStatus": "Not Delivered",
          "SupplierChangeOrderWindow": "NON",
          "SupplierProductIdentifier": "SN74LS00N",
          "SupplierTotalOrderItemQuantity": 5000,
          "CustomerExpectedUnitPrice": "0.152",
          "SupplierUnitPrice": 1,
          "CustomerCertificateOfConformance": "YES",
          "LineItemMessages": [
            {
              "Code": "TI-TXT-051",
              "Type": "INFO",
              "Message": "Customer expected price mismatch with TI price"
            },
            {
              "Code": "TI-TXT-089",
              "Type": "INFO",
              "Message": "Item quantity does not match rated quantity; Rating has not been applied"
            }
          ],
           "Schedules": [
            {
              "CustomerRequestedQuantity": 2000,
              "CustomerRequestedDate": "2023-06-15",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0005",
                  "SupplierConfirmedQuantity": 2000,
                  "CustomerRequestedShipDate": "2023-06-12",
                  "SupplierEstimatedShipDate": "2023-06-12",
                  "SupplierEstimatedDeliveryDate": "2023-06-15",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            },
            {
              "CustomerRequestedQuantity": 3000,
              "CustomerRequestedDate": "2020-07-15",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0006",
                  "SupplierConfirmedQuantity": 3000,
                  "CustomerRequestedShipDate": "2023-07-10",
                  "SupplierEstimatedShipDate": "2023-07-10",
                  "SupplierEstimatedDeliveryDate": "2023-07-15",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            }
          ]
        },
        {
          "SupplierOrderLineItemNumber": "000020",
          "CustomerPurchaseOrderLineItemNumber": "2",
          "SupplierOrderItemStatus": "Not Delivered",
          "SupplierChangeOrderWindow": "NON",
          "SupplierProductIdentifier": "SN74LS00N",
          "SupplierTotalOrderItemQuantity": 4000,
          "CustomerExpectedUnitPrice": "1.00",
          "SupplierUnitPrice": 1,
          "Schedules": [
            {
              "CustomerRequestedQuantity": 4000,
              "CustomerRequestedDate": "2023-08-01",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0002",
                  "SupplierConfirmedQuantity": 4000,
                  "CustomerRequestedShipDate": "2023-07-29",
                  "SupplierEstimatedShipDate": "2023-07-29",
                  "SupplierEstimatedDeliveryDate": "2023-08-01",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

若要進一步了解訂購和可用訂單詳細資訊、請參閱未交貨訂單 API 文件頁面。

 

步驟 8：了解如何變更訂單 

請求更改訂單的第一步是確認您是否已建立測試訂單。

以下列出的資料參數來自訂單建立請求有效負載，其用於識別建立的測試訂單號碼、建立訂單的日期、訂單的狀態，以及識別該訂單的客戶 PO 號碼。

  •  AsOfDateTime "2023-01-30 18:11:04"
  •  SupplierOrderIdentifier "1111111111"
  •  SupplierOrderStatus "OPEN"
  •  CustomerPurchaseOrderIdentifier "PO-Order1"

變更訂單請求有效負載中的訂單資料欄位必須與原始訂單請求完全相符。

測試訂單請求範例：

  {
	"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order1",
		"CustomerPurchaseOrderDate": "2022-12-01",
		"CustomerSoldToIdentifier": "111111",
		"CustomerShipToIdentifier": "111111",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

使用未交貨項目測試訂單變更 url: https://transact-pre.ti.com/v1/orders/change (進入生產階段前) 測試下列任何訂單變更案例  

  1. 客戶請求日期變更 - 設定 CustomerItemChangeIndicator 為 "U"，並視需要修改 CustomerRequestedDate。 
  2. 客戶請求數量變更 - 設定 CustomerItemChangeIndicator 為 "U"，並視需要修改 CustomerRequestedQuanity
  3. 客戶預期單價 (+/-) 設定 CustomerItemChangeIndicator 為 "U"，並視需要修改 CustomerExpedUnitPrice


訂單變更請求的修改範例：

"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order1",
		"CustomerPurchaseOrderDate": "2022-12-01",
		"CustomerSoldToIdentifier": "167435",
		"CustomerShipToIdentifier": "167435",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"CustomerItemChangeIndicator": "U",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

如何使用未交貨項目測試訂單變更 url: https://transact-pre.ti.com/v1/orders/change (進入生產階段前) 取消訂單，以及下方所示每個行項目的參數指標。

 4.取消訂單測試案例 - 要取消完整訂單，必須針對訂單中的所有項目 (1-n) 將 CustomerItemChangeIndicator 設定爲 “X”。若要取消個別項目，須僅列出 CustomerItemChangeIndicator 設爲 “X” 的項目，並移除應保留在訂單內的其他所有項目。

 

已修改的變更訂單請求取消範例：

{
	"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order2",
		"CustomerPurchaseOrderDate": "2023-01-01",
		"CustomerSoldToIdentifier": "111111",
		"CustomerShipToIdentifier": "111111",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"CustomerItemChangeIndicator": "X",
				"SupplierProductIdentifier": "SN74LVC139",
				"CustomerProductIdentifier": "SN74LVC139",
				"CustomerExpectedUnitPrice": 1.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
		      		
       "LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "2",
				"CustomerItemChangeIndicator": "X",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

請聯絡  

步驟 9：了解如何擷取出貨追蹤

在完成您訂單的包裝作業後準備運送時，TI 會產生可透過出貨前通知 (ASN) API 存取的出貨追蹤資訊。此回應包含有關您的出貨詳細資訊，例如出貨追蹤編號、貨運業者資訊和商業發票。API 可用於推播或擷取實作。 

請求擷取範例：

curl --request POST \
--url 'https://transact-pre.ti.com/v1/advance-ship-notices/retrieve/?SupplierOrderIdentifier=123456789&
CustomerSoldToIdentifier=ABC123456&RequestCommercialInvoicePDF=X&RequestWaybillPDF=X' \
--header 'Authorization: Bearer {access_token}'

範例回應：

{
  "CustomerSoldToIdentifier": "ABCDEF",
  "SupplierOrderIdentifier": "1234567890",
  "CustomerPurchaseOrderIdentifier": "T1234567",
  "SupplierWayBillIdentifier": "5678901234",
  "RequestCommercialInvoicePDF": "X",
  "RequestWaybillPDF": "X",
  "Data": {
    "ConsolidatedInformation": [
      {
        "ShipmentEstimatedDateOfArrival": {},
        "ShipmentGoodsIssueDate": {},
        "ShipmentNumberOfPallet": "1",
        "ShipmentGrossWeight": "2.450",
        "ShipmentGrossWeightUnitOfMeasure": "KG",
        "ShipmentNumberOfPieces": "2",
        "ShipmentNetWeight": "0.264",
        "ShipmentNetWeightUnitOfMeasure": "KG",
        "ShipmentServiceLevelCode": "ABC",
        "ShipmentProductDescription": "ABC DEF GHI",
        "CarrierShipmentMasterTrackingNumber": "123456",
        "CarrierShipmentBoxTrackingNumber": "CUSTOMER XLR8",
        "SupplierShippingDate": {},
        "SupplierShippingPoint": "1808",
        "SupplierShippingCondition": "EG",
        "CustomerSoldToIdentifier": "0000123456",
        "SpecialProcessingIndicator": "string",
        "ModeOfTransport": "05",
        "CustomerBuyerCode": "12345",
        "CustomerShipperVendorCode": "ABCDEFG",
        "SupplierShipTrackReference": "123456789012",
        "SupplierSoldToPartyName": "CUSTOMER CORPORATION",
        "ShipmentInternalTransactionNumberList": [
          {
            "ShipmentInternalTransactionNumber": "1234"
          }
        ],
        "ForwardingAgentDetails": {
          "ForwarderCompanyName": "XYZ",
          "ForwarderStandardCarrierAccessCode": "ABCD",
          "SupplierCarrierIdentifier": "12345",
          "SupplierCarrierTrackingWebSite": "https://www.carrierxyz.com"
        },
        "SupplierWayBillNumberList": [
          {
            "SupplierWayBillIdentifier": "5678901234",
            "SupplierWayBillCreationDate": {},
            "SupplierWayBillCreationTime": "09:15:08",
            "SupplierWaybillPDF": "string"
          }
        ],
        "SupplierCommercialInvoicelist": [
          {
            "SupplierCommercialInvoiceIdentifier": "987654321",
            "SupplierCommercialInvoiceDate": {},
            "SupplierCommercialInvoiceTime": "22:32:40",
            "SupplierIncotermCode": "DDP",
            "SupplierIncotermDescription": "Buyers Dock",
            "SupplierCommercialInvoiceValue": "100.100",
            "SupplierCommercialInvoiceCurrency": "USD",
            "SupplierCommercialInvoicePDF": "string"
          }
        ],
        "ShipToDetails": {
          "CustomerShipToPlantIdentifier": "00001234",
          "CustomerShipToCompanyName": "XYZ",
          "CustomerShipToContactName": "010-234-2010",
          "CustomerShipToAddress1": "123 Main St",
          "CustomerShipToAddress2": "ABC",
          "CustomerShipToCity": "Fort Worth",
          "CustomerShipToState": "TX",
          "CustomerShipToZipCode": "12345-1234",
          "CustomerShipToCountry": "US",
          "CustomerShipToCompanyNameAdditionalDetail": "ABCD"
        },
        "ShipFromDetails": {
          "SupplierShipFromPlantIdentifier": "00001234",
          "SupplierShipFromCompanyName": "Texas Instruments",
          "SupplierShipFromContactName": "010-234-2010",
          "SupplierShipFromAddress1": "13601 Independence Parkway",
          "SupplierShipFromAddress2": "ABC",
          "SupplierShipFromCity": "Fort Worth",
          "SupplierShipFromState": "TX",
          "SupplierShipFromZipCode": "12345-1234",
          "SupplierShipFromCountry": "US",
          "SupplierShipFromEmailAddress": "test@test.com",
          "SupplierShipFromPhoneNumber": "010-101-2031"
        },
        "SupplierCrossDockDetails": {
          "SupplierCrossDockPlantIdentifier": "00001234",
          "SupplierCrossDockCompanyName": "XYZ",
          "SupplierCrossDockContactName": "010-234-2010",
          "SupplierCrossDockAddress1": "123 Main St",
          "SupplierCrossDockAddress2": "ABC",
          "SupplierCrossDockCity": "Fort Worth",
          "SupplierCrossDockState": "TX",
          "SupplierCrossDockZipCode": "12345-1234",
          "SupplierCrossDockCountry": "US"
        },
        "ImporterDetails": {
          "ImporterCompanyName": "XYZ",
          "ImporterContactName": "010-234-2010",
          "ImporterAddress1": "13601 Independence Parkway",
          "ImporterAddress2": "ABC",
          "ImporterCity": "Fort Worth",
          "ImporterState": "TX",
          "ImporterZipCode": "12345-1234",
          "ImporterCountry": "US"
        },
        "SupplierManifestIdentifierList": {
          "SupplierManifestIdentifier": "7890123456"
        },
        "BookingOrderDetails": [
          {
            "CustomerPurchaseOrderIdentifier": "T1234567",
            "CustomerPurchaseOrderDate": {},
            "PassThrus": [
              {
                "SupplierOrderIdentifier": "1234567890",
                "CustomerPassthru1": "ZREF*00001*URL=www.test.com",
                "CustomerPassthru2": "ZREF*00002*URL=www.test.com",
                "CustomerPassthru3": "ZREF*00003*URL=www.test.com",
                "CustomerPassthru4": "ZREF*00004*URL=www.test.com",
                "CustomerPassthru5": "ZREF*00005*URL=www.test.com",
                "CustomerPassthru6": "ZREF*00006*URL=www.test.com",
                "CustomerPassthru7": "ZREF*00007*URL=www.test.com",
                "CustomerPassthru8": "ZREF*00008*EML=test@test.com",
                "CustomerPassthru9": "ZREF*00009*URL=www.test.com",
                "CustomerPassthru10": "ZREF*00010*URL=www.test.com",
                "CustomerPassthru11": "ZREF*00011*URL=www.test.com",
                "CustomerPassthru12": "ZREF*00012*EML=test@test.com",
                "CustomerPassthru13": "ZREF*00013*URL=www.test.com",
                "CustomerPassthru14": "ZREF*00014*URL=www.test.com",
                "CustomerPassthru15": "ZREF*00015*URL=www.test.com"
              }
            ],
            "PackageDetails": [
              {
                "PackageHandlingUnitIdentifier": "1234567890",
                "PackageContainerVolume": "0.000",
                "PackageContainerVolumeUnitOfMeasure": "CDM",
                "PackageLength": "0.000",
                "PackageWidth": "0.000",
                "PackageHeight": "0.000",
                "PackageLWHUnitOfMeasure": "MM",
                "PackageTrackingNumber": "123456789012",
                "PackageNumberOfLineItems": "0",
                "PackageAlternateHandlingUnitIdentifier": "ABCDEFGH",
                "PackageNetWeight": "0.000",
                "PackageGrossWeight": "0.000",
                "PackageWeightUnitOfMeasure": "KG",
                "ItemDetails": [
                  {
                    "SupplierProductIdentifier": "TPS12345",
                    "CustomerProductIdentifier": "ABCDEFG",
                    "SupplierProductDescription": "TPS12345 description",
                    "SupplierDeliveryLineItemNumber": "000010",
                    "SupplierDeliveryIdentifier": "0123456789",
                    "SupplierOrderIdentifier": "1234567890",
                    "SupplierOrderLineItemNumber": "000010",
                    "CustomerPurchaseOrderIdentifier": "T1234567",
                    "CustomerPurchaseOrderItemNumber": "2",
                    "CustomerPurchaseOrderDate": {},
                    "SupplierItemNumberOfUnitsShipped": "000000000001",
                    "SupplierItemBaseUnitOfMeasure": "EA",
                    "SupplierItemGrossWeight": "1.450",
                    "SupplierItemNetWeight": "0.165",
                    "SupplierItemWeightUnitOfMeasure": "KG",
                    "SupplierCommercialInvoiceIdentifier": "987654321",
                    "SupplierCommercialInvoiceItem": "000001",
                    "SupplierCommercialInvoiceUnitprice": "123.000000",
                    "SupplierCommercialInvoiceValue": "123.000000",
                    "SupplierCommercialInvoiceCurrency": "USD",
                    "SupplierCountryOfOriginCode": "PH",
                    "SupplierCountryOfOriginDescription": "Philippines",
                    "SupplierAssemblyCountryOfOriginCode3Character": "PHL",
                    "SupplierAssemblyCountryOfOriginCode2Character": "PH",
                    "SupplierAssemblyCountryOfOriginDescription": "Philippines",
                    "SupplierItemHarmonizedTariffScheduleExportCode": "8901234567",
                    "SupplierItemHarmonizedTariffScheduleExportDescription": "Electronic Integrated Circuits, Other",
                    "SupplierItemHarmonizedTariffScheduleImportCode": "8901234567",
                    "SupplierItemHarmonizedTariffScheduleImportDescription": "Electronic Integrated Circuits, Other",
                    "SupplierItemConfirmDate": {},
                    "SupplierOrderType": "ZJR",
                    "SupplierDeliveryLineItemTotalQuantity": "24000.000",
                    "SupplierDeliveryLineItemTotalQuantityUnitOfMeasure": "EA",
                    "SupplierItemGoodsIssueDate": {},
                    "SupplierItemGoodsIssueTime": "05:23:19",
                    "CustomerItemPassThru1": "ZOI6*00001*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru2": "ZOI6*00002*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru3": "ZOI6*00003*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru4": "ZOI6*00004*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru5": "ZOI6*00005*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru6": "ZOI6*00006*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru7": "ZOI6*00007*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru8": "ZOI6*00008*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru9": "ZOI6*00009*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru10": "ZOI6*00010*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru11": "ZOI6*00011*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru12": "ZOI6*00012*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru13": "ZOI6*00013*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru14": "ZOI6*00014*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru15": "ZOI6*00015*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "SupplierShipTrackCodeList": [
                      {
                        "SupplierShipTrackCode": "012345ABC",
                        "SupplierAlternateShipTrackCode": "HIJKLM",
                        "SupplierChipCountryOfOriginCode3Character": "USA",
                        "SupplierChipCountryOfOriginCode2Character": "US",
                        "SupplierChipCountryOfOriginDescription": "USA",
                        "SupplierItemShipTrackCodeQuantity": "3000",
                        "SupplierBatchNumber": "1234567PHI",
                        "SupplierShipDate": {},
                        "SupplierDateCode": "2110",
                        "SupplierAlternateTrackingIdentifier": "ABCDEFGHIJK"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

請聯絡 API 支援部門以了解有關使用 API 測試代碼測試 ASN 的進一步指示。

 

步驟 10：了解如何擷取財務文件

財務文件 API 提供付款的發票資訊。若要使用財務文件 API 擷取發票，訂購單編號是擷取之 JSON 酬載的必要部分。TI 處理裝運程序後便會提供財務文件。

若要擷取 PDF，請參見配置選項的文件。

範例：

curl --request POST \
--url 'https://transact-pre.ti.com/v1/financial-documents/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "CustomerSoldToIdentifier": "123",
  "SupplierFinancialDocumentIdentifier": "1234567890",
  "CustomerReferenceIdentifier": "",
  "SupplierDeliveryIdentifier": "",
  "CustomerPurchaseOrderIdentifier": "",
  "SupplierDocumentStatus": "",
  "SupplierDocumentCreatedFromDate": "",
  "SupplierDocumentCreatedToDate": "",
  "RequestPDF": ""
}

範例回應：

{
  "CustomerSoldToIdentifier": "123",
  "SupplierFinancialDocumentIdentifier": "1234567890",
  "TotalNumberOfDocuments": "1",
  "Documents": [
    {
      "SupplierDocumentType": "INVOICE",
      "SupplierFinancialDocumentIdentifier": "1234567890",
      "SupplierDocumentCreatedDate": "2020-05-11",
      "SupplierDocumentStatus": "CLEARED",
      "SupplierDocumentCurrency": "USD",
      "CustomerPurchaseOrderIdentifier": "PO1234",
      "CustomerReferenceIdentifier": "0100000200",
      "SupplierGrossWeight": "100.000",
      "SupplierNetWeight": "100.000",
      "SupplierWeightUnit": "GRM",
      "SupplierCarrier": "FEDEX EXPRESS",
      "DocumentValue": {
        "SupplierTotalAmount": "15,000.00"
      },
      "SalesOrder": {
        "SupplierOrderIdentifier": "1000001234",
        "SupplierOrderLineItemNumber": "000000",
        "CustomerPurchaseOrderIdentifier": "PO1234",
        "CustomerPurchaseOrderDate": "2020-01-01"
      },
      "PaymentTerms": {
        "SupplierIncoterms1": "TERMS1",
        "SupplierIncoterms2": "TERMS2",
        "SupplierTermsOfDelivery": "SHIPPING TERMS",
        "SupplierTermsOfPayment": "Net XX Days from Invoice Date",
        "PaymentTermsText": [
          {
            "SupplierPaymentTermsText": "Up to XX.XX.2020 without deduction"
          }
        ]
      },
      "CreditManager": {
        "SupplierCreditManagerName": "Bill Johnson",
        "SupplierCreditManagerTelephone": "1234567890",
        "SupplierCreditManagerEmail": "bj-noreply@ti.com"
      },
      "Delivery": {
        "SupplierDeliveryIdentifier": "0200000300",
        "SupplierDeliveryLineItemNumber": "000000",
        "SupplierDeliveryDate": "2020-04-13",
        "SupplierGoodsMovementDate": "2020-05-11"
      },
      "Waybill": {
        "SupplierWaybillNumber": "123456",
        "SupplierNumberOfBoxes": "1"
      },
      "Partners": [
        {
          "PartnerTypeDescription": "Sender",
          "Name1": "Texas Instruments Incorporated",
          "Name2": "Semiconductor",
          "StreetAddress": "12500 TI Boulevard",
          "City": "Dallas",
          "Region": "TX",
          "PostalCode": "75243",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Remit To",
          "Name1": "For ACH Transfer send to:",
          "Name2": "Texas Instruments ",
          "Name3": "Bank Acct 1234567890, ABA 123456789",
          "Name4": "SWIFT 12345678",
          "City": "DALLAS",
          "Region": "TX",
          "PostalCode": "75202",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Sold-to Party",
          "CustomerNumber": "123",
          "Name1": "TEST CUSTOMER",
          "Name2": " TEST CUSTOMER Line 2",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Bill-to Party",
          "Name1": "TEST CUSTOMER",
          "Name2": "ATTN: ACCOUNTS PAYABLE DEPT",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Ship-to Party",
          "CustomerNumber": "123",
          "Name1": "TEST CUSTOMER",
          "Name2": "TEST CUSTOMER Line 2",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        }
      ],
      "Items": [
        {
          "SupplierOrderLineItemNumber": "000010",
          "SupplierProductIdentifier": "SM1234",
          "CustomerPartNumber": "CPN5678",
          "SupplierProductDescription": "SM1234 description",
          "SupplierItemQuantity": "300.000",
          "SupplierUnitPrice": "50.00",
          "SupplierItemValue": "15,000.00",
          "SupplierGrossWeight": "100.000",
          "SupplierNetWeight": "100.000",
          "SupplierCommercialInvoiceNumber": "1234567890",
          "SalesOrder": {
            "SupplierOrderIdentifier": "1000001234",
            "SupplierOrderLineItemNumber": "000010",
            "CustomerPurchaseOrderIdentifier": "PO1234",
            "CustomerPurchaseOrderLineItemNumber": "1",
            "CustomerPurchaseOrderDate": "2020-01-01"
          },
          "Delivery": {
            "SupplierDeliveryIdentifier": "0200000300",
            "SupplierDeliveryLineItemNumber": "000010",
            "SupplierDeliveryDate": "2020-04-13",
            "SupplierGoodsMovementDate": "2020-05-11",
            "SupplierGrossWeight": "100.000",
            "SupplierNetWeight": "100.000"
          },
          "ItemVAT": [
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "6.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX0000000000"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.500",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804500000"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "1.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.000",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.000",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            }
          ]
        }
      ]
    }
  ]
}

請聯絡 API 支援 部門以了解有關使用 API 測試代碼測試財務文件 API 擷取 的進一步指示。

 

步驟 11：建立匯款通知

客戶的系統可以呼叫匯款通知 API 以傳送匯款資訊，以便在 TI 企業系統中建立匯款通知記錄。

每個請求都必須包含標題和項目部分。 標題部分識別客戶的匯款通知、付款人帳戶和總付款資訊。 項目部分可包含一筆或任何數量的詳細記錄，以及特定付款和相關財務文件資訊。如需詳細資訊，請參閱未交貨訂單匯款通知 API 頁面。

請求範例：

curl --request POST \
--url 'https://transact.ti.com/v1/remittance-advice' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"CustomerRemittanceAdviceIdentifier": "CustomerRemit100",
	"CustomerPayerIdentifier": "CustomerPayer1",
	"CustomerPaymentAmount": "100000",
	"CustomerCurrency": "USD",
	"Items": [
		{
			"CustomerNetPaymentAmount": "20000",
			"SupplierFinancialDocumentIdentifier": "1234567890",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc123"
		},
		{
			"CustomerNetPaymentAmount": "30000",
			"SupplierFinancialDocumentIdentifier": "1234567891",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc124"
		},
		{
			"CustomerNetPaymentAmount": "50000",
			"SupplierFinancialDocumentIdentifier": "1234567892",
			"CustomerFinancialDocumentIdentifier": ""
		}
	]
}
DATA

回應範例：

{
	"SupplierRemittanceAdviceIdentifier": "0620062214281851",
	"CustomerRemittanceAdviceIdentifier": "CustomerRemit100",
	"CustomerPayerIdentifier": "CustomerPayer1",
	"CustomerPaymentAmount": "100000",
	"CustomerCurrency": "USD",
	"Messages": [
		{
			"Code": "TI-TXT-012013",
			"Type": "INFO",
			"Message": "Remittance Advice 0620062214281851 posted"
		}
	],
	"Items": [
		{
			"CustomerNetPaymentAmount": "20000",
			"SupplierFinancialDocumentIdentifier": "1234567890",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc123"
		},
		{
			"CustomerNetPaymentAmount": "30000",
			"SupplierFinancialDocumentIdentifier": "1234567891",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc124"
		},
		{
			"CustomerNetPaymentAmount": "50000",
			"SupplierFinancialDocumentIdentifier": "1234567892",
			"CustomerFinancialDocumentIdentifier": ""
		}
	]
}

步驟 12：何處可以找到技術支援

如需技術支援，請參閱 TI E2E™ 設計支援論壇或發佈您的問題。