保税仓商品通关注意事项

最新推荐文章于 2022-12-03 15:56:16 发布

lvqinglou

最新推荐文章于 2022-12-03 15:56:16 发布

阅读量2.7k

点赞数 1

本文链接：https://blog.csdn.net/lvqinglou/article/details/103758206

版权

前段时间因公司业务开展，需要支持保税商品的下单，在接触的过程中，发现这块断断续续做了有两个月，所以趁这个时间，把我踩到的坑全记录一下。

1.跨境商品简单介绍

目前跨境商品主要可分为两个途径，一是海外直邮，二是保税商品。

海外直邮是指由国外直接发快递到国内，优点是不需要在下单的时候做额外的工作量，流程简单，只要通知商家发货就可以。缺点是时间长（十天半个月都是很常见的）、邮费贵、有可能被海关直接拦截（小概率）。
国内保税仓发货，保税仓相当于一个商品的前置仓（一般是由第三方供应链提供的服务），要事先把海外商品先囤积到保税仓中，收到订单后，再由保税仓直接发货到用户手中，优点是发货送货速度快（海关不会卡）、商品来源有保障（商品进保税仓要备案登记的，用户放心）、运费便宜。缺点时既然要囤积商品就是滞销风险、流程要复杂的多。

2.保税仓前置条件

公司要在相应海关备案登记（登记也有一个坑，企业类型一定要选择电商平台，否则你是拿不到电商平台代码号的），并拿到放密钥的U盘（这个东西超级坑，只能windows系统用，所以还要准备一台windows机器用于调试），备案后，你会得到海关备案的编号和名称。
要准备一台稳定的windows机器插上海关给的U盘当做线上的服务器（用于线上订单加密使用），登录海关的商户页面什么之类的操作都需要用到加密U盘，所以事先要多申请几个。
推支付单时，现在第三方支付平台都提供了推送支付单的接口，比如我们使用的是支付宝支付，通过支付宝推送订单时，要额外申请推送支付单的功能

3.保税仓整体流程概述

国家海关为了能够更好的规范跨境商品的流程，所以在前几年的时候对这块进行了改革，保税仓的商品必须要通过三单合一（订单、物流单、支付单三单校验）才能发货，其中支付单可以用第三方支付平台接口推送，订单和物流单某些第三方供应链平台也会帮你一起推送到海关去，大大降低了开发成本，对于电商来说只要申请了电商平台的备案，接一下支付平台的报关接口、供应链的推送订单接口（物流单推送需要物流仓储的备案才能推，一般电商企业不需要关心这个）、海关实时数据接口即可。

4.推送支付单

