Repository navigation
Replies: 1 comment 1 reply
|
Hey! Thanks for the proposal. We have a little bit of a backlog but we'll be taking a closer look into it asap. |
1 reply
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
I build EZStock, an inventory and purchase order app on the Shopify App Store, so I'd register this type myself.
What type are you proposing?
application/purchase-orderfor purchase orders owned by inventory, purchasing and replenishment apps: orders a merchant sends to an outside supplier to buy stock.The initial actions would be:
create: open a staged workflow for one new purchase order, optionally prefilled with a supplier and lines.edit: open an existing app-owned purchase order, for example to change lines on a draft or to receive a delivery against it.Sending the order to the supplier and receiving stock into Shopify inventory should stay explicit steps inside the opened app, each confirmed by the merchant.
What do merchants ask Sidekick to do?
Apps like ours can already answer the questions through an
admin.app.tools.dataextension: what to reorder, what's running low, what's on order. The gap is the follow-up action:For each of these, Sidekick should take the merchant to the right app with the order prefilled, and the merchant reviews and confirms.
What apps would register it?
Inventory management, purchasing, replenishment and forecasting apps, plus ERPs that own purchase orders. Shopify's own purchase order app, Stocky, shut down on August 31, 2026. Shopify admin covers basic purchase orders, and merchants who need reorder suggestions, supplier emails or forecasting move to these apps.
We're ready to register the intent and give implementation and testing feedback. Other purchasing apps could use the same contract; no other named app is implied.
What fields might it need?
All input fields optional, so the app's own screen can collect or check what's missing.
valueeditsupplier_nameline_itemsreorder_suggestionslocation_idexpected_datecurrencynotesFinal names,
$refusage and thevaluemapping should follow Shopify's conventions. The input schema would declare norequiredarray.What existing type is close?
None fits:
application/shipmentis shipment tracking for outgoing orders, not stock bought from a supplier.application/quoteis a sales quote to a customer; a purchase order goes the other way, from the merchant to a supplier.shopify/orderimportcreates Shopify sales orders. A purchase order isn't a sales order.shopify/transfer(discussion shopify/transfer intent for creating transfers between locations #26) moves stock between the merchant's own locations. A purchase order brings stock in from outside. The two are siblings and could share line item shapes.Shopify admin also has its own purchase orders. This type is for orders owned by an app (with its own suppliers, reorder logic and supplier emails). A
shopify/purchase-orderfor admin purchase orders could be a separate proposal.Safety and interaction boundary
The intent should only open and stage an order. Sending it and receiving stock stay with the merchant. The app must:
Why this is useful beyond a deep link
A typed purchase-order intent lets Sidekick pick the right installed app when a merchant wants to order stock, pass an existing order through
value, and tell "order more stock" apart from sales orders, transfers and shipments.All reactions