개요

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. 배송지 코드는 TI에서 제품을 배송하는 위치입니다.
   2. 최종 고객 식별 코드는 승인된 계약 제조업체(CMS) 또는 다른 고객을 대신하여 구매하는 고객만 사용할 수 있습니다.
2. 은행 정보가 있는 TI 공급업체 정보도 이메일 알림을 통해 고객 식별 코드와 함께 제공됩니다.
   1. 고객은 연결된 PDF를 통해 TI 공급업체 정보와 재무 정보에 액세스할 수 있습니다. 이 기능은 시스템에서 공급업체 설정을 용이하게 하기 위해 제공됩니다. 이 PDF에는 TI 우편 주소, NICS 코드, 연방 세금 ID 번호, 연간 수익 및 표준 결제 정보가 포함됩니다. 또한 이 PDF에는 연간 보고서, 기업윤리 보고서 및 품질 인증에 대한 링크도 포함되어 있습니다. 고객 온보딩 양식에 대한 응답에 따라 이 이메일 알림에는 공급업체 설정에서 활용할 수 있는 당사 은행의 국가가 표시됩니다.

 

3단계: 주문 흐름 개요

1. TI 표준 API 형식이 검색되고, API 푸시를 사용할 경우 API 비즈니스 가이드북을 참조하십시오.
2. 할당된 API 키와 비밀을 사용하여 인증합니다.
3. 견적을 작성할 수 없는 경우 주문하려는 부품이 TI 가격 계약에 포함되어 있는지 확인하십시오.
4. 원하는 페이로드로 주문을 작성하고 백로그 주문 API에 게시합니다.
5. API는 상태 코드, 생성된 201 및 주문 확인이 포함된 JSON을 사용하여 회신합니다.
6. 주문 상태 및 추가 주문 세부 정보에 대한 백로그 주문 API를 쿼리합니다.
7. 주문 배송 후ASN(사전 발송 통지서) 검색 API를 통해 선적 추적을 검색하고 재무 문서 검색 API를 통해 API 및 송장을 검색합니다.
8. 송금 통지 API는 필수입니다. 송금 정보를 TI로 보내보려면 송금 통지 API를 호출합니다.
9. 이러한 단계에 대한 예제 코드를 보고 싶으십니까? TI의 예제 코드를 다운로드합니다.

 

4단계: 인증

TI API 제품군은 OAuth 2.0으로 보호됩니다. 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 엔터프라이즈 시스템 내에서 견적을 생성할 수 있습니다. 여러 부품 및 수량에 대해 견적을 제출할 수 있습니다. 참조용 견적 번호를 받게 됩니다.  견적 응답은 일반적으로 견적을 제출한 후 30분 - 24시간 이내에 제공됩니다. "quoteStatus"는 견적이 수락되었는지, 거부되었는지 또는 변경되었는지 여부를 나타냅니다. "status"는 라인 항목이 보류 중, 입찰 또는 입찰 없음인지를 나타냅니다. 자세한 내용은 백로그 견적 API 페이지를 참조하십시오.

견적 요청 생성 예:

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

견적 응답 생성 예:

{
	"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"
		}
	]
}

견적 요청 검색 예:

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

견적 응답 검색 예:

{
	"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"
		}
	]
}

6단계: 테스트 주문 생성하기

백로그 테스트 주문은 사전 생산 테스트 환경에서 시뮬레이션되며 특히 고객 애플리케이션 개발을 지원하기 위한 것입니다.  반환된 정보는 데모 목적으로 시뮬레이션된 테스트 데이터이며 처리된 정보를 나타내지 않습니다.  

백로그 테스트 주문 생성 URL: https://transact-pre.ti.com/v2/backlog/orders (사전 제작)

1. 주문(테스트 또는 생산)을 발주하려면 승인을 받고, 설정을 구성하고, 온보딩 프로세스를 완료해야 합니다.
2. 고객이 주문 입력 및 변경 모두에 대한 테스트를 성공적으로 완료하면 API 비즈니스 가이드북의 사용자 수용 테스트 시나리오에 따라 테스트 단계를 완료합니다

생산 백로그 순서를 지정할 준비가 되면 요청 페이로드에서 보낼 모든 매개 변수를 검토하고 인증 및 백로그 주문의 생산 버전을 사용하여 API URL(https://https://transact.ti.com/v1/oauth and https://transact.ti.com/v2/backlog/orders)을 생성합니다.   특히 라인 항목이 30개가 넘는 주문에서 연결 시간 초과가 발생하는 경우 시간 초과 오류가 발생하지 않도록 연결 시간 제한을 5분으로 설정하는 것이 좋습니다.

테스트 및 생산 주문에 대한 자세한 내용은 백로그 주문 API 설명서 페이지를 참조하십시오.

백로그 테스트 주문 생성 요청 예: 

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"
          }
        ]
      }
    ]
  }
}

백로그 테스트 순서 생성 응답 예: 

{
	"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
								}
							]
						}
					]
				}
			]
		}
	]
}

7단계: 주문 세부 정보 조회

