ForHosting KIT · PDF e documentos

Etiquetas por folha

A calculadora de etiquetas por folha encontra o número de linhas, colunas e a capacidade total de uma grade retangular antes de você imprimir ou comprar material.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe as dimensões da folha e da etiqueta em uma única unidade e reserve as margens superior, direita, inferior e esquerda exigidas pela impressora. Espaçamentos horizontais e verticais opcionais representam a distância entre etiquetas. O resultado também apresenta as dimensões úteis, ocupadas e restantes para você confirmar o layout sem redimensionamento oculto.

Informe todas as dimensões na mesma unidade

Comece pela largura e altura físicas da folha e de uma etiqueta acabada. Você pode usar milímetros, polegadas, pontos ou outra unidade, pois o cálculo preserva os valores em vez de convertê-los. A regra essencial é usar a mesma unidade em todos os campos. Não combine uma folha medida em milímetros com uma etiqueta medida em polegadas. Informe o tamanho real de corte, não o tamanho da arte depois de um driver de impressão aplicar escala. Todas as dimensões precisam ser números finitos maiores que zero. Essa validação identifica medidas ausentes, negativas ou fornecidas como texto antes que gerem uma contagem enganosa. A orientação também importa: sheet_width e label_width representam a direção horizontal, enquanto os campos de altura representam a vertical. Se as etiquetas puderem ser giradas, faça outro cálculo trocando largura e altura e compare os totais. A ferramenta não gira automaticamente porque a arte, o sentido da fibra, o aplicador ou a legibilidade podem exigir uma orientação específica.

Reserve margens e espaçamentos antes da contagem

As margens representam partes da folha que não podem receber etiquetas. Informe os valores superior, direito, inferior e esquerdo separadamente para reproduzir áreas não imprimíveis assimétricas ou perdas diferentes nas bordas. Margens omitidas assumem zero. A soma das margens esquerda e direita pode ser igual à largura da folha, mas não pode ultrapassá-la; a mesma regra vale no eixo vertical. horizontal_gap é a distância livre entre colunas vizinhas, e vertical_gap é a distância entre linhas vizinhas. O espaçamento existe apenas entre etiquetas, nunca fora da primeira ou da última; portanto, uma linha com três etiquetas contém dois espaços horizontais. Ambos assumem zero e não aceitam valores negativos. A largura útil é a largura da folha menos as margens laterais, e a altura útil segue a mesma lógica. Uma coluna cabe quando sua largura e todos os espaços anteriores permanecem na área útil. Isso evita o erro comum de acrescentar espaço depois da última etiqueta e reduzir indevidamente a capacidade.

Interprete a capacidade e o espaço restante

O resultado informa columns, rows e labels_per_sheet. Linhas e colunas são inteiras porque uma etiqueta parcialmente encaixada não pode ser usada; o produto delas é a capacidade total. Um layout válido pode retornar zero quando a área disponível é menor que uma etiqueta. Isso é um resultado de encaixe, não uma entrada inválida. As dimensões úteis mostram a área após as margens. As dimensões ocupadas incluem etiquetas e espaços internos, enquanto as dimensões não utilizadas mostram a sobra dentro da área útil. Essa sobra não é dividida nem centralizada automaticamente. Para centralizar a grade, some metade de unused_width à margem esquerda e metade de unused_height à margem superior ao posicionar a primeira etiqueta. O cálculo pressupõe etiquetas retangulares alinhadas aos eixos em uma grade regular. Ele não acrescenta sangria, marcas de corte, tolerâncias da impressora, folga para cantos arredondados ou marcas de registro, a menos que você inclua essas necessidades nas dimensões, margens ou espaçamentos. Confirme a geometria com a especificação da impressora antes de uma grande tiragem.

Planejar material personalizado

Compare dimensões e espaços com a folha escolhida antes de encomendar facas, material ou produção.

Configurar um modelo de impressão

Obtenha contagens exatas e espaço restante para posicionar etiquetas em um documento ou aplicativo de layout.

Comparar orientações

Calcule as orientações normal e girada para identificar a grade válida com maior capacidade.

Quanto custa?

Cada solicitação de API custa US$ 0,002. O mesmo cálculo determinístico também pode ser executado no navegador.

Quais unidades de medida posso usar?

Qualquer unidade linear funciona, inclusive milímetros e polegadas, desde que todas as dimensões usem a mesma unidade.

Há espaçamento depois da última etiqueta?

Não. Os espaços só ficam entre etiquetas adjacentes; n etiquetas exigem n menos um espaços.

O que acontece se uma etiqueta não couber?

A calculadora retorna zero na direção em que ela não cabe, e labels_per_sheet também será zero.

A calculadora gira etiquetas para obter o melhor encaixe?

Não. Ela usa a orientação informada. Troque label_width e label_height em outra solicitação para avaliar o giro.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/doc/labels-per-sheet

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/doc/labels-per-sheet \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sheet_width":210,"sheet_height":297,"label_width":63.5,"label_height":38.1}'
{
  "sheet_width": 210,
  "sheet_height": 297,
  "label_width": 63.5,
  "label_height": 38.1
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.labels_per_sheet",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_mb25
max_pages200
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →