中国电子口岸（海口海关）报文加签API文档

x-auth-token-eport-sign

string

true

客户端加签时携带的请求头，token值必须和配置文件里面配置鉴权token相等

message

string

返回消息

-

success

boolean

是否成功

-

timestamp

string

响应时间戳

-

code

int32

状态码

-

data

object

响应数据

-

└─success

boolean

本次加签是否成功

-

└─certNo

string

签名的ukey的卡序列号

-

└─x509Certificate

string

签名的ukey证书

-

└─digestValue

string

XML报文的数字摘要

-

└─signatureValue

string

调用ukey获取的签名值

-

└─signatureNode

string

XML报文的签名节点

-

x-auth-token-eport-sign

string

true

客户端加签时携带的请求头，token值必须和配置文件里面配置鉴权token相等

message

string

返回消息

-

success

boolean

是否成功

-

timestamp

string

响应时间戳

-

code

int32

状态码

-

data

object

响应数据

-

└─success

boolean

本次加签是否成功

-

└─certNo

string

签名的ukey的卡序列号

-

└─x509Certificate

string

签名的ukey证书

-

└─digestValue

string

XML报文的数字摘要

-

└─signatureValue

string

调用ukey获取的签名值

-

└─signatureNode

string

XML报文的签名节点

-

x-auth-token-eport-sign

string

true

客户端加签时携带的请求头，token值必须和配置文件里面配置鉴权token相等

cmd

string

true

No comments found.

x-auth-token-eport-sign

string

true

客户端加签时携带的请求头，token值必须和配置文件里面配置鉴权token相等

message

string

返回消息

-

success

boolean

是否成功

-

timestamp

string

响应时间戳

-

code

int32

状态码

-

data

object

响应数据

-

└─stdOutList

array

标准输出流信息

-

└─errorOutList

array

错误输出流信息

-

x-auth-token-eport-sign

string

true

客户端加签时携带的请求头，token值必须和配置文件里面配置鉴权token相等

messageType

enum

true

消息类型
[Enum values:
CEB311Message("CEB311Message")
CEB621Message("CEB621Message")
]

dataType

enum

true

报文的数据类型
[Enum values:
JSON()
XML()
]

cebMessage

object

true

进口单、出口单的底层数据模型

以CEB311Message数据类型为例

• JSON示例

  
  {"order":{"orderHead":{"guid":"AFNC7T-WEASLEY-20230713095517-N04JEE","appType":"1","appTime":"20230704181028","appStatus":"2","orderType":"I","orderNo":"T_C5051511332138160010","ebpCode":"4601630004","ebpName":"海南省荣誉进出口贸易有限公司","ebcCode":"4601630004","ebcName":"海南省荣誉进出口贸易有限公司","goodsValue":"0.01","freight":"0","discount":"0","taxTotal":"0","acturalPaid":"0.01","currency":"142","buyerRegNo":"4","buyerName":"袁晓雨","buyerTelephone":"13701727375","buyerIdType":"1","buyerIdNumber":"130435200009241538","consignee":"袁晓雨","consigneeTelephone":"13701727375","consigneeAddress":"北京北京市东城区","note":"test"},"orderList":[{"gnum":1,"itemNo":"1","itemName":"LANNA兰纳","gmodel":"10片/包","itemDescribe":"","barCode":"1","unit":"011","qty":"1","price":"1","totalPrice":"1","currency":"142","country":"136","note":"test"}]},"guid":"AFNC7T-WEASLEY-20230713095517-N04JEE","version":"1.0","baseTransfer":{"copCode":"4601630004","copName":"海南省荣誉进出口贸易有限公司","dxpMode":"DXP","dxpId":"DXPENT0000530815","note":"test"}}
  

• XML示例: 不带ds:Signature节点的CEBXxxMessage.xml原文;待加签xml报文样例

message

string

返回消息

-

success

boolean

是否成功

-

timestamp

string

响应时间戳

-

code

int32

状态码

-

data

object

响应数据

-

└─payload

object

请求数据载荷

-

     └─Message

object

No comments found.

-

          └─MessageHead

object

No comments found.

-

               └─MessageId

string

No comments found.

-

               └─MessageType

string

No comments found.

-

               └─SenderID

string

No comments found.

-

               └─ReceiverID

string

No comments found.

-

               └─SendTime

string

No comments found.

-

               └─Version

string

No comments found.

-

          └─MessageBody

object

No comments found.

