Buy Pirate Ship shipping labels in bulk

1. On the Ship page, choose Import from Integrations for store orders, or drag a CSV, XLS, XLSX or ODS file into the spreadsheet upload for everything else.
2. The first time a new sheet layout is uploaded, Pirate Ship asks you to map each column (Name, Address, City, State, Zip, and Weight, Length, Width, Height as Override fields).
3. On the package screen, pick a Saved Package from the Package Details drop-down or type Default weight and dimensions for rows that have none.
4. Click Get Rates, choose a service, then the green Buy Labels button, and Print Labels on the page that follows.
5. Pirate Ship cannot mix package types, Extra Services or customs options inside one spreadsheet, so envelopes and boxes need separate uploads. Addresses that fail come back as a new spreadsheet to fix and upload again, and that loop is where orders get dropped.

Take the wholesale orders in wholesale.csv plus my unshipped Shopify orders, split them by box, show me the USPS Ground Advantage totals and buy the labels once I say OK.

1. 01

   Gather every open order in one list

   The agent reads the file or message you point it to and calls list_import_orders with refresh on, so orders paid in the last few minutes are included. An order that appears in both places, for example a Shopify order a wholesale buyer also emailed about, is kept once and named in the report.

2. 02

   Assign a box to each order

   Pirate Ship needs one package type per batch, so the agent sorts orders into groups by your Saved Packages from list_saved_packages, using the item or weight rules you gave it. An order that fits no saved box is held back and listed for you instead of being forced into the wrong size.

3. 03

   Build one batch per group, buying nothing yet

   Each group becomes its own create_batch call with the matching saved package and the order number in the Rubber Stamp, so a packer can match label to parcel. Rows missing a street, city, state or ZIP are left out at this point, not guessed.

4. 04

   Check prices and money before the purchase

   get_batch_rates returns the total per service. The agent picks the service you asked for, shows any address problems it found, and compares the sum of all batches with get_account_balance so you know how much will go on your card.

5. 05

   Buy with your OK, then hand over the labels

   After you confirm, buy_batch runs once per batch. The agent returns one print link per batch and the tracking numbers by order, and leaves store orders alone afterwards because Pirate Ship writes tracking back to Shopify or eBay itself.

23 open orders: 17 from Shopify, 6 from wholesale.csv (order #1052 was in both, counted once).
Small box batch b_7Q4K2M: 14 labels, USPS Ground Advantage, $101.36.
Poly mailer batch b_7Q4K2N: 7 labels, USPS Ground Advantage, $38.15.
Held back: #1049 (no ZIP in the sheet), #1055 (36 lb, no saved box fits).
Account Balance $40.00 used first, $99.51 charged to your card.
Print links: 2 PDFs. Shopify orders now show as Fulfilled with tracking.

• Pirate Ship spreadsheet uploads accept CSV, ODS, XLS and XLSX files with a header row, and each part of the address has to sit in its own column.
• Insurance cannot be set in a Pirate Ship spreadsheet column. The help center workaround is a Saved Package that already carries insurance, picked in the Package Details drop-down.
• Pirate Ship's Override feature imports order weights only from BigCommerce, Cratejoy, Ecwid, Etsy, PayPal, Shopify and WooCommerce, and only when every package in the batch shares dimensions and packaging type.
• After a spreadsheet batch, the Get Rates screen in Pirate Ship shows an average price rather than each label's price; the Shipment Details section is where to confirm the sheet's own weights were used.
• On USPS labels Pirate Ship prints up to four Rubber Stamp lines of 25 characters each, UPS allows two lines of 35, and UPS Ground Saver labels take none.

buy_batch asks for your OK by default. To run it daily without you, switch confirmation off for that tool in your dashboard.

Sources: How do I upload address spreadsheets into Pirate Ship? · How do I upload a spreadsheet with different weights and dimensions? · How to import from integrations · What are Rubber Stamps and how do I use them? · How do I correct address errors on my spreadsheet upload?

curl https://cotlet.dev/api/v1/pirate-ship/create_batch \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_ids":["o_4412","o_4413","o_4415"],"saved_package_id":"pkg_small_box","rubber_stamp":["order_id"]}'

{
  "batch_id": "b_9X2LQ1",
  "shipments": 3,
  "rows_with_address_errors": 0,
  "bought": false
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is pirate-ship_create_batch. Example data.

• Refund unused Pirate Ship labels
• Create a Pirate Ship SCAN Form and book a pickup
• Pirate Ship API and MCP server: every tool
• All use cases