Zollanmeldungen automatisch ausfüllen
Führen Sie die folgenden Schritte aus, um das automatische Auffüllen der Zollanmeldung mit Declaration IDs von Ihrer Plattform aus zu aktivieren.
1. Aktivieren Sie das Feld Declaration ID im Etikettenerstellungsablauf
Fügen Sie ein Declaration ID-Feld zu Ihrer Schnittstelle zur Erstellung von Postetiketten hinzu. Wenn Benutzer ein gültiges Declaration ID eingeben, kann Ihre Plattform die Zollanmeldung automatisch ausfüllen, wodurch eine manuelle Dateneingabe entfällt.
2. Fragen Sie den Declaration ID-Status und die Details der Zollanmeldung ab
Verwenden Sie die folgende Abfrage, um vollständige Zollanmeldungsdaten mithilfe von Declaration ID abzurufen. Dies gibt den Validierungsstatus zusammen mit Artikeldetails, Werten, HS-Codes und Empfängerinformationen zurück, sofern verfügbar
query DeclarationQuery($id: ID!) { declaration(id: $id) { id status paymentStatus landedCost { id method landedCostGuaranteeCode amountSubtotals { duties taxes fees landedCostTotal } } items { id sku productId amount currencyCode name hsCode description hsCodeSource countryOfOrigin quantity measurements { type value unitOfMeasure } } parties { id type person { firstName lastName email phone } location { id line1 line2 countryCode postalCode } } }}3. Behandeln Sie die Antwort und füllen Sie die Zollanmeldung automatisch aus
Die API-Antwort enthält Validierungsstatus und Zolldaten. Verwenden Sie die status-Informationen, um festzustellen, ob Declaration ID gültig ist, und füllen Sie dann die verfügbaren Zolldaten automatisch aus oder fordern Sie zur manuellen Eingabe auf.
Beispielantworten
Gültig Declaration ID mit vollständigen Zolldaten:
{
"data": {
"declaration": {
"id": "0mm1993s0mdcn",
"status": "OPEN",
"paymentStatus": "OPEN",
"landedCost": {
"id": "landed_cost_eabb13ab-df23-45df-9ce8-96dd29d396d1",
"method": "DAP",
"landedCostGuaranteeCode": "NOT_APPLICABLE",
"amountSubtotals": {
"duties": 0.0,
"taxes": 0.0,
"fees": 2.62,
"landedCostTotal": 2.62
}
},
"items": [
{
"id": "item_0mm199388v57g",
"sku": "item_1",
"productId": "item_1",
"amount": 70.0,
"currencyCode": "USD",
"name": "Item 1",
"hsCode": "9504.90.4000",
"description": "This is the description for Item 1",
"hsCodeSource": "TARIFF_COMPLETED",
"countryOfOrigin": "CN",
"quantity": 2,
"measurements": [
{
"type": "WEIGHT",
"value": 1,
"unitOfMeasure": "POUND"
}
]
}
],
"parties": [
{
"id": "party_0kesb32rw5hfa",
"type": "DESTINATION",
"person": {
"firstName": "test",
"lastName": "origin",
"email": null,
"phone": "1234567890"
},
"location": {
"id": "location_c7882546-652e-49cb-81a4-98962a54c49f",
"line1": "123 Test Street",
"line2": "",
"countryCode": "US",
"postalCode": "84790"
}
},
{
"id": "party_0mjfz59bgg175",
"type": "ORIGIN",
"person": {
"firstName": "test",
"lastName": "destination",
"email": null,
"phone": "1234567890"
},
"location": {
"id": "location_0mdzb9vk8bp7c",
"line1": "998 Ridgehaven",
"line2": null,
"countryCode": "CA",
"postalCode": "N0N 0N0"
}
}
]
}
}
}
4. Erstellen Sie die Sendung
Verarbeiten Sie die Etikettenerstellung entweder mit automatisch ausgefüllten Daten aus einem Declaration ID oder manuell eingegebenen Deklarationsinformationen.
5. Tracking-Nummer mit Declaration ID verknüpfen
Verwenden Sie nach der Etikettenerstellung die DeclarationShipmentCreate-Mutation, um die Sendungsverfolgungsnummer mit Declaration ID zu verknüpfen und so eine ordnungsgemäße Zollzahlungsvalidierung und Sendungsverfolgung sicherzustellen.
mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) { declarationShipmentCreate(input: $input)}Sie können eine mit einem Declaration ID verknüpfte Sendung erstellen, indem Sie ein Array aus status und dem für die Sendung verwendeten trackingNumbers übergeben.
Sie können eine Sendung auch erstellen, indem Sie status mit Details zu den Kartons und den Artikeln in den Kartons übergeben. Sie können diese im trackingNumbers zusammen mit declarationID für diesen Karton übergeben.
Versandetiketten | Validieren Sie ein Declaration ID
Rufen Sie den Status eines Declaration ID ab und füllen Sie die Zolldokumente automatisch aus
Wenn Sie Postetiketten erstellen, können Sie Zonos aufrufen, um vollständige Zollanmeldungsdetails abzurufen, wenn ein Benutzer ein Declaration ID bereitstellt. Dadurch entfällt für Benutzer das manuelle Ausfüllen von Zolldokumenten, wodurch ein nahtloses Versanderlebnis entsteht, bei dem Zölle im Voraus bezahlt werden und Zollformulare automatisch ausgefüllt werden.