How account keys work
Zonos organizations with Account Keys can dynamically generate Declaration IDs during label creation, creating a seamless shipping experience while ensuring duty payment compliance.
Organizations can obtain Account Keys through Zonos Dashboard based on their specific use case and relationship with Zonos.
Generate Declaration IDs using your account key
Organizations with Account Keys can dynamically generate individual Declaration IDs for shipments through the Zonos API. This process enables automated duty collection without requiring users to manually enter Declaration IDs.
Use the following GraphQL mutation to generate Declaration IDs for a shipment without details about the shipment itself.
1
mutation DeclarationCreate($input: DeclarationCreateInput!) {2
declarationCreate(input: $input) {3
id4
status5
paymentStatus6
source7
organizationId8
parties {9
id10
}11
items {12
id13
}14
landedCost {15
id16
currencyCode17
}18
}19
}GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS
Create account keys
Create Declaration IDs through account keys for postal operators and shipping platforms
An account key is a unique authorization credential (similar to an API key) that allows approved organizations to collect duties on behalf of their users without requiring individual Declaration IDs for each shipment. Account keys eliminate the need for manual duty collection while enabling automated billing and compliance with postal DDP requirements.
An account key represents the final party responsible for the payment of duties. For instance, if a shipping platform wants to obtain their own account key, they can use this key to generate Declaration IDs on behalf of their users. In this case, the shipping platform would collect the duties from the user and Zonos would invoice the shipping platform for the duties based on the Declaration IDs generated from their Account Key.