Support

Help with Wharfly.

Install, uninstall, data deletion and common questions. If you cannot find an answer, write to support@wharfly.app. We reply within two business days.

How to install Wharfly

Wharfly is available in the Shopify App Store. Installation works like this.

  1. Find Wharfly in the Shopify App Store

    Search for Wharfly in the App Store, or use the Install on Shopify button at the top of this page, then choose Install while signed in to your Shopify admin.

  2. Review and approve the permissions

    Shopify shows you what Wharfly asks for. The permissions are explained below under "What permissions does Wharfly ask for?"

  3. Open Wharfly from your Shopify admin

    Wharfly reads your products, inventory and locations. The left menu has Purchase orders, Today, Planning, Receipts, Stock counts, Bills, Accounting, Suppliers, Labels, Reports, AI and Settings.

  4. Allow order access for demand planning

    Open Planning and press Sync orders. If Shopify has not yet given Wharfly access to orders, the page asks you to allow it. Only quantities are read, and Shopify shares up to 24 months of order history when the all orders permission is approved (60 days otherwise).

  5. Make your first purchase order

    Open Purchase orders and choose New purchase order. The steps are under "How do I make a purchase order?" below.

How to uninstall Wharfly

  1. Download your data first, if you want it

    Open Settings in Wharfly and download all data as CSV files. Orders, receipts, bills and accounting records are deleted after an uninstall and cannot be brought back.

  2. Open your Shopify admin settings

    Go to Settings, then Apps and sales channels.

  3. Uninstall Wharfly

    Find Wharfly in the list and choose Uninstall.

What happens next: Wharfly removes the saved sign in sessions for your store right away. About 48 hours after you uninstall, Shopify sends Wharfly a store data erasure notice, and Wharfly then deletes all the other data it holds for your store. If you reinstall Wharfly before that notice arrives, your data is kept and the notice does not erase it. To delete your data sooner while keeping the app, an admin can use Settings, then Delete all data, and type the store address to confirm. CSV export is available beforehand. Changes already made in your Shopify store, such as stock added when you received goods, stay as they are.

How to request data deletion

  1. Uninstalling starts deletion

    As described above, Wharfly deletes your store's data when Shopify sends the erasure notice, about 48 hours after uninstall. You do not need to do anything else.

  2. Want it confirmed, or have a question?

    Email support@wharfly.app from an address you use with your store. Put "Data deletion request" in the subject and include your store's .myshopify.com address. We reply within two business days.

  3. Customers of your store

    Wharfly does not store Shopify customer personal data. It reads orders only to total the units sold for each product each day. Shopify's customer data request and erasure notices are received and acknowledged, and there is nothing to return or delete.

See the privacy policy for the full details of what Wharfly keeps and for how long.

Common questions

How do I install Wharfly?

Wharfly is installed from the Shopify App Store while you are signed in to your Shopify admin. Choose Install, review the permissions, and open Wharfly from Apps in your admin.

How do I make a purchase order?

Open Purchase orders and choose New purchase order. Type or choose a supplier, choose the location that will receive the stock, and choose Create draft. On the next page search for a product by SKU, barcode or name, press Add, and set the quantity and the cost for each. Save the draft, and choose Send order when it is ready. A draft can still be edited or cancelled. A sent order cannot be edited.

Wharfly does not email the supplier for you. Open the order and use the email button to start a message in your own mail app, and attach the order PDF yourself.

Why can I not find a product when I add it to an order?

Search by at least two letters or numbers of the SKU, barcode or product name. Wharfly looks in your Shopify catalog. A product can be on an order once. If it is already there, change its quantity instead.

How do I receive goods?

Open the order and choose Receive. Scan a barcode, use the camera, or tap the quantity for each line. Use Receive all outstanding if everything arrived, or count only what came and receive the rest later. Choose Reject for damaged, wrong or short shipped units and give a reason. Add freight or duty if you want it shared across the goods, then choose Review, check the old and new Cost per item, and choose Submit receipt.

Receiving adds the accepted units to your live Shopify stock at the location you chose, as an addition to what is there, never an overwrite. This is why Wharfly asks for the permission to change inventory, and it only happens when you submit. Rejected units are not added.

I pressed Submit receipt twice, or my signal dropped.

