清关业务-目的国海关申报商品标准品名查询(方法名称:common.import_customs.standard_goods.get)
| 环境 | HTTP请求地址 |
|---|---|
| 正式环境 | https://open.yw56.com.cn/api/order |
| 测试环境 | https://open-fat.yw56.com.cn/api/order |
| 环境 | 账号 | 秘钥 apitoken |
|---|---|---|
| 正式环境 | 贵司在我司客户号; | 登录我司客户中心系统-账号管理-制单账号管理信息下查看秘钥; |
| 测试环境 | 99000015 | E33A3973221DB08128F8FF436EFDB8F4 |
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| user_id | String | 是 | 客户号 |
| format | String | 是 | 报文格式 默认为json格式,可选值:json |
| method | String | 是 | api名称; |
| timestamp | Long | 是 | 时间戳(毫秒级) 有效期为5分钟 |
| version | String | 是 | api版本号 可选 V1.0 |
| sign | String | 是 | 签名(根据动态规则生成) |
| data | String | 是 | 报文内容(body请求参数,放在请求体中,使用json格式) |
1.请求方式 所有接口使用 POST 方式请求,没有特殊说明 所有字符编码为utf-8; Content-Type: application/json;
2.公共请求参数放在url后面,使用&连接
3.签名规则
第一步:按字典序排列将参数拼接。具体顺序为 user_id+data+format+method+timestamp+version
第二步:将apiToken拼接到第一步的字符串的头部和尾部 apitoken+user_id+data+format+method+timestamp+version+apitoken
第三步:将第二步的结果进行md5加密; MD5(apitoken+user_id+data+format+method+timestamp+version+apitoken)
生成签名示例:
E33A3973221DB08128F8FF436EFDB8F499000015{}jsoncommon.import_customs.standard_goods.get1655798809414V1.0E33A3973221DB08128F8FF436EFDB8F4
注:a.data 参数为body请求参数为json格式,并且使用压缩格式 b.MD5加密方式为32位小写;
加密后结果:ea76207d6e3581bb99d7d63ef5faae6f
4.请求URL示例
https://open-fat.yw56.com.cn/api/order?user_id=99000015&method=common.import_customs.standard_goods.get&format=json×tamp=1655798809414&sign=ea76207d6e3581bb99d7d63ef5faae6f&version=V1.0
注:user_id,method,format,version,timestamp要和生成签名时使用的参数一致。sign为生成参数签名步骤生成的md5加密后得到的
| 参数 | 类型 | 是否必填 | 描述 | |
|---|---|---|---|---|
| countryCode | String | 是 | 2 | 国家二字码 |
| goodsNameEn | String | 是 | 200 | 英文品名 |
| 参数 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 是否请求成功 |
| code | String | 响应码 |
| message | String | 响应文本 |
| data | Object | 实体信息 |
| standardGoodsName | String | 标准中文品名 |
| standardGoodsNameEn | String | 标准英文品名 |
| importHsCode | String | 清关海关编码 |
| taxRate | String | 税率 |
{
"countryCode": "US",
"goodsNameEn": "shoes"
}
{
"success":true,
"code":"0",
"message":"操作成功",
"data": {
"standardGoodsName": "运动鞋",
"standardGoodsNameEn": "Athletic Shoes",
"importHsCode": "6402993115",
"taxRate": "16.55%"
}
}