公用接口-报关订单查询

接口描述

使用报关订单号获取合利宝系统相关订单信息

基本信息

测试请求地址 https://cbtrxtest.helipay.com/cbtrx/rest/applyCustoms/query
请求地址 https://cbptrx.helipay.com/cbtrx/rest/applyCustoms/query
提交方式 采用POST方法提交,requestbody传值 Content-Type=[application/json;charset=UTF-8]
签名算法 UTF-8字符编码 SHA256签名 AES加密

请求参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) APPLYCUSTOMS 对应的产品编码
商户订单号 orderNo String(64) p_20170302185347 商户订单号
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号

响应参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) APPLYCUSTOMS
商户订单号 orderNo String(64) p_20170302185347 原交易订单号
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号
支付产品编码 payProductCode String(20) ALIPAYSCAN 商户请求[网银,快捷,扫码,会员支付等接口]的 productCode 字段
原始订单号 payOrderNo String(64) p_20170202185447 商户请求[网银,快捷,扫码,会员支付等接口]的 orderNo 字段
响应码 errorCode String(10) 0000 0000 代表请求成功
响应信息 errorMessage String(200) 成功 响应信息 错误信息
响应时间 current String(20) 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss
报关明细 detailList List 详见下面说明 不同的海关国检的情况

报关明细(海关通道和国检通道的组合不能重复)

名称 参数 类型 必填 示例值 说明
海关通道 customsType String(20) GUANGZHOU
国检通道 inspectionType String(20)
平台流水号 serialNumber String(32) 201702241400010002 合利宝-跨境系统生成的唯一交易流水号
下单时间 createDate String(20) 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss
完成时间 finishDate String(20) 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss
订单状态 orderStatus String(20) INIT INIT: 待报送(实名认证及扣费成功); FAIL: 失败(实名认证失败); CUSTOMSSEND: 海关已报国检无须报; CUSSENDINSNO: 海关已报国检待报; CUSSENDINSSEND: 海关已报国检已报; PUSHAPPLYBLOCK: 风控阻断; CANCELED: 取消;
支付金额 orderAmount Number(10.2) 125.00 单位:元
折扣金额 discountAmount Number(10.2) 0.98 单位:元
支付货款 goodsAmount Number(10.2) 100.00 单位:元
支付运费 freight Number(10.2) 20.00 单位:元
支付税款 tax Number(10.2) 5.00 单位:元
拆单支付单号 splitPaySerialNumber String(64)
排序参数 index Integer 1

代码示例

        @Test
        public void queryApplyCustomsOrder() {
        RemoteServiceImpl remoteService = new RemoteServiceImpl();
        HeliRequest heliRequest =
        remoteService.postRemoteInvoke(LoadPropertiesUtils.getProperty("applyCustomsQueryUrl"), installDto(),
        HeliRequest.class);
        ResponseBase form = decode(heliRequest, ResponseBase.class, heliRequest.getProductCode(),
        heliRequest.getMerchantNo());
        logger.info("#####解密后的内容为{}", form.toString());
        }

        public static String installDto() {
        BaseDTO baseDTO = new BaseDTO();
        baseDTO.setProductCode(ProductEnumType.APPLYCUSTOMS.name());
        baseDTO.setMerchantNo("");
        baseDTO.setOrderNo("");

        return JSONObject.toJSONString(encodeAndSign(baseDTO, baseDTO.getProductCode(), baseDTO.getMerchantNo()));
        }
        

        

        

错误码

错误码 错误码描述 解决方案

接口描述

使用报关订单号重推报关

基本信息

测试请求地址 https://cbtrxtest.helipay.com/cbtrx/rest/applyCustoms/retransmission
请求地址 https://cbptrx.helipay.com/cbtrx/rest/applyCustoms/retransmission
提交方式 采用POST方法提交,requestbody传值 Content-Type=[application/json;charset=UTF-8]
签名算法 UTF-8字符编码 SHA256签名 AES加密

请求参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) APPLYCUSTOMS 对应的产品编码
商户订单号 orderNo String(64) p_20170302185347 原交易订单号
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号
口岸 customsType String(64) 口岸NINGBO、GUANGZHOUHP

响应参数

名称 参数 类型 必填 示例值 说明
产品编码 productCode String(20) APPLYCUSTOMS
商户订单号 orderNo String(64) p_20170302185347 原交易订单号
商户编号 merchantNo String(10) Me10000002 合利宝-跨境系统分配的商户编号
响应码 errorCode String(10) 0000 0000 代表请求成功
响应信息 errorMessage String(200) 成功 响应信息 错误信息
响应时间 current String(20) 2018-04-01 12:00:00 格式yyyy-MM-dd HH:mm:ss

代码示例

错误码

错误码 错误码描述 解决方案