Bob Go MCP by usefulapi

CANCELS a shipment and refunds its charge to the customer's Bob Go account. Bob Go refuses it once the courier has moved the parcel past collection. Use the Bob Go tracking_reference, not your custom reference. Bob Go: POST /v2/shipments/cancel.

BOOKS a courier for the parcels and charges the customer's own Bob Go account once the courier rate is known. Take provider_slug and service_level_code from a rate you selected. The call returns at once with submission_status pending-rates; check it later with bobgo_list_shipments (id) before you tell anyone the parcel is booked. Bob Go: POST /v2/shipments.

Return the shipping options a buyer should see at checkout, priced by the rules configured in the Bob Go account (service levels, zones, markups, exclusions). Use it for a cart, not to pick a courier to book. An empty result means no delivery for that area, not an error. Bob Go: POST /v2/rates-at-checkout.

Ask every courier on the Bob Go account what the parcels cost to ship between two addresses. Returns per-courier quotes with rate_amount; use only rates with status success. This is a quote, not a booking, and it does not apply the account's checkout markups. Waits up to about 20 seconds for couriers (timeout_ms). Bob Go: POST /v2/rates.

Read a queued label or waybill batch. Poll until file_status leaves processing; file_url is set on success and valid 24 hours. Records are kept for a month. Bob Go: GET /v2/file-history.

List every fulfilment (shipment or buyer collection) on an order, newest first. The tracking reference of an order's shipment is here, not on the order. Bob Go: GET /v2/order-fulfillments.

Read a rate request made earlier, with the couriers' answers so far. Use it after bobgo_get_courier_rates returned a pending provider. Without an id it lists the most recent rate requests. Bob Go: GET /v2/rates.

Generate sticker labels for shipments. type zpl returns ZPL strings inline, one per parcel, for a Zebra printer. type pdf returns the same envelope as the waybill. Sticker labels need a Bob Go plan that includes them. Bob Go: GET /v2/shipments/sticker-waybill.

Return every tracking checkpoint for a shipment, with its current status and the courier's branding. Not limited to this account: any Bob Go tracking reference resolves, as on the public tracking page. Bob Go: GET /v2/tracking (returns an array).

Generate the A4/A5/A6 waybill PDF for shipments and return a download_url (valid 24 hours). Cancelled or unknown references are skipped. Shipments that the courier has not accepted yet produce no label: read submission_status per shipment. Two or more shipments are always queued: then poll bobgo_get_file with file_history_id. Bob Go: GET /v2/shipments/waybill.

List orders on the account, most recently placed first, or fetch one by id. Filter by payment, order or fulfilment status, delivery province code or date placed. Items and relations are included by default: ask only for what you need. Bob Go: GET /v2/orders.

List shipments, newest first, or fetch one by id or tracking_reference. Without id, tracking_reference or a date range, only the current month (South African time) is returned: send start_date and end_date for older shipments. Use submission_status to find bookings that never reached a courier. Bob Go: GET /v2/shipments.