microservice / rider-service · Files

package com.diligrp.rider.service;

import com.diligrp.rider.dto.DeliveryOrderCreateDTO;
import com.diligrp.rider.vo.DeliveryOrderCreateVO;

public interface DeliveryOrderService {
    /**
     * 外部系统推单（核心接口）
     * 1. 校验城市是否开通服务
     * 2. 计算配送费
     * 3. 创建配送订单（status=2待接单）
     * 4. 返回订单信息供接入方展示
     */
    DeliveryOrderCreateVO create(String appKey, DeliveryOrderCreateDTO dto);

    /** 查询订单状态（供接入方轮询） */
    DeliveryOrderCreateVO queryByOutOrderNo(String appKey, String outOrderNo);

    /** 取消订单（仅 status=2 可取消） */
    void cancel(String appKey, String outOrderNo);
}