API REFERENCE
Zollanmeldung einreichen
Tipp
Hinweis:
- Für jede Bestellung kann es nur einen Datensatz für eine nicht aufgeteilte Bestellung und mehrere Datensätze für Teilbestellungen geben. Datensätze für Teilbestellungen mit derselben sub_order_no (Händler-Unterbestellnummer) gelten als derselbe Datensatz.
- Um Angaben zur Zollanmeldung zu ändern, setzen Sie action_type auf MODIFY. Änderbar sind nur die Registrierungsnummer des Händlers, der registrierte Name, der Zollcode und der Betrag sowie die Identitätsnachweisdaten des Nutzers. Geben Sie bei Teilbestellungen sub_order_no an, um den zu ändernden Datensatz zu bestimmen.
- Wurde eine Transaktion zur Zollanmeldung übermittelt, der elektronische Hafen kann die Bestellung jedoch nicht finden, verwenden Sie die API zum erneuten Senden. Behalten Sie dabei dieselbe Zollreferenznummer wie in der ursprünglichen Anfrage bei.
- Beträge in der API für Zollanmeldungen werden in Fen angegeben.
- Die Währung für die Zollanmeldung ist CNY (der vom Nutzer in CNY gezahlte Betrag). Sie kann über Bestellung abfragen ermittelt werden.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | UID des Kassen- oder Superadmin-Kontos | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.CustomDeclareOrder | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| trade_id | String | YabandPay-Transaktions-ID | Erforderlich |
| customs | String | Zollbezeichnung | Erforderlich |
| mch_customs_no | String | Zollregistrierungsnummer des Händlers | Erforderlich |
| mch_name | String | Beim Zoll registrierter Händlername | Erforderlich |
| duty | Int | Zollabgabe in Fen; nicht an den Zoll übermittelt | Optional |
| action_type | String | Aktion für die Zollanmeldung: ADD zum Hinzufügen, MODIFY zum Ändern; Standardwert ist ADD | Optional |
| sub_order_no | String | Händler-Unterbestellnummer | Optional (bei Teilbestellungen erforderlich) |
| currency | String | Währung der Zollanmeldung; CNY wird empfohlen | Optional (bei Teilbestellungen erforderlich) |
| order_fee | Int | Betrag der Teilbestellung (Gesamtbestellbetrag über amount_cny mittels QueryOrder abrufen), order_fee=transport_fee+product_fee | Optional (bei Teilbestellungen erforderlich) |
| transport_fee | Int | Versandkosten der Teilbestellung in Fen | Optional (bei Teilbestellungen erforderlich) |
| product_fee | Int | Warenwert der Teilbestellung in Fen | Optional (bei Teilbestellungen erforderlich) |
| cert_type | String | Art des Identitätsnachweises; übergeben Sie den festen Wert IDCARD. Derzeit werden nur chinesische Personalausweise vom chinesischen Festland unterstützt. | Optional |
| cert_id | String | Nummer des Identitätsnachweises: Nummer des chinesischen Personalausweises des Nutzers. Endet die Nummer auf X, verwenden Sie ein großes X. | Optional |
| name | String | Name des Nutzers | Optional |
Werte der Zollfelder:
Zollanmeldungswerte für WeChat Pay
| Feld | Beschreibung |
|---|---|
| GUANGZHOU_ZS | Guangzhou (Version der Generalzolldirektion) |
| GUANGZHOU_HP_GJ | Guangzhou Huangpu – Inspektion und Quarantäne |
| GUANGZHOU_NS_GJ | Guangzhou Nansha – Inspektion und Quarantäne |
| HANGZHOU_ZS | Hangzhou (Version der Generalzolldirektion) |
| NINGBO | Ningbo |
| ZHENGZHOU_BS | Zhengzhou (Zoll-Logistikzentrum) |
| CHONGQING | Chongqing |
| SHANGHAI_ZS | Shanghai (Version der Generalzolldirektion) |
| SHENZHEN | Shenzhen |
| ZHENGZHOU_ZH_ZS | Zhengzhou – umfassende Freihandelszone (Version der Generalzolldirektion) |
| TIANJIN | Tianjin |
TIANJIN (Damit eine Bestellung an den Zoll von Tianjin gesendet werden kann, konfigurieren Sie im Händlerverwaltungsportal sowohl die Registrierungsdaten des Zolls von Tianjin als auch die Registrierungsdaten der Inspektions- und Quarantänestelle von Tianjin. Richten Sie beim Aufruf der Zollanmeldungs-API nur eine Anfrage an den Zoll von Tianjin.)
Zollanmeldungswerte für Alipay
| Feld | Beschreibung |
|---|---|
| ZONGSHU | Generalzolldirektion der Volksrepublik China |
| ZHENGZHOU | Zhengzhou |
| NINGBO | Ningbo |
| SHANGHAI_CBT | Shanghai |
Signaturbeispiel:
Die sortierten Parameter werden zu einer URL-ähnlichen Abfragezeichenfolge verkettet.
"customs=NINGBO&mch_customs_no=3302462090&mch_name=宁波保税区嘉里大通物流有限公司&method=v3.CustomDeclareOrder&time=1560499094&trade_id=4760a968-4c5d-1e7e-3b88-89641af6e041&user=YOUR_CASHIER_UID"
Signieren Sie stringA mit secret_key.
Die resultierende Signatur lautet:
"YOUR_SIGNATURE"
Anfragebeispiel:
{
"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": "宁波保税区嘉里大通物流有限公司"
}
}
Antwortbeispiel für die Zollanmeldung:
{
"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": ""
}
Status:
| Status | Beschreibung |
|---|---|
| UNDECLARED | Nicht angemeldet (die Anmeldung wurde übermittelt und wartet auf die Bearbeitung durch den Zoll; eine erneute Übermittlung ist nicht erforderlich) |
| SUBMITTED | Übermittelt (dieser Status wird erfasst, wenn die Bestellung an den Zoll gesendet wurde, der Händler eine neue Anmeldung einreicht und der Zoll eine API zur Änderung bereitstellt) |
| PROCESSING | In Bearbeitung |
| SUCCESS | Erfolgreich |
| FAIL | Fehlgeschlagen |
| EXCEPT | Fehler der Zoll-API |
