Campos de entrada
Embora apenas uma descrição seja necessária para gerar uma classificação, quanto mais detalhes do produto você fornecer, mais precisa será sua classificação. Alternativamente, você pode simplesmente fornecer o URL do produto e Classify extrairá automaticamente todos os detalhes relevantes do item para você. Abaixo está uma explicação abrangente de cada campo de entrada aceito por Classify. Ao compreender esses campos de entrada, você pode maximizar seu uso 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 Classify irá buscar automaticamente a página e extrair detalhes relevantes do item (nome, descrição, categorias, etc.) para classificação. Disponível em Dashboard clicando no ícone + ou adicionando diretamente no campo de texto principal. Para integrações API, entre em contato com seu representante Zonos. Embora sejam ideais para demonstrações e testes, as implementações de produção alcançam desempenho ideal e eficiência de custos ao transmitir dados de itens diretamente de sistemas back-end. |
| Descrição (opcional) | Uma descrição detalhada e longa do produto |
| URL da imagem (opcional) | Link para uma imagem do produto. Observação: certifique-se de usar um link para o URL da imagem real e não para o URL da página do produto |
| Categorias (opcional) | Categorias gerais de subprodutos, por exemplo, Roupas e acessórios, suprimentos para animais de estimação, produtos de escritório ou Roupas de bebê, camas para animais de estimação, adesivos e fitas adesivas |
| Material (opcional) | Do que o produto é feito, por exemplo, plástico, madeira, aço |
| País de Origem (opcional) | O abreviatura de duas letras (código ISO) para o país de fabricação ou produção do produto |
| Código HS fornecido (opcional) | Inclua um HS code existente em sua solicitação de classificação para orientar sua solicitação. Dependendo da sua preferência e da origem do HS code fornecido, Classify pode validar o HS code e verificar sua coerência com os detalhes da descrição do item. Saber mais. |
| País de destino (opcional) | Identifica em qual país o produto será classificado. O país de destino deve ser exibido com o nome de cada país abreviatura de duas letras (código ISO) e não o nome real do país, por exemplo, AU, não Austrália. A inclusão deste campo permitirá que Classify retorne um HS code específico do país com mais de 8 dígitos em vez do código universal de 6 dígitos. Saiba mais sobre as diferenças entre universal e específico do país HS codes. |
| ID do produto (opcional) | Seu ID do produto ou qualquer número que possa ser usado para identificar cada produto de maneira exclusiva. Se um ID de produto não for fornecido, Classify atribuirá IDs de produto começando com 1 |
Observação: Se você estiver enviando seu CSV de solicitação em massa em Dashboard, o país de destino não fará parte do modelo; em vez disso, você selecionará seus países de destino depois de fazer upload do CSV de solicitação em massa.
Solicite uma classificação
Para solicitar classificação em Dashboard ou via API, siga os passos e mutação abaixo.
O exemplo abaixo mostra uma solicitação universal (6 dígitos). Para solicitar classificações para países específicos, adicione os países Códigos ISO na solicitação Classify conforme visto no exemplo abaixo. Para solicitar um HS code universal, deixe o país de destino null na solicitação Classify.
A entrada recebe uma lista para que você possa solicitar várias ou uma única classificação de uma vez.
Observação: Para gerar trilhas de auditoria via API, inclua o
auditTrailcampo em sua consulta. Entre em contato com seu representante Zonos para obter detalhes de acesso e implementação.
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) { classificationsCalculate(input: $input) { id name categories imageUrl hsCode { code description { full } } }}Possíveis respostas API
Quando Classify recebe uma solicitação de classificação, ele tenta combinar os dados do item de entrada incluídos na solicitação com uma correspondência no banco de dados de Classify com base na pontuação de confiança mais alta. Com base no que for encontrado, Classify retornará uma das seguintes respostas:
- Quando
hsCodeé retornado com um HS code de 6 a 8+ dígitos, dependendo se um país de destino foi incluído ou não na solicitação, sua solicitação de classificação foi bem-sucedida. - Quando
{"errors": [ { "message": "No adequate response"}]}é retornado, isso significa que Classify não conseguiu encontrar uma classificação devido a informações de entrada insuficientes.
Classifying itens
Saiba como solicitar classificação em Dashboard e via API.
Abaixo você encontrará exemplos que ilustram como solicitar classificações universais e específicas de cada país através de Dashboard ou via API. Para quem procura detalhes técnicos mais completos e documentação extensa, visite nosso Zonos GraphQL API site de referência do desenvolvedor. Este recurso abrangente oferece insights detalhados sobre endpoints API, mutações GraphQL e informações técnicas extensas.