Skip to main content
All CollectionsIntegration Settings
How does the WooCommerce integration work?
How does the WooCommerce integration work?

Learn about Pirate Ship's WooCommerce integration and how you can use it to easily buy labels for your orders

Updated yesterday
  • Import WooCommerce Orders Automatically: 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: The minimum requirements for connecting WooCommerce to Pirate Ship are as follows:

    • 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://)

See the WooCommerce integration in action:

How to connect Pirate Ship to WooCommerce

  • Get Connected: Here's how to connect Pirate Ship to WooCommerce:

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

    • 2. Confirm 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 👍)

Importing & filtering YARrrr WooCommerce orders

  • How to Import Orders: 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.

    • Order Statuses: By default, Pirate Ship only imports orders marked as "Processing."

    • Refresh Data: Pirate Ship will refresh the data in the Import grid periodically, but click the "Refresh Data" button to ensure you’re always looking at the most current order list.  

  • Filter and Sort Orders: You can click any of the columns in the Import grid to filter or sort the data to group and select which orders you'd like to create shipments for.

Customizing YARrrr integration

  • Adjust Settings: In Pirate Ship’s Settings > Integrations > WooCommerce page you can adjust some settings:

    • Field Mapping on Labels: 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.

    • Enable Tracking Emails: You can enable Pirate Ship's tracking emails (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.

      • A Note on Emails: If you enable Pirate Ship's emails, the tracking information will be pushed back to WooCommerce 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 as a Customer Note, which will trigger the Customer Note email template within WooCommerce if you have it enabled.

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

What if I need to refund a label?

  • Refunding Labels for WooCommerce Orders: 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

  • Additional Help for Order Management: 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:

  • PUT Requests: If your orders aren't getting updated to Completed after purchasing a label on Pirate Ship, it could be an issue with PUT requests.

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

We ARRrrr here if you need help getting sailing!

Feeling lost at sea, Captain? Click the blue chat button to get in touch with ARRrrr Support Crew - we're here for ya 😃

Did this answer your question?