海关申报提交
[!TIP|style:flat]
注意：
1.每个订单只能有一条非拆单数据和多条拆单数据，拆单数据中 sub_order_no (商户子订单号)相同时将会视为同一条数据。
2.如需修改报关信息，action_type 类型请传 MODIFY, 修改只能对商户备案号、备案名称、海关编码和金额、用户证件信息做修改,如果为拆单数据，则需传递 sub_order_no 来对应修改数据。
3.如果某笔交易已请求报送海关，但电子口岸丢单，可以使用重推接口, 重推时，需要保持报关流水号和原始请求一致。
API URL：https://mapi.yabandpay.com/Payments
Method：POST
POST data type：Json
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| user | String | 收银员账号的UID | 必填 |
| sign | String | 签名 | 必填 |
| method | String | v3.CustomDeclareOrder | 必填 |
| time | Long | 时间戳 | 必填 |
- 参数
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| trade_id | String | YabandPay交易ID | 必填 |
| customs | String | 海关名称 | 必填 |
| mch_customs_no | String | 商户海关备案号 | 必填 |
| mch_name | String | 商户海关备案名称 | 必填 |
| duty | Int | 关税，单位(分)，不会提交给海关 | 选填 |
| action_type | String | 报关类型,ADD 新增 MODIFY 修改，默认ADD 新增 | 选填 |
| sub_order_no | String | 商户子订单号 | 选填(拆单时必传) |
| order_fee | Int | 应付金额，已修改为 结算币种金额（Settlement Amount）， 单位(分)，不能超过原订单金额，order_fee=transport_fee+product_fee | 选填(拆单时必传) |
| transport_fee | Int | 物流费，已修改为 结算币种金额（Settlement Amount），单位(分) | 选填(拆单时必传) |
| product_fee | Int | 商品价格，已修改为 结算币种金额（Settlement Amount），单位(分) | 选填(拆单时必传) |
| cert_type | String | 证件类型,请传固定值IDCARD,暂只支持大陆身份证 | 选填 |
| cert_id | String | 证件号码,用户大陆身份证号，尾号为字母X的身份证号，请大写字母X | 选填 |
| name | String | 用户姓名 | 选填 |
customs字段如下：
GUANGZHOU_ZS 广州（总署版）
GUANGZHOU_HP_GJ 广州黄埔国检
GUANGZHOU_NS_GJ 广州南沙国检
HANGZHOU_ZS 杭州（总署版）
NINGBO 宁波
ZHENGZHOU_BS 郑州（保税物流中心）
CHONGQING 重庆
SHANGHAI_ZS 上海（总署版）
SHENZHEN 深圳
ZHENGZHOU_ZH_ZS 郑州综保（总署版）
TIANJIN 天津（需要推送订单至天津海关时，需要在商户管理后台同时配置天津海关备案信息与天津国检备案信息；调用报关接口时只需推送天津海关，即请求一次报关接口。)
签名示例：
拼接为URL方式并排序后的字符串
"customs=NINGBO&mch_customs_no=3302462090&mch_name=宁波保税区嘉里大通物流有限公司&method=v3.CustomDeclareOrder&time=1560499094&trade_id=4760a968-4c5d-1e7e-3b88-89641af6e041&user=016683"
得到的 stringA 使用 secret_key做签名
得到的签名如下：
"0c4f56b21229ec6212c83d936154954a71bbd5c8b5d2c94a231928e9903632dd"
提交示例：
{
"user": "016683",
"sign": "0c4f56b21229ec6212c83d936154954a71bbd5c8b5d2c94a231928e9903632dd",
"method": "v3.CustomDeclareOrder",
"time": 1560499094,
"data": {
"trade_id": "4760a968-4c5d-1e7e-3b88-89641af6e041",
"customs": "NINGBO",
"mch_customs_no": "3302462090",
"mch_name": "宁波保税区嘉里大通物流有限公司"
}
}
返回示例：
{
"status": true,
"code": "200",
"data": {
"return_code":"SUCCESS",
"return_msg":"成功",
"sign":"B5655009514B44C0F06EFB3D859EB53B",
"appid":"wx8888888888888888",
"mch_id":"8888888888",
"result_code":"SUCCESS",
"err_code":"0",
"err_code_des":"OK",
"state":"UNDECLARED",
"transaction_id":"4200000827202010243639059397",
"out_trade_no":"95be9c4257e14714a676be9a312e5bfc",
"modify_time":"20201116155617",
"cert_check_result":"UNCHECKED", //订购人和支付人身份信息校验结果(UNCHECKED 商户未上传订购人身份信息 SAME 商户上传的订购人身份信息与支付人身份信息一致 DIFFERENT 商户上传的订购人身份信息与支付人身份信息不一致)
"verify_department":"NETSUNION",
"verify_department_trade_id":"2020102421250683240722310310908"
},
"message": ""
}
State状态如下：
| 状态 | 描述 |
|---|---|
| UNDECLARED | 未申报 （该状态表示已提交报关,等待海关处理中,无需再次提交） |
| SUBMITTED | 申报已提交（订单已经送海关，商户重新申报，并且海关还有修改接口，那么记录的状态会是这个） |
| PROCESSING | 申报中 |
| SUCCESS | 申报成功 |
| FAIL | 申报失败 |
| EXCEPT | 海关接口异常 |