基础资料'销售物流信息'默认集成了销售订单，发货通知单，销售出库单和销售退货单上的物流详细轨迹信息，一般来讲物流详细轨迹信息是通过调用快递100接口获取到的，本帖子演示下如何通过WebApi查询及新增详细信息。首先创建一张销售订单，并录入物流单号，如下图1-1所示：

图1-1

    使用'销售物流信息'的单据查询WebApi接口查询物流详细信息，传入的JSON格式为(这里使用销售订单号和物流单号做条件查询，并设置返回一些基础资料内码，手机号码，物流公司，客户编码，明细内码，详细轨迹信息等，请根据实际情况替换FieldKeys参数即可)：

{
    "FormId": "SAL_LogisticsInfo",
    "FieldKeys": "FID,FCARRYBILLNO,FSalBillNo,FLogComId,FPhoneNumber,FCustomerID.FNumber,FLogistDetailEntry_FEntryId,FTraceDetail,FTraceTime",
    "FilterString": [{"Left":"        (","FieldName":"FSalBillNo","Compare":"67","Value":"XSDD001005","Right":")","Logic":"0"},{"Left":"(","FieldName":"FCarryBillNo","Compare":"67","Value":"YD522455685422","Right":")","Logic":"0"}],
    "OrderString": "",
    "TopRowCount": 0,
    "StartRow": 0,
    "Limit": 2000,
    "SubSystemId": ""
}

    可以看到初始添加的物流单号对应的物流详细轨迹信息是没有的， 如下图1-3所示：

图1-2

    根据上一步返回的基础资料内码ID：'131410-SAL_SaleOrder-100770'，使用批量保存WebApi接口追加物流详细轨迹信息，如下图2-1所示：

图2-1

    上图2-1中输入的JSON格式如下：

{
    "NumberSearch": "true",
    "ValidateFlag": "true",
    "IsDeleteEntry": "false",
    "IsEntryBatchFill": "true",
    "NeedUpDateFields": [],
    "NeedReturnFields": [],
    "SubSystemId": "",
    "InterationFlags": "",
    "Model": [
    {
        "FID": "131410-SAL_SaleOrder-100770",
        "FLogistDetailEntry": [
            {"FTraceDetail":"WebApi添加的详细信息1", "FTraceTime":"2023-01-02 18:43:32" },
            {"FTraceDetail":"WebApi添加的详细信息2", "FTraceTime":"2023-01-02 20:50:32" },
            {"FTraceDetail":"WebApi添加的详细信息3", "FTraceTime":"2023-01-03 20:50:32" }
        ]
    }
],
    "BatchCount": 0,
    "IsVerifyBaseDataField": "false",
    "IsAutoAdjustField": "false",
    "IgnoreInterationFlag": "false",
    "IsControlPrecision": "false",
    "ValidateRepeatJson": "false"
}

    再次调用图1-2所示的单据查询接口，可以看到现在就有详细信息了，如下图2-2所示：

图2-2

    如果是使用单据查看WebApi接口，也是可以查询到对应的详细信息，但此接口只适用传ID，不适用传NUMBER，如下图3-1所示：

图3-1

    打开销售物流信息列表界面，也可以看到对应的详细信息，如下图3-2所示：

图3-2

注意事项：

    由于销售物流信息的表头是由数据库视图'V_SAL_LOGISTICSINFO'（如果查看此视图可以看到它使用 UNION ALL 从句拼接了多个销售单据的物流跟踪页签里的信息）定义的，而表体详细物流轨迹信息是由数据库表'T_SAL_LOGISTINFODETAIL'定义的，因此在用WebApi保存销售物流信息时，不应当新增表头数据，应当按基础资料内码去修改表体数据，如果想要新增表头数据，则要通过对应单据的WebApi修改接口实现。