API business guidebook

The API calls are through backlog order create API, backlog order change API, backlog quote API, backlog order retrieve API, backlog ASN retrieve API, backlog financial document retrieve API, backlog remittance advice API.

1. API push notifications are not enabled by default
   1. If you would like to receive API push notifications for advanced ship notice, financial document and quotes, follow the instructions below
      1. Go to TI.com/support
      2. Select Open a new support request
      3. Select Direct customer fulfillment
      4. Complete the API push form, attach and submit


2. End-to-end order flow
    


3. API initial setup
   1. Errors within an API call
      1. Customer will need to fix the errors
      2. Customer system will obtain a full list of error details in the same API call
      3. With a full list of warning or error details, customer will have better control on how and when to correct the error and resubmit the request if needed
   2. Partial orders allowed
      1. Correct API order entry will be accepted while rejections will not be entered
      2. API order change will always be performed at the individual line item level
   3. Synchronous response
      1. Synchronous response is default
      2. Within one API call, customer system would know whether TI processed the request fully and actual sales order has been changed in TI system successfully
   4. Customer details needed for your connection
      1. TI will send an email notification with the required identifiers for you to place an order such as sold to and ship to identifier (if you are a contract manufacturer (CM), the end customer identifier will be provided)


4. API order creation requirements   

   Order Elements	Mandatory / Optional	Character Limitations
   Purchase order (PO) number	Mandatory	UPPER CASE; No more than 35 Characters  No space in PO number;
   PO line item	Mandatory
   Manufacturer part number (MPN)	Mandatory
   Customer direct price (CDP)	Mandatory	No more than five (5) decimals
   Customer requested date (CRD)	Mandatory
   Quantity	Mandatory
   Customer part number (CPN)	Optional
   End customer	Optional (Required for CM)	UPPER CASE

   1. For each PO item, only ONE single CRD is allowed.
   2. For each PO item under the same PO number, the item number should not be duplicated, otherwise the PO change will fail
   3. For each PO, multiple PO items with same or different TI part numbers are both accepted
   4. For PO with “End Customer”, only materials for same end customer can be accepted under same PO number
   5. The quantity should be a multiple of the TI standard pack quantity (SPQ) and meet both the minimum order requirement (MOQ) and minimum item value (MIV) as is defined in the TI product catalog

5. Order creation and change flow chart and highlights:
   
   1. Order created with issue
      1. If there is a price mismatch between CDP and TI's pricing agreement (PA), the result will be an incomplete order that is reviewed by TI
      2. If CDP is correct, TI will refresh price - no action needed from customer
      3. If TI price is correct, you will need to update CDP via order change, response will be sent back indicating if the price mismatch is resolved
         1. In order to review pricing discrepancies, review the customer backlog report file, pricing discrepancy tab
      4. Order will not be created if there is SPQ/MOQ/MIV errors, correct the quantity and resend to TI as order creation

6. Period for order cancellations or changes
   1. Change Order Window (COW) is defining the period of time when changes or cancellations are no longer authorized to process
   2. COW Rules depends on the type of parts
   3. It applies from our Estimated Ship Date (ESD)
   4. TI rejects all changes within the COW except CRD pull in and price change

      Part Type	Change Period
      Standard (STD)	30 days from estimated ship date
      Custom (CST)	90 days from estimated ship date
      Non- Cancellable Non-Returnable (NCNR)	Cannot be cancelled

       

7. Types of order changes allowed
   1. Customer request date (CRD) push out or pull in.
   2. PO line item price update
   3. PO line item quantity decrease
   4. PO line item cancellation


8. Order change tips:
   1. To increase PO line item quantity, create a new PO
   2. PO line items that have shipped completely, with an advanced ship notice (ASN), cannot be changed
   3. PO line item or PO cancellation can result in loss of estimated ship date (ESD)
   4. Keep the original quantity ordered on the PO line item, when changing the CRD, price, or when cancelling a PO line item
   5. When changing CRD keep in mind the COW
   6. Push outs once within the COW will generate rejections and errors
   7. Customer needs to update price on original PO line item via order change for new effective price
   8. Keep the same PO and PO item number structure in the order change request


9. Remittance advice tips:
   1. Use TI’s financial invoice number
      1. If not available, use the delivery note number or the commercial invoice number provided through the ASN
      2. TI will provide the customer payer identifier after submission of the customer onboarding form


10. User acceptance testing scenarios (UAT) to pass testing phase:
    1. Once the customer completes self-service testing scenarios 1.0 – 2.1, our GBO regional team will contact the admin email which has access to the API keys