# Shipping Label Generations ## Shipping Label Generation If you encounter difficulties generating a shipping label within the `HotWax Commerce Fulfillment App`, it may be attributed to incorrect configurations of the shipping carrier, incomplete facility associations, or missing customer details. Here are some cases that may result in shipping label generation errors: ### Verify Shipping Carrier is set up in HotWax Commerce **Case: Shipping Carrier Not Set Up in HotWax Commerce** HotWax Commerce relies on the accurate setup of shipping carriers to facilitate the generation of shipping labels. Without a properly configured carrier, the system lacks the necessary information to process and generate shipping labels for orders. Resolution: 1. Verify if the shipping carrier corresponding to the desired shipping method is set up in HotWax Commerce. 2. For more details, refer to the [documentation on creating a carrier in HotWax Commerce](https://github.com/hotwax/oms-documentation/blob/user-guides-pub/documents/system-admin/fulfillment/shipping-methods/carrier-and-shipment-methods.md). 3. Ensure the carrier setup includes accurate details relevant to the shipping method. **Case: Shipping Gateway Configurations Missing** Shipping gateway configurations are essential for HotWax Commerce to communicate with external shipping services and facilitate the exchange of shipping data. Without proper configurations, the system cannot communicate with shipping gateways to process shipping labels. Resolution: 1. Check if the carrier data has been successfully loaded into HotWax Commerce. 2. Follow the steps outlined in the documentation to [add shipping gateway configurations](https://github.com/hotwax/oms-documentation/blob/user-guides-pub/documents/system-admin/fulfillment/shipping-methods/shipping-gateway.md). 3. Ensure that the shipping gateway configurations are accurately entered and correspond to the carrier data. **Case: Shipping Method Not Configured** Shipping methods need to be configured within HotWax Commerce to map the shipping method the customer selected during the checkout process on Shopify with the shipping method provided by the carrier. Resolution: 1. Verify if the shipment method corresponding to the carrier is set up in HotWax Commerce. 2. Follow the documentation to [set up shipping methods](https://github.com/hotwax/oms-documentation/blob/user-guides-pub/documents/system-admin/fulfillment/shipping-methods/shipping-gateway.md#add-shipment-methods). **Case: Shipment Boxes Not Configured for Carrier** Proper configuration of shipment boxes within HotWax Commerce ensures accurate label generation by providing the necessary dimensions and specifications for packaging orders. Resolution: 1. Follow the steps outlined in the documentation to [configure shipment boxes for the carrier](https://github.com/hotwax/oms-documentation/blob/user-guides-pub/documents/system-admin/fulfillment/shipping-methods/shipping-box.md#adding-shipment-boxes-for-specific-carriers). 2. Ensure that the dimensions and specifications of the shipping boxes are accurately entered to facilitate accurate label generation. ### Check Facility Association **Case: Facility Not Associated with Shipping Carrier** In HotWax Commerce, shipping labels are generated based on the association between facilities and shipping carriers. If the facility for which a shipping label is being generated is not associated with the relevant shipping carrier, the label generation process will fail. Resolution: Verify Facility Association: Confirm that the facility for which the shipping label is being generated is properly associated with the corresponding shipping carrier. Refer to the [shipping gateway documentation](https://github.com/hotwax/oms-documentation/blob/user-guides-pub/documents/system-admin/fulfillment/shipping-methods/shipping-gateway.md) for guidance on associating facilities with carriers. **Case: Shipping Label Generation Disabled for Facility** HotWax Commerce provides the option to enable or disable shipping label generation for individual facilities. If this feature is disabled for the facility from which orders are being fulfilled, shipping labels cannot be generated. Resolution 1. Access Facility Details: Navigate to the Facility Detail page within the Facilities App to access the settings for the relevant facility. 2. Enable Label Generation: Locate the toggle for "Generate Shipping Label" and ensure it is switched on to allow for shipping label generation. 3. Retry Label Generation: After enabling shipping label generation for the facility, attempt to generate the shipping label again for the affected order. **Case: Missing Facility Phone Number** A valid phone number associated with the facility is often required by shipping carriers for shipment notifications and communication purposes. Failure to provide this information may result in errors during label generation. Resolution 1. Edit Address Section in Facility detail page: Open the facility from the `Facilities App` and update the phone number from the [`Address and Contact Details`](https://github.com/hotwax/oms-documentation/blob/user-guides-pub/documents/system-admin/administration/facilities/manage-facility-details.md#address-and-contact-details) section. 2. Retry Label Generation: After adding the phone number, attempt to generate the shipping label again for the affected order. ### Check Customer Information **Case: Customer Address Not Compatible with Shipping Method** Shipping methods may have specific requirements or restrictions based on the destination address. If the customer's address does not meet the criteria set by the shipping method (e.g., international shipments not supported), the shipping label generation process may fail. Resolution: 1. Facility Rejection: Reject the order from the facility if the customer's address does not comply with the shipping method requirements. 2. Manual Release: Manually release the order and assign it to a facility located in the customer's country. 3. Fulfillment from Appropriate Facility: Fulfill the order from the facility aligned with the customer's country to ensure compatibility with the shipping method. **Case: Incorrect Customer Zip Code** Accurate zip code information is crucial for generating shipping labels, as it ensures the delivery of packages to the proper location. If the customer's zip code is incorrect, label generation may fail. Resolution: 1. Facility Rejection: Reject the order from the facility to prevent incorrect label generation. 2. Edit Customer Address: Navigate to the Sales Order > View Order page for the affected order ID. 3. Update Zip Code: Access the Item Groups section and click on the pencil icon next to the address to edit the information. 4. Save and Broker Order: Enter the correct zip code, save the address changes, and broker the order again for fulfillment. **Case: Missing Customer Contact Number** Customer contact numbers are often required by shipping carriers for notification purposes and to facilitate communication regarding delivery. If the customer's contact number is missing, label generation may encounter errors. Resolution: 1. Facility Rejection: Reject the order from the facility to prevent label generation until the issue is resolved. 2. Edit Customer Information: Access the order details and edit the customer's address to include the contact number. 3. Save and Broker Order: After adding the contact number, save the changes, and broker the order again for fulfillment. If the issues persist despite following the troubleshooting steps, consider reviewing the specific requirements of the shipping method or contacting HotWax Commerce support for further assistance. {% hint style="info" %} If you are using test APIs, then there may be a slight delay in shipping label generation, wait for a few minutes and try generating label again, if it's not generated on the first try. {% endhint %} ## Generate Shipping Labels from Preferred Carrier Retailers can generate `shipping labels` from their preferred `carrier` using HotWax Commerce’s `Fulfillment App`, to have more control when working with multiple shipping providers. By toggling the feature in the facility details page `App link`, store associates can either automatically generate labels from the default carrier or `manually` select their preferred carrier after packing. This feature provides enhanced flexibility, especially for stores using multiple carriers, allowing for easier switching between partners and optimizing the shipping process. ### Steps to Generate Shipping Labels from Preferred Carriers 1. **Access the Fulfillment App**: `Open` the HotWax Commerce `Fulfillment App` on your device. 2. **Go to the "In Progress" Section**: `Navigate` to the `In Progress` section where you’ll find details of `active orders`. 3. **Select the Order and Pack**: Choose the relevant order and click on the `Pack Order` option. 4. **Choose the Preferred Carrier**: Select from options like FedEx, UPS, or EasyPost based on the order's requirements and convenience, ensuring flexibility and control over shipping. 5. **Enter Tracking Code and URL**: Store associates can manually enter the `tracking code` in the provided field. Ensure that a `tracking URL` is configured for the selected carrier. If it’s not available, you may need to input the tracking URL `manually` to allow customers to track their `shipments` effectively. 6. **Generate the Label**: Once the carrier is selected, `generate` the `shipping label` for the order. ## Manual fallback: Generate tracking code If automatic shipping label generation fails, store associates can manually provide tracking details to proceed with the shipment. 1. If a label generation error occurs, a `Shipping label error` button appears on the shipment card. 2. Click the button to open the `Generate tracking code` modal. 3. Manually enter the `Tracking code` provided by the carrier. 4. If a tracking URL is available, enter it in the `Tracking URL` field. 5. Select `Save` to update the shipment with manual tracking details.