公路舱单 (交易接口)

• 创建
• 申报/撤销申报
• 附：数据模型

创建

请求

• 接口路径：v1/rmft
• 请求方法：POST
• 请求头内容：
  • Content-Type: application/json
• 请求Body内容

{
  "requestId": "1",
  "manifestType": "MT1401",
  "data": {
    "manifest": {
      "consignmentList": [
        {
          "billNo": "提单号"
        }
      ]
    }
  }
}

• 业务类型：
  • MT1401 - 原始舱单
  • MT2401 - 预配舱单

响应

• HTTP状态: 200 代表调用成功

• 响应正文：

{
  "success": true,
  "message": null,
  "result": {
    "rmftId": "公路舱单id",
    "cargoBatchNo": "货物批次号"
  },
  "error": null
}

result结构

申报/撤销申报

请求

• 接口路径：v1/rmft/declare
• 请求方法：POST
• 请求头内容：
  • Content-Type: application/json
• 请求Body内容

{
  "requestId": "1",
  "rmftId": "公路舱单id",
  "billNoStr": "T1234,T9876",
  // 提单号 多个用英文逗号隔开
  "functionCode": "9"
  // 功能码 9-申报  3-撤销申报
}

响应

• HTTP状态: 200 代表调用成功

• 响应正文：

{
  "success": true,
  "message": null,
  "result": {
    "success": true,
    // 请求是否成功
    "message": null,
    // 失败信息
    "succeedTotal": 1,
    // 成功数量
    "failedTotal": 1,
    // 失败数量
    "billMessages": [
      // 失败的提单信息
      {
        "billNo": "T26031211382",
        "message": "该状态不允许申报。"
      }
    ]
  },
  "error": null
}

{
  "success": false,
  "message": "异常信息",
  "result": null,
  "error": null
}

result的结构

附：数据模型

公路舱单数据模型

{
  "manifest": {
    "iePort": "0105",
    "cargoBatchNo": null,
    "content": null,
    "plateLicenseNo": null,
    "agentCode": null,
    "transportType": "3",
    "carrierCode": null,
    "loadingPlace": null,
    "unloadingPlace": " 88888",
    "dataExchangeIdText": null,
    "loadingDate": 1773207641907,
    "arrivalDate": null,
    "agentName": null,
    "representativeCode": null,
    "representativePerson": "深圳徐测试网络科技有限公司",
    "customsMaster": "0100",
    "consignmentList": [
      {
        "consignmentIndex": 1,
        "billNo": "T26031211381",
        "changeReasonCode": null,
        "reason": null,
        "contact": null,
        "phone": null,
        "conditionCode": null,
        "freightPaymentMethods": null,
        "cargoClearanceCode": "RD01",
        "transitDestination": null,
        "totalPackageQuantity": 10,
        "packingType": "BA",
        "grossVolumeMeasure": null,
        "totalGrossMeasure": 100,
        "cargoValue": 100,
        "amountType": null,
        "deconsolidator": null,
        "consigneeCode": null,
        "consigneeName": null,
        "consigneePhone": null,
        "consignorCode": null,
        "consignorName": null,
        "consignorPhone": null,
        "notifyCode": null,
        "notifyName": null,
        "notifyPhone": null,
        "dangercontactName": null,
        "dangercontactPhone": null,
        "consignmentCargoList": [],
        "consignmentContainerList": [],
        "consignmentCountryList": []
      }
    ]
  },
  "manifestType": "MT1401"
}

字段说明

RmftData 根节点字段

Manifest 表头字段

ManifestConsignment 提单字段

ManifestConsignmentCountry 途径国家列表信息

ManifestConsignmentCargo 商品项信息

ManifestConsignmentContainer 集装箱信息