概述
要开始使用 TI 备货 API 套件,请执行以下步骤:
- 满足访问和开发的必要条件
- 接收客户识别码
- 查看使用备货 API 套件的典型订购流程
- 进行身份验证以接收访问令牌
- 了解如何创建和检索 TI 产品报价
- 了解如何创建测试订单
- 了解如何访问您的订单信息
- 了解如何更改订单
- 了解如何检索物流状态
- 了解如何检索财务单据
- 了解如何创建汇款通知
- 获取支持
第 1 步:设置和审核引导流程的先决条件
只有获得批准的客户才能使用备货 API 套件构建应用程序。获得批准:
- 创建 myTI 帐户或登录您的现有 myTI 帐户
- 将您的 myTI 帐户与公司帐户关联
- 登录 API 门户
- 审核客户引导流程
- 提交客户引导表单并进行审核
- 在您的内部系统中将 TI 设置为供应商
- 查看 API 业务指导手册,了解业务和流程知识
第 2 步:接收客户识别码
- 完成客户引导表单后,TI 将提供您所在站点的客户识别码。识别码用于订单、变更订单和报价的备货 API 连接。这些代码也会出现在发送给客户的各种外发文件上:
- 收货方代码由 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 API 套件使用 OAuth 2.0 进行保护。在使用 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 企业系统中创建报价。可以提交多个器件和数量的报价。您将收到一个报价编号供您参考。 报价回复通常在提交报价后的 30 分钟至 24 小时内提供。“quoteStatus”指示报价是处于“Accepted”、“Rejected”还是“Changed”状态;“status”指示行项目是处于“Pending”、“Bid”还是“No Bid”状态。有关更多详细信息,请参阅备货报价 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 (pre-production)
- 要下订单(测试或量产),客户必须获得批准,配置相关设置并完成引导流程。
- 客户成功完成订单创建和变更测试后,请按照 API 业务指导手册中的用户验收测试方案完成测试阶段。
当您为下一个量产备货订单做好准备后,请查看您要在申请有效载荷中发送的所有参数,并使用量产版本的身份验证和备货订单创建 API(URL: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 测试以下任一订单更改方案:https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (pre-production)
- 客户申请日期变更 - 将 CustomerItemChangeIndicator 设为“U”,并根据需要修改 CustomerRequestedDate。
- 客户申请数量变更 - 将 CustomerItemChangeIndicator 设为“U”,并根据需要修改 CustomerRequestedQuanity
- 客户预期单价 (+/-) - 将 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 (pre-production)
- 取消订单测试方案 - 要取消完整订单,必须将订单中所有项目 (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 支持 ,获取有关使用 API 测试代码进行 ASN 测试的进一步说明。
示例检索申请:
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 步:创建汇款通知
客户的系统可以调用汇款通知 API 来发送汇款信息,以便在 TI 企业系统中创建汇款通知记录。
每个申请都必须包含标头和项目部分。 标头部分标识客户的汇款通知和货币代码信息。 项目部分可以包含一个或多个详细记录,以及特定付款和相关财务单据信息。有关更多详细信息,请参阅备货汇款通知 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™ 设计支持论坛或发布您的问题。