Dokumentation/API-Referenz

API REFERENCE

Zollanmeldung einreichen

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

Zollanmeldung einreichen

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters14

Required fields first

海关申报提交

trade_idRequiredstringdata.trade_idYabandPay交易ID
customsRequiredstringdata.customs海关名称
mch_customs_noRequiredstringdata.mch_customs_no商户海关备案号
mch_nameRequiredstringdata.mch_name商户海关备案名称
Optional parameters 10
dutyOptionalintegerdata.duty关税,单位(分),不会提交给海关
action_typeOptionalstringdata.action_type报关类型,ADD 新增 MODIFY 修改,默认ADD 新增
sub_order_noComplete groupstringdata.sub_order_no商户子订单号选填(拆单时必传)
currencyComplete groupstringdata.currency报关的币种建议CNY选填(拆单时必传)
order_feeComplete groupintegerdata.order_fee子订单金额(通过QueryOrder获取订单总金额amount_cny),order_fee=transport_fee+product_fee选填(拆单时必传)
transport_feeComplete groupintegerdata.transport_fee子订单物流金额,单位(分)选填(拆单时必传)
product_feeComplete groupintegerdata.product_fee子订单商品价格,单位(分)选填(拆单时必传)
cert_typeOptionalstringdata.cert_type证件类型,请传固定值IDCARD,暂只支持大陆身份证
cert_idOptionalstringdata.cert_id证件号码,用户大陆身份证号,尾号为字母X的身份证号,请大写字母X
nameOptionalstringdata.name用户姓名

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

Tipp

Hinweis:

  1. 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.
  1. 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.
  1. 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.
  1. Beträge in der API für Zollanmeldungen werden in Fen angegeben.
  1. Die Währung für die Zollanmeldung ist CNY (der vom Nutzer in CNY gezahlte Betrag). Sie kann über Bestellung abfragen ermittelt werden.
ParameterTypBeschreibungErforderlich
userStringUID des Kassen- oder Superadmin-KontosErforderlich
signStringSignatureErforderlich
methodStringv3.CustomDeclareOrderErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
trade_idStringYabandPay-Transaktions-IDErforderlich
customsStringZollbezeichnungErforderlich
mch_customs_noStringZollregistrierungsnummer des HändlersErforderlich
mch_nameStringBeim Zoll registrierter HändlernameErforderlich
dutyIntZollabgabe in Fen; nicht an den Zoll übermitteltOptional
action_typeStringAktion für die Zollanmeldung: ADD zum Hinzufügen, MODIFY zum Ändern; Standardwert ist ADDOptional
sub_order_noStringHändler-UnterbestellnummerOptional (bei Teilbestellungen erforderlich)
currencyStringWährung der Zollanmeldung; CNY wird empfohlenOptional (bei Teilbestellungen erforderlich)
order_feeIntBetrag der Teilbestellung (Gesamtbestellbetrag über amount_cny mittels QueryOrder abrufen), order_fee=transport_fee+product_feeOptional (bei Teilbestellungen erforderlich)
transport_feeIntVersandkosten der Teilbestellung in FenOptional (bei Teilbestellungen erforderlich)
product_feeIntWarenwert der Teilbestellung in FenOptional (bei Teilbestellungen erforderlich)
cert_typeStringArt des Identitätsnachweises; übergeben Sie den festen Wert IDCARD. Derzeit werden nur chinesische Personalausweise vom chinesischen Festland unterstützt.Optional
cert_idStringNummer des Identitätsnachweises: Nummer des chinesischen Personalausweises des Nutzers. Endet die Nummer auf X, verwenden Sie ein großes X.Optional
nameStringName des NutzersOptional

Werte der Zollfelder:

Zollanmeldungswerte für WeChat Pay

FeldBeschreibung
GUANGZHOU_ZSGuangzhou (Version der Generalzolldirektion)
GUANGZHOU_HP_GJGuangzhou Huangpu – Inspektion und Quarantäne
GUANGZHOU_NS_GJGuangzhou Nansha – Inspektion und Quarantäne
HANGZHOU_ZSHangzhou (Version der Generalzolldirektion)
NINGBONingbo
ZHENGZHOU_BSZhengzhou (Zoll-Logistikzentrum)
CHONGQINGChongqing
SHANGHAI_ZSShanghai (Version der Generalzolldirektion)
SHENZHENShenzhen
ZHENGZHOU_ZH_ZSZhengzhou – umfassende Freihandelszone (Version der Generalzolldirektion)
TIANJINTianjin

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

FeldBeschreibung
ZONGSHUGeneralzolldirektion der Volksrepublik China
ZHENGZHOUZhengzhou
NINGBONingbo
SHANGHAI_CBTShanghai

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:

StatusBeschreibung
UNDECLAREDNicht 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)
PROCESSINGIn Bearbeitung
SUCCESSErfolgreich
FAILFehlgeschlagen
EXCEPTFehler der Zoll-API