# EM回执

EM发送后,系统会把发送结果发送给API用户,用户需要接收处理,并返回应答.

用户系统需要提供接口来接收回执消息, 请提供测试版和正式版交由我方开发人员配置

EM 接收成功回调:

POST http://xxx.xxx/xxx
Content-Type: application/json
Timestamp: 1592534449848
Nonce: 1267005109107130370
Sign: b66b1bd624c00d309fb741b72de1f6b7

{
"enterpriseName": "XXXX",
"houseBillType": "EM",
"fullMasterBillNo":"MASTERBILLNO",
"fullHouseBillNo": "OPENAPI",
"messageType": "Acknowledgement",
"receiveDate": "2021-04-25 19:27:38"
"messageStatus": "ACCEPTED"
}

EM 接收失败回调:

POST http://xxx.xxx/xxx
Content-Type: application/json
Timestamp: 1592534449848
Nonce: 1267005109107130370
Sign: b66b1bd624c00d309fb741b72de1f6b7

{
"enterpriseName": "XXXX",
"houseBillType": "EM",
"fullMasterBillNo":"MASTERBILLNO",
"fullHouseBillNo": "HOUSEBILLNO",
"messageType": "Acknowledgement",
"receiveDate": "2021-04-25 19:27:38"
"messageStatus": "REJECTED"
"errorDescription": "Warehouse office is not associated with Port of Destination",
"ackBadData":,"3891",
"ackRelevantField","Warehouse Office"
}

EM 下层匹配状态回调:

POST http://xxx.xxx/xxx
Content-Type: application/json
Timestamp: 1592534449848
Nonce: 1267005109107130370
Sign: b66b1bd624c00d309fb741b72de1f6b7

{
"enterpriseName": "XXXX",
"houseBillType": "EM",
"fullMasterBillNo":"MASTERBILLNO",
"fullHouseBillNo": "HOUSEBILLNO",
"messageType": "Disposition",
"receiveDate": "2021-04-25 19:27:38"
"emNextMatchingStatus":"Cargo Complete",
"emNextMatchingStatusDesc":"Indicates that a non-consolidated primary cargo document has been transmitted to the CBSA and ACCEPTED. If consolidated, it indicates that all of the related secondary cargo (i.e. House Bills) is transmitted as well."
}

上层匹配状态回调:

POST http://xxx.xxx/xxx
Content-Type: application/json
Timestamp: 1592534449848
Nonce: 1267005109107130370
Sign: b66b1bd624c00d309fb741b72de1f6b7

{
"enterpriseName": "XXXX",
"houseBillType": "EM",
"fullMasterBillNo":"MASTERBILLNO",
"fullHouseBillNo": "HOUSEBILLNO",
"messageType": "Disposition",
"receiveDate": "2021-04-25 19:27:38"
"emPreviousMatchingStatus":"Matched",
"emPreviousMatchingStatusDesc":"Indicates that a specific trade document is linked to all of its directly related trade documents."
}

EM 到港状态回调:

POST http://xxx.xxx/xxx
Content-Type: application/json
Timestamp: 1592534449848
Nonce: 1267005109107130370
Sign: b66b1bd624c00d309fb741b72de1f6b7

{
"enterpriseName": "XXXX",
"houseBillType": "EM",
"fullMasterBillNo":"MASTERBILLNO",
"fullHouseBillNo": "HOUSEBILLNO",
"messageType": "Disposition",
"receiveDate": "2021-04-25 19:27:38",
"emOtherStatus":"Arrived",
"emOtherStatusDesc":"Informs clients that their cargo has arrived at its Port of Destination."
}

# 参数解释

属性 类型 说明
enterpriseName string 企业名称
houseBillType string house申报类型 取值 {EM,ACI}
fullMasterBillNo string 船东提单号(MBL),示例值(9066NZ714464001)
fullHouseBillNo string 货代提单号(HBL),示例值(8FN0YYLFSE0000001)
messageType string 消息类型,Acknowledgement代表申报状态;Disposition代表匹配状态
receiveDate string 接收回执日期
messageStatus string ACCEPTED代表接收成功,REJECTED代表接收失败
errorDescription string 异常描述,只有messageStatus是REJECTED才有值
ackBadData string 异常字段值,只有messageStatus是REJECTED才有值
ackRelevantField string 异常字段名称,只有messageStatus是REJECTED才有值
emNextMatchingStatus string EM 下层匹配状态
emNextMatchingStatusDesc string EM 下层匹配状态描述
emPreviousMatchingStatus string EM 上层匹配状态
emPreviousMatchingStatusDesc string EM 上层匹配状态描述
emOtherStatus string EM 到港状态
emOtherStatusDesc string EM 到港状态描述