How to configure BUKU Ship (BUKU) in techSHIP [Guide]

Last updated: November 13, 2026

BUKU Ship is a multi-carrier consolidator. The base BUKU connection remains available, while carrier-specific BUKU splits can be used to limit available services to a selected underlying carrier group.

This guide explains how to add and configure this carrier connection, review its available carrier-specific settings, and understand the shipment requirements and operational constraints that apply.

Carrier Requirements and Specifications

This section summarizes onboarding requirements and lists confirmed carrier-specific constraints.

To review all supported carriers and their specific requirements, see: 📄 techSHIP supported Carriers - Master List [Guides List].

Onboarding Requirements

The BUKU Ship integration supports:

  • Rate Shopping

  • Void

  • Time in Transit

  • Manifesting

Information to be Provided

The following credentials and data points are mandatory to connect to BUKU Ship and configure Client Accounts. Ensure you have these items available before starting the setup:

DATA ELEMENT

SOURCE (HOW TO OBTAIN)

Carrier Account Id

Obtain the Carrier Account Id directly from BUKU Ship.

On-Behalf-Of

Obtain the organization-specific On-Behalf-Of value directly from BUKU Ship.

Warehouse Id

Obtain the Warehouse Id for the applicable client or warehouse directly from BUKU Ship.

Sender address and contact information

Provide the warehouse or induction sender details used for shipments. A sender name or company, street, city, country, and phone number are required.

Specifications and Constraints

Operational Details

BUKU Ship processes parcel shipments through the services enabled for the configured account. The base BUKU connection can return all eligible services when no valid service restriction is supplied. Carrier-specific BUKU splits reuse the same account configuration but expose only the services assigned to the selected carrier group.

Current carrier-specific groups include ACI, Amazon Shipping, Canada Post, DHL, DHL Express, ePost Global, FedEx, First Mile, Landmark, OnTrac, OSM, Parcll, SkyPostal, Stallion Express, UniUni, UPS, USPS, and Wizmo.

During Rate Shopping, techSHIP can request a specific valid Service code or allow the base BUKU connection to return the eligible services for the configured account. When using a carrier-specific split, the selected service must belong to that split.

For international shipments, each package must contain line-item data. The integration sends customs information from the package lines, including harmonized code, country of origin, description, SKU, quantity, weight, currency, and value.

Commercial Invoice: For international labels, BUKU can return a PDF commercial invoice. techSHIP stores the returned commercial invoice as the shipment's Commercial Invoice document. Whether it is included in printed/output documents depends on the Client Account's Print Commercial Invoice setting.

  • Amazon Shipping services: Package line items are required even for domestic shipments when using an Amazon Shipping service through BUKU.

  • International shipments: Each package must contain line items and a harmonized code. BUKU also requires a package total value. techSHIP sends the declared value when one is available; otherwise it uses the total customs value calculated from the package lines.

  • Address data: Recipient and return addresses require a name or company, street, city, and country. Recipient phone and email are optional. The sender requires a name or company, street, city, country, and phone number; sender email is optional.

  • Carrier closeout: BUKU supports manifest/close-day processing. Finalization closes the BUKU labels that belong to the current techSHIP manifest. Enable Skip carrier closeout on finalize only when the account should not send a BUKU closeout request.

Configuring a Baseline Account

A Baseline Account serves as the fundamental connection point between techSHIP and the carrier's system. It acts as a template that holds the credentials and fundamental properties required to process shipments.

The techSHIP AI Assistant is available from the Carrier page for supported Carrier configuration tasks. For detailed conceptual information and advanced configuration, refer to 📄 techSHIP AI Assistant: Overview & Availability [Information].

Adding a Carrier

Before adding an account, you must ensure the Carrier entity is available for your location.

  1. Click My Carriers from the left menu under the Carriers category.

  2. Click Add Carrier.

  3. Select the desired Carrier.

You may encounter additional messages depending on the carrier status or your plan:

  • Subscription Required (⭐): If the carrier has a star icon, you will see a message stating "To use this carrier, a subscription upgrade is required." Press Contact to Upgrade to proceed.

  • Carrier Suspended: If the carrier has not been used for an extended period, you will see a message stating “This carrier is currently on hold...” Click Request Assistance to reactivate it.

  • Setup Fee Waived: If a carrier from the same carrier group is already installed in your location, you can add this carrier without incurring additional fees.

  1. If needed, update the carrier Name.

  2. Click Add Carrier.

