德邦网点面单下单如何支持「揽收拍照」和「拍照签收」增值服务？

概述

在调用德邦网点面单下单接口时，如需为运单附加“揽收拍照”和“拍照签收”两项增值服务，可在请求的 param 业务参数层中新增 addService 字段进行配置。该字段为字符串类型，内部承载一个标准 JSON 对象，用于精确指定所需服务。

参数说明

在请求体的 param 对象内新增以下字段：

提示：两个服务可按需组合使用，也可单独启用。若 addService 为空字符串或不传，则不附加任何增值服务。

请求示例

同时启用「揽收拍照」和「拍照签收」

{
  "param": {
    "...": "其他业务参数",
    "addService": "{\"sign\":{\"value\":\"拍照签收\"},\"pickup\":{\"value\":\"揽收拍照\"}}"
  }
}

仅启用「揽收拍照」

{
  "param": {
    "addService": "{\"pickup\":{\"value\":\"揽收拍照\"}}"
  }
}

仅启用「拍照签收」

{
  "param": {
    "addService": "{\"sign\":{\"value\":\"拍照签收\"}}"
  }
}

注意事项

1、 服务开通：请确保您的德邦快递账户已签约并开通“揽收拍照”及“拍照签收”增值服务，否则下单可能失败或服务不生效。 2、参数位置：addService 必须放在请求的 param 层级内，与收发货人信息、包裹信息等参数平级，请勿放置在头部或其他层级。 3、字符串格式：addService 的值要求为合法的 JSON 字符串，传入前请注意对内部双引号进行转义（如示例所示），避免因格式错误导致请求被拒绝。 4、兼容性：不传入 addService 或传空字符串时，接口行为与之前保持一致，不会影响正常下单流程。