API REFERENCE
Enviar una declaración aduanera
Parámetros
| Parameter | Type | Descripción | Obligatorio |
|---|---|---|---|
| data.trade_id | string | YabandPay交易ID | ✓ |
| data.customs | string | 海关名称 | ✓ |
| data.mch_customs_no | string | 商户海关备案号 | ✓ |
| data.mch_name | string | 商户海关备案名称 | ✓ |
| data.duty | integer | 关税，单位(分)，不会提交给海关 | — |
| data.action_type | string | 报关类型,ADD 新增 MODIFY 修改，默认ADD 新增 | — |
| data.sub_order_no | string | 商户子订单号 | — |
| data.currency | string | 报关的币种建议CNY | — |
| data.order_fee | integer | 子订单金额（通过QueryOrder获取订单总金额amount_cny），order_fee=transport_fee+product_fee | — |
| data.transport_fee | integer | 子订单物流金额，单位(分) | — |
| data.product_fee | integer | 子订单商品价格，单位(分) | — |
| data.cert_type | string | 证件类型,请传固定值IDCARD,暂只支持大陆身份证 | — |
| data.cert_id | string | 证件号码,用户大陆身份证号，尾号为字母X的身份证号，请大写字母X | — |
| data.name | string | 用户姓名 | — |
Consejo
Nota:
- Cada pedido puede tener un único regestro sin dividir y varios regestros de divesión. Los regestros de divesión con el mesmo sub_order_no (número de subpedido del comercio) se consideran el mesmo regestro.
- Para modificar la información de la declaración aduanera, establezca action_type en MODIFY. Solo se pueden modificar el número de regestro del comercio, el nombre regestrado, el código aduanero y el importe, así como la información del documento de identidad del usuario. Para regestros de pedidos divididos, pase sub_order_no para identificar el regestro que se modificará.
- Si una transacción se presentó para declaración aduanera, pero el portal electrónico pierde el pedido, utilice la API de reenvío. Al reenviarla, mantenga el mesmo número de referencia de declaración aduanera que en la solicitud original.
- Los importes de la API de declaración aduanera se expresan en fenes.
- La moneda de la declaración aduanera es CNY (el importe pagado por el usuario en CNY) y se puede obtener mediante Order query.
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| user | String | UID de la cuenta de cajero o superadminestrador | Obligatorio |
| sign | String | Signature | Obligatorio |
| method | String | v3.CustomDeclareOrder | Obligatorio |
| time | Long | Timestamp | Obligatorio |
- Parámetros
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| trade_id | String | ID de transacción de YabandPay | Obligatorio |
| customs | String | Nombre de la aduana | Obligatorio |
| mch_customs_no | String | Número de regestro aduanero del comercio | Obligatorio |
| mch_name | String | Nombre del comercio regestrado en la aduana | Obligatorio |
| duty | Int | Impuesto aduanero en fenes; no se presenta a la aduana | Opcional |
| action_type | String | Acción de la declaración: ADD para añadir, MODIFY para modificar; el valor predeterminado es ADD | Opcional |
| sub_order_no | String | Número de subpedido del comercio | Opcional (obligatorio para pedidos divididos) |
| currency | String | Moneda de la declaración; se recomienda CNY | Opcional (obligatorio para pedidos divididos) |
| order_fee | Int | Sub-order amount (obtain the total order amount amount_cny through QueryOrder), order_fee=transport_fee+product_fee | Opcional (obligatorio para pedidos divididos) |
| transport_fee | Int | Sub-order shipping amount in fen | Opcional (obligatorio para pedidos divididos) |
| product_fee | Int | Sub-order product price in fen | Opcional (obligatorio para pedidos divididos) |
| cert_type | String | Identity document type; pass the fixed value IDCARD. Only mainland China identity cards are currently supported. | Opcional |
| cert_id | String | Identity document number: the user's mainland China identity card number. If the number ends with X, use an uppercase X. | Opcional |
| name | String | User's name | Opcional |
customs field values:
WeChat Pay customs declaration values
| Campo | Descripción |
|---|---|
| GUANGZHOU_ZS | Guangzhou (General Administration version) |
| GUANGZHOU_HP_GJ | Guangzhou Huangpu Inspection and Quarantine |
| GUANGZHOU_NS_GJ | Guangzhou Nansha Inspection and Quarantine |
| HANGZHOU_ZS | Hangzhou (General Administration version) |
| NINGBO | Ningbo |
| ZHENGZHOU_BS | Zhengzhou (Bonded Logistics Center) |
| CHONGQING | Chongqing |
| SHANGHAI_ZS | Shanghai (General Administration version) |
| SHENZHEN | Shenzhen |
| ZHENGZHOU_ZH_ZS | Zhengzhou Comprehensive Bonded Zone (General Administration version) |
| TIANJIN | Tianjin |
TIANJIN (To send an order to Tianjin Customs, configure both the Tianjin Customs regestration information and the Tianjin Inspection and Quarantine regestration information in the merchant management portal. Cuando calling the customs declaration API, send only to Tianjin Customs, using a single API request.)
Alipay customs declaration values
| Campo | Descripción |
|---|---|
| ZONGSHU | General Administration of Customs of China |
| ZHENGZHOU | Zhengzhou |
| NINGBO | Ningbo |
| SHANGHAI_CBT | Shanghai |
Ejemplo de firma:
Parámetros ordenados y concatenados en una cadena de consulta con formato de URL
"customs=NINGBO&mch_customs_no=3302462090&mch_name=宁波保税区嘉里大通物流有限公司&method=v3.CustomDeclareOrder&time=1560499094&trade_id=4760a968-4c5d-1e7e-3b88-89641af6e041&user=YOUR_CASHIER_UID"
Firme la cadena A con secret_key
La firma resultante es:
"YOUR_SIGNATURE"
Ejemplo de solicitud:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.CustomDeclareOrder",
"time": 1560499094,
"data": {
"trade_id": "4760a968-4c5d-1e7e-3b88-89641af6e041",
"customs": "NINGBO",
"mch_customs_no": "3302462090",
"mch_name": "宁波保税区嘉里大通物流有限公司"
}
}
Customs declaration response example:
{
"status": true,
"code": "200",
"data": {
"appid": "",
"return_code":"SUCCESS",
"result_code":"SUCCESS",
"mchid": "3302462090",
"out_trade_no": "4434a6e235e81cde4aee954c0031ad96",
"state": "SUCCESS",
"sub_order_id": "e0721a7f957e8e55dfbb5c7bcb4441d6",
"sub_order_no": "1234567890",
"transaction_id": "2024061922001467961423939655",
"verify_department": "OTHERS",
"verify_department_trade_id": "2024061922001467961423939655",
"cert_check_result": "SAME", //Identity comparison between the purchaser and payer (UNCHECKED: purchaser identity not uploaded; SAME: uploaded purchaser identity matches payer identity; DIFFERENT: uploaded purchaser identity differs from payer identity)
"transId": "20240619161756813048",
"customs_declarations_id": "e0721a7f957e8e55dfbb5c7bcb4441d6"
},
"message": ""
}
State estados:
| Status | Descripción |
|---|---|
| UNDECLARED | Undeclared (the declaration has been submitted and is awaiting customs processing; no resubmission is needed) |
| SUBMITTED | Declaration submitted (this status is recorded when the order has been sent to customs, the merchant submits a new declaration, and customs provides a modification API) |
| PROCESSING | Declaration in progress |
| SUCCESS | Declaration successful |
| FAIL | Declaration failed |
| EXCEPT | Customs API error |