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

# Advanced Features

> Explore advanced shipping features including custom location addresses, per-order configuration, and bulk operations

export const calendlyUrl = "https://calendly.com/kivaro-support/30min";

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

export const appName = "AusPost MyPost Business";

## Advanced Shipping Features

Take your shipping operations to the next level with these powerful features designed for complex fulfillment scenarios and high-volume stores.

## Custom Location Addresses

Perfect for merchants using multiple warehouses, 3PLs, or PO Boxes. Configure custom "From / Return" addresses for each fulfillment location.

### Why Use Custom Location Addresses?

<CardGroup cols={2}>
  <Card title="Multi-Warehouse Operations" icon="warehouse">
    Different addresses for different warehouses or fulfillment centers
  </Card>

  <Card title="3PL Integration" icon="truck">
    Custom addresses for third-party logistics providers
  </Card>

  <Card title="PO Box Support" icon="mailbox">
    Use PO Box addresses for specific locations
  </Card>

  <Card title="Flexible Configuration" icon="gear">
    Mix default and custom addresses as needed
  </Card>
</CardGroup>

### Setting Up Custom Location Addresses

<Steps>
  <Step title="Access Settings">
    Go to Settings in your {appName} app and find "Fulfillment Location Addresses"
  </Step>

  <Step title="Select Location">
    Choose the fulfillment location you want to configure
  </Step>

  <Step title="Choose Address Type">
    Use the default fulfillment location address or set a custom address
  </Step>

  <Step title="Enter Custom Address">
    Fill in the custom address details (Address Line 1, Suburb, State, Postcode, Phone, Country)
  </Step>

  <Step title="Apply to All Locations">
    Optionally apply the same address to all locations using the checkbox
  </Step>

  <Step title="Save Configuration">
    Save your settings to apply the custom addresses
  </Step>
</Steps>

### Address Requirements

* **Address Line 1**: Required - Main address line
* **Suburb**: Required - City or suburb name
* **State**: Required - Australian state (NSW, VIC, QLD, etc.)
* **Postcode**: Required - 4-digit Australian postcode
* **Phone**: Optional - Contact phone number
* **Country**: Defaults to Australia (AU)

### Use Cases

<AccordionGroup>
  <Accordion title="Multiple Warehouses">
    **Scenario**: You have warehouses in Sydney, Melbourne, and Brisbane
    **Solution**: Set custom addresses for each warehouse location
    **Benefit**: Labels automatically use the correct warehouse address
  </Accordion>

  <Accordion title="3PL Integration">
    **Scenario**: You use a third-party logistics provider for fulfillment
    **Solution**: Set the 3PL's address as the custom address for that location
    **Benefit**: Labels show the 3PL's address instead of your business address
  </Accordion>

  <Accordion title="PO Box Operations">
    **Scenario**: You use a PO Box for returns or specific product lines
    **Solution**: Set the PO Box as the custom return address
    **Benefit**: Returns are directed to your PO Box instead of your business address
  </Accordion>
</AccordionGroup>

## Per-Order Shipment Configuration

Customize delivery instructions and customer references for individual orders, giving you complete control over each shipment.

### Accessing Per-Order Settings

1. **From Shipping Labels Page**: Click the settings icon in the right corner next to any order
2. **From Bulk Operations**: Access settings for multiple orders at once

### Available Customizations

<CardGroup cols={2}>
  <Card title="Delivery Instructions" icon="clipboard">
    Add specific delivery instructions for each order
  </Card>

  <Card title="Customer References" icon="tag">
    Set unique reference numbers per order
  </Card>

  <Card title="Special Handling" icon="exclamation-triangle">
    Mark orders for special handling or fragile items
  </Card>

  <Card title="Contact Preferences" icon="phone">
    Set delivery contact preferences and instructions
  </Card>
</CardGroup>

### Delivery Instructions

Add custom delivery instructions that will be visible to the delivery driver. By default, the system will use any delivery instructions already added in Shopify for that order.

**Default Behavior:**

* **Shopify Instructions**: If delivery instructions are already set in Shopify for the order, these will be used by default
* **Custom Override**: You can add additional instructions or override the default ones
* **Driver Visibility**: All instructions (both Shopify and custom) will be visible to the delivery driver in their system

**Examples:**

* "Leave at front door if no answer"
* "Call customer before delivery"
* "Handle with care - Fragile items"
* "Deliver to reception desk"
* "Requires signature - Do not leave unattended"