Submitting the same count twice makes one receipt, and the stock is added once. If Shopify refuses a stock change, Wharfly tells you in plain words, nothing is counted twice, and the receipt stays unfinished with the line marked Not applied. Submit the same counts again to finish it. Lines already added are not added again.

I received stock by mistake.

If you reverse a receipt for a purchase order made in Wharfly, Wharfly takes the same accepted units off the same Shopify location again. Open the receipt and choose Reverse this receipt. The receipt stays on record, marked reversed, the units go back on the order as outstanding, Cost per item is restored where nobody has changed it since, and nothing is posted to your accounts.

How do I close or cancel an order?

Open the order. Close order is for an order that is partly received and will not get the rest: what is still missing is written off and the order leaves the open list. Cancel order is only offered while nothing has been received. Closed and cancelled orders cannot be received against.

What does the Free receipt limit count?

The Free limit is 5 receipts in each calendar month. Each submitted receipt counts, whether it is for a whole order or a part of one. A receipt you reverse is given back. The count is per store and starts again each calendar month. The full details are on the pricing page.

How do I add freight and duty to my cost?

On the receiving page choose Add a landed cost, enter the amount and its currency, and choose how to share it across the lines: by value, by quantity or by weight. The review step shows the Cost per item before and after. You can undo a cost change from the receipt if nobody has changed the cost since.

How do I record a supplier bill and pay it?

Open Bills and choose Add a bill. Choose the supplier, enter the invoice number, dates and the goods, freight and duty amounts, and link a purchase order if there is one. Open the bill to record payments. A payment made by mistake can be voided with a reason: it stays visible, marked voided, and the amount owed goes back up. Bills and payments are posted to Accounting, which shows accounts, the journal and what you owe each supplier. Receiving goods posts nothing there.

How do I count stock?

Open Stock counts, choose a location, and choose Start counting. Search for a product, enter the quantity you counted, and save it. Choose Review differences to see expected, counted and the difference. Nothing is written to Shopify until you confirm, and a product whose stock changed in Shopify after the review is marked for a recount instead of being overwritten.

How do I export to CSV?

Lists and reports with a download button, such as the purchase orders board, demand planning suggestions, bills, receipts, each report and a product's cost history, download what you are looking at as a CSV file. Settings can download all of your Wharfly data as a set of CSV files.

How do I connect an AI assistant?

This is optional. Open AI in the left menu. It shows the connector address and the steps for adding it as a custom connector in an assistant such as Claude or ChatGPT. You approve the connection in your Shopify admin. The assistant can read your purchase orders, supplier terms and recent receipts, and propose changes. Nothing changes until you press Approve, and you can disconnect it at any time. See the AI page.

What permissions does Wharfly ask for, and why?

Wharfly asks for permissions for locations, products and inventory, and one optional permission for orders. Each one has a specific job:

  • Locations: so you can choose which location an order is received into and which location you count.
  • Products: so you can find products to put on an order, and see their SKU, barcode, price and Cost per item.
  • Inventory: to show stock on hand, to add stock when you receive goods or put it back when you reverse a receipt, to write Cost per item, and to apply a stock count when you confirm. Shopify's write permissions include read access.
  • Orders (optional): to total the units sold for each product each day, which demand planning needs. Only quantities are read, never customer details. Shopify shares up to 24 months of order history when the all orders permission is approved, 60 days otherwise.
How do I delete my data?

A store admin can open Settings in Wharfly, choose Delete all data, and type the store address to confirm. CSV download is available beforehand. This permanently deletes everything Wharfly holds for the store while the app stays installed, including suppliers, purchase orders, receipts, bills, payments, accounting entries and stock counts. It cannot be undone. Changes already made in your Shopify store, such as stock added when you received goods, stay as they are.

What happens when I uninstall?

Wharfly removes the saved sign in sessions for your store right away. About 48 hours later Shopify sends Wharfly a store data erasure notice, and Wharfly then deletes all the other data it holds for your store. If you reinstall Wharfly before that notice arrives, your data is kept and the notice does not erase it. Changes already made in your Shopify store, such as stock added when you received goods, stay as they are.

How do I contact support?

Email support@wharfly.app and include your store's .myshopify.com address. We reply within two business days. You can also use the contact page.

Still stuck?

Write to us and include your store's .myshopify.com address. We reply within two business days.