SF Express
Use an agent with SF Express to query shipment routes and delivery estimates, validate shipment details before ordering, and manage supported shipping and printing operations.
Use your SF Open Platform connection to query routes, check shipping options, create orders, and prepare waybills with supported print templates.
エージェントが SF Express でできること
アクションをタスク別にまとめ、各グループに呼び出すアクションを記載しています。
Tracking and Estimates
Read shipment routes, promised time, service timing, and freight-fee details.
- Search Routes
- Estimate Delivery Time
- Query Delivery Time Price
- Query Waybill Fee
Order Preparation and Creation
Validate an order or create a real shipment and inspect its processing result.
- Pre Order
- Create Order
- Query Order Result
Waybill Printing
Generate PDF, HTML, or printer-command output with cloud templates.
- Print Waybill Pdf
- Print Waybill Html
- Print Waybill Command
エージェントに任せられるタスク
かっこ内を埋め、タスクに 2 つ目のアプリがあればそれも接続してください。
Check Parcels Before Replying to Customers
Summarize the latest route event and highlight returned delivery exceptions.
Check these SF Express tracking numbers [numbers] using the corresponding sender or recipient phone last-four digits [digits]. Give me the latest event, its time and location, and any reported delivery exceptions for each parcel.
Check an Order Before Creation
Validate a proposed order without creating a shipment.
Check whether this proposed SF shipment can be accepted: order reference [ID], product [type], sender [contact and address], recipient [contact and address], cargo [name]. Explain any issue and the returned service windows. Do not place the order.
Compare Delivery Options
Check product delivery windows and available freight estimates for a proposed shipment.
Compare SF delivery options for [origin address] to [destination address], weight [kg], shipping at [date and time]. Include returned delivery windows and prices, and flag missing prices.
アクション155
SF Express コネクタが提供するすべてのアクションを、名前と ID で掲載しています。
- Search Routes
search_routesQuery logistics routes (tracking events) for up to 10 SF Express shipments. Waybill-only queries return routes only for shipments paid with a monthly card bound to your partnerID; for any other shipment, pass the sender or recipient phone's last 4 digits in check_phone_nos. Only shipments from the last 3 months have routes. - Query Delivery Time Price
query_delivery_time_priceQuery the SF Express delivery time standards for an origin and destination, optionally with freight prices per product. - Estimate Delivery Time
estimate_delivery_timeQuery the promised delivery time for an SF Express waybill, verified by the sender or recipient phone number or by the monthly card that paid the waybill. - Validate Waybill No
validate_waybill_noCheck whether a waybill number is a valid SF Express waybill number. - Filter Order
filter_orderCheck whether origin and destination addresses are within SF Express pickup and delivery coverage (筛单), before placing an order. - Query Service Points
query_service_pointsList nearby SF Express service points (自营服务点, 合作商家店, 顺丰站, 丰巢柜, and more) around an address or a coordinate. - Recommend Product
recommend_productRecommend SF Express products with prices and promised delivery times for a shipment. - Recommend Vas
recommend_vasRecommend value-added services (保鲜, 保价, 定时派送, and more) with prices for a shipment on a chosen product. - Check Pickup Time
check_pickup_timeCheck whether an SF Express pickup at an address can be served at a planned time, optionally returning the service window. - Create Order
create_orderCreate a real SF Express shipment order (下订单) and allocate waybill numbers; charges may apply. Mainland China and Hong Kong/Macao/Taiwan lanes are supported. The response includes the screening result (filterResult) and the allocated waybill numbers. Use pre_order to validate an order without creating it. - Pre Order
pre_orderValidate whether an SF Express order would be accepted (预下单) — checks cargo, monthly card, address reachability, and number controls — without creating it, and returns the available service time windows. - Update Order
update_orderConfirm (deal_type confirm) or cancel (deal_type cancel) an SF Express order before shipment, optionally updating weight, volume, or the recipient address. Confirming requires the waybill numbers. A cancelled order number cannot be reused. - Query Order Result
query_order_resultQuery the processing result of a previously placed SF Express order, for example when the create_order response never arrived. - Get Sub Waybill Nos
get_sub_waybill_nosAllocate additional child waybill numbers (子单号) for an existing SF Express order, at most 20 per call. - Intercept Order
intercept_orderIntercept, redirect, return, or adjust an in-transit SF Express waybill (截单转寄退回), for example redirecting it to a new address or returning it to the sender. Only for waybills already picked up; cancel an unshipped order with update_order instead. - Send Delivery Notice
send_delivery_noticeSend a delivery or return notification for an SF Express waybill (派件通知), used in pre-sale scenarios where the goods were stocked in an SF warehouse in advance. - Query Waybill Fee
query_waybill_feeQuery the freight fee breakdown (清单运费) of an SF Express shipment by order number (only orders placed under your partnerID) or by waybill number (the waybill's monthly card must be bound to your partnerID). - Register Route Push
register_route_pushRegister an SF Express order or waybill for route (tracking) push. Prerequisite: the route push callback must already be configured in the SF console (控制台 → 开发者对接 → 查看API → 路由注册接口 → 配置信息); after registration, SF pushes route updates to that address. - Register Waybill Picture Push
register_waybill_picture_pushRegister a waybill for waybill picture push (回单 receipt, 清单 manifest, 拍照回传 photo proof, etc.). SF pushes the AES-encrypted picture to the configured callback once generated; register after the shipment is signed for, because pictures are produced late. The decryption key comes from the SF console (控制台 → 开发者对接 → 查看API → 图片注册及推送接口). - Print Waybill Pdf
print_waybill_pdfGenerate waybill PDF print files from a cloud print template (云打印面单转PDF). Returns download URLs that need the returned token in the X-Auth-token header (valid 24h).
SF Express のサインイン方法
- サインイン方法
- 認証情報Provide SF Open Platform partnerId and checkWord, with the configured signature algorithm and sandbox setting.
- 必要なもの
- An approved SF Open Platform application with partnerId and checkWord.
- 備考
- New apps must pass sandbox tests for production. Tracking unbound shipments needs phone verification; routes cover the last three months.