API REFERENCE
Een douaneaangifte indienen
Tip
Opmerking:
- Per bestelling is er maximaal één record zonder splitsing en kunnen er meerdere records voor gesplitste bestellingen zijn. Records van gesplitste bestellingen met hetzelfde sub_order_no (subordernummer van de merchant) worden als hetzelfde record beschouwd.
- Stel action_type in op MODIFY om aangiftegegevens te wijzigen. Alleen het registratienummer van de merchant, de geregistreerde naam, de douanecode en het bedrag, en de identiteitsdocumentgegevens van de gebruiker kunnen worden gewijzigd. Geef bij gesplitste bestellingen sub_order_no mee om het te wijzigen record aan te duiden.
- Als een transactie voor douaneaangifte is ingediend maar de elektronische douanepoort de bestelling kwijt is, gebruikt u de API om de aangifte opnieuw te verzenden. Gebruik daarbij hetzelfde referentienummer voor de douaneaangifte als in de oorspronkelijke aanvraag.
- Bedragen in de douaneaangifte-API worden uitgedrukt in fen.
- De valuta voor de douaneaangifte is CNY (het door de gebruiker in CNY betaalde bedrag). U kunt deze ophalen via Order opvragen.
API-URL:https://mapi.yabandpay.com/Payments
Methode:POST
POST gegevenstype:Json
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| user | String | UID van het kassier- of superbeheerderaccount | Verplicht |
| sign | String | Signature | Verplicht |
| method | String | v3.CustomDeclareOrder | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| trade_id | String | YabandPay-transactie-ID | Verplicht |
| customs | String | Naam van de douane-instantie | Verplicht |
| mch_customs_no | String | Douaneregistratienummer van de merchant | Verplicht |
| mch_name | String | Bij de douane geregistreerde naam van de merchant | Verplicht |
| duty | Int | Douanerecht in fen; niet ingediend bij de douane | Optioneel |
| action_type | String | Aangiftehandeling: ADD om toe te voegen, MODIFY om te wijzigen; standaardwaarde is ADD | Optioneel |
| sub_order_no | String | Subordernummer van de merchant | Optioneel (verplicht voor gesplitste bestellingen) |
| currency | String | Valuta van de aangifte; CNY wordt aanbevolen | Optioneel (verplicht voor gesplitste bestellingen) |
| order_fee | Int | Bedrag van de suborder (haal het totale orderbedrag amount_cny op via QueryOrder), order_fee=transport_fee+product_fee | Optioneel (verplicht voor gesplitste bestellingen) |
| transport_fee | Int | Verzendkosten van de suborder in fen | Optioneel (verplicht voor gesplitste bestellingen) |
| product_fee | Int | Productprijs van de suborder in fen | Optioneel (verplicht voor gesplitste bestellingen) |
| cert_type | String | Type identiteitsdocument; geef de vaste waarde IDCARD door. Momenteel worden alleen Chinese identiteitskaarten van het Chinese vasteland ondersteund. | Optioneel |
| cert_id | String | Nummer van het identiteitsdocument: het nummer van de Chinese identiteitskaart van de gebruiker. Eindigt het nummer op X, gebruik dan een hoofdletter X. | Optioneel |
| name | String | Naam van de gebruiker | Optioneel |
Waarden voor douanevelden:
Douaneaangiftewaarden voor WeChat Pay
| Veld | Beschrijving |
|---|---|
| GUANGZHOU_ZS | Guangzhou (versie van de Algemene Administratie van de Douane) |
| GUANGZHOU_HP_GJ | Inspectie en quarantaine van Guangzhou Huangpu |
| GUANGZHOU_NS_GJ | Inspectie en quarantaine van Guangzhou Nansha |
| HANGZHOU_ZS | Hangzhou (versie van de Algemene Administratie van de Douane) |
| NINGBO | Ningbo |
| ZHENGZHOU_BS | Zhengzhou (douanelogistiekcentrum) |
| CHONGQING | Chongqing |
| SHANGHAI_ZS | Shanghai (versie van de Algemene Administratie van de Douane) |
| SHENZHEN | Shenzhen |
| ZHENGZHOU_ZH_ZS | Uitgebreide douanezone Zhengzhou (versie van de Algemene Administratie van de Douane) |
| TIANJIN | Tianjin |
TIANJIN (Als u een bestelling bij de douane van Tianjin wilt indienen, configureert u zowel de registratiegegevens bij de douane van Tianjin als die bij de inspectie- en quarantainedienst van Tianjin in het merchantbeheerportaal. Richt bij het aanroepen van de douaneaangifte-API één API-aanvraag uitsluitend aan de douane van Tianjin.)
Douaneaangiftewaarden voor Alipay
| Veld | Beschrijving |
|---|---|
| ZONGSHU | Algemene Administratie van de Douane van China |
| ZHENGZHOU | Zhengzhou |
| NINGBO | Ningbo |
| SHANGHAI_CBT | Shanghai |
Voorbeeld van een handtekening:
Parameters op volgorde samengevoegd tot een querystring in URL-stijl
"customs=NINGBO&mch_customs_no=3302462090&mch_name=宁波保税区嘉里大通物流有限公司&method=v3.CustomDeclareOrder&time=1560499094&trade_id=4760a968-4c5d-1e7e-3b88-89641af6e041&user=YOUR_CASHIER_UID"
Onderteken stringA met secret_key
De gegenereerde handtekening is:
"YOUR_SIGNATURE"
Voorbeeld van een aanvraag:
{
"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": "宁波保税区嘉里大通物流有限公司"
}
}
Voorbeeld van een antwoord op een douaneaangifte:
{
"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": ""
}
Statussen:
| Status | Beschrijving |
|---|---|
| UNDECLARED | Niet aangegeven (de aangifte is ingediend en wacht op douaneafhandeling; opnieuw indienen is niet nodig) |
| SUBMITTED | Aangifte ingediend (deze status wordt geregistreerd nadat de bestelling naar de douane is verzonden, de merchant een nieuwe aangifte indient en de douane een wijzigings-API beschikbaar stelt) |
| PROCESSING | Aangifte wordt verwerkt |
| SUCCESS | Aangifte geslaagd |
| FAIL | Aangifte mislukt |
| EXCEPT | Fout in de douane-API |