我这里先以支付宝举例子（坑超级多，支付宝的接口是真的难对接，写的不详细）。
这个是支付宝的报关接口文档注意，只看这个就行了，还有另一个推送支付单的文档不需要管他。
报送支付单可以进行拆单报送，什么意思呢？比如用户购买了四件商品，花了100元，其中只有一件跨境商品A，价值30元。用户是一次性支付的，支付回调接口会返回一个支付单号paymentNo。但是你在推送支付单的时候，可以用同一paymentNo推送多个子支付单，用该支付单号只推30元的支付单也是可以的（只要每个子支付单推送的支付金额加起来不超过paymentNo的支付金额就可以，否则会返回错误）。
在推送结束时，把支付宝返回的相关数据最好也要记录一下，在后面推送订单信息的时候需要用到。
以下是支付宝推送支付单的主要代码

	/**
	 * @Description: 支付宝报关接口  文档地址https://docs.open.alipay.com/155/104778/
	 * @param tradeNo 支付宝交易号
 	 * @param orderNo 主订单号
	 * @return: void
	 * @Author: lvqiushi
	 * @Date: 2019-08-28
	 */
	private void alipayAcquireCustom(String tradeNo, String orderNo, String initResponse) {
		// 根据主订单号获取所有的子订单信息
		OrderDO orderInfo = this.getAllSubOrderByOrderNo(orderNo);

		// 如果订单为多个，则需要拆单
		Map<String, String> sParaTemp = new HashMap<>();
		sParaTemp.put("service", AcquireCustomConstants.ALIPAY_METHOD_NAME);
		sParaTemp.put("partner", AcquireCustomConstants.ALIPAY_PARTENER_ID);
		sParaTemp.put("_input_charset", AlipayConfig.CHARSET);
		sParaTemp.put("trade_no", tradeNo);
		sParaTemp.put("merchant_customs_code", AcquireCustomConstants.MERCHANT_CUSTOMS_CODE);
		sParaTemp.put("merchant_customs_name", AcquireCustomConstants.MERCHANT_CUSTOMS_NAME);
		sParaTemp.put("customs_place", AliPayCostomsCodeEnum.ZONGSHU.getCostsmsName());
		sParaTemp.put("buyer_name", orderInfo.getConsigneeName());
		sParaTemp.put("buyer_id_no", orderInfo.getIdentityCard());

		List<SubOrderVO> subOrderList = orderInfo.getSubOrderList();
		if (CollectionUtils.isEmpty(subOrderList)) {
			log.warn("推送支付单时，订单下无子订单数据");
			return;
		}
		
        // 获取子订单下保税商品的总支付金额，进行拆单报关
		Map<String, GrabaServiceImpl.SubOrderPrice> subOrderPriceMap = grabaService.getSubOrderPrice(orderInfo);
		for (SubOrderVO subOrder : subOrderList) {
		    // 判断子订单是否包含保税商品
			if (!this.judgeSubOrderContainBondItem(subOrder)) {
				continue;
			}

			GrabaServiceImpl.SubOrderPrice subOrderPrice = subOrderPriceMap.get(subOrder.getSubOrderDO().getSubOrderNo());
			if (null == subOrderPrice) {
				continue;
			}

			sParaTemp.put("out_request_no", this.genertedAcquireCustomNo());
			sParaTemp.put("is_split", "T");
			sParaTemp.put("sub_out_biz_no", subOrder.getSubOrderDO().getSubOrderNo());
			sParaTemp.put("amount", StringTool.priceFormatForNoFuhao(subOrderPrice.getPayAmount()));
			// 执行支付宝报关接口方法
			this.excuteAcquireRequest(sParaTemp, orderNo, subOrder.getSubOrderDO().getSubOrderNo(), initResponse);
		}
	}

其中我踩过的坑，
支付接口中的appId一定要为接口所传的合作伙伴id下的appId
out_request_no 报关流水号：自己按照规则生成就好，唯一标识符，没有业务含义
推送支付单直接推送总署就好，不需要推送到海关所在地，否则会导致海关接收不到推送的支付单。（杭州是这样，其他地方我没试过）

5.推送订单和物流单

我们公司目前没有自己的保税仓，用的是多拉供应链的保税仓。在对接多拉的时候，多拉提供了接口让我提交订单相关信息，我在下单完成后，调用多拉接口即可。
多拉那边会自动的帮我向海关推送物流单和订单信息，节省了对接成本（多拉记得打钱）

6.对接海关实时获取数据接口（超级超级坑）

海关现在有了新规定，跨境商品要对接他们的一个抓取订单信息接口，公告见6.4
先放上参考资料，我一开始对接的时候主要是看的这篇博客
先说一下步骤

如果我上面说的前置条件你准备好了，你现在手头上，就有一个windows机器和秘钥U盘了
检查卡介质是否正确，在windows电脑上，登录customs.chinaport.gov.cn 选择使用卡介质登录时会弹出下载控件选项。点击控件下载到本地，运行控件的exe后再进行登录，初始密码88888888。在下载别人提供的一个工具https://pan.baidu.com/s/1xo0AcZZ4QZDeAu2DHOEQjg 提取码: cfpp，把证书序列号和证书获取出来，用于注册接口。
为什么windows机器和加签U盘这么重要呢，因为海关为了数据安全性，对接接口的所有参数必须要经过加密（加密还用的是websocket = =），所以就必须要安装控件和插U盘。

先加微信公告上的两位微信好友，让他们拉你进微信群，微信群里每天发送注册接口所需要用的的资料。测试环境接口私聊他们添加（把电商平台代码、名称、接口路径、证书、证书编号发他就好），线上接口在电子口岸网站上自行注册
在这里插入图片描述
5. 之前提到过，加签掉的是加签服务期的websocket接口，这里先放一下我写的代码，以供参考

// 先定义几个接口请求的实体类

@Data
@JSONType(orders = { "sessionID", "payExchangeInfoHead", "payExchangeInfoLists", "serviceTime", "certNo", "signValue" })
public class HgCheckDTO {
	
	/** 证书编号  */
	private String certNo;

	/** 签名结果值  */
	private String signValue;

	/** 海关发起请求时，平台接收的会话ID  */
	private String sessionID;

	private Head179DTO payExchangeInfoHead;

	private List<Body179DTO> payExchangeInfoLists;

	/** 返回时的系统时间 时间戳的字符串 */
	private String serviceTime;

}

@Data
@JSONType(orders = { "guid", "initalRequest", "initalResponse", "ebpCode", "payCode", "payTransactionId", "totalAmount", "currency", "verDept", "payType", "tradingTime", "note" })
public class Head179DTO {
	/** 系统唯一序号  */
	private String guid;

	/** 支付原始请求  */
	private String initalRequest;

	/** 支付原始响应  */
	private String initalResponse;

	/** 电商平台代码  */
	private String ebpCode;

	/** 支付企业代码  */
	private String payCode;

	/** 交易流水号  */
	private String payTransactionId;

	/** 交易金额 单位：元 */
	private Double totalAmount;

	/** 币制  人民币：142 */
	private String currency;

	/** 验核机构  */
	private String verDept;

	/** 支付类型  */
	private String payType;

	/** 交易成功时间 */
	private String tradingTime;

	/** 备注  */
	private String note;

}

@Data
@JSONType(orders = { "orderNo", "goodsInfoDTO", "recpAccount", "recpCode", "recpName" })
public class Body179DTO {
	
	/** 订单编号  */
	private String orderNo;
	
	/** 商品信息  */
	private List<GoodsInfoDTO> goodsInfoDTO;
	
	/** 收款账号  */
	private String recpAccount;
	
	/** 收款企业代码  */
	private String recpCode;

	/** 收款企业名称  */
	private String recpName;
}

@Data
@JSONType(orders = { "gname", "itemLink" })
public class GoodsInfoDTO {
	
	/** 商品名称  */
	private String gname;
	
	/** 商品展示链接地址  */
	private String itemLink;
}

	/**
	 * @Description: 海关抓取数据接口
	 * @param openReq
	 * @return: java.util.Map<java.lang.String,java.lang.Object>
	 * @Author: lvqiushi
	 * @Date: 2019-09-26
	 */
	public Map<String, Object> doPlatDataOpen(@Param(value="openReq") String openReq) {
		/**
		 * 海关抓取数据流程
		 * 1.海关调用企业注册地址
		 * 2.异步查询原始订单数据，向海关指定的地址调用接口返回，必须要在两分钟内上传完毕
		 * 3.向海关返回"code", "10000" 告诉海关收到响应
		 */
		JSONObject object = JSONObject.parseObject(openReq);
		// 异步调用数据报送接口
		ThreadEventBusImpl.commonExecute.submit(new Runnable() {
			@Override
			public void run() {
				haiguanRepayService.repDataApply(object.getString("orderNo"), object.getString("sessionID"));
			}
		});
		
		/* 返回报文给海关 */
		Map<String, Object> result = new HashMap<>();
		result.put("code", "10000");
		result.put("message", "接收成功!");
		result.put("serviceTime", System.currentTimeMillis());
		return result;
	}

	/**
	 * @Description: 向海关返回原始订单数据接口
	 * @param orderNo
	 * @param sessionID
	 * @return: java.lang.String
	 * @Author: lvqiushi
	 * @Date: 2019-09-23
	 */
	public String repDataApply(String orderNo, String sessionID) {
		// 只有线上环境才会进行支付单报关，因为支付宝的报关接口没有测试环境
		if (!"online".equals(PropertyService.CURRENT_PROFILE)) {
			return "";
		}

		HgCheckDTO entity;
		try {
			entity = this.getHaiguanOrginData(orderNo, sessionID);
		} catch (Exception e) {
			log.error("", e);
			return null;
		}

		CountDownLatch waitSignLock = new CountDownLatch(1);
		/*加签成海关指定数据格式(4项:不能多不能少)*/
		StringBuffer sb = new StringBuffer();
		sb.append("\"sessionID\":\"").append(entity.getSessionID()).append("\"").append("||");
		String headerString = JSON.toJSONString(entity.getPayExchangeInfoHead(), SerializerFeature.SortField);
		sb.append("\"payExchangeInfoHead\":\"").append(headerString).append("\"").append("||");
		String listString = JSON.toJSONString(entity.getPayExchangeInfoLists(), SerializerFeature.SortField);
		sb.append("\"payExchangeInfoLists\":\"").append(listString).append("\"").append("||");
		sb.append("\"serviceTime\":\"").append(entity.getServiceTime()).append("\"");
		String signValue = sb.toString();

		ThreadEventBusImpl.commonExecute.submit(new Runnable() {
			@Override
			public void run() {
				Map<String,String> args = new java.util.HashMap<>();
				args.put("inData", signValue);
				args.put("passwd", password);
				JSONObject epdata = new JSONObject(true);
				epdata.put("_method", "cus-sec_SpcSignDataAsPEM");
				epdata.put("_id", 1);
				epdata.put("args", args);
				haiguanSign.sign(epdata.toJSONString(), new Sign179Callback() {
					@Override
					public void signReply(String reply) {
						if (!StringUtils.isEmpty(reply)) {
							log.info("-----sessionId:{}, sign:{}", entity.getSessionID(), reply);
							entity.setCertNo(certNo);
							entity.setSignValue(reply);
							waitSignLock.countDown();
						}
					}
				});
			}
		});

		ThreadEventBusImpl.commonExecute.submit(new Runnable() {
			@Override
			public void run() {
				try {
					// 如果加签30秒都没有成功，则失败打印日志，目的是为了防止死锁。
					if(!waitSignLock.await(30, TimeUnit.SECONDS)) {
						log.error("海关抓取数据接口，等待加签超时 orderNo = " + orderNo);
						return;
					}

					if (StringUtils.isEmpty(entity.getSignValue())) {
						log.error("未获得加签结果，向海关返回数据失败");
						return ;
					}

					String returnOrderParams = JSON.toJSONString(entity, SerializerFeature.SortField);
					String encode = URLEncoder.encode(returnOrderParams, "UTF-8");
					OkHttpClient client = new OkHttpClient();
					MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
					RequestBody body = RequestBody.create(mediaType, "payExInfoStr=" + encode);
					Request request = new Request.Builder()
							.url(uploadUrl)
							.post(body)
							.addHeader("Content-Type", "application/x-www-form-urlencoded")
							.build();

					Response response = client.newCall(request).execute();
					log.info("海关数据上报返回结果 " + response.body().string());
				} catch (InterruptedException e) {
					log.error("", e)
				} catch (IOException e) {
					log.error("", e)
				} catch (Exception e) {
					log.error("", e)
				}
			}
		});
		
		return null;
	}

lvqinglou

关注

1
点赞
踩
6

收藏

觉得还不错? 一键收藏
4
评论
保税仓商品通关注意事项

前段时间因公司业务开展，需要支持保税商品的下单，在接触的过程中，发现这块断断续续做了有两个月，所以趁这个时间，把我踩到的坑全记录一下。1.跨境商品简单介绍目前跨境商品主要可分为两个途径，一是海外直邮，二是保税商品。海外直邮是指由国外直接发快递到国内，优点是不需要在下单的时候做额外的工作量，流程简单，只要通知商家发货就可以。缺点是时间长（十天半个月都是很常见的）、邮费贵、有可能被海关直接...
复制链接

扫一扫