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. 최종 고객 식별 코드는 승인된 계약 제조업체(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는 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 및 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"로 설정하고 필요에 따라 CustomerExpectedUnitPrice를 수정합니다.


수정된 주문 변경 요청 예:

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

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

 

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 테스트 코드를 사용하여 ASN을 테스트하는 방법에 대한 자세한 내용은 API 지원에 문의하십시오.

 

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 지원 부서에 문의하십시오.  

 

11단계: 송금 통지 생성

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

각 요청에는 헤더 및 항목 섹션이 모두 포함되어야 합니다.  헤더 섹션은 고객의 송금 통지, 지급인 계정 및 총 지급 정보를 식별합니다.  항목 섹션에는 특정 지불 및 관련 재무 문서 정보와 함께 하나 이상의 세부 레코드가 포함될 수 있습니다. 자세한 내용은 백로그 송금 조언 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™ 설계 지원 포럼 을 참조하거나 질문을 게시하십시오.