If the purchase confirmation appears, complete the following steps:

  • Review the purchase notice and any applicable charge information.

  • Optionally enter a PO Number.

  • Select I am authorized to complete this purchase on behalf of my organization.

  • Click Purchase to confirm the Carrier addition.

Preview

Once the Carrier is added, you will be automatically redirected to the Carrier page to continue setting it up.

  1. Enter the Code of the Carrier as it appears in your host system.

The Code of the Carrier must match exactly the value defined in the host system. Any discrepancy (including casing or extra spaces) may prevent the carrier from working correctly.

  1. Click Save.

If your facility utilizes the centralized Pickup Schedule, we highly recommend adding this new carrier to your calendar now. While not required to process labels, this ensures accurate induction metrics for your Insights dashboards. To learn more, see 📄 Understanding the Centralized Pickup Schedule & Expected Induction Logic [Information].

Adding a Baseline Account

From the Carrier page, click Add Account to create a new Baseline Account.

You will be redirected to the Baseline Account page to complete the setup.

Entering incorrect values will prevent the system from generating shipping labels.

General Tab

In the General tab, define the administrative properties:

  • Name: Enter a descriptive name for the account.

Enter a descriptive name based on unique properties. E.g.:

  • Carrier Name - Account Number (CarrierX - 123456789)

  • Carrier Name - Consolidator Name (CarrierY - MyConsolidator)

  • Carrier Name

  • Usage: Select the most suitable option:

    • Test: Used for sandbox or onboarding purposes.

    • Production: Used for live shipping.

Keep the Status field set to its default Active value. An account must be Active to remain fully editable. For detailed conceptual information on account statuses, refer to 📄 How to Inactivate and Activate a Carrier Baseline Account [Step-by-Step Guide].

Carrier Tab

BUKU Ship Credentials

  • Carrier Account Id: Enter the BUKU Ship carrier account identifier.

  • On-Behalf-Of: Enter the organization-specific On-Behalf-Of value supplied by BUKU Ship.

  • Skip carrier closeout on finalize: Enable this only when the account should not send a BUKU manifest request during finalization.

The same BUKU credentials and account configuration are reused by the carrier-specific BUKU splits. You do not create separate BUKU credentials for each underlying carrier group.

Sender address

Complete the Sender address fields with the warehouse or induction address used for shipments. Provide at least a sender name or company, street, city, country, and phone number. Email is optional.

Labels Tab

Supported label formats: PDF, ZPL, and PNG.

BUKU supports 4 × 6 and 4 × 8 label stock sizes. Select the required Mode and label stock size for the Baseline Account. BUKU returns the label through a download URL, and techSHIP stores the downloaded output according to the selected format.

For international shipments, BUKU can also return a PDF commercial invoice. The commercial invoice remains PDF even when the shipping label is ZPL or PNG.

Finalizing the Setup

Once you have entered the required information, click Save.

After you save the Baseline Account, check whether the Registration tab or a registration status badge is available.

If neither is available, the Carrier does not use this Registration workflow in techSHIP. If registration is still pending, open the Registration tab and press Registration, then complete 📄 How to Register a Carrier Baseline Account [Step-by-Step Guide] before creating shipments.

From the Carrier page, you can now see the Baseline Account listed with the administrative status Active. The Active status is separate from the account's registration status.

The Baseline Account configuration is now saved. You can continue with Configuring a Client Account below to assign the Baseline Account to a specific Client.

Configuring a Client Account

Adding an Account

Before adding a Client Account, ensure that the Client has been created. For instructions creating a Client, see: 📄 10 - How to create a Client profile [Step-by-Step guide].

  1. Click Clients from the left menu under the Clients section.

  2. Click the Edit icon for the desired Client.

  3. Click Add Accounts.

  4. Optionally, use the Search box to search by Baseline Account Name or Carrier.

  5. Select the Baseline Accounts that will serve as the foundation for your new Client Accounts.

  6. Click Add Accounts.

    A toast notification will confirm the accounts were successfully assigned. Click the Refresh icon if recently added accounts are not displayed.

  1. Click Edit on each newly created account.

  2. Configure the available options in each tab (except Carrier).

For complete instructions on configuring this settings, see 📄 How to configure the Billing Account General Options tab [Step-by-Step guide].

Carrier Tab

