API REFERENCE
Renvoyer une déclaration en douane
Paramètres
| Parameter | Type | Description | Obligatoire |
|---|---|---|---|
| data.trade_id | string | YabandPay交易ID | ✓ |
| data.customs | string | 海关名称 | ✓ |
| data.mch_customs_no | string | 商户海关备案号 | ✓ |
Cette API renvoie une déclaration en douane pour une commande déjà soumise aux douanes.
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| user | String | UID du compte caissier ou super administrateur | Obligatoire |
| sign | String | Signature | Obligatoire |
| method | String | v3.CustomDeclareRedeclare | Obligatoire |
| time | Long | Timestamp | Obligatoire |
- Parameters | Paramètre | Type | Description | Obligatoire | |:--- |:--- |:--- |:--- | | trade_id | String | ID de transaction YabandPay | Obligatoire | | customs | String | Nom des douanes | Obligatoire | | mch_customs_no | String | Numéro d’enregistrement en douane du marchand | Obligatoire |
Exemple de signature :
Paramètres triés et concaténés dans une chaîne de requête au format URL
"customs=NINGBO&mch_customs_no=8888888888&method=v3.CustomDeclareRedeclare&time=1560499094&trade_id=dd11d082-810d-c8b7-3669-b784c466759b&user=YOUR_CASHIER_UID"
Signer stringA avec secret_key
La signature obtenue est :
"YOUR_SIGNATURE"
Exemple de requête :
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.CustomDeclareRedeclare",
"time": 1560996670,
"data": {
"trade_id": "dd11d082-810d-c8b7-3669-b784c466759b",
"customs": "NINGBO",
"mch_customs_no": "8888888888"
}
}
Exemple de réponse :
{
"status": true,
"code": "200",
"data": {
"state": "UNDECLARED",
"explanation": []
},
"message": ""
}
États :
| Status | Description |
|---|---|
| UNDECLARED | Non déclarée (la déclaration a été soumise et attend son traitement par les douanes ; aucune nouvelle soumission n’est nécessaire) |
| SUBMITTED | Déclaration soumise (cet état est enregistré lorsque la commande a été envoyée aux douanes, que le marchand soumet une nouvelle déclaration et que les douanes fournissent une API de modification) |
| PROCESSING | Déclaration en cours de traitement |
| SUCCESS | Déclaration effectuée avec succès |
| FAIL | Échec de la déclaration |
| EXCEPT | Erreur de l’API des douanes |