### Customer References

Set unique reference numbers for each order:

**Use Cases:**

* **Order Numbers**: Use your internal order reference
* **Customer Codes**: Reference customer account numbers
* **Project Codes**: Link to specific projects or work orders
* **Tracking Codes**: Use your own tracking system references

### Best Practices

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

## Bulk Delivery Instructions

Efficiently add delivery instructions to multiple orders simultaneously, perfect for special handling requirements or consistent delivery preferences.

### When to Use Bulk Instructions

<CardGroup cols={2}>
  <Card title="Fragile Items" icon="shield">
    Apply "Fragile - Extra protection required" to delicate orders
  </Card>

  <Card title="Heavy Items" icon="weight">
    Add "Heavy items - Use appropriate equipment" for heavy packages
  </Card>

  <Card title="Weather Conditions" icon="cloud-rain">
    Apply weather-specific delivery instructions
  </Card>

  <Card title="Signature Required" icon="signature">
    Add "Requires signature - Do not leave unattended" for high-value orders
  </Card>
</CardGroup>

### 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>

### Bulk Instruction Examples

**Fragile Items:**

* "Fragile - Extra protection required"
* "Handle with care - Delicate items"
* "Glass items - Extra protection needed"

**Heavy Items:**

* "Heavy items - Use appropriate equipment"
* "Two-person lift required"
* "Heavy package - Handle with care"

**Delivery Preferences:**

* "Leave at front door if no answer"
* "Call before delivery"
* "Deliver to reception desk"
* "Requires signature - Do not leave unattended"

## Advanced Configuration Tips

### Location Address Management

<Note>
  You can mix and match default and custom addresses. Some locations can use their default Shopify fulfillment location address while others use custom addresses.
</Note>

**Pro Tips:**

* **Test First**: Always test custom addresses with a small batch before applying to all orders
* **Backup Defaults**: Keep a record of your default addresses in case you need to revert
* **Regular Reviews**: Periodically review your location addresses to ensure they're still accurate
* **Team Communication**: Inform your team about custom address configurations

### Per-Order Configuration Strategy

**When to Use Per-Order Settings:**

* **High-Value Orders**: Custom instructions for expensive items
* **International Orders**: Special handling for overseas shipments
* **Customer Requests**: When customers request specific delivery instructions
* **Fragile Items**: Special handling for delicate products

**When to Use Bulk Settings:**

* **Fragile Items**: Apply consistent handling instructions to delicate orders
* **Heavy Items**: Apply lifting and handling instructions to heavy packages
* **Weather Events**: Weather-specific delivery instructions
* **High-Value Orders**: Signature requirements for expensive items

## Troubleshooting

### Common Issues

<AccordionGroup>
  <Accordion title="Custom Address Not Applied">
    **Problem**: Custom address not showing on labels
    **Solutions**:

    * Verify the address is saved in settings
    * Check that the location ID matches
    * Ensure the address has all required fields
    * Try resetting to default and re-entering
  </Accordion>

  <Accordion title="Delivery Instructions Not Appearing">
    **Problem**: Custom delivery instructions not visible to delivery driver
    **Solutions**:

    * Check that instructions are saved for the order
    * Verify the order is using the correct settings
    * Ensure instructions aren't too long for driver visibility
    * Try refreshing the order details
  </Accordion>

  <Accordion title="Bulk Instructions Not Applied">
    **Problem**: Bulk delivery instructions not applied to all orders
    **Solutions**:

    * Verify all orders are selected
    * Check that orders are eligible for bulk operations
    * Ensure instructions are saved before processing
    * Try applying to a smaller batch first
  </Accordion>

  <Accordion title="Refunding Shipping Labels">
    **Need to refund a label?** Currently, Australia Post does not provide a way to refund labels through their API. To refund a shipping label purchased through the app:

    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 label batch you want to refund
    4. Click **View** again for the specific label you want to refund
    5. Click the red **Refund** button

    <Note>
      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>

## Need Help?

<CardGroup cols={2}>
  <Card title="Book Free Consultation" icon="calendar" href={calendlyUrl}>
    Schedule a one-on-one session with our shipping experts
  </Card>

  <Card title="Contact Support" icon="envelope" href={`mailto:${supportEmail}`}>
    Get help with advanced features and configuration
  </Card>
</CardGroup>