Resolving Carrier Label Errors in Cahoot – Cahoot

When you encounter a Carrier Label Error in Cahoot, it typically indicates an issue that prevented the shipping label from being created successfully. These errors can range from simple address validation problems to carrier API authentication issues. This guide will help you identify the cause and resolve the error quickly.

Important: When these errors occur, the Cahoot Sales Order page will display a "Carrier Label Error Encountered" tag on the affected order. This tag indicates there was an issue with the carrier or shipping service that prevented label creation. The specific error details will be shown on the order page to help you determine the next steps.

Key Point: Most carrier label errors are related to address validation issues that you can resolve yourself. However, authentication errors with Cahoot-managed accounts require immediate support contact.

🔍 Understanding Carrier Label Errors - What Causes These Issues

Carrier label errors occur when the shipping carrier's system rejects the label creation request. The most common causes include:

Address Validation Issues: Incorrect, incomplete, or invalidly formatted shipping addresses
Service Availability Problems: Selected shipping service not available for the destination
Authentication Errors: Problems with carrier account credentials or API access
Package Specification Issues: Problems with weight, dimensions, or customs declarations
Account Configuration Problems: Issues with carrier account settings or service agreements

Important: If you're using your own UPS or FedEx account, you'll need to resolve authentication and validation issues directly with your carrier. If using Cahoot accounts, contact support for authentication problems.

The error message will appear on the Sales Order page and typically includes specific details about what caused the failure.

⚠️ Common Address & Validation Errors - Issues You Can Fix

These errors are typically caused by address or package specification issues that you can resolve by updating the order information:

Address Format Errors

Error:"Dynamic validation failed. postalcode - postal code format should be as follows: nnnnn or nnnnn-nnnn."

Solution: The ZIP code format is invalid. Update and validate the address.

Error:"120203 - Invalid ShipTo AddressLine2."

Solution: Address line 2 exceeds the 35-character limit. Shorten the address line 2 field and recreate the label.

Error message location on Sales Order page

Click to expand image

Weight & Customs Errors

Error:"Weight of Items on Customs Declaration cannot be larger than the Parcel Weight"

Solution: The total package weight must be equal to or greater than the sum of individual item weights. Verify and adjust the package weight or individual item weights.

Service Availability Errors

Error:"121210 - The selected service is not available from the origin to the destination."

Solution: Contact your UPS account manager to verify your contract covers shipments to this destination, or select a different shipping service.

Quick Fix: Most address-related errors can be resolved by correcting the shipping address and manually recreating the label.

🔐 Authentication & API Errors - Credential Issues

These errors indicate problems with carrier account authentication or API access. Resolution steps depend on whether you're using your own carrier account or Cahoot's accounts.

UPS Authentication Errors

Error: "UPS - 250002 - Invalid Authentication Information"

Cause: The UPS API credentials are outdated, incorrect, or improperly configured.

Common Causes Include:

UPS username, password, or API key has been changed or reset
Incorrect UPS account number in the system
Expired or revoked API key or access token

Solution: Contact your UPS account representative to verify and update your API credentials. Submit your updated credentials here.

Note: Contact Cahoot support immediately if you are using Cahoot's UPS Account.

FedEx Authentication Errors

Error: "FedEx Authentication Failed" or "Invalid FedEx Credentials"

Solution: Verify your FedEx Web Services credentials and contact FedEx technical support if needed. Submit your updated credentials here.

General API Connection Errors

Error: "Carrier API connection timeout" or "Service temporarily unavailable"

Solution: Check down detector to see if the carrier is having an API outage. Wait 5-10 minutes and retry label creation. If the issue persists, contact support.

🛒 Platform-Specific Errors - Amazon & Other Channels

Amazon Buy Shipping Errors

Error: "The purchase request parameters are invalid, please call with the correct parameters or make another call to check eligible options"

Solution: This indicates an Amazon Buy Shipping issue. Open a case with Amazon Seller Support to resolve the problem with their shipping service.

If issue persists: Request "Direct From Carrier" label generation - Request that Cahoot generate your Amazon labels directly from the carrier instead of through Amazon Buy Shipping. This means:

Amazon Buy Shipping will NOT be used for label generation
More service options will become available
You'll still need to meet delivery SLAs

Other Channel-Specific Issues

Each sales channel may have specific requirements or limitations that can cause label errors:

eBay Managed Shipping: Verify the shipping service is authorized for your eBay account
Walmart Shipping: Ensure package dimensions and weight comply with Walmart's requirements
Shopify Orders: Check that shipping zones and rates are properly configured

📞 When to Contact Support - Escalation Guidelines

Follow these steps based on the type of error you're experiencing:

1Identify the Error Type: Look at the specific error message on the Sales Order page to determine if it's an address, authentication, or service issue.

2For Customer Address Issues: Fix the address and retry label creation.

3For Authentication Issues: Contact your carrier representative for credential verification

4For Service Availability: Try selecting a different shipping service or verify your carrier contract covers the destination

Still Having Issues? If you've tried the appropriate resolution steps and the error persists, contact Cahoot support with the complete error message and order details.

Contact Your Carrier First

Authentication issues with your own carrier accounts
Service availability questions for specific destinations
Account configuration problems with your carrier contract
Billing or account status issues with your carrier

Information to Provide Support

When contacting support, include:

Complete error message text
Order number and sales channel
Carrier and shipping service being used
Whether you're using your own carrier account or Cahoot's
Steps you've already taken to resolve the issue