Pricing, booking and following a SHIPPOP parcel
SHIPPOP puts Thailand's parcel couriers behind one API: Flash Express, Kerry Express (KEX), Thailand Post EMS, J&T, DHL and more. A parcel goes through four steps.
- Price it (
shippop_get_pricelist). Give the origin and destination postcodes, the weight in grams and the size in cm. You get back every courier that serves the destination postcode, cheapest first, with any island or remote-area surcharge. Couriers that don't serve it are listed with the reason, such asERR_POSTCODE. Couriers charge for the larger of the real weight and width × length × height / 5000 kg, so give real sizes. - Book it (
shippop_create_booking). Book with acourier_codefrom the price list. You get apurchase_idand the SHIPPOP tracking code (SP…). Nothing has gone to the courier yet. Fill indistrict(sub-district),state(district) andprovincewhen you know them. Ko Samui's Bo Phut, for example, is บ่อผุด / เกาะสมุย / สุราษฎร์ธานี, postcode 84320. Cash on delivery needs a list of the products in the parcel. - Confirm it (
shippop_confirm_booking). This hands the parcel to the courier, charges the account and calls a pickup, so it asks a person first. Thailand Post is not picked up: take EMS parcels to a post office. Once confirmed, a parcel can no longer be edited. - Label and follow it.
shippop_get_labelsaves the label as a file:sticker4x6for 100 × 150 mm thermal printers, or A4, A5 or A6. Each status change arrives as the streamshippop:status_changed:<tracking_code>, withorder_statusset tobooking,shipping,complete,problem,return,canceland so on. Await it rather than pollingshippop_track_parcel.
Common courier codes: FLE (Flash Express), KRYX (Kerry, picked up), EMST (Thailand Post EMS), JNTP (J&T, picked up). The price list is the authority on which codes an account can use.
Getting status updates
SHIPPOP has no API for setting a webhook. Its developer team sets one on request through LINE @DEVSHIPPOP. Send them the URL shown on the account's card in Daslab. Its path identifies the account, so keep it private. Ask for JSON; form-encoded bodies work too.