# Configure Peoplevox labels, couriers, and packages
URL: https://support.starshipit.com/articles/90200000000501-configure-peoplevox-labels-couriers-and-packages
Canonical: https://support.starshipit.com/articles/90200000000501-configure-peoplevox-labels-couriers-and-packages
Markdown: https://support.starshipit.com/articles/90200000000501-configure-peoplevox-labels-couriers-and-packages.md
Updated: 2026-11-10

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Configure Peoplevox print templates and control how Starshipit selects couriers and creates packages for Peoplevox orders.

Configure the labels, couriers, and package behaviour used when Peoplevox despatches an order through Starshipit.

## Before you begin

[Connect Peoplevox to Starshipit](/articles/360000934795-connect-peoplevox-to-starshipit) before configuring this workflow. For tracking against individual packages in a consolidated shipment, use Peoplevox version `24.09-02` or later.

## Create print templates in Peoplevox

1. In Peoplevox, switch to the **Setup** view.
2. Select **Print Templates**.
3. Select **DespatchPackage** for outgoing labels and commercial invoices, or **Returns** for return documents.
4. Click **Search**, then open the template you want to use.
5. Set **Registered template name** to the applicable document type:
   - `Outgoing label`
   - `Commercial invoice`
   - `Returns label`
   - `Returns commercial invoice`
6. Click **Save**.

## Add templates to the carrier connection

1. Switch to the **Integration** view in Peoplevox.
2. Open **Carrier Integration**, select Starshipit, then click **Edit**.
3. Under **Document Types**, enter a name and select the corresponding print template.
4. Set **Reference** to the exact applicable value listed above.
5. Click **Save**.

Start with the outbound label and test it before adding the other document types.

## Set default couriers

Starshipit automatically generates labels when orders are despatched in Peoplevox, so each order needs a courier and product code.

1. In Starshipit, go to **Settings > Couriers**.
2. Select default domestic and international couriers.
3. Open each default courier and select a default product code.
4. If required, use [shipping rules](/articles/notifications-branded-tracking-rules-child-accounts/business-rules/rules-based-on-shipping-method) to select different couriers or services.

## Configure package creation

Go to **Settings > Integrations > Peoplevox** and select the package behaviour that matches your workflow:

- **Create package using item weights from Peoplevox order** creates one shipment using weights from the Peoplevox despatch items.
- **Create packages using package details from Peoplevox orders** creates packages from the names and dimensions sent by Peoplevox.

When using Peoplevox package details:

- A Peoplevox package name matching a Starshipit package uses the Starshipit dimensions.
- An unmatched package name uses the dimensions sent by Peoplevox.
- A package without a name uses the default Starshipit package dimensions.

To combine packages into one shipment and return tracking against each Peoplevox package:

1. Select **Create packages using package details from Peoplevox orders**.
2. Choose the **Dimensions unit** used by your Peoplevox package data.
3. Enable **Consolidate multi-packages into one shipment**.
4. Click **Save**, then reopen the connection and confirm both package details and consolidation remain selected.

Starshipit waits until the despatch is complete (`totalPickedItems` matches `totalDespatchedItems`), then generates the combined labels. When tracking is available, the final response associates each number with its Peoplevox package. Packages sharing a consignment number still receive separate package entries.

If package details are off, package identities are missing or ambiguous, or the package layout changes so the association cannot be retained, Starshipit returns the first available tracking number for each tracking type. It cannot reliably reconstruct package associations for those shipments.

## Verify the configuration

Use a controlled despatch with more than one package and your expected courier. Complete the despatch, then check that Peoplevox receives the combined labels and that the tracking number against each package matches its Starshipit label.

If another system receives tracking from Peoplevox, check that it processes package-level tracking events. A correct Starshipit response does not establish that the downstream system received an update. See [Troubleshoot Peoplevox](/articles/90200000000502-troubleshoot-peoplevox) if package tracking is missing.
