Email ordering overview
An order request can be submitted by filling out the order template and emailing the document to TI.
Order submission
Order submission requirements:
- The submission email must be sent from a valid corporate email domain provided on customer onboarding form on TI.com
- The attached document must follow the standard ordering format shown below
- The submission email must be send to a valid automated TI email address:
- Test/user authorized testing (UAT): cust_documents_test@ti.com
- Production: cust_documents@ti.com
Supported document formats
|
Format |
Template |
Sample Completed Document |
|---|---|---|
|
Excel (xlsx) |
Download | Download |
|
Excel (xls) |
Download | |
|
Comma Separated Values (csv) |
Download |
Document fields
|
Field |
Type |
Limit |
Required |
Example |
Description |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Customer Purchase Order Identifier |
Alphanumeric |
35 characters |
✓ |
PO0001 |
An order identifier that uniquely identifies this order request. Once the order has been placed, another cannot be submitted with the same identifier, but new line items can be added to an existing order |
||||||||||
|
Customer Purchase Order Line Item Number |
Alphanumeric |
6 characters |
✓ |
0001 |
A line item identifier that uniquely identifies the line item for this order. The same line item identifier cannot be used more than once on the same purchase order, but can be changed using the appropriate change indicator |
||||||||||
|
Customer Purchase Order Date |
Date |
YYYY-MM-DD |
2022-01-25 |
The date that this purchase order was generated. If a value is not provided, the date at which TI processes your request will be used |
|||||||||||
|
Customer End Customer Identifier |
Alphanumeric |
17 characters |
|
The end customer identifier agreed upon during the onboarding process * This field is required for contract manufacturers (CMs) |
|||||||||||
|
Change Indicator |
Character |
1 character |
N |
A single character change indicator that identifies how this item should be handled. The list of valid indicators are as follows:
|
|||||||||||
|
Customer Product Identifier |
Alphanumeric |
35 characters |
G01234 |
This value can optionally be sent, if available. This product identifier will be attached as informational data to the line item |
|||||||||||
|
Supplier Product Identifier |
Alphanumeric |
35 characters |
✓ |
OPA333 |
The TI part identifier that will be ordered. This must match a valid TI part |
||||||||||
|
Customer Requested Date |
Date |
YYYY-MM-DD |
✓ |
2022-01-25 |
The desired ship date for the associated quantity of product. There can be multiple, distinct requested ship dates for the same material on a purchase order, commonly referred to as schedule lines |
||||||||||
|
Customer Requested Quantity |
Integer |
✓ |
5000 |
The requested quantity to be ordered for a particular date. This value must be a whole number |
|||||||||||
|
Customer Expected Unit Price |
Decimal |
5 decimals |
✓ |
1.23 |
The price per single unit that you are expecting to pay. This value should match the pricing agreement for the product |
||||||||||
|
Supplier Sold To Identifier |
Alphanumeric |
17 characters |
✓ |
12345 |
The TI sales entity identifier that was provided as part of the onboarding process |
||||||||||
|
Supplier Ship To Identifier |
Alphanumeric |
17 characters |
✓ |
12345 |
The TI shipping destination identifier that was provided as part of the onboarding process |
Order changes
Existing orders can be altered by either adding, changing, or removing line items. Removing all line items from an order effectively cancels it completely. Under certain circumstances, it may not be possible to alter a line item. For example, line items that have already shipped cannot be adjusted. When requesting an update to a line item, following fields can be modified:
- Customer Requested Date
- Customer Requested Quantity
- Customer Expected Unit Price
Each line item is identified by the unique combination of CustomerPurchaseOrderIdentifier and CustomerPurchaseOrderLineItemNumber.
Notice
Purchase order line items with multiple schedules cannot be updated. Instead, the line item should be canceled and the line item re-submitted with the updated delivery schedule. It is also possible to split a line item into multiple, each with their own CustomerPurchaseOrderLineItemNumber and a single delivery date and quantity.
Order response
Response email
TI will typically send a response email to the order sender within 30 minutes after submission. The body of the email will provide an overview of the results for each attachment, which could include errors if there was in issue identified with the order request.
Response attachment
The response details are provided in the Excel (.xlsx) document attached to the response email. The original input information will be provided in combination with the response from TI for each line item submitted. It is possible for part of your order request to complete successfully, while other line items fail.
A templated response attachment can be downloaded here.
|
Field |
Type |
Example |
Description |
||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Supplier Order Status |
Alphabetic |
OPEN |
Denotes the status of the order as a whole. It is possible for an order to be successfully placed, with some of the line items excluded due to errors
|
||||||||||||||||
|
Supplier Order Identifier |
Alphanumeric |
100234 |
The TI order number for the order that was created (if successfully created) |
||||||||||||||||
|
Supplier Order Line Item Number |
Alphanumeric |
00001 |
The TI line item number for the line item that was created (if successfully created) |
||||||||||||||||
|
Supplier Order Item Status |
Alphabetic |
Pending |
Denotes the status of the line item
|
||||||||||||||||
|
Supplier Unit Price |
Decimal |
1.23 |
The TI expected unit price, as agreed in the pricing agreement with TI for this product |
||||||||||||||||
|
Supplier Estimated Ship Date |
Date |
2022-01-01 |
The date which TI estimates the product can be shipped. In some cases, this date cannot be estimated immediately and will not be provided in the response document |
||||||||||||||||
|
Supplier Confirmed Quantity |
Integer |
1000 |
The quantity of product that TI was able to confirm to be shipped |
||||||||||||||||
|
Order Response Messages |
Alphanumeric |
Purchase order level errors or informational messages that occurred when attempting to process the request document |
|||||||||||||||||
|
Line Item Response Messages |
Alphanumeric |
Line item level errors or informational messages that occurred when attempting to process the request document |
Errors
It is possible that specific line items or an entire order may be rejected if input values do not meet requirements. There are two fields in the response document that can contain errors:
- Order Response Messages - errors that apply to the entire order, usually due to incorrect order header information
- Line Item Response Messages - errors for the specific line item or schedule line
All errors will be prefixed with an error code in square brackets that can be used to uniquely identify and communicate the specific issue. The following error message will provide a descriptive explanation of what went wrong. Error handling steps for specific error messages can be found on the E2E forum. Once you know what changes need to be made, the document can be remediated and resubmitted to TI through email.
Note
If some line items were successfully created and are included in a revised attempt at order creation, those lines will be rejected for that second run as duplicates. This will not affect the already created line items and is just an informational message and revised line items will still be processed accordingly.