> ## Documentation Index
> Fetch the complete documentation index at: https://help.kivaro.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Label Operations

> Learn how to efficiently create shipping labels for multiple orders at once

export const appName = "AusPost MyPost Business";

export const supportEmail = "support@kivaro.io";

## Overview

Bulk operations allow you to create shipping labels for multiple orders simultaneously, significantly reducing the time spent on order fulfillment. This feature is perfect for high-volume stores or when processing orders in batches.

## Accessing Bulk Operations

### From Orders Page

1. Navigate to **Orders** in your Shopify admin
2. Select multiple unfulfilled orders using checkboxes
3. Click **Create shipping labels** from the bulk actions dropdown

### From App Dashboard

1. Open the {appName} app
2. Navigate to the **Orders** section
3. Use filters to find orders that need labels
4. Select multiple orders and click **Create shipping labels**

## Bulk Label Creation Process

<Steps>
  <Step title="Select Orders">
    Choose orders that need shipping labels (up to your plan limit)
  </Step>

  <Step title="Review Orders">
    Check each order for completeness and accuracy
  </Step>

  <Step title="Configure Packages">
    Set package details for each order or use bulk settings
  </Step>

  <Step title="Select Shipping Services">
    Choose shipping options for each order
  </Step>

  <Step title="Review and Purchase">
    Final review before purchasing all labels
  </Step>

  <Step title="Download Labels">Download and print all generated labels</Step>
</Steps>

## Order Selection

### Eligible Orders

Orders must meet these criteria for bulk processing:

* **Unfulfilled items**: Contains items that haven't been fulfilled
* **Valid shipping address**: Complete and accurate delivery address
* **Recent orders**: Created within the last 60 days
* **Paid status**: Order must be paid or authorized

### Selection Limits

* **Batch limits**: Maximum of 2000 labels in a single batch
* **Weight limits**: Total weight cannot exceed Australia Post limits
* **Value limits**: High-value orders may require individual processing

<Info>
  The app will automatically exclude ineligible orders and show you which ones
  were skipped and why.
</Info>

## Bulk Configuration Options

### Package Settings

<AccordionGroup>
  <Accordion title="Apply to All">
    Set the same package for all selected orders: - Choose from flat-rate
    packaging - Select custom packages - Use default package settings
  </Accordion>

  <Accordion title="Individual Configuration">
    Configure packages individually: - Review each order's items - Select
    appropriate package size - Adjust weights if needed - Override bulk settings
    for specific orders
  </Accordion>
</AccordionGroup>

### Set Custom Dimensions

Use **Set custom dimensions** to apply one-off package dimensions (length, width, height in cm) to selected orders. This is useful when an order uses a package size that isn’t in your saved custom packages, or when you want to try different dimensions without changing settings.

<img src="https://mintcdn.com/kivaro/rNQld9Kl5YnVnSt5/images/set-oneoff-package.png?fit=max&auto=format&n=rNQld9Kl5YnVnSt5&q=85&s=d4bf14fdf4aae82214e970647e42c0c9" alt="Set custom dimensions modal with Length, Width, Height fields, Save as custom package checkbox, and Apply button" width="1248" height="498" data-path="images/set-oneoff-package.png" />

#### How to use

<Steps>
  <Step title="Select orders">
    Select the orders you want to apply custom dimensions to from the shipping labels table.
  </Step>

  <Step title="Open the bulk action">
    Click the bulk actions menu and choose **Set custom dimensions**.
  </Step>

  <Step title="Enter dimensions">
    Enter **Length**, **Width**, and **Height** in centimetres. All three are required and must be greater than 0.1. Each dimension cannot exceed 105 cm (MyPost Business limit). At least two dimensions must be 5 cm or greater.
  </Step>

  <Step title="Optional: Save as custom package">
    Check **Save as custom package** to add this size to your custom package list for future use. Enter a **Package name** when this is checked. The new package will appear in the package list and will be applied to the selected orders.
  </Step>

  <Step title="Apply">
    Click **Apply** (or **Apply and save** if saving as custom package) to apply the dimensions to all selected orders. Quotes will refresh with the new dimensions.
  </Step>
</Steps>

#### Display in the table

* **One-off (not saved):** The package column shows **One off package** plus the dimensions you entered.
* **Saved as custom package:** The package column shows the package name and dimensions like any other custom package, and that package is selected.

#### Validation rules

* All three dimensions (length, width, height) are required.
* Each value must be greater than 0.1.
* No dimension may exceed 105 cm.
* At least two dimensions must be 5 cm or greater.
* If you save as custom package, the package name is required and must not duplicate an existing name.

### Shipping Services

Configure shipping services in bulk:

* **Parcel Post**: Standard delivery for all orders
* **Express Post**: Priority delivery for all orders
* **Mixed Services**: Different services based on order criteria
* **Rule-based**: Apply shipping rules automatically

### Additional Options

<CardGroup cols={2}>
  <Card title="Signature on Delivery" icon="signature">
    Require signature for all orders or high-value items only
  </Card>

  <Card title="Transit Cover" icon="shield">
    Add insurance coverage for valuable shipments
  </Card>

  <Card title="Tracking Notifications" icon="bell">
    Automatically send tracking details to customers
  </Card>

  <Card title="Customs Declarations" icon="globe">
    Handle international shipping requirements
  </Card>
</CardGroup>

## Review and Validation

### Pre-Purchase Review

Before purchasing labels, the system validates:

* **Address accuracy**: All shipping addresses are complete
* **Weight calculations**: Package weights are within limits
* **Service availability**: Selected services are available for destinations
* **Payment verification**: Australia Post account has sufficient funds

### Error Handling

If some orders fail validation:

