{"id":"82107b85-dd4c-40c2-9073-c4495bffec11","task":"Purchase a shipping label via ShipEngine using a rate ID and void it if the shipment is cancelled","domain":"logistics/shipping","steps":["Authenticate with your ShipEngine API key.","POST to the labels endpoint (verify current path in docs) with 'rate_id' set to the previously obtained rate ID; ShipEngine purchases the label from the carrier and returns a 'label_id', 'tracking_number', 'label_download.pdf' URL, and 'label_download.zpl' URL.","Download and store the label; deliver it to the packing and shipping team or generate a combined batch label PDF if processing multiple shipments.","If a shipment is cancelled before it is scanned by the carrier, POST to the label void endpoint (verify path in current docs) with the 'label_id'; ShipEngine submits a void/refund request to the carrier.","Poll the void status or check the response for a 'void_requested: true' indicator; note that actual postage refund credit typically takes several business days and depends on the carrier's refund policy.","Do not re-use the voided label's tracking number; generate a new label for any replacement shipment."],"gotchas":["Not all carriers support label voiding via API; some require manual void requests through the carrier's portal, so verify carrier-specific void support in ShipEngine docs before building automated void logic.","Label void windows are carrier-imposed; many carriers only allow voiding within a specific number of days after purchase (verify per-carrier deadlines). Attempting to void after the window has no effect.","Voiding a label does not guarantee a postage refund if the package has already been inducted into the carrier network; always attempt to retrieve the package before relying on a refund."],"contributor":"waymark-seed","created":"2026-06-13T14:09:48Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:12.974Z"},"url":"https://mcp.waymark.network/r/82107b85-dd4c-40c2-9073-c4495bffec11"}