Obtenha os detalhes da encomenda para preparar uma expedição.
GraphQL
Se é parceiro da Zonos e trabalha com um cliente que utiliza a sua plataforma para expedições, pode consultar a Zonos para obter os detalhes da encomenda. Estes detalhes podem ser utilizados no seu pedido de etiqueta à transportadora, para garantir que os dados enviados são os mesmos que a Zonos utiliza para garantir os direitos e impostos calculados para essa expedição. Devolvemos detalhes sobre identificadores fiscais, artigos (incluindo códigos HS e descrições aduaneiras) e os números de conta aos quais devem ser faturados os direitos e impostos.
Siga os passos abaixo para permitir que os seus clientes obtenham detalhes aduaneiros que podem ser utilizados ao criar expedições a partir da sua plataforma.
1
Permitir que os clientes introduzam as suas credenciais da API Zonos
A API Zonos é acessível através de um credentialToken. A sua plataforma terá de permitir que os clientes introduzam o respetivo credentialToken do Zonos Dashboard na sua plataforma. A partir daí, poderá fazer pedidos à Zonos em nome deles.
2
Consultar detalhes aduaneiros
Utilize a seguinte consulta para obter os detalhes aduaneiros necessários para criar a expedição. Para o orderId, pode utilizar o ID da encomenda Zonos ou o accountOrderNumber, que provavelmente já existe no seu sistema.
Depois de obter os detalhes aduaneiros de uma encomenda, pode utilizá-los no seu pedido à transportadora. Quando receber a etiqueta e o número de seguimento da transportadora, pode utilizar a mutação shipmentCreate para informar a Zonos do número de seguimento, para que possamos atualizar o estado da encomenda.
Obter detalhes aduaneiros
Obter detalhes aduaneiros
Obtenha os detalhes da encomenda para preparar uma expedição.
GraphQL
Se é parceiro da Zonos e trabalha com um cliente que utiliza a sua plataforma para expedições, pode consultar a Zonos para obter os detalhes da encomenda. Estes detalhes podem ser utilizados no seu pedido de etiqueta à transportadora, para garantir que os dados enviados são os mesmos que a Zonos utiliza para garantir os direitos e impostos calculados para essa expedição. Devolvemos detalhes sobre identificadores fiscais, artigos (incluindo códigos HS e descrições aduaneiras) e os números de conta aos quais devem ser faturados os direitos e impostos.
Consultar a Zonos para obter detalhes aduaneiros
Siga os passos abaixo para permitir que os seus clientes obtenham detalhes aduaneiros que podem ser utilizados ao criar expedições a partir da sua plataforma.
Permitir que os clientes introduzam as suas credenciais da API Zonos
A API Zonos é acessível através de um
credentialToken. A sua plataforma terá de permitir que os clientes introduzam o respetivocredentialTokendo Zonos Dashboard na sua plataforma. A partir daí, poderá fazer pedidos à Zonos em nome deles.Consultar detalhes aduaneiros
Utilize a seguinte consulta para obter os detalhes aduaneiros necessários para criar a expedição. Para o
orderId, pode utilizar o ID da encomenda Zonos ou oaccountOrderNumber, que provavelmente já existe no seu sistema.query GetCustomsSpec($referenceId: String!) {customsSpecByReference(referenceId: $referenceId) {idcurrencyCodeamountSubtotals {itemsshipping}reasonForExportincotermdeclarationStatementattributes {typevalue}serviceLevel {namecodecarrier {namecode}}parties {idtypeperson {companyNamefirstNamelastNameemailphone}location {countryCodeline1localitypostalCodeadministrativeAreaCodeadministrativeArea}}customsItems {idamountquantityhsCodehsCodeSourcedescriptioncountryOfOriginitems {idamountcurrencyCodequantity}}}}Criar a expedição com a transportadora
Depois de obter os detalhes aduaneiros de uma encomenda, pode utilizá-los no seu pedido à transportadora. Quando receber a etiqueta e o número de seguimento da transportadora, pode utilizar a mutação
shipmentCreatepara informar a Zonos do número de seguimento, para que possamos atualizar o estado da encomenda.Esta página foi útil?