概述
要开始使用 TI 备货 API 套件，请执行以下步骤：
- 满足访问和开发的必要条件
- 接收客户识别码
- 查看使用备货 API 套件的典型订购流程
- 进行身份验证以接收访问令牌
- 了解如何创建和检索 TI 产品报价
- 了解如何创建测试订单
- 了解如何访问您的订单信息
- 了解如何更改订单
- 了解如何检索物流状态
- 了解如何检索财务单据
- 了解如何创建汇款通知
- 获取支持
第 1 步：设置和审核引导流程的先决条件
只有获得批准的客户才能使用备货 API 套件构建应用程序。获得批准：
- 创建 myTI 帐户或登录您的现有 myTI 帐户
- 将您的 myTI 帐户与公司帐户关联
- 登录 API 门户
- 审核客户引导流程
- 提交客户引导表单并进行审核
- 在您的内部系统中将 TI 设置为供应商
- 查看 API 业务指导手册，了解业务和流程知识
第 2 步：接收客户识别码
- 完成客户引导表单后，TI 将提供您所在站点的客户识别码。这些代码用于订单、变更单、报价和汇款通知的备货 API 连接。这些代码也会出现在发送给客户的各种外发文档上：
- 买方代码是购方实体
- 收票人代码供 TI 用于开具发票
- 付款方代码用于支付发票
- 收货方代码供 TI 用于产品发货
- 终端客户识别码仅适用于经批准的合同制造商 (CM) 或代表其他客户进行采购的客户
- TI 的供应商信息和银行帐户详细信息也将随客户识别码一起通过电子邮件通知的形式提供
- 客户可以通过链接的 PDF 访问 TI 的供应商信息和财务信息。这是为了方便在您的系统中进行供应商设置。该 PDF 将包括 TI 邮寄地址、NAICS 代码、联邦税号、年收入和标准付款信息。该 PDF 还包含指向我们的年度报告、公民报告和质量认证的链接。根据您的客户引导回复，我们将在此电子邮件通知中指明您在供应商设置中使用的银行所在国家/地区。
第 3 步：订购流程概述
- TI 的标准 API 格式是检索，如果更喜欢 API 推送，请参阅 API 业务指导手册
- 使用为您分配的 API 密钥进行身份验证
- 如果您无法创建报价，请确保您打算订购的器件包含在您的 TI 价格协议中
- 使用所需的有效载荷构建订单，并将其发布到备货订单 API
- API 将使用状态代码“201 Created”和包含订单确认的 JSON 进行回复
- 查询备货订单 API，了解订单状态和其他订单详细信息
- 在订单处理后，通过出货前通知 (ASN) 检索 API 检索物流状态，通过财务单据检索 API 检索发票
- 汇款通知 API 是必需的。调用汇款通知 API 向 TI 发送汇款信息
- 有兴趣查看这些步骤的示例代码？请下载我们的示例代码
第 4 步：身份验证
TI 已使用 OAuth 2.0 保护其 API 套件。使用您的 API 密钥进行身份验证。授权后，OAuth2 将返回与已启用的套件中的 API 一起使用的访问令牌。有关更多详细信息，请参阅“Authentication”页面。
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”指示报价是处于“Accepted”、“Rejected”还是“Changed”状态。“SupplierQuoteItemStatus”指示行项目是处于“Pending”、“Bid”还是“No Bid”状态。
检索报价申请示例：
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 (pre-production)
- 要下订单（测试或量产），客户必须获得批准，配置相关设置并完成引导流程
- 一旦客户成功完成了订单录入和变更测试，请按照 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 (pre-production)
- 客户申请日期变更 - 将 CustomerItemChangeIndicator 设为“U”，并根据需要修改 CustomerRequestedDate。
- 客户申请数量变更 - 将 CustomerItemChangeIndicator 设为“U”，并根据需要修改 CustomerRequestedQuanity
- 客户预期单价 (+/-) - 将 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 (pre-production)，每个行项目的参数指示符如下。
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 支持，了解使用 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™ 设计支持论坛或发布您的问题。