目前德州仪器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 响应将在限制字段中返回一个空白值。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
{ "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 对接,用于下测试订单的库存不会减少或者保留。返回的信息模拟生产订单数据返回的信息,但有些字段仅用于演示,不代表处理后的信息。
第六步:查询订单详情
示例请求:
1 2 3 |
curl --request GET \ --url 'https://transact.ti.com/v2/store/orders/{orderNumber}' --header 'Authorization: Bearer {access_token}' \ |
示例响应:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 |
{ "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 访问的发货跟踪信息。回复包括有关您的货件的详细信息,例如货件跟踪号、承运人信息和商业发票。
检索请求示例:
1 2 3 |
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 处理订单后,即可获得发票。
示例请求:
1 2 3 |
curl --request GET \ --url 'https://transact.ti.com/v2/store/orders/{orderNumber}/financial-documents/{financialDocumentNumber}' --header 'Authorization: Bearer {access_token}' \ |
示例响应:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 |
{ "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 是什么?
注:文案部分图片及内容来源于网络,版权归原创作者所有,如有侵犯到您的权益,请您联系我们进行删除,给您带来困扰,我们深感抱歉。