EM CLOSE接口

发送CLOSE&取消CLOSE接口

发送CLOSE请求地址

POST https://beta-callback.hgj.com/ingress-ng/aci/openapi/em/close
Content-Type: application/json
Access-Token: f6645125abaa4e0ab12d1b638843ff5b
Timestamp: 1592364092493
Nonce: 1592364092493
Sign: d72bfe24c25f0d19dc8e8df81b10798e
Staff: 18036094790

{
  "fullHouseBillNo": "8FN0YYLFSE0000001",
  "actionReason": "20"
}

提示

关联提单中存在已到港，修改原因必填
关联提单中存在HBL已提交的, 不能发送CLOSE
关联提单中存在CLOSE已提交的, 不能发送CLOSE

发送CLOSE请求参数说明

API接口会对参数进行校验, 用户系统可以提前对调用参数进行校验, 防止被API接口校验拦截.

属性	类型	必填	说明	校验规则
fullHouseBillNo	string	是	货代提单号（HBL）,示例值(8FN0YYLFSE0000001)	格式 货代四字码 + 货代提单号
actionReason	string	是	修改原因，关联提单中存在已到港，修改原因必填	参考修改原因列表

取消CLOSE请求地址

POST https://beta-callback.hgj.com/ingress-ng/aci/openapi/em/unclose
Content-Type: application/json
Access-Token: f6645125abaa4e0ab12d1b638843ff5b
Timestamp: 1592364092493
Nonce: 1592364092493
Sign: d72bfe24c25f0d19dc8e8df81b10798e
Staff: 18036094790

{
  "fullHouseBillNo": "8FN0YYLFSE0000001"
}

提示

上层提单已到港 不能取消CLOSE
关联提单中存在HBL已提交的, 不能取消CLOSE
关联提单中存在CLOSE已提交的, 不能取消CLOSE
关联提单中不存在CLOSE已完成的, 不能取消CLOSE

取消CLOSE请求参数说明

API接口会对参数进行校验, 用户系统可以提前对调用参数进行校验, 防止被API接口校验拦截.

属性	类型	必填	说明	校验规则
fullHouseBillNo	string	是	货代提单号（HBL）,示例值(8FN0YYLFSE0000001)	格式 货代四字码 + 货代提单号

返回数据示例

正常返回 Http状态码200

错误时返回 (令牌有误)

{
  "httpStatus": 400,
  "message": "The token is invalid"
}

错误时返回 (参数有误)

{
 {
  "httpStatus": 400,
  "message": "关联提单中存在已到港，修改原因必填"
}
}