• State TI Thinks Resolved
  • Locked Locked
  • Replies 5 replies
  • Answers 3 answers
  • Subscribers 2 subscribers
  • Views 306 views
  • Users 0 members are here
Support feedback
Options
Options
Similar topics

This thread has been locked.

If you have a related question, please click the "Ask a related question" button in the top right corner. The newly created question will be automatically linked to this question.

TI-API: status codes for ORDER API - in V2

Gideon Reifman
Prodigy 40 points
Part Number: TI-API

Dear Samip and team,

Can I order multiple part number under one order API sending ? It turns that if one line items is falling (quantities requested is above availability or other issue) then the return Jason is NULL/Empty and so is the status of the specific Line items.

Why is this behavior in API 2 ? The return status in the Json that is received should contains status and not empty even if one of the items was not successful.

Please advice if not clear, and if clear please advice how to order multiple orderable part numbers and still get the correct status for each line item.

Please also advice what are the possible return statuses for ORDER API. Up until now we only see PROCESSSING or (empty)

Thanks in advance.

  • 0
    TI__Genius 10401 points

    Hi Gideon,

    Yes, you can order multiple parts with a single order request. We are working on an enhancement that would optionally allow partial orders to be accepted if one of multiple line items cannot be processed. We don't have a timeline for release of this functionality yet, but we do understand that there is a desire for this behavior.

    In the logs, I can see a few of your API orders that have failed due to insufficient inventory, but in each case there was a json response that indicates which line item is in error. For example, the following snippet is from the response on a Nov 11 test order:

    ...
	"errors": [
		{
			"errorCode": "ERR-TICOM-ORDER-API-0001",
			"type": "lineItems",
			"section": "Orders",
			"field": null,
			"reason": " Part number(s) requested inventory quantity is not available per your request",
			"message": "Please check the inventory levels for available quantity and resubmit the request with different qty. Note In instances of low inventory ordering  limits may be set",
			"data": [
				{
					"customerLineItemNumber": "null",
					"tiPartNumber": "SN74HCS365PWR",
					"quantity": "80000",
					"availableQuantity": "79388",
					"limit": "999999999",
					"waitPeriod": null
				}
			]
		}
	]
...

    If you're not seeing any response from failed orders, please ensure that your system is expecting an application/json response.

    You can find a list of the possible order status codes at https://e2e.ti.com/support/enterprise-automation-integration-group/enterprise-automation-integration/f/enterprise-automation-integration-forum/1159378/faq-ti-api-api-order-status-codes-and-meanings

    I hope this helps.

    Best regards,
    Paul

  • 0 in reply to Paul King
    Prodigy 40 points

    Dear Paul,

    Thanks for the reply, and for the honest answer.

    Let me make sure this is understood - so are you saying that getting a null in the return status is expected, but we rather should monitor the error code and not the return status code ?

    Also, the limitation of ordering only one OPN at a time is really a painful situation, because each order will be added shipping ($12 in case of Israel), and it could be that we order $2 worth of goods and paying $24 or even $36 for shipping....

    Therefore, this is extremely urgent.

    Thanks,

    Gideon

  • 0 in reply to Gideon Reifman
    TI__Genius 10401 points

    Hi Gideon,

    I misunderstood a part of your question, but the general idea is the same. I thought you were saying that you did not receive a json response at all after placing an unsuccessful order. In the response you do receive, it is expected that the order status will be null if the order failed to create due to an inventory error - there is no order status to report if an order was not created. The response will contain an array of each line item that was out of stock and caused the order to fail.

    Please note that you are able to place orders for multiple OPNs when all of the OPNs are available in the quantities that you need. You may consider using the inventory and pricing API to check the available inventory of all of the parts you need, and place a single order for all OPNs that are in stock.

    Best regards,
    Paul

  • 0 in reply to Paul King
    Prodigy 40 points

    Thanks Paul for this further clarification.

    Just to make sure we have it all straight - If multiple OPN was submitted in ORDER API, and one of them fails (quantity, wrong P/N or other reason), would all of the items won't get order (even if the other OPNs are correct and quantity exist), or we still need to check each line item for status even if the order status is NULL/Empty ?

  • 0 in reply to Gideon Reifman
    TI__Genius 10401 points

    Gideon,

    Today, if one of multiple line items fails, then the entire order fails. No order number will be returned, and there is no need to check the status of each line item. A new order will need to be placed for the OPN(s) that are in stock.

    In the future, we expect to support an optional partial order capability that would allow the order to be placed just for those OPNs that are in stock. There is no timeline, however, for this feature.

    Best regards,
    Paul

**Attention** This is a public forum