Troubleshoot Easyship rates and labels
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.
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
Confirm the destination is complete.
Confirm the basket contains the intended products, variants and quantities.
Read the diagnostic beside the result.
Check the ship-from address.
Check product and customs information.
Review package sizes and shipping profile restrictions.
Run the quote again.
If only backup rates appear, checkout still has a saved option but Easyship live quoting will not be not confirmed.
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.
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.