Connect WooCommerce with the Printen.eu plugin

How do you install the plugin?

1. 1

   Open Plugins

   In WordPress, go to Plugins > Add New Plugin.

2. 2

   Search for the plugin

   Search for Printen.eu Print on Demand.

3. 3

   Install and activate

   Click Install Now and then Activate. Printen.eu now appears in the WooCommerce menu.

How do you connect the plugin to your account?

The plugin connects with an API key from your Printen.eu dashboard. Start with a test key: it lets you run through the whole flow without anything being charged or printed.

1. 1

   Create a test key

   In your Printen.eu dashboard, go to API keys. Enter a Key name (for example “WooCommerce test”), tick Test key and click Create key.

2. 2

   Copy the key

   The key starts with prk_test_. Click Copy. You only see it once.

3. 3

   Paste it in WordPress

   In WordPress, go to WooCommerce > Printen.eu, paste the key under API key and click Connect.

4. 4

   Check the connection

   You see Connected to Printen.eu. with your company, your Wallet balance, your Tier (your discount percentage) and Tracking updates: Active. With a test key, it also says that orders are not charged and not produced.

5. 5

   Place a test order

   Link a product (see below) and place an order in your own store. As soon as it is Processing, the order notes show it was placed at Printen.eu, with the addition (sandbox: not charged, not produced).

6. 6

   Switch to live

   In your dashboard, create a key without Test key (it starts with prk_live_), paste it under Replace API key and click Connect. From now on, orders are really charged and printed.

How do you link your products?

A WooCommerce product comes to us when it is linked to one of your active Printen.eu products. That link runs through your Printen.eu SKU. There are two ways: import or link yourself.

1. 1

   Option 1: import

   On WooCommerce > Printen.eu, click Import my Printen products. We create a draft WooCommerce product for each product, with title, description, your selling price, the SKU and mockup images (if you added them through the API).

2. 2

   Wait a minute

   The import runs in the background. Refresh the Products screen after a minute. Products that already exist (same SKU or already linked) are skipped.

3. 3

   Review and publish

   Open the drafts, check the text, price and shipping class, and click Publish.

4. 4

   Option 2: link yourself

   Open an existing product in WooCommerce. On the General tab, choose the right product under Printen.eu product (you see SKU and title). Click Update.

5. 5

   Variations

   For a variable product, you can link the parent product, or give each variation its own Printen.eu product. Leave a variation on - Same as parent product - to use the parent’s link. A variation’s own link always takes precedence.

Which settings does the plugin have?

On WooCommerce > Printen.eu you find three settings under Orders. After a change, click Save settings.

How are orders forwarded?

• Paid orders only. Sending starts as soon as an order becomes Processing. An order On hold (for example a bank transfer) is sent once it is paid.
• In the background. Sending runs through WooCommerce’s Action Scheduler. Your checkout is never slowed down.
• Linked lines only. In a mixed order we only take the lines with a Printen.eu product. You ship the rest yourself. The same SKU in several lines is added up.
• Refunded quantities are left out. If you refunded part of the order before it was sent, those quantities are left out.
• Never twice. Every order is sent to us with a fixed key. A retry therefore never creates a second order.

On the order screen in WooCommerce, the Printen.eu box on the right shows the Printen.eu order number, the State, the Production status and the Tracking.

How does your customer get the tracking?

1. 1

   We ship

   The parcel leaves with your name as the sender. See White label.

2. 2

   Customer note on the order

   The plugin adds a customer note to the order with the carrier and tracking code, for example “Your order has been shipped with ...” and “Tracking code: ...”. WooCommerce emails customer notes to your customer by default.

3. 3

   Also for tracking plugins

   The tracking is also stored in the format of the Advanced Shipment Tracking plugin. If you use it, the tracking appears there too.

4. 4

   Completion

   If Complete orders is on and all lines are Printen.eu products, the plugin marks the order Completed.

Seen an error message? Here is how to fix it

The plugin retries temporary errors (for example when we are briefly unreachable) automatically: after 1, 5, 15, 60 and 180 minutes. If it still fails after that, the order gets a note and you see a notice in your WordPress dashboard. Fix the cause and click Send to Printen.eu on the order.

How do you disconnect?

1. 1

   Disconnect in WordPress

   Go to WooCommerce > Printen.eu, click Disconnect and confirm. The key is removed from your site and we stop sending updates.

2. 2

   Revoke the key

   In your dashboard, go to API keys and click Revoke next to the key. It can then no longer be used anywhere.

Can it work without the plugin?

Yes. Instead of the plugin, we can also connect your store from our side using WooCommerce REST API keys. You then install nothing in WordPress.

• We create the webhooks for new and updated orders in your store ourselves.
• We only fetch orders with the status Processing (paid), and only lines with your SKUs.
• When shipped, we add the tracking as a customer note on the order (also in the Advanced Shipment Tracking format) and mark orders with only our lines Completed.
• When disconnecting, we remove our webhooks. You revoke the REST key yourself in WordPress.

1. 1

   Open the REST API settings

   In WordPress, go to WooCommerce > Settings > Advanced > REST API and click Add key.

2. 2

   Create the key

   Enter a description (for example “Printen.eu”), choose your own user and set Permissions to Read/Write. Click Generate API key.

3. 3

   Keep the details

   Note the Consumer key (starts with ck_) and the Consumer secret (starts with cs_), together with your store’s https URL.

Why not both at the same time?

Use either the plugin or the REST key connection, never both. Otherwise every order reaches us twice.

The plugin protects you against that. If it sees that your store is also connected through REST API keys, it shows a warning (“This shop is also connected to Printen.eu through WooCommerce REST API keys...”) and stops forwarding orders itself. The box on the order screen then shows Sent through the server-side connection.