Setup

  • Service code: Select the default BUKU Ship service for this Client Account. For the base BUKU connection, leaving service selection unrestricted allows BUKU to return eligible services. For a carrier-specific BUKU split, select a service exposed by that split.

  • Warehouse Id: Enter the Warehouse Id supplied by BUKU Ship for this client or warehouse.

  • Currency: Select the shipment currency used when a value is not supplied at Order level.

  • Export reason: Select the customs content category used for international shipments. Available values are merchandise, gift, documents, other, returned SAMPLE, and sample GOODS.

  • Non delivery: Select return or abandon for international non-delivery handling.

Sender address

Configure client-specific sender information when this Client Account needs values different from the Baseline Account. Provide a sender name or company, street, city, country, and phone number. Email is optional.

Return address

Enable Override return address when the Client Account must send a separate return address to BUKU. Provide a return name or company, street, city, and country. Phone and email are optional.

International Tab

For international shipments, use Print Commercial Invoice to control whether the commercial invoice returned by BUKU is included with the shipment output when applicable.

Specifying Rate Shopping Service Codes

BUKU Ship supports Rate Shopping.

For the base BUKU connection, when a valid Service code is supplied, the integration restricts the BUKU rate request to that service. When no valid service is supplied, the service restriction is omitted and BUKU Ship can return the eligible rates for the configured carrier account.

For carrier-specific BUKU splits, Rate Shopping is restricted to the services assigned to that carrier group. A service from another BUKU split is not accepted for that split.

For detailed instructions on how to configure this, see: Include or exclude Service Codes when Rate Shopping [Step-by-Step Guide].

Finalizing the Setup

Once you have entered the required information, click Save.

With the account configured and requirements verified, you can now proceed to process orders as described below.

Configuring an Order

The steps described in this section are not required for carrier setup, and they are offered as an optional review if further order-level configuration is required.

Follow the UI Navigation steps in 📄 05 - How to edit an order’s information - [Step-by-Step guide], using the carrier-specific values provided in this guide.

Carrier Tab

The following BUKU Ship settings are available when editing an Order:

  • Service code: Select the BUKU Ship service to use for the shipment. When using a carrier-specific BUKU split, the service must belong to that split.

  • Currency: Set the shipment currency when it needs to differ from the Client Account value.

  • Send total value (liability): For domestic shipments, enable this option when the package declared value should be sent to BUKU. For international shipments, techSHIP always sends the required package total value; it uses the declared value when available or the package line-item customs value otherwise.

Click Save to apply the order-level changes. After the Order is updated, continue with the standard shipping workflow.

Troubleshooting

  • No rates are returned on the base BUKU connection: Confirm that Carrier Account Id, On-Behalf-Of, Warehouse Id, package dimensions and weight, addresses, and the requested Service code are valid. If a specific service is not required, remove the service restriction so BUKU can return the services eligible for the configured account.

  • A carrier-specific BUKU split rejects a service: Confirm that the selected Service code belongs to that BUKU carrier group. Splits expose only their assigned BUKU services; use the matching split or the base BUKU connection as appropriate.

  • Amazon Shipping rate or label requests fail: Confirm that every package contains line items. BUKU sends line-item data for Amazon Shipping services even on domestic shipments.

  • An international shipment fails validation: Confirm that every package contains line items and that each required item includes a harmonized code, country of origin, description, SKU, quantity, net weight, currency, and value. Also verify Export reason and Non delivery. techSHIP automatically sends the required package total value from the declared value or the package lines.

  • A shipment fails because address data is missing: For recipient and return addresses, provide a name or company, street, city, and country. For the sender, also provide a phone number. Recipient phone/email and sender email are optional.

  • A commercial invoice is not included with an international shipment: Confirm that BUKU returned a commercial invoice and review Print Commercial Invoice on the Client Account's International tab. The invoice is PDF even when the shipping label is ZPL or PNG.

  • A label cannot be downloaded: Confirm that BUKU returned a label URL and that the selected Baseline label Mode is PDF, ZPL, or PNG. Retry after correcting the shipment data and service configuration.

  • Void fails for one or more labels: Confirm that the shipment has a valid BUKU label identifier and retry the void operation. If BUKU rejects the request again, use the failed label identifiers from the operation result when escalating the issue.

  • Carrier closeout fails or closes the wrong scope: Confirm the Carrier Account Id and account configuration. Current finalization sends the BUKU label identifiers for the current techSHIP manifest. If the account intentionally does not use BUKU manifest processing, enable Skip carrier closeout on finalize on the Baseline Account.