Install and set up
Install the app from the Shopify App Store. It opens inside your Shopify admin, under Apps. On the first open the app sets itself up for your store: it makes your store's login and its own forwarding address. You do not make a ParserBee account, build a template or connect anything.
The app asks Shopify for access to your products (to match lines), your customers (to find the buyer by email) and draft orders (to make them). It does not create real orders, take payments or change your products.
New to the app? Follow the step-by-step tutorial, or watch the 3-minute walkthrough of a real store.
Sending orders
By email
Your store has one forwarding address, shown in the app under Send orders by email. It looks like orders-k7m2p9xq4tbw@in.parserbee.com. The random part is the only key to your store's inbox, so share it only with people who forward orders for you.
- Forward an email with the order attached, or with the order typed in the email itself.
- You can set your mailbox to forward orders to the address automatically.
By upload
Under Upload orders, drop up to 10 files at a time and press Make draft order. Each file is one order. It can take one or two minutes, so keep the page open.
File types
| Kind | Formats |
|---|---|
| Documents | PDF, including scanned PDFs |
| Spreadsheets | Excel (XLSX) and CSV |
| Photos and scans | JPG, PNG, WebP and HEIC (iPhone photos) |
| Orders typed in the body of the email you forward |
Finding the customer
The app looks for a customer in your store by email address only, in this order, and uses the first one it finds:
- A line in the email you forward:
Shopify Customer: buyer@example.com. Use it when you forward an order that someone else received. - The address that sent the email.
- A buyer email address printed on the order document.
If none of them belongs to a customer in your store, the draft is still made, without a customer. It gets the tag ParserBee-Customer-Not-Found, and its note names the buyer, so you can add the customer before you send it.
Product matching
Each line on the order is matched to one product variant in your store. Only active products are used. The app tries, in order:
- SKU. The code on the line must belong to exactly one variant. Codes are compared without case, spaces or punctuation, so
jo-cn-lav-8matchesJO CN LAV 8. - Barcode. The same rule, against your variants' barcodes.
- Description. When there is no code, the app searches your products with the line's words and picks one only if it matches clearly and clearly better than the next best product.
A wrong product is worse than a line to check. If two variants share a code, or no product is a clear winner, the line is not matched. It stays on the draft as a custom line named NOT MATCHED: ... with the description, quantity and price from the document, so the order is complete and you replace that one line.
If a line has no clear quantity, it is set to 1 and the note says so.
Prices
A matched line sends only the product variant and the quantity, so Shopify uses your store's price. The price printed on the purchase order is ignored, which protects you from old price lists. Only a NOT MATCHED line carries the document's price, so you can see what the customer expected.
What goes on the draft
| Customer | The customer found by email, if any. |
|---|---|
| Lines | Matched products with quantities, plus any NOT MATCHED custom lines. |
| Ship-to address | From the order. The country is set only when the document gives a two-letter country code. |
| PO number | The customer's purchase order number. |
| ParserBee reference | A reference you can quote to support. |
| Note | The file it came from, lines not matched, quantities set to 1, the requested delivery date and the buyer's notes. |
Emails you get
- For each order: Draft order #D13 is ready, or Draft order #D14 needs your check with what to check.
- When your plan has no orders left: one email a day at most, while orders keep arriving.
- A welcome email after you install, with your forwarding address, and a few short tips in your first days.
Plans and order counts
| Plan | Price | Orders |
|---|---|---|
| Free | $0 | 5 orders, no time limit |
| Starter | $39 / month | 25 orders every 30 days |
| Scale | $99 / month | 100 orders every 30 days |
| Business | $249 / month | 300 orders every 30 days |
- One draft order made is one order, however many pages or lines. A file that fails to read is not counted.
- Paid plans count orders per 30-day billing period. Unused orders do not roll over. The 5 free orders do not expire.
- When no orders are left, new orders are not read until the next period or a bigger plan.
- Billing goes through Shopify. Change your plan from See plans in the app. See pricing.
Your data
- Your orders are never used to train AI models.
- Files travel to ParserBee over an encrypted (HTTPS) connection.
- Read our privacy policy for the details.
Getting help
Write to support@parserbee.com or see support. For a question about one order, give the draft order number or the ParserBee reference from the draft.