API · Etiquetas e expedição

API de etiquetas ZPL para marketplaces e expedição

Converta ZPL em PDF (ou PNG) para visualizar e arquivar, transforme a etiqueta em PDF do marketplace em ZPL para a impressora térmica e gere etiquetas e romaneio direto da planilha de pedidos. Tudo por chamada HTTP, sem instalar driver.

Criar chave grátis Ver documentação

500 créditos grátis por mês · sem cartão · Pix, cartão e nota fiscal

Para quem é

Marketplaces e sellers

Mercado Livre, Shopee, Amazon e Magalu: etiquetas, romaneio e notas sem trabalho manual.

ERPs e hubs de integração

Adicione PDF, DANFE, etiquetas e consultas ao seu sistema sem manter infraestrutura.

Lojas e e-commerce

Plataformas próprias, Shopify, Nuvemshop, VTEX e WooCommerce automatizando a expedição.

SaaS e plataformas

Produtos que geram contratos, relatórios e comprovantes para os próprios clientes.

Fluxos que você automatiza

Etiqueta do marketplace direto na Zebra
Baixe o PDF da etiqueta (Mercado Livre, Shopee, Correios), envie para pdf-para-zpl com o tamanho 10×15 e a resolução da impressora e mande o ZPL para a porta 9100. Sem diálogo de impressão e sem etiqueta torta.
PDF para ZPL
Prévia e arquivo do ZPL gerado pelo seu sistema
Seu WMS ou ERP já gera ZPL? Envie o código para zpl-para-pdf e guarde um PDF por etiqueta, ou mostre a prévia em PNG para o operador conferir antes de imprimir.
ZPL para PDF
Folha A4 com etiquetas 10×15 recortadas
Recorte automaticamente as etiquetas de envio que vêm em folha A4 e junte a lista de separação e o romaneio de coleta para a transportadora assinar.
Recortar etiqueta de envio (10×15) · Lista de separação (picking) pelo XML da NF-e · Romaneio de coleta pelo XML da NF-e
Etiquetas e romaneio a partir da planilha de pedidos
Envie o CSV ou XLSX exportado da loja e receba as etiquetas (10×15, 10×10 ou A4) com código de barras e o romaneio de entregas; endereços com CEP inválido voltam listados.
Etiquetas de envio a partir de planilha · Etiqueta de volumes pelo XML da NF-e · POST /v1/barcode · GET /v1/cep/{cep}

Exemplo de código

Autentique com a chave no cabeçalho Authorization: Bearer. Respostas em JSON com mensagens em português; use ?wait=true para receber o resultado na mesma chamada ou webhook_url para ser avisado.

ZPL para PDF

curl -X POST "https://convertaja.com.br/v1/tools/zpl-para-pdf?wait=true" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -F "files=@arquivo1.zpl" \
  -F 'options={"width_mm":100,"height_mm":150,"dpmm":"8","format":"pdf"}'

import { openAsBlob } from 'node:fs';

const form = new FormData();
form.append('files', await openAsBlob('arquivo1.zpl'), 'arquivo1.zpl');
form.append('options', JSON.stringify({"width_mm":100,"height_mm":150,"dpmm":"8","format":"pdf"}));

const res = await fetch('https://convertaja.com.br/v1/tools/zpl-para-pdf?wait=true', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.CONVERTAJA_KEY}` },
  body: form,
});
const job = await res.json();
console.log(job.status, job.outputs);

import json, os, requests

res = requests.post(
    "https://convertaja.com.br/v1/tools/zpl-para-pdf",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['CONVERTAJA_KEY']}"},
    files=[("files", open("arquivo1.zpl", "rb"))],
    data={"options": json.dumps({"width_mm": 100, "height_mm": 150, "dpmm": "8", "format": "pdf"})},
)
job = res.json()
print(job["status"], job.get("outputs"))

<?php
$ch = curl_init('https://convertaja.com.br/v1/tools/zpl-para-pdf?wait=true');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CONVERTAJA_KEY')],
  CURLOPT_POSTFIELDS => [
    'files[0]' => new CURLFile('arquivo1.zpl'),
    'options' => json_encode(['width_mm' => 100, 'height_mm' => 150, 'dpmm' => '8', 'format' => 'pdf']),
  ],
]);
$job = json_decode(curl_exec($ch), true);
echo $job['status'];

PDF da etiqueta para ZPL (Zebra 203 dpi)

curl -X POST "https://convertaja.com.br/v1/tools/pdf-para-zpl?wait=true" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -F "files=@arquivo1.pdf" \
  -F 'options={"size":"100x150","dpmm":"8"}'

import { openAsBlob } from 'node:fs';

const form = new FormData();
form.append('files', await openAsBlob('arquivo1.pdf'), 'arquivo1.pdf');
form.append('options', JSON.stringify({"size":"100x150","dpmm":"8"}));

const res = await fetch('https://convertaja.com.br/v1/tools/pdf-para-zpl?wait=true', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.CONVERTAJA_KEY}` },
  body: form,
});
const job = await res.json();
console.log(job.status, job.outputs);

