Leina connects to SF Express to help you track parcels, compare delivery options, and prepare shipment orders. Ask in your team chat. Leina does the work and brings back the result.
Connect SF Express, choose what to share, and hand off your first task.
You
Check the two tracking numbers and phone suffixes I supplied. Which parcel needs follow-up?
Leina
Parcel B has a delivery exception in its latest route event. Parcel A is out for delivery.
SF Express · Illustrative route results
Two parcels · Status check
The latest event for each parcel, with one delivery exception to follow up.
An SF Express AI agent uses your SF Open Platform connection to check parcels and work with shipping orders. Give it shipment details to retrieve routes, validate an order, or prepare a waybill.
You specify the source and the destination. Leina uses the content available to your connection and returns the result for you to review.
SF Express provides express delivery and logistics services. Its Open Platform supports shipping, tracking, and waybill operations for connected applications.
Share the tracking numbers and any required phone verification details.
Retrieve the available route events for each parcel.
Compare the latest events and highlight reported exceptions.
Use the event times and locations to explain the current delivery status.
Copy a prompt, add your details, and send it to Leina in your connected team chat.
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 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 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.
Your next SF Express task can start with a message.
Tell Leina what you need in your team chat. Include the source, destination, and expected result.
Connect the tools involved and give Leina access to the content it needs.
Share the source material, say where the result belongs, and describe what you need.
Review the result and any changes in the connected app.
Hand off these everyday tasks to your AI employee.
Query 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 the SF Express delivery time standards for an origin and destination, optionally with freight prices per product.
Query 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.
Check whether a waybill number is a valid SF Express waybill number.
Check whether origin and destination addresses are within SF Express pickup and delivery coverage (筛单), before placing an order.
List nearby SF Express service points (自营服务点, 合作商家店, 顺丰站, 丰巢柜, and more) around an address or a coordinate.
Recommend SF Express products with prices and promised delivery times for a shipment.
Recommend value-added services (保鲜, 保价, 定时派送, and more) with prices for a shipment on a chosen product.
Check whether an SF Express pickup at an address can be served at a planned time, optionally returning the service window.
Create 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.
Validate 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.
Confirm (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 the processing result of a previously placed SF Express order, for example when the create_order response never arrived.
Allocate additional child waybill numbers (子单号) for an existing SF Express order, at most 20 per call.
Intercept, 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 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 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 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 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 → 图片注册及推送接口).
Generate 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).
Convert waybills into printer command sets (云打印面单转指令, cpcl or zpl), returned inline as text or as downloadable files.
Convert waybills into Cainiao print template URLs (云打印面单转菜鸟模板) for systems already integrated with the Cainiao print component.
Generate waybill HTML print files from a cloud print template (云打印面单转HTML). Returns download URLs that need the returned token in the X-Auth-token header (valid 24h).
Submit waybill print content for 大同城 citywide freight orders. Asynchronous by default: returns a print batch number to poll with sf_express.query_citywide_print_status; sync mode (max 20 documents) returns the files directly.
Query the status and generated PDF files of a 大同城 citywide print batch.
List a merchant's published custom print templates with their placeholder fields (ISV 自定义模板列表).
Save a merchant custom print template (ISV 保存自定义模板); same name means a new version of the same template. The content follows the SF markup language spec.
Delete a merchant custom print template (ISV 删除自定义模板); SF caps the number of templates per account, so delete unused ones before adding new.
Check whether SF Cold Chain can serve a given origin-destination flow with a product, returning the serving points' business hours and the available temperature levels.
Estimate the SF Cold Chain transport fee for a flow and one or more products, returning the per-product fee breakdown.
Estimate the SF Cold Chain delivery time for a flow and one or more products, including pickup and delivery transit times.
Create an SF Cold Chain transport order (陆运运输). The monthly account is required for monthly-settlement payment (PR_ACCOUNT).
Cancel an SF Cold Chain transport order that has not been accepted yet.
Query the waybill numbers (master waybill, sign-back receipt number, child waybills) generated for an SF Cold Chain order.
Query SF Cold Chain route events by waybill number, SF order number, or client order number, combined with the order source code.
Query the full details of an SF Cold Chain order, including parties, weights, goods lines, value-added services, and the sign-back receipt.
Place an SF Freight (快运) LTL order for bulky or heavy shipments. This is for 大件 special scenarios only; for regular parcels use sf_express.create_order. When waybill_no is provided, the order uses that reserved master waybill number instead of generating one.
Cancel an SF Freight LTL order. Only orders not yet picked up can be cancelled.
Get the latest dispatch result of an SF Freight LTL order placed with courier call (下call), including the assigned waybill numbers.
Append sub waybill numbers to an SF Freight LTL order, for shippers who finalize the package count after packing. Only own orders before pickup; at most 1200 sub waybills per order. Reprint the waybills afterwards if they were already printed.
Check whether an address is within SF Freight pickup or delivery coverage (订单筛单).
Query the standard base freight price for an SF Freight product between two addresses. At least one of weight, size, or declare_value is required for pricing.
Register an SF Freight waybill for waybill picture push. The picture push callback must be configured in the SF console before pushes arrive.
Query the route of an SF cross-border bulky (大件跨境) waybill. For transfer waybill numbers (转单号), use freight_query_crossborder_transfer_routes.
Query the route events of a transfer waybill number (转单号) for an SF cross-border bulky shipment.
List the transfer waybill numbers (转单号) of an SF cross-border bulky mother waybill.
Report a work order (工单) about an SF Freight shipment to SF customer service.
Reply to an SF Freight work order, identified by work_order_id or report_source_no (at least one).
Create an SF Freight truckload (整车直达) order. Set generate_waybill_no to have SF assign a waybill number, or pass your own waybill_no. A monthly card (monthly_card) is required when pay_method is 1 (寄付月结) or 2 (寄付转第三方).
Cancel an SF Freight truckload order. Cancellation only succeeds while the order is in a cancellable state; otherwise the error message explains why.
Query an SF Freight truckload order by client order number; pass waybill_no as well when you have it.
Create the vehicle track playback page URL for an SF Freight waybill. Requires the monthly card that paid the waybill.
Place an SF Freight city-delivery (城市配送货运) order. send_start_time must be at least 2 hours in the future.
Calculate the freight fee for an SF Freight city-delivery shipment before ordering.
List SF Freight city-delivery orders for an ordering phone number, with optional time and pagination filters.
Get the details of an SF Freight city-delivery order by order number or client order number.
Cancel an SF Freight city-delivery order.
List the value-added services available for a city and vehicle model in SF Freight city delivery.
List the vehicle models available for a city and business scenario in SF Freight city delivery.
List the cities where SF Freight city delivery is available.
Get the pickup appointment time window available for a city in SF Freight city delivery.
Append an install service to an existing SF waybill. The append is only confirmed once the waybill is picked up; the final result arrives via the install status push. This endpoint requires SF sales onboarding (联系客户经理).
Create an SF install order (安装单下单): install-only, pickup-and-install, or repair.
Update an install order's customer info, non-SF logistics info, or cargo images. Customer and logistics info can only change before a master is assigned; cargo images can change until the waybill is signed.
Cancel an appended install service; the waybill must not be picked up yet.
Query an SF install order's status and fee breakdown by client order number.
Create an SF recovery order (回收单下单) for door-to-door goods recycling. The pickup date must be within 3 days, the window whole hours between 08:00 and 21:00.
Mark an install order's goods as arrived (到货通知), optionally completing the pickup address. Only the not-arrived to arrived transition is supported.
Cancel an SF recovery order; not possible once the master has arrived.
Query the full SF recovery product catalog (回收品类). The list is large and returned in full; cache it instead of calling repeatedly.
Query the home-delivery service rules (宅配规则) bound to one or more SF monthly cards.
Audit a value-added service request (审核增值服务), for example the JZ17 好评返现 service.
Report an install-task operation node to SF as the supplier (操作节点回传): assign master, pickup, appointment, arrival check, completion, review, fault detection, and more. Required fields depend on operate_code; images are required for codes 3, 17, 20, 21.
Query the appointment times a supplier's master may offer for an install task (送装协同可预约时间).
Submit a supplier master's quote for a bidding install order (回传报价).
Report an operation node for a bidding install order (供应商自主报价操作节点回传). operate_data's required keys depend on operate_code: OP000006 needs installMaster+installConcat, OP000004 needs appTime, OP000008/OP000001/OP000010 need imgUrl, OP000013 needs closeReason.
Report the master's decision on a bidding install order's add-fee request (增加费用结果回传).
Apply for an add-fee on a bidding install order as the supplier (供应商侧发起增加费用).
Query the result of a supplier add-fee application (增加费用结果查询); the fallback when the result push or report fails.
Report the master's decision on a bidding install order's refund request (退款结果回传).
Report the complaint handling result for a bidding install order (接收投诉结果).
Ask the customer for supplementary evidence while handling a complaint (通知用户补充举证). The deadline defaults to 12 hours after the notice time.
Submit the master's evidence for a complaint on a bidding install order (师傅举证回传).
Upload the recipient's signature or other proof-of-delivery images for an SF Freight forwarding waybill; SF reviews them and then marks the waybill signed. Image URLs must be publicly accessible.
Upload the pickup driver information for an SF Freight forwarding order once the carrier assigns the driver.
Upload multiple vehicle track points for one SF Freight forwarding waybill in a single call. All track points must belong to the same waybill number.
Upload a remark for an SF Freight forwarding waybill.
Upload the sign-back receipt number for an SF Freight forwarding waybill.
Upload a real-time order status update for an SF Freight forwarding shipment.
Upload route events for an SF Freight forwarding waybill. Upload incrementally, newest first; cover all loading, unloading, and out-for-delivery nodes (use freight_forward_upload_sign_image for the signed node).
Upload one vehicle track point for an SF Freight forwarding waybill.
Apply for an additional last-mile fee on an SF Freight forwarding waybill; currently only 入仓垫付 (warehouse entry advance, type 50) is supported.
Place a return-receipt order (标快到付) for one or more SF Freight forwarding waybills.
Report an exception for an SF Freight forwarding waybill, for example damage, miscount, delay, or a reweigh appeal. delay_days is required for codes SIGN_03/SIGN_05/SIGN_15/TRANSITING_15; weight and sub_items are required for the reweigh codes HANDOVER_06/TRANSITING_17.
Get the payment QR code for an unpaid SF Freight forwarding waybill.
Bind the payment of an SF Freight forwarding waybill to a monthly settlement card (月结卡号) so the fee is charged to it. Requires a monthly card.
Upload route events for an SF Freight forwarding return receipt. Upload incrementally, newest first; cover all loading, unloading, out-for-delivery, and signed nodes.
Report logistics traces for an SF cross-border bulky shipment, as the carrier agent. Routes are stored newest first; milestone values make the corresponding nodes visible to end customers.
Place an SF cross-border bulky (大件跨境) order and receive the master and sub waybill numbers. A monthly card (monthly_card) is required when settlement_type is 2 (寄付月结).
Check whether a destination postal code is served for SF cross-border bulky shipments, returning the address info and remote-area flag.
Start an SF cross-border bulky waybill print download and get the print batch number.
Get the waybill print file download URLs for a print batch created by freight_crossborder_get_print_batch.
Confirm and update a new delivery window option for an FBA shipment as the carrier agent.
Query the selectable delivery window options for an FBA shipment as the carrier agent.
Query the current delivery window of an FBA shipment as the carrier agent.
Query the proof-of-delivery information for an SF cross-border bulky waybill.
Upload proof-of-delivery files for an SF cross-border bulky waybill, as publicly accessible file URLs.
Cancel one or more SF cross-border bulky orders by waybill number.
Batch-upload the 600 route (滞留件盘点) for waybills held at a partner station.
Report an exception return for a waybill at an external station (驿站异常件退件处理).
Check whether a waybill number is an SF Express waybill number, for the station channel.
Query the route events of a waybill for the station channel.
Send a pickup notification SMS to the recipient of a waybill held at a station.
Send a fixed-template notification SMS for a waybill to its recipient or sender.
Batch-upload the 600 route (滞留件盘点) for waybills held at a convenience store.
Query whether a waybill is a centralized (集收/集派) shipment through the station general query API.
Submit or update the regional outsourcing information (区域外包信息变更) for outsourced station areas.
Create or update a robot/smart-cabinet channel station (渠道新增/修改). Omit virtual_addr when creating; pass it when updating.
Create or update a cage cabinet (笼车柜); the sn field is the upsert key.
Report an exception return for a waybill at a store (门店异常件退件处理).
Check whether an operator on a channel may handle a waybill at a store (渠道可派件交接管控).
Register a customer drop-off at a store (顾客到店寄件). When receiver_payment is 0 (寄付), weight, pack_fee, insurance_money and insurance_fee are required.
Register that an SF courier picked up the consigned parcels from a store (顺丰小哥到店收件).
Register that a store received parcels handed over by an SF courier (门店接收小哥派件).
Register that a customer picked up their parcel at a store (顾客到店取件). When receiver_payment is 1 (到付), weight, pack_fee, insurance_money, insurance_fee and successfully_payed_fee are required.
Query a station's information. One of virtual_addr or store_code is required. The returned field names vary by api_version.
Check whether a Hive Box (丰巢) cabinet drop-off fee settles monthly (丰巢订单结算校验, 订单类型 1 派件投柜). The rental and reservation order types carry different payloads and are not covered.
Create or update a Hive Box regional-outsource store (丰巢区域外包门店新增及更新).
Create or update a 驿收发 regional-outsource store (驿收发区域外包门店新增及更新).
Create or update a township agent station (乡镇代理基本信息新增).
Upload the exterior and interior images for a township agent station (乡镇代理图片上传).
Create or update a city station's base information (驿站基本信息新增/更新). When outsource_flag is 1, outsource_info is saved and required for 驿收发/丰巢 stores.
Create or update a 星管家 station's base information (星管家基本信息新增).
Upload identity, face and property images for a 星管家 station (星管家相册新增); identity_file_names must contain exactly 2 images.
Get an OSS token for direct image upload (获取OSSToken信息). The oss_client_name and path_id values come from your SF Express contact.
Query the grid/bin assignment for a courier's shift at a station (星管家排班信息查询).
Upload one base64 image for a station (图片上传); the image must be at most 200 KB.
Submit or update a Hive Box service station's information (丰巢服务站信息接收或更新).
Update a 星管家 waybill's dispatch and review-fee information (星管家运单及好评费更新).
Update a 星管家 station's monthly insurance fee (星管家保险费更新).
Submit a waybill's receipt information with its fee, service, mark and addition lists (回单信息).
Query a waybill's contact, payer and fee details (通用运单查询). Phone and address fields in the response are encrypted by SF Express.
Upload storefront and interior images for a Hive Box service station (丰巢服务站相册新增).
Upload album images for a station (驿站相册新增), such as exterior, license, poster and signage photos.
Submit brand-inspection images for a station task (品牌巡检相册新增); resubmitting the same task_id updates its images.
Pre-check-in a delivery waybill at an external station (外部驿站派件预入库) before the physical handover.
Check in a delivery waybill at an external station (外部驿站派件入库, route 657).
Check out a waybill at an external station when the customer picks it up (外部驿站派件出库, route 658).
Create or update an external station (新增/修改外部驿站). Omit virtual_addr to create; pass it to update an existing station.
Attach business-license, filing, or album image file names to an external station (外部驿站上传营业执照、末端备案、相册).
Send a pickup-code SMS for a waybill from an external station (外部驿站发送短信).
Check whether a waybill is valid for external-station operations (外部驿站运单校验); an SF waybill without a recipient phone cannot receive station SMS.
Report a temporary station hold for a waybill (驿站暂存): bill_type 1 = 收端暂存 (route 410), 2 = 派端暂存 (route 210).
Check whether a channel and courier may deliver a waybill (派件管控). The channel code is allocated by SF (联系868850).
Validate a customer's pickup password for a waybill at a partner station (验证取件密码).
Connect the Apps your work depends on, and give Leina the context to carry the task forward.
Hand off a task while your team is discussing it. Leina uses your connected tools and brings the result back to the conversation.
See How Leina Works in SlackLeinaExample Result Parcel B has a delivery exception in its latest route event. Parcel A is out for delivery.
No. The pre-order check validates the proposed shipment without placing it. Creating a shipment is a separate operation and may incur charges.
For shipments outside the monthly account linked to your connection, provide the last four digits of the sender’s or recipient’s phone number.
Waybill links expire after 24 hours and require access verification. Save or print the file while the link is available.
Start with one task you already need to do. Tell Leina what a finished result should look like.
Connect SF Express, choose what to share, and hand off your first task.
