Description
Wholesale customers send purchase orders as PDF, Excel, Word files or plain email text. Someone then retypes every line into WooCommerce, looks up each product, and makes mistakes with quantities.
OrderScribe does that work:
- Reads the purchase order with AI: PO number, buyer, delivery address and every line (their item code, description, quantity, price).
- Matches each line to your products: by your SKU, by the customer’s own item code, by product name, and with AI when the customer writes it their own way (“blue gloves lge”, another language, “1000 cups” when you sell cases of 500).
- Turns pieces into your selling units (1000 cups = 2 cases of 500) and checks every match against size, colour, price and pack size before an order is created by itself.
- Creates the WooCommerce order for the right customer account, with the PO number saved on the order.
- Charges each customer their own price from WooCommerce Wholesale Prices or B2BKing, and stops the order when the price on the purchase order differs from it, showing both prices.
- Lines it is not sure about wait for you. Pick the product once, and the plugin remembers it for that customer next time.
- Never creates the same PO twice from the same customer.
- Emails you when a purchase order that came by email is ready: the order was created, it waits for you, or it could not be read. One short email with a link; choose all, only problems, or none, and who gets it.
- Optional: checks a mailbox (IMAP, or Microsoft 365 / Outlook.com with your own Microsoft app ID) every 15 minutes, so forwarding the email is all you do. Only email that arrives after you connect the mailbox is read.
- Safe with email: an order is created by itself only from a sender with a customer account whose email passed the mail server’s sender check (SPF/DKIM/DMARC). Everything else waits for you.
- Orders forwarded by your own staff go to the customer named in the purchase order, never to the staff account, and wait for you.
- Orders in another currency than your store, or for more than you have in stock, wait for you.
- New orders get the status Pending payment by default, so WooCommerce emails nobody before you have looked.
Files: PDF (also scanned), XLSX, CSV (UTF-8, UTF-16 and the usual Windows code pages), DOCX, TXT, PNG, JPG, and forwarded emails (.eml). Other formats (XLS, DOC, ODS, ODT, RTF, HEIC, TIFF) are never dropped: the order waits for you with a note.
Reading runs in the background (WooCommerce’s Action Scheduler), so a long purchase order does not time out the page. If the AI service is busy or your credit or allowance has run out, the order is tried again later and a notice tells you what to fix.
Two ways to read orders, you choose in Settings:
- OrderScribe service: connect with one click, no Anthropic account needed. Your first 5 purchase orders are free, once per store; after that a paid plan ($29 a month for up to 50 orders, see https://orderscribe.burcenko.com/pricing) or your own key.
- Your own Anthropic API key: no limits in the plugin. You pay Anthropic only for what you read, usually about 2-3 US cents per purchase order.
- WordPress 7.0 and later: the AI provider you set up in Settings > Connectors (WordPress AI Client). The plugin keeps no key of its own then; the provider must read PDF files and images and answer in JSON, for example Anthropic Claude.
External services
Purchase orders are read by AI through one of two services, whichever you chose in Settings. Nothing is sent until you connect the service or save an API key. An optional third service, Microsoft, is used only if you connect a Microsoft mailbox.
OrderScribe service (https://orderscribe.burcenko.com/pricing)
Run by the plugin author. What is sent and when:
- Connect (POST /v1/sites): when you press “Connect to the OrderScribe service” or “Connect again”, your store address (site URL) is sent and a site key comes back.
- Reading (POST /v1/messages): each time an order is read, the same content described below for the Anthropic API is sent with the site key, and the service passes it to the Anthropic API with its own key.
- Usage (GET /v1/usage): when you open the OrderScribe pages, at most every 5 minutes, the site key is sent to get the order count and limit.
- Licence (POST /v1/license): when you enter a licence key, the key is sent with the site key.
The service keeps the store address, the site key’s hash, the licence key’s hash, the plan and the number of orders read; it does not keep order content. To stop abuse, the IP addresses that register stores are counted per day as a salted hash.
Terms: https://orderscribe.burcenko.com/terms
Privacy policy: https://orderscribe.burcenko.com/privacy
WordPress AI Client (only if you choose it)
Purchase-order content is sent to the AI provider you chose in Settings > Connectors, under that provider’s terms and privacy policy. The plugin itself sends it nowhere else in this mode.
Microsoft (only if you connect a Microsoft 365 or Outlook.com mailbox)
When you press Connect Microsoft mailbox, the plugin signs in through login.microsoftonline.com and then reads new emails in that mailbox’s Inbox through Microsoft Graph (graph.microsoft.com) every 15 minutes: the email’s sender, subject, text, headers and attachments. It asks only for permission to read mail (Mail.Read, and Mail.Read.Shared if you set a shared mailbox), your address (User.Read) and to stay signed in (offline_access, so it can read every 15 minutes without asking you again). It stores Microsoft’s renewable sign-in token in your database, never your password. Disconnect or uninstall deletes it. Microsoft terms: https://www.microsoft.com/servicesagreement , privacy: https://privacy.microsoft.com/privacystatement
Anthropic API
With your own key, this plugin sends purchase-order content to the Anthropic API (https://api.anthropic.com) to read it. This happens each time you upload or paste an order, and each time the optional mailbox check finds a new order email. What is sent: the order file you uploaded or that was attached to the email, and the email’s sender address, subject and text. When a line cannot be matched by code or exact name, a second request sends the order lines with product names, SKUs and prices from your catalog (the whole catalog up to 400 products, otherwise the closest names for each line). The purchase order itself can contain personal data of the person who ordered (name, email, phone, delivery address); that data is sent with it. Your store’s customer list and orders are not sent. The plugin adds a suggested paragraph to Settings > Privacy for your privacy policy.
With your own Anthropic API key, the API is billed by Anthropic to you.
Anthropic terms: https://www.anthropic.com/legal/commercial-terms
Anthropic privacy policy: https://www.anthropic.com/legal/privacy
Installation
- Install and activate the plugin (WooCommerce must be active).
- Go to WooCommerce > OrderScribe > Settings and press “Connect to the OrderScribe service”, or paste your own Anthropic API key.
- Upload a purchase order on the Purchase orders tab, or set up the mailbox.
FAQ
-
Does it work with wholesale price plugins?
-
Yes, with WooCommerce Wholesale Prices (the customer’s wholesale role price, plus the category, general and quantity discounts of its premium add-on, read through the plugin’s own price functions) and B2BKing (prices per customer and per customer group, sale price first, tiered prices for the ordered quantity, and discount rules shown as the product price). With “Use my store prices” each line gets the price this customer pays for that quantity; products without one keep the store price. Prices are read as that customer, so rules for one customer or group apply. B2BKing discount rules that show only as a cart discount, and rule conditions on the cart total, count only the line itself. Other plugins can give the price through the potoorder_customer_price filter.
-
What if the buyer writes another price?
-
With the price check on (default), an order whose price differs from what this customer pays by more than 1% waits for you, with both prices shown in the line. A buyer who writes net prices into a store with gross prices, or the other way round, is not stopped for that.
-
What if my host has no PHP imap extension?
-
Mailbox checking is then off. Uploading and pasting orders still work.
-
Which mailboxes work?
-
Any mailbox that allows IMAP over SSL with a password: your host’s own mail, or Gmail with an app password (needs 2-Step Verification). Microsoft 365 and Outlook.com: register an app in Microsoft Entra (public client, delegated permission Mail.Read), enter its Application (client) ID as Own Microsoft app ID in Settings, choose Microsoft as the mailbox type and press Connect Microsoft mailbox; you sign in once at Microsoft, no password is stored and no PHP imap extension is needed. A shared mailbox such as orders@ works too: enter its address as the shared mailbox and sign in with an account that has access to it. In a work account, Microsoft may ask that an administrator allows the app once; if you run your own Microsoft 365, that is you. If your organisation blocks sign-in codes, use Sign in another way on the same page.
-
Who can change the settings?
-
Only administrators: the settings hold the mailbox password and the API key. Shop managers can upload, paste and review purchase orders.
-
Does every attachment count as one order read?
-
Yes, each attached file is read on its own (up to 5 files per email; the same file attached twice is read once). With your own key you pay Anthropic per read; on the service each file counts towards the monthly allowance.
-
What happens after the 5 free orders on the service?
-
The next order waits with a message until you enter a licence key or your own Anthropic key. The free orders do not come back next month or when you connect the store again. Orders that fail to read and documents that are not orders are not counted.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“OrderScribe – Purchase Order Reader for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “OrderScribe – Purchase Order Reader for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.8.4
- Long purchase orders are read in parts, so a long order no longer stops with “split it into smaller files”.
- Scanned PDFs and photos are straightened and made smaller before reading: tilted pages no longer move item codes to the next row, and long scans fit the service file limit.
- Scans and photos are read more carefully (higher model effort), which stopped quantities being taken from the next row.
- A page photographed at an angle is cut out of the photo and flattened to a straight page, with its real proportions.
- Phone photos are turned upright by their own orientation setting (EXIF), so a portrait shot is no longer sent sideways. iPhone (HEIC) photos get the same preparation.
- The purchase order record and the order note say what was done to a scan or photo before reading (pages straightened, flattened, turned, size), or why it was sent as received.
0.8.3
- The OrderScribe service moved to orderscribe.burcenko.com.
0.8.2
- New name: OrderScribe.
- Read orders with the WordPress AI Client (WordPress 7.0+), as a third choice next to the service and your own key.
- Needs WordPress 7.0 or later (the AI Client is part of WordPress since 7.0).
0.8.1
- Email to the store when a purchase order that came by email has been read: created, waiting for review, or not readable. Settings: all, only problems, or off, and the addresses (empty = site admin). Sent once per result, also after Read again.
0.8.0
- Customer prices from WooCommerce Wholesale Prices and B2BKing: the order charges the price the customer pays, not the list price.
- Price check: an order whose price differs from the customer’s price waits for review, with both prices in the line.
- The price-vs-pack check compares with the customer’s own price, so a wholesale price no longer looks like a wrong pack size.
- Tiered and quantity prices count for the ordered quantity, and B2BKing discount rules and Wholesale Prices premium discounts count too. A buyer who writes the price before the tier is not stopped.
0.7.1
- The settings notice now says the first 5 purchase orders are free (it wrongly said 10 a month).
- The “cannot read purchase orders” notice shows only on WooCommerce and OrderScribe screens, can be dismissed, and goes away as soon as a licence key, a new API key or another mode is saved.
- Uploads accept only the file types the plugin can read.
- Microsoft mailboxes need your own Microsoft app ID for now; the FAQ explains how.
- The readme lists everything the OrderScribe service keeps.
0.7.0
- OrderScribe service: the first 5 purchase orders are free, once per store; after that a paid plan or your own key.
- On the free plan a document that is not an order (an invoice, a newsletter) uses no free order.
- The Settings page shows the free orders used and a link to the plans.
0.6.0
- All code names use the prefix potoorder.
- Reading runs in the background, so long orders no longer time out the upload page; failed reads are tried again later and can be read again with one click.
- Mailbox: only email that arrives after connecting is read; an email with no sender check result waits for review; orders forwarded by staff no longer use the staff account as customer; two checks at once can no longer queue an email twice; a lost 15-minute schedule is restored.
- Matching: products without a SKU are told apart; the buyer’s own item code is trusted only when the product name agrees.
- Duplicates from buyers without an account are compared only with that buyer’s orders.
- Orders in another currency or beyond stock wait for review; new orders default to Pending payment.
- Settings are for administrators only; changing the mail server needs the password again; the server name is checked.
- CSV files in Cyrillic, Baltic and Central European code pages and UTF-16 are read correctly.
- Up to about 300 lines per purchase order.
- A notice on every admin page when the API key, credit or allowance stops reading.
- Microsoft shared mailboxes (orders@).
- The service can be connected again if it no longer knows the store.
0.5.0
- Microsoft 365 and Outlook.com mailboxes: sign in once with Microsoft, orders are read through Microsoft Graph. No password stored, no imap extension needed, read only. An order the owner has already opened in Outlook is still read.
0.4.1
- Mailbox: an attachment that cannot be read (XLS, DOC, ODS, RTF, HEIC, TIFF…) now waits for a person instead of being lost; small attached screenshots are read; forwarded emails (.eml) are read; windows-1257 and other charsets no longer stop the mailbox; a job the server stops half way leaves a clear note.
0.4.0
- OrderScribe service: read orders without an Anthropic account, 10 a month free, licence keys for more. Your own key still works without limits.
0.3.0
- No monthly limit.
- Email orders from unknown senders, or that fail SPF/DKIM/DMARC, always wait for review.
- Logos and pictures inside an email are no longer read as separate orders.
- Protection against huge files: very large texts are cut, Office files that unpack to more than 50 MB are refused.
- Suggested privacy policy text.
0.2.1
- Large catalogs (over 400 products): the products shown to the AI are now ranked by rare shared words, so the right one is no longer pushed out by short names that share one common word (2151-product test: right product in the list for 97 of 97 lines, was 93).
0.2.0
- AI product choice for lines written in the customer’s own words or language, checked against size, colour, price and pack size.
- Pieces are turned into selling units (1000 cups = 2 cases of 500); the review screen shows the quantity to send and lets you change it.
- Struck-through rows in Excel and Word files are treated as cancelled; sheet names are read.
- A matched code no longer asks for a check when the buyer’s price confirms the unit.
0.1.0
- First version.
