Skip to main content

Track and fix document generations on the Monitor

The Monitor shows every Shopify order with the status of its documents in Pennylane, in real time. If a document wasn’t created, you see why, and you can fix it without leaving Shopify.

Search by order ID

Type an order ID in the search field; the list filters as you type.

Part of the ID is enough. For order #344, searching 344 finds it.

Switch between views

The Monitor opens on All orders. Two quick views narrow it down:

  • Only successful: everything that went through

  • Only errors: the orders that need you

Reading the order rows

Every document of an order shows one of three states.

⚫ No document

No document was created for this order yet. Next to it you see why, for example:

  • Skipped by your exception: order has tag influencer. The order matched one of your Skip these orders exceptions in Settings.

  • Based on your trigger settings, this order hasn’t triggered any document. None of your triggers has run for it.

If no document was created because of Generate for, you see a Not created entry for each skipped document instead (see below).

Generate document opens the manual generation window, where you pick the document to create: an invoice or a proforma.

⚪ Not created

Your trigger would have created this document, but your Generate for setting skipped it. You see a grey Not created badge, the document type and the reason:

  • Generate for: Companies: “The order has no valid VAT number, and this document is created for companies only (Generate for: Companies).”

  • Generate for: Individuals: “The order has a valid VAT number, and this document is created for individuals only (Generate for: Individuals).”

Good to know:

  • If another document was created for the order, the Not created entry shows below it, without a button. After a failed attempt, it shows below the error, and the error keeps its own Try again.

  • If no document was created, each skipped document gets its own entry, with Generate document below them, so you can create it by hand.

  • It’s not an error, so Only errors doesn’t show it.

  • If you later create the same document type by hand, the entry disappears.

  • If one of your exceptions also matches the order, you see the exception reason instead.

  • It only appears for documents the app creates automatically, and not on orders processed before this feature was released.

🟢 Success

The document was created in Pennylane. The row shows its type, its Pennylane number and when it was created. Open or download it in Pennylane.

Under the document you see what happened to its email:

  • Email sent to …: Pennylane sent it to the customer.

  • Email sending is turned off for this document in Settings. Not an error: everything works.

  • The order has no email address, so there was nobody to send it to.

  • 🟡 The document was created, but Pennylane couldn’t send the email. The document is fine and is never created twice. Click Contact us and we’ll check it.

A failed email isn’t sent again automatically.

Pennylane can’t email proformas, so they have no email line.

🔴 Error

The document wasn’t created. The row shows the error code, what went wrong and how to fix it. Usually one small setting on your side fixes it.

  • Try again: opens the manual generation window, where you can pick any document type and create it again.

  • Send to support: opens the chat with the error log attached, so you don’t have to explain anything.

🤗 We’re on it. Your error log goes straight to our technical team. You always hear back from us, and we stay on it until your document is created.

How the Monitor works

  • If you have no orders yet, it shows an empty list.

  • Otherwise you see your orders, 25 per page.

Your numbers at the top

  • Successfully generated: how many documents the app created, in total and today.

  • Saved time so far: how much manual work that saved you (3 minutes per document).

Not connected yet?

Until the app is connected to your Pennylane account, the Monitor shows Connect your Pennylane account first instead of the orders. Click Connect now → to set up the connection.

Email notification, only when it matters

If something failed during the day, we send you a summary email with the affected orders, so you know to open the Monitor. No email means nothing to fix.

Looking up an error code

You don’t need this table to fix an error: the Monitor shows the explanation and the fix on the order row. Use it to look up a code you’ve seen.

Error code

💬 Explanation

✅ How to fix

1-

No document was created: the app skipped this order on purpose.

Nothing to do. If you expected a document, contact us: https://makeiteasy.app/contact/

1-1

App access denied: subscription not approved or app not in development mode.

Approve the subscription to this Shopify app.

1-2

The Pennylane connection didn't finish: no Pennylane company is linked, so there's nowhere to issue the document.

Go to the app settings and click Connect to link your Pennylane account again.

1-3

Shopify isn't connected to your Pennylane account.

Go to the app settings and click Connect to link your Pennylane account.

1-4

The order total was 0. We don't create a document for it.

Create an order with a total above 0.

2-

Some order data needed for the document is missing.

Try creating the document by hand from the order. If it still fails, contact us: https://makeiteasy.app/contact/

3-

Something went wrong on our side while preparing the document.

Please contact us, we'll help as soon as we can: https://makeiteasy.app/contact/

3-1

The order has no customer, and a document needs one.

Add a customer to the order and try again.

3-2

The billing address on the order isn't complete. Pennylane needs a street, postal code, city and country for every customer.

Complete the billing address on the order in Shopify, then create the document again.

3-3

A credit note was requested, but the invoice it reverses isn't in Pennylane.

Check that the invoice still exists in Pennylane. If it was deleted, create the credit note by hand.

4-

The call to Pennylane failed. We may have sent wrong data, or the problem is on Pennylane’s side.

Please contact us, we'll help as soon as we can: https://makeiteasy.app/contact/

4-1

Pennylane has no VAT code for one of the tax rates on this order, so the document couldn't be created. Pennylane only accepts rates it knows (20% France, 19% Germany, …), not any percentage.

Check the tax rates on the order in Shopify. If the order should be tax-free, check the customer's tax exemption. If it's a real national VAT rate Pennylane is missing, send it to support.

4-400

Pennylane rejected the request: some document data isn't in a format it accepts.

Check the customer's billing details on the order, then try again. If it keeps failing, send it to support.

4-401

Pennylane didn't accept the API key: it was revoked or isn't valid anymore.

In Pennylane, generate a new API token. Paste it into the API key field in the app's Settings and click Save.

4-403

Pennylane refused the request. The API token is missing a permission, or your Pennylane plan doesn't include this.

Check that your Pennylane subscription is active and the token has read and write access to customers, customer invoices and commercial documents. If not, create a new token and paste it in the app's Settings.

4-404

Pennylane couldn't find a document or customer the app referred to.

It may have been deleted in Pennylane. Try creating the document again; if it keeps failing, contact us: https://makeiteasy.app/contact/

4-409

Pennylane was still making the document's PDF and couldn't send it yet.

The document itself was created. Wait a minute and send it from Pennylane, or create it again from the app.

4-422

Pennylane refused the document because some of its data isn't valid.

Check the customer's billing details and the tax rates on the order, then try again. If it keeps failing, send it to support.

4-429

Pennylane's API limit was reached.

Wait a few minutes and try again. If it happens often, contact us: https://makeiteasy.app/contact/

Make sure the trigger isn’t ‘Never’. If a document type is set to Never in the trigger settings, the app doesn’t create it by itself. That’s the setting, not a bug. You can still create it by hand from the Monitor.

Did this answer your question?