All Collections
Integration Settings
How does the WooCommerce integration work?
How does the WooCommerce integration work?

Learn about Pirate Ship's Woo Commerce integration

Updated over a week ago

Pirate Ship’s WooCommerce integration makes it simple to import your orders and turn them into shipping labels. When you buy postage for your WooCommerce orders using Pirate Ship, the order is automatically marked as "Completed" in WooCommerce and the tracking number is attached to the order as an "Order Note" or a "Customer Note" depending on your settings.

Minimum requirements:

  1. Your WooCommerce plugin must be at least version 2.6 or newer.

  2. Your Wordpress installation must be at least version 4.4 or newer.

  3. You must have an SSL certificate installed on your website (https://)

Here's how to connect Pirate Ship to WooCommerce:

  1. In Pirate Ship, head to Settings > Integrations > Connect New Source > WooCommerce.

  2. Confirm sure your website is live and functional. Next, enter the base URL of your WooCommerce store and click "Connect" (by base URL, we mean you should be connecting to yourwebsitenamehere.com, not yourwebsitenamehere.com/shop 👍)

Once your WooCommerce store is connected, click back to the "Ship" page in Pirate Ship and you'll see a new option: "Import from WooCommerce". From here you’ll see all of the orders in your store that have the "Processing" status. Pirate Ship will refresh the data periodically, but make sure to click the Refresh Data button to make sure you’re always looking at the most current order list.  

You can click any of the columns to filter or sort the data to group and select which orders you would like to create shipments for.

In Pirate Ship’s Settings > Integrations > WooCommerce page you can adjust several settings:

  • You can select which Statuses you’d like Pirate Ship to import, by default we'll only import orders marked as "Processing".

  • You can edit the Field Mapping to have some of the WooCommerce order data printed in small text in the corner of the shipping label. This is commonly used to print Order Items or an Order ID on each label, which can be helpful.

  • You can also choose to enable Pirate Ship's tracking email (which have the added ability to be scheduled for a specific date and time). Just go to Settings > Integrations > Edit WooCommerce. You'll see a checkbox that says "Enable Pirate Ship's Tracking Emails for WooCommerce shipments." You can configure how this email looks and the subject line by going back to Settings > Tracking Emails.

    Important Note on Emails: If you enable Pirate Ship's emails, the tracking information will be pushed back to Woo as a private Order Note, which will not trigger any email notifications within WooCommerce. But if you disable Pirate Ship's emails, the tracking information will be pushed back to Woo as a Customer Note, which will trigger the Customer Note email template within WooCommerce if you have it enabled. 

Keep in mind, WooCommerce may also trigger an email notification when the status of an order gets changed to "Completed". Generally, it's best to disable this email template in WooCommerce. You can configure this notification in your WooCommerce settings under the "Emails" tab.

A note on refunding labels:

If for any reason you need to "Refund" a label that won't be used, Pirate Ship will automatically change the associated WooCommerce order status from "Completed" back to "Processing". 

Managing orders in WooCommerce

While we're not experts in WooCommerce's interface, we can do our best to steer y'ee to smoother waters! WooCommerce offers additional help for managing orders in this article. There, you can find information like how to confirm the status of your orders and locate your order manager, which allows you to confirm if an order can be imported or not 👌

Other known issues:

  • If your orders aren't getting updated to Completed after purchasing a label on Pirate Ship, it could be an issue with PUT requests. Make sure that your web server accepts PUT requests. Some tutorials recommend adjusting your setting via an .htaccess file to deny PUT requests. However, PUT requests are needed for the WooCommerce API to work properly!

Pirate Ship doesn't display live rates to your customers

Keep in mind that Pirate Ship never displays live rates to your customers. What you charge for shipping is up to you 😉 Check out this article for some tips on what to charge for shipping.

Have any questions? Click the blue chat button to get in touch with our Support crew 😃

Did this answer your question?