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 it here, see why, and fix it without leaving Shopify.

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.

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.

  • Generate document: opens the manual generation window, where you pick the document to create.

🟢 Success

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

Under the document you see what happened to its email:

  • Email sent to …: the customer got it.

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

  • 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.

📷 [IMAGE: Pennylane Monitor: a Success row with its email line (canvas board pennylane-MonitorOrders, order #23245)]

🔴 Error

The document wasn't created. This is almost never a problem with your data or the app: usually one small setting on your side fixes it, and the row tells you which one: Why it failed and How to fix, right there.

  • 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.

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 rejected the connection: the access couldn't be renewed.

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

4-403

Pennylane refused the request. The connected account may lack a permission the app asked for, or your Pennylane plan doesn't include this.

Check that your Pennylane subscription is active and the user who approved the app can create invoices, then reconnect in the app 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?