Why online orders retrieved with the API are missing the Order number?

We are building an integration and we need the Order number when an order is paid. We have a webhook notifying us about the paid order with the order id, we go to retrieve the order with the id using the API but the Order number is missing. The Order number is the way we have with the customer to find it but it’s missing. Is there a reason for that? Is there a way to get the Order number using the API?

We have issues because the fulfilment details are missing in the API, check the ‘New Delivery Fulfillment type’ question, and now we find that the Order number is also missing in the API? Everything from the order should be available in the API, right? What can we do? Is there a way to get the Order number using the API?

What order number are you referring to on the order? Is it the one that’s shown on the Dashboard for Square Online Store orders? :slightly_smiling_face:

Yes, the number in the left column when you go to see your orders in the Online dashboard. The same Order number that the customer gets in the email notification after it’s paid. It’s the only way for the customers and us to get to the right order and it’s missing when retrieving the order with the API, right?

Unfortunately the short order ID isn’t currently available in the order returned by the Orders API. We’re constantly working to improve our features based on feedback like this, so I’ll be sure to share your request to the API product team. :slightly_smiling_face:

I can’t believe it. For you it can be the Short Order ID, but for everybody else it’s the Order Number. How is possible that it’s not available in the API? That number has been there always, it’s none sense.

Our customers are having many orders with us. We need a unique id or number sent to the customer in the notification email, for us to locate the order when they are on the phone.

Can we add the Long Order ID to the email notification?

Or, is there a way to add a custom field to the order? where we can enter our own unique Order tracking number using API? and add this custom field to the notification email sent to the customer? so when the customer calls us he can give us something to locate his order in the system?

@Bryan-Square, you said the Order number is a ‘short order ID’. Is it, by any chance, a result from applying any formula to the Order Id?

We have this order_id V7T08cn2TvF7jdJP9SXryz6x0RQZY
that has this order number #1385905013

Is there any relationship between them? can we get the Order number from applying any formula to the Order id? Or the other way around and get the Order id from the Order number?

At this time there isn’t any relationship between the order identifiers. I’ve shared this feedback with the team. :slightly_smiling_face:

The only way we have to find orders when talking with our customers is with their contact info and then by date or products bought which is very time consuming and confusing for repeating customers.
Can you help us to find a way to locate the orders with our customers using some kind of unique identifier? or tracking id? unique to each order?

Hi @Bryan-Square, any idea? we really need a unique identifier on each order that we can get in the API, so our kitchen, drivers and front desk contractors can communicate with our customers. They need to be out of Square, so we have a separate system for them and that’s why we need this unique tracking ID to be available in the API order retrieve call. It’s important and urgent for us to get it done soon, any idea?

Hi @Bryan-Square, we noticed that online orders are different objects than orders and there are a synchronization between them. That may be re reason because the short id is not coming back in the order api retrieval? So, the question can be then, is there any API to retrieve the online orders them self?

All orders including the Square online order are returned with the Orders API. Unfortunately the short ID that you see in the Dashboard isn’t returned in any API response at this time. We’re constantly working to improve our features based on feedback like this, so I’ll be sure to share your request to the API product team. :slightly_smiling_face: