Title: OrderScribe &#8211; Purchase Order Reader for WooCommerce
Author: maksimsburcenko
Published: <strong>November 16, 2026</strong>
Last modified: November 16, 2026

---

Search plugins

![](https://ps.w.org/orderscribe/assets/banner-772x250.png?rev=3805869)

![](https://ps.w.org/orderscribe/assets/icon-256x256.png?rev=3805869)

# OrderScribe – Purchase Order Reader for WooCommerce

 By [maksimsburcenko](https://profiles.wordpress.org/maksimsburcenko/)

[Download](https://downloads.wordpress.org/plugin/orderscribe.0.8.4.zip)

 * [Details](https://wordpress.org/plugins/orderscribe/#description)
 * [Reviews](https://wordpress.org/plugins/orderscribe/#reviews)
 *  [Installation](https://wordpress.org/plugins/orderscribe/#installation)
 * [Development](https://wordpress.org/plugins/orderscribe/#developers)

 [Support](https://wordpress.org/support/plugin/orderscribe/)

## 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

 1. Install and activate the plugin (WooCommerce must be active).
 2. Go to WooCommerce > OrderScribe > Settings and press “Connect to the OrderScribe
    service”, or paste your own Anthropic API key.
 3. 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.

Contributors

 *   [ maksimsburcenko ](https://profiles.wordpress.org/maksimsburcenko/)

[Translate “OrderScribe – Purchase Order Reader for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/orderscribe)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/orderscribe/), check
out the [SVN repository](https://plugins.svn.wordpress.org/orderscribe/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/orderscribe/) by
[RSS](https://plugins.trac.wordpress.org/log/orderscribe/?limit=100&mode=stop_on_copy&format=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.

## Meta

 *  Version **0.8.4**
 *  Last updated **18 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 7.0 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [b2b](https://wordpress.org/plugins/tags/b2b/)[order import](https://wordpress.org/plugins/tags/order-import/)
   [purchase order](https://wordpress.org/plugins/tags/purchase-order/)[wholesale](https://wordpress.org/plugins/tags/wholesale/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/orderscribe/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/orderscribe/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/orderscribe/reviews/)

## Contributors

 *   [ maksimsburcenko ](https://profiles.wordpress.org/maksimsburcenko/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/orderscribe/)