백로그 주문 검색 API를 사용하면 고객 구매 주문 번호 또는 TI 주문 번호를 사용하여 주문 세부 정보에 액세스할 수 있습니다.  주문 및 사용 가능한 주문 세부 정보에 대한 자세한 내용은 백로그 주문 API 설명서 페이지를 참조하십시오.

고객 구매 주문 번호를 사용하여 세부 정보를 검색하는 주문 예:

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

공급자 주문 번호를 사용하여 세부 정보를 검색하는 주문 예: 

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

응답 예:

{
	"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
								}
							]
						}
					]
				}
			]
		}
	]
}

8단계: 주문을 변경하는 방법 알아보기 

변경 주문 요청 페이로드의 주요 주문 데이터 필드는 원래 주문 요청과 정확히 일치해야 합니다. 이러한 필드에는 다음이 포함됩니다.

• customerPurchaseOrderNumber
• customerLineItemNumber
• tiPartNumber

API 테스트 코드를 사용하여 변경 주문 API를 테스트하려면 API 지원에 문의하십시오.

테스트 주문 요청의 예:

{
	"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"
					}
				]
			}
		]
	}
}

백로그 테스트 주문 변경 URL을 사용하여 주문 변경에 대한 다음 시나리오를 테스트합니다. URL: https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (생산전)

1. 고객 요청 날짜 변경 - CustomerItemChangeIndicator를 "U"로 설정하고 필요에 따라 CustomerRequestedDate를 수정합니다.
2. 고객 수량 변경 요청 - CustomerItemChangeIndicator를 "U"로 설정하고 필요에 따라 CustomerRequestedQuanity를 수정합니다
3. 고객 예상 단가(+/-)는 CustomerItemChangeIndicator를 "U"로 설정하고 필요에 따라 CustomerExpectedUnitPrice를 수정합니다.

수정된 주문 변경 요청 예:

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

백로그 테스트 주문을 사용하여 주문을 취소하는 방법 변경 URL: https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (생산 전)

4.  주문 테스트 취소 시나리오 - 주문 전체를 취소하려면 주문의 모든 항목(1-n)에 대해 CustomerItemChangeIndicator 를 "X"로 설정해야 합니다. 개별 항목을 취소하려면 CustomerItemChangeIndicator가 "X"로 설정된 항목만 나열하고 주문에 포함되어야 하는 다른 모든 항목을 제거합니다.

수정된 변경 주문 취소 요청 예:

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

9단계: 배송 추적을 검색하는 방법 알아보기

주문을 포장한 후 TI를 배송할 준비가 되면 ASN(고급 배송 알림) API를 통해 액세스할 수 있는 배송 추적 정보를 생성합니다. 답변에는 배송 추적 번호, 배송사 정보, 상업 송장과 같은 배송에 대한 자세한 정보가 포함됩니다. API는 푸시 또는 검색 구현에서 사용할 수 있습니다.   API 테스트 코드를 사용하여 ASN을 테스트하는 방법에 대한 자세한 내용은 API 지원 담당자에게 문의하십시오.

검색 요청 예:

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

응답 예:

{
	"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"
											}
										]
									}
								]
							}
						]
					}
				]
			}
		]
	}
}

10단계: 재무 문서를 검색하는 방법에 대해 알아봅니다

재무 문서 API는 지불에 대한 송장 정보를 제공합니다. 재무 문서 API를 사용하여 송장을 검색하려면 주문 번호, 재무 문서 번호, 배송 번호 또는 고객 구매 주문 번호 중 하나가 필요합니다.  날짜 범위별로 쿼리할 때 시작 및 종료 날짜는 송장이 생성된 날짜를 참조합니다. TI의 배송 절차가 완료되면 재무 문서를 볼 수 있습니다.  API는  푸시 또는 검색 구현으로 사용할 수 있습니다.

PDF를 검색하려면 구성 옵션에 대한 설명서를 참조하십시오.

   API 테스트 코드를 사용하여 재무 문서 API 검색을 테스트하는 추가 지침은 API 지원 부서에 문의하십시오.

예:

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

응답 예:

{
	"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"
						}
					]
				}
			]
		}
	]
}

11단계: 송금 통지 생성

고객의 시스템은 TI 엔터프라이즈 시스템에서 송금 통지 레코드를 생성하기 위해 송금 통지 API를 호출하여 송금 정보를 전송할 수 있습니다.

각 요청에는 헤더 및 항목 섹션이 모두 포함되어야 합니다.  헤더 섹션은 고객의 송금 통지 및 통화 코드 정보를 식별합니다.  항목 섹션에는 특정 지불 및 관련 재무 문서 정보와 함께 하나 이상의 세부 레코드가 포함될 수 있습니다. 자세한 내용은 백로그 송금 조언 API 페이지를 참조하십시오.

요청 예:

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

응답 예:

{
	"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"
		}
	]
}

12단계: 기술 지원을 받을 수 있는 곳

기술 지원이 필요한 경우 TI E2E™ 설계 지원 포럼 을 참조하거나 질문을 게시하십시오.