-

               └─data

string

No comments found.

-

└─original

string

三方原始返回

-

└─expected

string

三方期望返回

-

x-auth-token-eport-sign

string

true

客户端加签时携带的请求头，token值必须和配置文件里面配置鉴权token相等

sessionID

string

true

海关发起请求时，平台接收的会话ID

payExchangeInfoHead

object

true

支付原始数据表头

└─guid

string

false

系统唯一序号

└─initalRequest

string

false

原始请求

└─initalResponse

string

false

原始响应

└─ebpCode

string

false

电商平台代码

└─payCode

string

false

支付企业代码

└─payTransactionId

string

false

交易流水号(支付报关时会有返回) 微信对应的字段是:verify_department_trade_id 支付宝对应的字段是:pay_transaction_id

└─totalAmount

double

false

交易金额

└─currency

string

false

币制(币制编码:142(人民币))

└─verDept

string

false

验核机构(支付报关结果会返回),1-银联 2-网联 3-其他 微信返回的字段是:verify_department 支付宝对应的字段是:ver_dept

└─payType

string

false

支付类型

└─tradingTime

string

false

交易成功时间

└─note

string

false

备注

payExchangeInfoLists

array

true

支付原始数据表体

└─orderNo

string

false

订单编号

└─goodsInfo

array

false

商品信息

     └─gname

string

false

商品名称

     └─itemLink

string

false

商品展示链接地址

└─recpAccount

string

false

收款账号

└─recpCode

string

false

收款企业代码

└─recpName

string

false

收款企业名称

serviceTime

string

true

返回时的系统时间

message

string

返回消息

-

success

boolean

是否成功

-

timestamp

string

响应时间戳

-

code

int32

状态码

-

data

object

响应数据

-

└─payload

object

请求数据载荷

-

     └─mapKey

object

A map key.

-

          └─any object

object

any object.

-

└─original

string

三方原始返回

-

└─expected

object

三方期望返回

-

     └─code

string

No comments found.

-

     └─total

int64

No comments found.

-

     └─message

string

No comments found.

-

     └─serviceTime

int64

No comments found.

-

x-auth-token-eport-sign

string

true

客户端加签时携带的请求头，token值必须和配置文件里面配置鉴权token相等

x-auth-token-eport-sign

string

true

客户端加签时携带的请求头，token值必须和配置文件里面配置鉴权token相等

id

int32

false

唯一id, 用来区分是哪一次发送的消息，默认值=1，从1开始，{@code int} 最大, 2³¹-1.

data

string

true

加签源数据

支持的加签数据类型
• 1. 不带ds:Signature节点的CEBXxxMessage.xml原文;待加签xml报文样例
• 2. 海关179加签数据; 数据格式请传符合「海关179数据规范」的标准字符串,入参示例:

  "sessionID":"ad2254-8hewyf32-55616249"||"payExchangeInfoHead":"{"guid":"9D55BA71-22DE-41F4-8B50-C36C83B3B530","initalRequest":"原始请求","initalResponse":"ok","ebpCode":"4404840022","payCode":"312226T001","payTransactionId":"2018121222001354081010726129","totalAmount":100,"currency":"142","verDept":"3","payType":"1","tradingTime":"20181212041803","note":"批量订单，测试订单优化,生成多个so订单"}"||"payExchangeInfoLists":"[{"orderNo":"SO1710301150602574003","goodsInfo":[{"gname":"lhy-gnsku3","itemLink":"http://m.yunjiweidian.com/yunjibuyer/static/vue-buyer/idc/index.html#/detail?itemId=999761&shopId=453"},{"gname":"lhy-gnsku2","itemLink":"http://m.yunjiweidian.com/yunjibuyer/static/vue-buyer/idc/index.html#/detail?itemId=999760&shopId=453"}],"recpAccount":"OSA571908863132601","recpCode":"","recpName":"YUNJIHONGKONGLIMITED"}]"||"serviceTime":"1544519952469"

message

string

返回消息

-

success

boolean

是否成功

-

timestamp

string

响应时间戳

-

code

int32

状态码

-

data

object

响应数据

-

└─success

boolean

本次加签是否成功

-

└─certNo

string

签名的ukey的卡序列号

-

└─x509Certificate

string

签名的ukey证书

-

└─digestValue

string

XML报文的数字摘要

-

└─signatureValue

string

调用ukey获取的签名值

-

└─signatureNode

string

XML报文的签名节点

-