import json, os, requests

res = requests.post(
    "https://convertaja.com.br/v1/tools/pdf-para-zpl",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['CONVERTAJA_KEY']}"},
    files=[("files", open("arquivo1.pdf", "rb"))],
    data={"options": json.dumps({"size": "100x150", "dpmm": "8"})},
)
job = res.json()
print(job["status"], job.get("outputs"))

<?php
$ch = curl_init('https://convertaja.com.br/v1/tools/pdf-para-zpl?wait=true');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CONVERTAJA_KEY')],
  CURLOPT_POSTFIELDS => [
    'files[0]' => new CURLFile('arquivo1.pdf'),
    'options' => json_encode(['size' => '100x150', 'dpmm' => '8']),
  ],
]);
$job = json_decode(curl_exec($ch), true);
echo $job['status'];

Ferramentas e custo por operação

Ferramenta ou endpoint	Chamada	Créditos
ZPL para PDF	`POST /v1/tools/zpl-para-pdf`	1 por arquivo
PDF para ZPL	`POST /v1/tools/pdf-para-zpl`	1 por arquivo
Recortar etiqueta de envio (10×15)	`POST /v1/tools/recortar-etiqueta`	1 por arquivo
Etiquetas de envio a partir de planilha	`POST /v1/tools/etiquetas-envio-planilha`	1 por arquivo
Lista de separação (picking) pelo XML da NF-e	`POST /v1/tools/lista-de-separacao`	1 por arquivo
Romaneio de coleta pelo XML da NF-e	`POST /v1/tools/romaneio-de-coleta`	1 por arquivo
Etiqueta de volumes pelo XML da NF-e	`POST /v1/tools/etiqueta-de-volumes`	1 por arquivo
Gerar código de barras	`POST /v1/barcode`	1 por chamada
Consultar CEP	`GET /v1/cep/{cep}`	grátis

Preços em reais, sem surpresa

Comece no Sandbox com 500 créditos grátis por mês, sem cartão. Planos pagos a partir de R$ 29,00/mês (Mini, 1.000 créditos) até 30.000 créditos no Scale, a R$ 0,015 por crédito. Anual = 10× o mensal (2 meses grátis). Pix, cartão e nota fiscal.

Tarefa que termina com erro não é cobrada: os créditos voltam automaticamente.

Ver planos e calculadora Volume acima de 30.000 créditos/mês? Fale com vendas

Perguntas frequentes

Quais impressoras são compatíveis?

Qualquer impressora térmica que entenda ZPL (Zebra, Elgin, Argox em modo ZPL e similares). Escolha a resolução da impressora: 8 pontos/mm (203 dpi), 12 (300 dpi) ou 24 (600 dpi).

Quanto custa converter uma etiqueta?

Converter ZPL para PDF ou PDF para ZPL custa 1 crédito por arquivo enviado, e um arquivo pode ter várias etiquetas. Se a tarefa der erro, o crédito volta.

Dá para mandar o ZPL como texto, sem arquivo?

Sim. Em zpl-para-pdf você pode enviar o código no campo de opção zpl em vez de um arquivo .zpl ou .txt.

Funciona com etiquetas do Mercado Livre, Shopee e Correios?

Sim. O recorte de etiquetas reconhece as folhas A4 com etiquetas 10×15 desses canais, e o PDF resultante pode ser convertido em ZPL para impressão térmica.

Preciso de cartão para testar?

Não. O plano Sandbox é grátis, com 500 créditos por mês, e as chaves de teste não consomem créditos.

Guias passo a passo

Outros casos de uso da API

Comece em 2 minutos

Entre com seu e-mail, crie a chave em Minha conta → API e faça a primeira chamada. Precisa de volume alto, contrato ou faturamento personalizado? Fale com vendas.

Criar chave grátis