目前德州仪器TI 除了做EDI对接之外，也在使用 API 方式下单。TI API 的订购流程如图所示：
第一步：只有获得批准的客户才能使用 TI API 对接
第二步：订购流程概览
1.使用您分配的 API key 和 secret 进行身份验证。 2.向库存和价格 API 发送查询，以检索产品可用性和其他匹配信息。 3.API 将回复状态代码： 200 OK 以及包含请求产品数据的 JSON。 4.构建您的订单并发布到订单 API。 5.API 将回复一个状态码：200 OK 和一个包含订单确认的 JSON。 6.查询订单 API 以获取订单状态和其他订单详情。 7.订单被处理后，通过提前发货通知 (ASN) API 检索货运跟踪，并通过财务 API 检索发票。
第三步：认证
TI使用 OAuth 2.0 保护其 API 套件，使用您的 API 密钥和密码进行身份验证。授权后，OAuth2.0 返回一个访问令牌，用于您启用的套件中的 API。
第四步：查询库存和定价
以下示例说明了如何检索每个产品的库存可用性和定价信息，查询部件号 AFE7799IABJ。可用库存为 5,435（”quantity”: 5435）；但是，在此示例中，数量限制为每个订单 50 个（”limit”: 50）个单位。如果产品没有订单限制，则 JSON 响应将在限制字段中返回一个空白值。
代码语言：javascript复制{
"tiPartNumber": "AFE7799IABJ",
"genericPartNumber": "AFE7799",
"buyNowURL": "https://www.ti.com/product/AFE7799/part-details/AFE7799IABJ",
"quantity": 5435,
"limit": 50,
"pricing": [
{
"currency": "USD",
"priceBreaks": [
{
"priceBreakQuantity": 1,
"price": 2.03
},
{
"priceBreakQuantity": 10,
"price": 1.43
},
{
"priceBreakQuantity": 25,
"price": 1.35
},
...
],
"description": "8-Bit 200MSPS Low-Power Analog-to-Digital Converter (ADC) With Internal Sample and Hold",
"minimumOrderQuantity": 1,
"standardPackQuantity": 126,
"exportControlClassificationNumber": "EAR99",
"htsCode": "8542390001",
"pinCount": 5,
"packageType": "SOT-23 (DBV)",
"packageCarrier": "Large T&R",
"customReel": true,
"lifeCycle": "ACTIVE"
}第五步：创建测试订单
模拟测试订单并非正式订单，其目的在于帮助企业完成与TI 的 API 对接，用于下测试订单的库存不会减少或者保留。返回的信息模拟生产订单数据返回的信息，但有些字段仅用于演示，不代表处理后的信息。
第六步：查询订单详情
示例请求：
代码语言：javascript复制curl --request GET
--url 'https://transact.ti.com/v2/store/orders/{orderNumber}'
--header 'Authorization: Bearer {access_token}' 示例响应：
代码语言：javascript复制{
"orderNumber": 0,
"orderStatus": "string",
"customerPurchaseOrderNumber": "string",
"subTotal": 0,
"totalPrice": 0,
"lineItems": [
{
"tiPartNumber": "string",
"tiPartDescription": "string",
"quantity": "string",
"status": "string",
"unitPrice": 0,
"customReelIndicator": true
}
],
"shippingAddress": [
{
"addressType": "string",
"firstName": "string",
"lastName": "string",
"company": "string",
"addressLine1": "string",
"addressLine2": "string",
"town": "string",
"state": "string",
"postalCode": "string",
"country": "string",
"email": "string",
"phoneNumber": "string",
"companyURL": "string"
}
],
"billingAddress": [
{
"addressType": "string",
"firstName": "string",
"lastName": "string",
"company": "string",
"addressLine1": "string",
"addressLine2": "string",
"town": "string",
"state": "string",
"postalCode": "string",
"country": "string",
"email": "string",
"phoneNumber": "string",
"companyURL": "string"
}
],
"orderMessages": [
{
"code": "string",
"type": "string",
"Message": "string"
}
],
"customerOrderAttributes": [
{
"attribute": "string"
}
],
"orderPlacedTime": "string",
"paymentType": "string",
"currencyISO": "string",
"totalTax": 0,
"checkoutProfileIdentifier": "string",
"totalDeliveryCost": 0,
"totalDiscount": 0,
"couponCodes": "string"
}第七步：货件追踪
打包您的订单后，当它准备好发货时，TI 会生成可通过高级发货通知 (ASN) API 访问的发货跟踪信息。回复包括有关您的货件的详细信息，例如货件跟踪号、承运人信息和商业发票。
检索请求示例：
代码语言：javascript复制curl --request GET
--url 'https://transact.ti.com/v2/store/orders/{orderNumber}/advanced-shipment-notices/{wayBillNumber}'
--header 'Authorization: Bearer {access_token}' 第八步：检索发票
财务 API 提供非 Apruve 付款的发票信息。要使用财务 API ，需要通过订单号来检索发票。
订单号是检索 JSON 的必需部分。TI 处理订单后，即可获得发票。
示例请求：
代码语言：javascript复制curl --request GET
--url 'https://transact.ti.com/v2/store/orders/{orderNumber}/financial-documents/{financialDocumentNumber}'
--header 'Authorization: Bearer {access_token}' 示例响应：
代码语言：javascript复制{
"OrderNumber": "T02281839",
"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"
},
...以上信息，来源于 TI 官网公开信息，详细信息可参考TI 官方文档
TI API 解决方案
知行之桥除了帮助企业建立 EDI 直连之外，还可以为企业提供 TI API 解决方案，快速高效且低成本地实现与 TI 的 API 连接。
具体表现为四个方面：低代码、可集成、经验足、成本低。
1 低代码
- 无需开发背景、业务专家
通过知行之桥实现 TI API，操作门槛低，操作人员不需要具备开发背景或者是业务背景，即使是“职场新人”也能快速上手。
- 可视化流程设计器，通过鼠标拖拽、简单配置，分分钟实现对接
操作界面简洁明了，可视化的流程设计器，只需要鼠标拖拽即可完成。无需额外编写大量代码，只需简单配置即可满足需求。
- 工作流搭建、轻松实现业务流程自动化
文件接收、格式转换、集成业务系统等操作只需要拖拽端口 连线配置即可完成。一键开启文件自动化收发！
2 可集成
基于知行之桥的 TI API 解决方案可以实现与企业内部 ERP、SAP、WMS 等业务系统进行集成，支持连接各种数据源，比如 Mysql、SqlServer、Oracle 等。
采用内部集成的方式能够将从 TI 处获取到的数据自动传入企业内部业务系统中，企业将获得稳定、准确的数据流，错误出现概率也随之降低，并且能够有效地提高员工生产力，将人力投入至有更高附加值的事情上。
3 经验足
我们拥有丰富的 TI 对接经验，目前已帮助几十家客户成功与 TI 建立连接，提供定制化解决方案。熟悉业务逻辑与测试场景，内部积累沉淀了详细的操作流程文档以及项目经验。
4 成本低
使用知行之桥 TI API 解决方案，有效帮助企业降低投入成本，实现快速对接。
- 前期时间投入少
作为一款成熟的软件产品，知行之桥经历十余年的打磨，能够轻松满足用户的对接需求，无需额外投入人力成本，降低时间成本。
- 后期维护成本低
- 软件持续迭代更新
- 已考虑调用失败后的容错机制和重发机制
- 监控能力强、错误提醒，邮件及时通知，以及可自定义报告
- 灵活度高，只需简单调整即可适应未来内部系统的接口变化
以下是给企业提供的 TI API 解决方案：
下单
获取产品和价格列表
TI API 实战经验分享
1.TI API 对接流程
- 注册My Ti 账号
- 申请30天证书
- 请求 API 流程： 测试 生产
- 身份验证
- 切换生产
2.快速下单
- 一个月1,000,00 次调用（每分钟23次）
- 每秒20次API调用
3.快速对接
- 物料充足，开发和测试简单
- 为未来的EDI 直连奠定基础
更多EDI信息，请参阅: EDI 是什么？
阅读原文
