對接流程
1.同步接收,異步上報;
2.寫接口地址, 審核地址, 2分鍾內上報,部署好服務自動運行
>>前置工作:
1.保存原始支付請求,支付響應
2.開發商品預覽頁
3.支付報關
4.開發接收接口
5.開發加簽客戶端程序
6.開發上報程序
權限問題
1.我的頁面怎么沒有服務注冊管理?
1)需要用法人卡登錄
2)入口不對, 海關互聯網+ 登錄標准入口: http://ceb1.chinaport.gov.cn 點擊 跨境電商進口統一版 進入
3)沒有電商企業和電商平台的資質, 自己查詢, 查詢地址 http://credit.customs.gov.cn/ ,如果沒有,則需要辦理
2.沒有電商企業和電商平台資質怎么辦理?
1).線上申請,已經辦理好海關備案登記，取得電子口岸卡的企業，可登陸 辦卡海關所屬地單一窗口網站, 要用卡介質登錄
進入 企業資質 > 企業注冊登記 > 注冊信息變更申請 頁面，在跨境電子商務企業類型一欄 , 勾選 "電子商務企業"、"電子商務交易平台" 兩個選項，進行線上備案申請
2)現場審核,打電話(95198或12360)咨詢需要要什么資料,然后到你海關的企業管理科去做現場審核
注冊問題
>>注冊地址:
http://ceb1.chinaport.gov.cn/ 點進口版
1.注冊頁面需要填哪些信息?
a),證書編號, 如果有字母,要轉換為小寫,
b),證書,要用標准的證書, http://wyb.qdhuaxun.cn/179/other/cert.php 用這個網址導出
c),審核訂單編號(隨便填一個), 聯系人, 聯系方式
d),服務地址, 自己編寫的接收海關查詢的接口
2.證書注冊欄,點擊上傳證書按鈕,如果提示"操作失敗"?
a.互聯網+入口地址不對,看群公告最新登錄地址
b.清理瀏覽區緩存試下
c.不要用360瀏覽器,用谷歌瀏覽器試試,最大的原因是入口不對
3.為什么我的注冊頁面里, 電商平台代碼和電商平台名稱是空的?
沒有電商企業和電商平台的資質, 自己查詢, 查詢地址 http://credit.customs.gov.cn/ ,如果沒有,則需要辦理
4.注冊頁面里 ,平台代碼 或平台名稱與最新的不一致?
要到海關辦卡部門變更,同步成最新的
5.證書怎么獲取?
http://wyb.qdhuaxun.cn/179/other/cert.php
6.建行共享盾證書獲取失敗?
http://wyb.qdhuaxun.cn/179/other/cert.php
審核問題
1.查詢接口寫好了,如何知道能否通過審核?
可以使用 http://wyb.qdhuaxun.cn/179/zhongji.php#step1進行模擬查詢
2.服務接口寫好了, 怎么讓管理員審核?
群里按照此格式發審核請求:
電商平台代碼：**** ,麻煩審核一下,@鑫² º ² º
3. 服務地址為何審核沒通過?
1).端口不是80,不能加端口號, 不能是https,
2)網址前后有空格;
3)接口未返回正確信息,企業返回的不是:{“code”:“10000”,“message”:"",“serviceTime”:1567050097628}
4)http跳轉到https了, 301
5)useragent攔截了
4.一直沒給審核怎么辦?
可能是沒看到,多發幾次!
5.請求企業地址失敗:查詢無訂單號 null 這個是什么原因呢?
注冊頁面第二項, 審核訂單號,填一下就好了,這個訂單號隨便填
只要你填的訂單號,能返回{"code":"10000","message":"","serviceTime":1567050097628}就可以了,
所填訂單號要在http://wyb.qdhuaxun.cn/179/zhongji.php#step1 模擬查詢,能返回通過便可
取值問題
1,收款企業名稱recpName字段
取值問題, 收款企業名稱
2,收款賬號recpAccount字段
企業收款的銀行卡號
3.商品展示網址itemLink字段
單獨做一個web頁面，app不可以，小程序不可以，樣式無特別要求，顯示商品圖片，名稱，售價等便可
4.其他參數
https://blog.csdn.net/alexyu01/article/details/103611872
5.支付報關參數怎么獲取?
>微信報關接口: https://pay.weixin.qq.com/wiki/doc/api/external/declarecustom.php?chapter=18_1
>支付寶報關接口: https://opendocs.alipay.com/open/155/104778/
>報關詳解: https://blog.csdn.net/alexyu01/article/details/103585812
加簽問題
1.加簽需要在本地搞台服務器嗎?
因為上報的報文需要用ukey加簽, 而且驅動只能在window上運行
2.放雲服務器上不行嗎?
不建議,麻煩
3.加簽服務器要一直開着?
最好是,因為是抽查,不過一般是在上班時間, 在清單發送后這個節點
4.加簽方案用什么好?
usbkey的話
通過websocket服務器,wss: 61231,ws: 61232,加簽
通過調用dll方式加簽,效率高一些,穩定性好一些
加簽的內容是179獨有的格式字符串,海關對接會給例子,參照例子來就行,不同於其他總署報文的加簽內容
公服就是通過公服的接口加簽,雲加簽
用輪詢,掃描服務器的好,不要用什么固定ip,內網穿透這種的
5.其他問題
1).usbkey是硬件加簽,windows驅動,這個無論如何是繞不開的
所以想放到linux上去的,是不現實的
2).放在遠程服務器機房可不可以?
當然可以,但是維護起來麻煩,如果usbkey卡死了,還得找人重新拔插
3).我見過的幾種實現方式?
有ws內網穿透的,有usb虛擬接口的,但要么是使用和維護成本太高,要么是技術難度有點大
要么是安全性不行,目前輪詢是一個即經濟有便利的實現方式
4).對本地服務器有何要求?
對機器本身沒有太高要求,但是網絡要穩定
機器的話,windowxp的都一樣用
5).加簽實現方式
有用瀏覽器+js的,有用go的,有用java的,有用php的,有用c#的,有用python的
各有優劣吧,但是感覺還是比較復雜,需要配置計划任務
上報問題
1.上報數據時,如果報"驗簽失敗"
a.原文不匹配(注意格式 字段順序 二級字段順序 必須和固定格式一致 表頭表體和時間的value必須添加雙引號 totalAmount不帶引號)
b.證書問題(證書如果帶-----BEGIN CERTIFICATE與-----END CERTIFICATE獨占一行 別跟在后面，影響驗簽結果。)
c.加簽方式不對(js加簽如果證書原文沒問題一定可以過，不可以用法人卡要用操作員卡）
2.上報數據時,如果提示"簽名驗證根證書失敗"?
a.請檢查證書是否完整,有的沒有復制完整
b.證書格式是否標准
c.證書是否已過期,有這樣的
3.接口正式上報地址是什么?
https://customs.chinaport.gov.cn/ceb2grab/grab/realTimeDataUpload
4.還有沒有測試聯調地址了?
沒有了,用正式地址測
5.{“code”:“20004”,“message”:“企業實時數據獲取驗簽證書未在服務系統注冊”,“total”:0,“serviceTime”:1500000000000}
1)檢查證書編號是否已填寫, 檢查證書是否已上傳!
2)檢查填寫的ebpcode與certno是否與 上傳的一致!
6.{"code":"20005","message":"驗簽失敗","total":0,"serviceTime":1500000000000}
參與驗簽的字符串參數類型及順序必須與例子一致,注意特殊字符處理
7.{"code":"20000","message":"上傳失敗 java.lang.IllegalStateException: Expected BEGIN_OBJECT but was STRING at line 1 column 76 path $.payExchangeInfoHead","total":0,"serviceTime":1612158677093}
說明上傳的參數不符合標准
8.{"code":"20008","message":"簽名驗證根證書失敗","total":0,"serviceTime":1611820873686}
上傳的證書不完整或者格式錯誤!
9.{"code":"10000","message":"上傳成功","total":0,"serviceTime":1611628994529}
這表示ok了
10.{ "code": "20006", "message": "上傳失敗,入庫失敗 java.sql.SQLException: ORA-01400: 無法將 NULL 插入 (\"GUID \")", "total": 0, "serviceTime": 1609139628410}
表示可以了
>>仍有其他問題,請查看 海關179對接寶典