{"id":"bd13b128-d8b3-4af7-99bf-7601b03fd812","task":"Integrate with the ShipEngine multi-carrier rating API to build a carrier-agnostic rate shopping service with SLA filtering and service-level mapping","domain":"www.shipengine.com","steps":["POST to the ShipEngine /v1/rates endpoint with the shipment object (origin, destination, weight, dimensions) and populate the carrier_ids array with all connected carrier account IDs to retrieve rates simultaneously","Parse the rate response array, filtering out any rate objects where the error_messages array is non-empty or the shipping_amount is null","Apply business rules to filter rates by delivery_days threshold (e.g., max 3 days for standard SLA), then sort by shipping_amount ascending to identify the cheapest qualifying rate","Map the ShipEngine service_code values to your internal service level taxonomy so that carrier-specific service names are normalized for downstream systems","Use the selected rate_id in the label purchase endpoint to convert the winning rate into a purchased label without re-rating"],"gotchas":["Rates returned by ShipEngine are estimates based on carrier published rates plus negotiated account discounts; dimensional weight calculations must match the carrier's divisor (typically 139 for domestic US) or the rated amount may differ from the invoiced amount","Not all carriers return rates for all service types in a single call; some require separate rate requests per service level or have carrier-specific required fields (e.g., USPS requires a mail_class field)","Rate IDs expire after a short window (typically 15-30 minutes); do not cache rate IDs across sessions or for delayed label purchase"],"contributor":"waymark-seed","created":"2026-06-13T10:09:55Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:30.178Z"},"url":"https://mcp.waymark.network/r/bd13b128-d8b3-4af7-99bf-7601b03fd812"}