<AccordionGroup>
  <Accordion title="Partial Success">
    * Successful orders: Labels are generated and ready to print
    * Failed orders: Shown with specific error messages
    * Option to retry failed orders individually
  </Accordion>

  <Accordion title="Complete Failure">
    * No labels are purchased if critical errors occur
    * Detailed error report provided
    * Contact support for assistance with complex issues
  </Accordion>
</AccordionGroup>

## Label Management

### Download Options

After successful bulk processing:

* **Download all labels**: Download all labels as a single PDF based on your configured print layout (A4 single page, A4 multiple pages, or A6)
* **Print directly**: Send directly to your printer using your configured print settings

## Best Practices

### Preparation

<Steps>
  <Step title="Organize Orders">
    Group orders by shipping method, destination, or priority
  </Step>

  <Step title="Check Inventory">
    Ensure all items are available and ready to ship
  </Step>

  <Step title="Prepare Packages">
    Have appropriate packaging materials ready
  </Step>

  <Step title="Verify Addresses">Check for any address corrections needed</Step>
</Steps>

### Processing Efficiency

<AccordionGroup>
  <Accordion title="Batch Size">
    * Process orders in manageable batches (10-50 orders) - Avoid overwhelming
      your system or Australia Post API - Consider your plan limits and processing
      capacity
  </Accordion>

  {" "}

  <Accordion title="Timing">
    * Process during off-peak hours for better performance - Avoid processing
      during Australia Post maintenance windows - Allow time for error resolution if
      needed
  </Accordion>

  <Accordion title="Quality Control">
    * Review a sample of orders before bulk processing - Spot-check generated
      labels for accuracy - Verify package selections make sense
  </Accordion>
</AccordionGroup>

### Error Prevention

<Warning>
  Always review orders before bulk processing to avoid costly mistakes.
</Warning>

* **Address validation**: Use Shopify's address validation features
* **Weight verification**: Double-check item weights and package selections
* **Service selection**: Ensure chosen services are appropriate for destinations
* **Payment method**: Verify Australia Post account has sufficient funds

## Bulk Delivery Instructions

Efficiently add delivery instructions to multiple orders simultaneously. This feature is perfect for seasonal campaigns, special handling requirements, or when you need to apply consistent instructions across multiple orders. Note that any existing Shopify delivery instructions for orders will be preserved and combined with bulk instructions.

### Adding Bulk Delivery Instructions

<Steps>
  <Step title="Select Orders">
    Choose the orders you want to add delivery instructions to
  </Step>

  <Step title="Access Bulk Settings">
    Click on the bulk actions menu and select "Add delivery instructions"
  </Step>

  <Step title="Enter Instructions">
    Type your delivery instructions that will apply to all selected orders
  </Step>

  <Step title="Review and Apply">
    Review the instructions and apply them to all selected orders
  </Step>
</Steps>

### Use Cases for Bulk Delivery Instructions

<CardGroup cols={2}>
  <Card title="Seasonal Campaigns" icon="gift">
    Add instructions like "Handle with care - Holiday gift" for seasonal orders
  </Card>

  <Card title="Special Handling" icon="exclamation-triangle">
    Apply "Fragile - Extra protection required" for delicate items
  </Card>

  <Card title="Delivery Preferences" icon="door-open">
    Set "Leave at front door if no answer" for contactless delivery
  </Card>

  <Card title="Customer Instructions" icon="phone">
    Add "Call before delivery" for orders requiring customer contact
  </Card>
</CardGroup>

### Best Practices

* **Be Specific**: Use clear, actionable instructions
* **Keep it Concise**: Avoid overly long instructions that may not fit on labels
* **Consider the Recipient**: Write instructions that delivery drivers can easily follow
* **Test First**: Try bulk instructions on a small batch before applying to large orders

## Troubleshooting

### Common Issues

<AccordionGroup>
  <Accordion title="Orders Excluded">
    **Problem**: Some orders are automatically excluded from bulk processing
    **Solutions**: - Check if orders are already fulfilled - Verify shipping
    addresses are complete - Ensure orders are within the 60-day limit - Check
    payment status
  </Accordion>

  {" "}

  <Accordion title="Label Generation Fails">
    **Problem**: Labels fail to generate for some orders **Solutions**: - Verify
    Australia Post account has sufficient credit - Check package weight limits -
    Ensure shipping services are available for destinations - Review international
    shipping requirements
  </Accordion>

  <Accordion title="Performance Issues">
    **Problem**: Bulk processing is slow or times out **Solutions**: - Reduce
    batch size - Process during off-peak hours - Check internet connection
    stability - Contact support if issues persist
  </Accordion>

  <Accordion title="Refunding Shipping Labels">
    **Need to refund labels purchased in bulk?** Currently, Australia Post does not provide a way to refund labels through their API. When you purchase labels in bulk, all labels are created within a single Australia Post transaction. To refund labels:

    1. Log in to your Australia Post MyPost Business account
    2. Navigate to the <a href="https://auspost.com.au/mypost-business/transactions">**Transactions**</a> tab
    3. Click **View** for the bulk transaction containing your labels
    4. Click **View** for the specific label you want to refund
    5. Click the red **Refund** button

    <Note>
      All labels from a bulk purchase are in a single transaction, but each label must be refunded individually. If the refund is successful, the charges will be returned to your credit card or PayPal account within 5–10 business days.
    </Note>
  </Accordion>
</AccordionGroup>

### Recovery Options

If bulk processing fails:

1. **Retry individual orders**: Process failed orders one by one
2. **Split batches**: Break large batches into smaller groups (max 2000 labels per batch)
3. **Manual processing**: Handle problematic orders individually
4. **Contact support**: Get help with persistent issues at {supportEmail}
