Saiba como solicitar uma classificação no Dashboard e via API.
Em seguida, encontrará exemplos que ilustram como solicitar classificações universais e específicas de cada país através do Dashboard ou via API. Para quem procura detalhes técnicos mais completos e documentação abrangente, visite o nosso site de referência para programadores da Zonos GraphQL API. Este recurso abrangente oferece informações detalhadas sobre endpoints da API, mutações GraphQL e muita outra informação técnica.
Embora apenas uma descrição seja necessária para gerar uma classificação, quanto mais detalhes do produto fornecer, mais precisa será a sua classificação. Em alternativa, pode simplesmente indicar o URL do produto e o Classify extrairá automaticamente todos os detalhes relevantes do artigo por si. Em seguida, encontra uma explicação completa de cada campo de entrada aceite pelo Classify. Ao compreender estes campos de entrada, pode tirar o máximo partido deles e gerar classificações altamente precisas.
Descrições dos campos de entrada
Campo↕
Descrição↕
Nome (obrigatório)
O nome do produto
URL do produto (opcional)
Cole o URL de um produto e o Classify irá obter automaticamente a página e extrair os detalhes relevantes do artigo (nome, descrição, categorias, etc.) para a classificação. Disponível no Dashboard ao clicar no ícone + ou ao adicioná-lo diretamente no campo de texto principal. Para integrações via API, contacte o seu representante Zonos. Embora seja ideal para demonstrações e testes, as implementações em produção alcançam o melhor desempenho e eficiência de custos ao transmitir os dados dos artigos diretamente a partir dos sistemas de back-end.
Descrição (opcional)
Uma descrição detalhada e extensa do produto
URL da imagem (opcional)
Ligação para uma imagem do produto. Nota: certifique-se de que utiliza uma ligação para o URL da imagem propriamente dita e não para o URL da página do produto
Categorias (opcional)
Subcategorias gerais de produtos, por exemplo, Vestuário e acessórios, Artigos para animais de estimação, Material de escritório ou Roupa de bebé, Camas para animais de estimação, Adesivos e fitas
Material (opcional)
O material de que o produto é feito, por exemplo, plástico, madeira, aço
Inclua um código HS existente no seu pedido de classificação para orientar o pedido. Consoante a sua preferência e a origem do código HS fornecido, o Classify pode validar o código HS e verificar a sua coerência com os detalhes da descrição do artigo. Saiba mais.
País de destino (opcional)
Identifica o país para o qual o produto será classificado. O país de destino deve ser indicado com a abreviatura de duas letras (código ISO) de cada país e não com o nome do país, por exemplo, AU e não Austrália. A inclusão deste campo permite que o Classify devolva um código HS específico do país com 8 ou mais dígitos, em vez do código universal de 6 dígitos. Saiba mais sobre as diferenças entre códigos HS universais e específicos de cada país.
ID do produto (opcional)
O seu ID de produto ou qualquer número que possa ser utilizado para identificar cada produto de forma única. Se não for fornecido um ID de produto, o Classify atribuirá IDs de produto a começar em 1
Nota: Se estiver a carregar o CSV do seu pedido em massa no Dashboard, o país de destino não fará parte do modelo; em vez disso, selecionará os países de destino depois de carregar o CSV do pedido em massa.
Para solicitar uma classificação no Dashboard ou via API, siga os passos e a mutação abaixo.
O exemplo abaixo mostra um pedido universal (6 dígitos). Para solicitar classificações para países específicos, adicione os códigos ISO dos países no pedido ao Classify, como se vê no exemplo abaixo. Para solicitar um código HS universal, deixe o país de destino como null no pedido ao Classify.
A entrada aceita uma lista, pelo que pode solicitar várias classificações ou apenas uma de cada vez.
Nota: Para gerar registos de auditoria via API, inclua o campo auditTrail na sua consulta. Contacte o seu representante Zonos para obter acesso e detalhes de implementação.
Quando o Classify recebe um pedido de classificação, tenta fazer corresponder os dados do artigo incluídos no pedido a uma correspondência na base de dados do Classify, com base na pontuação de confiança mais elevada. Consoante o resultado, o Classify devolverá uma das seguintes respostas:
Quando hsCode é devolvido com um código HS de 6 a 8 ou mais dígitos, consoante tenha sido ou não incluído um país de destino no pedido, o seu pedido de classificação foi bem-sucedido.
Quando é devolvido {"errors": [ { "message": "No adequate response"}]}, significa que o Classify não conseguiu encontrar uma classificação devido a informações de entrada insuficientes.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Classificar artigos
Classificar artigos
Saiba como solicitar uma classificação no Dashboard e via API.
Em seguida, encontrará exemplos que ilustram como solicitar classificações universais e específicas de cada país através do Dashboard ou via API. Para quem procura detalhes técnicos mais completos e documentação abrangente, visite o nosso site de referência para programadores da Zonos GraphQL API. Este recurso abrangente oferece informações detalhadas sobre endpoints da API, mutações GraphQL e muita outra informação técnica.
Campos de entrada
Embora apenas uma descrição seja necessária para gerar uma classificação, quanto mais detalhes do produto fornecer, mais precisa será a sua classificação. Em alternativa, pode simplesmente indicar o URL do produto e o Classify extrairá automaticamente todos os detalhes relevantes do artigo por si. Em seguida, encontra uma explicação completa de cada campo de entrada aceite pelo Classify. Ao compreender estes campos de entrada, pode tirar o máximo partido deles e gerar classificações altamente precisas.
Descrições dos campos de entrada
Solicitar uma classificação
Para solicitar uma classificação no Dashboard ou via API, siga os passos e a mutação abaixo.
O exemplo abaixo mostra um pedido universal (6 dígitos). Para solicitar classificações para países específicos, adicione os códigos ISO dos países no pedido ao Classify, como se vê no exemplo abaixo. Para solicitar um código HS universal, deixe o país de destino como
nullno pedido ao Classify.A entrada aceita uma lista, pelo que pode solicitar várias classificações ou apenas uma de cada vez.
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {classificationsCalculate(input: $input) {idnamecategoriesimageUrlhsCode {codedescription {full}}}}Possíveis respostas da API
Quando o Classify recebe um pedido de classificação, tenta fazer corresponder os dados do artigo incluídos no pedido a uma correspondência na base de dados do Classify, com base na pontuação de confiança mais elevada. Consoante o resultado, o Classify devolverá uma das seguintes respostas:
hsCodeé devolvido com um código HS de 6 a 8 ou mais dígitos, consoante tenha sido ou não incluído um país de destino no pedido, o seu pedido de classificação foi bem-sucedido.{"errors": [ { "message": "No adequate response"}]}, significa que o Classify não conseguiu encontrar uma classificação devido a informações de entrada insuficientes.ClassificationCalculateInput
classificationsCalculate
Esta página foi útil?