Skip to main content

Troubleshoot Easyship rates and labels

Diagnose Easyship connection, carrier permissions, disabled controls, quotes, packages and label problems.

Start with the message shown in Beventi. The connection overview, quote tester and label card will identify the part of the workflow that needs attention.

Easyship will not connect

If Easyship is missing from Integrations, it may not be enabled for your Beventi account yet. Contact support before trying to change any account settings.

Check the following:

  • You copied the complete API token without extra spaces.

  • The token has not been revoked.

  • It has access to rates, addresses, boxes, shipments, labels and webhooks.

  • You are connecting it to the intended Beventi seller profile.

Create a new token in Easyship if the old one cannot be restored. Never send the token to support.

Carrier controls or Save changes are disabled

Open Integrations > Easyship > Carriers and read the message above the picker.

  • Permissions: select Update permissions and add Courier services: Read and Shipping rules: Read and Write to your token while retaining its existing shipping permissions.

  • Subscription access: review the required access in your Easyship account. Use Manage in Easyship to check your rules.

  • Refresh failed or Easyship is busy: the displayed list may be from a previous refresh. Editing and saving stay disabled until current rules can be loaded. Wait before selecting Retry; repeated refreshes can use the API allowance. If this persists, contact support with the exact message, time and whether you use sandbox or production.

  • Rules changed: use Reload and review (discard these edits) to inspect the current Easyship settings. This discards your unsaved picker edits.

  • No changes or no available services selected: make a change and keep at least one available service on before saving.

Missing only the additional carrier permissions does not disable otherwise-working shipping. Your existing Easyship rules remain in place. If a save reports a partial result, review the refreshed provider state before making another change.

A linked courier or selected service is missing

Check that the courier account is active on Easyship’s Couriers page, then return to Beventi and select Refresh carriers. Confirm the service is selected and save any changes.

Review Configured Easyship rules, especially conditional restrictions. A selected carrier must still support your parcel and destination. Run Test rates with the exact basket and address. A genuine no-service result is not bypassed by silently choosing an excluded carrier.

The account says "Setup incomplete"

Open Integrations > Easyship and follow the item named on the overview. Usually you need to add or choose the ship-from address. Product readiness is completed under Products before enabling an order form.

Live rates cannot be enabled

Open the readiness list and fix every blocking item. Common blockers are:

  • No connected Easyship account.

  • No ship-from address in use.

  • Missing product or variant weight and dimensions.

  • A bundle whose child items cannot be packed.

  • Missing customs information on a profile that may ship internationally.

No saved package is not a hard blocker. Add one when you want the quote to use your real mailer or box.

The tester shows no live services

  1. Confirm the destination is complete.

  2. Confirm the basket contains the intended products, variants and quantities.

  3. Read the diagnostic beside the result.

  4. Check the ship-from address.

  5. Check product and customs information.

  6. Review package sizes and shipping profile restrictions.

  7. Run the quote again.

If only backup rates appear, checkout still has a saved option but Easyship live quoting is not confirmed.

When a rate includes a handling fee, the test results show the fee under that rate.

A quote looks too high or too low

Review the following:

  • Product and variant weight.

  • Product dimensions.

  • Package dimensions and empty weight.

  • Basket quantity.

  • Origin and destination.

  • Separate shipping profiles.

  • Handling adjustments.

  • Currency.

Example: entering 25 kilograms instead of .25 kilograms can make a single-book quote appear extremely high. A large box can also be expensive because of dimensional weight even when it is light.

Check the form's handling fee. It is added on top of the carrier rate, and a fee by region can be higher for some countries. Run a shipping test: each rate shows "Includes your $X handling fee" so you can see how much of the price is the fee.

Checkout and label prices differ

The checkout rate is an estimate. The label flow obtains current fulfillment information, and Easyship supplies the final wallet charge. Review the service, parcel and new-price confirmation before purchasing.

Buy label is unavailable

Check the readiness banner and order card. The order may be unpaid, canceled, missing shipment data or waiting for a connection, permission or webhook issue to be fixed.

Some orders need a current service selection before the label can be bought.

Easyship asks for more customs information

International routes can require shipment-specific tax or customs identifiers in addition to the product's customs fields. Enter the requested recipient, seller or export identifier only when it applies.

For a bulk run, remove that order and buy its label individually so you can review the required fields.

A label is stuck on Generating

Select Check status on the existing label. Do not start another purchase. Beventi may be waiting for an Easyship webhook or reconciling an uncertain provider response.

If it later changes to Failed, follow the failure message and use Retry label from the same card.

The printer output is cropped or the wrong size

  • Match the printer paper to the label size selected at purchase.

  • Print at actual size or 100%, without fit-to-page scaling for a thermal label.

  • Use A4 when the carrier says it only supplies A4.

  • Download the document again and confirm the PDF itself is complete before changing printer settings.

Reopening a ready document does not purchase another label.

A void or purchase has an unknown result

Use the check or reconciliation action on the existing card. Beventi checks the original Easyship request to reduce duplicate purchases or repeated cancellation requests.

Do not create a replacement directly in Easyship until you have checked whether the original shipment exists.

Contact support

If the problem remains, send support:

  • Beventi order number.

  • Order form or wholesale listing name.

  • Easyship shipment or batch reference where shown.

  • The exact error message.

  • The time of the attempt and your timezone.

  • A screenshot that does not include an API token or private customs identifier.

Do not send Easyship API tokens, wallet credentials, or full tax identifiers.

FAQ

Should I disconnect and reconnect for every quote error?

No. Follow the quote diagnostic first. Reconnect only when the connection or permissions are the problem.

Can support buy or void the label for me?

Support can help diagnose the workflow, but label charges and cancellations belong to your connected Easyship account.

Why does one product fail while others quote correctly?

Check that product's variant, bundle and customs data. A single incomplete item can affect only baskets that contain it.

What should I do before retrying?

Fix the issue named on the card, then retry from the same shipment so Beventi can preserve the provider history.

Did this answer your question?