gPdf render/edge
Recursos

Os detalhes essenciais, bem feitos.

Semântica de documento real, não capturas de navegador num wrapper PDF.

Browse use cases
/01

Controle ao pixel

x/y em milímetros, x_anchor para alinhamento à direita, posicionamento submilimétrico em etiquetas. Coordenadas, não aproximações.

// inside elements[i]
"x_anchor": {
  "reference": "content_right",
  "offset": 6
}
/02

Códigos de barras vetoriais

30+ simbologias incl. GS1-128, QR, PDF417, DataMatrix. Todos vetoriais. Comprimento total preciso a 0,1 mm.

// 30+ formats: code128, qrcode, datamatrix, pdf417, ...
"type": "barcode",
"format": "code128",
"content": "INV-2026-001"
Why vector beats raster
/03

Cadeia de fallback de fontes

font_mode: strict (a família declarada deve cobrir todos os glifos), prefer (recorre às famílias integradas), auto (motor escolhe). Esgotamento de auto/prefer retorna API-504 — falha explícita, não silenciosa.

// inside style{}
"font_family": "NotoSans-Regular",
"font_mode": "prefer"
/04

Modos de conformidade

settings.profile = "pdfa-3b" ativa a conformidade PDF/A-3b mais o fluxo de anexos XML incorporado que Factur-X / ZUGFeRD requerem. Um campo, um documento conforme.

// top-level on DocumentRequest
"settings": {
  "profile": "pdfa-3b"
}
PDF/A and Factur-X, explained
/05

Variáveis + paginação

{page} / {total_pages} resolvidos pós-layout. keep_together, widow/orphan, blocos page_break.

// element of type "variable"
{ "type": "variable",
  "name": "page",
  "scope": "system" }
/06

Tabelas que paginam

row_span entre páginas, cabeçalhos repetidos, alternate_fill, bordas duplas compostas. O 1 % que sempre quebra.

// inside table element
"pagination": {
  "keep_spans_together": true
}
/07

Um JSON, duas superfícies

O mesmo JSON DocumentRequest impulsiona POST /api/v1/pdf/render e o editor visual em editor.gpdf.com. Edite visualmente, entregue via API ou escreva à mão — os três fluxos round-trippam o mesmo arquivo.

// three routes, one engine
POST /api/v1/pdf/render
POST /api/v1/template-render
POST /api/v1/e-invoice/render
Read the API reference
/08

Construído para faturas

$0,00005 por página, p50 3 ms, CJK embutido, fluxo de anexo PDF/A-3. Os quatro números que equipes fintech, ERP e compliance fiscal verificam primeiro.

// invoice — header + table pattern
{ "size": "a4",
  "elements": [
    { "type": "text",  "x": 18, "y": 22, ... },
    { "type": "table", "x": 18, "y": 60, ... }
  ]}
Why JSON beats HTML→PDF
/09

Construído para etiquetas de envio

Presets de tamanho label_100_150 e label_4_6_in. GS1-128, ITF-14, SSCC vetoriais com precisão de 0,1 mm — transportadoras e 3PLs imprimem no pico sem códigos de barras rasterizados.

// 4×6 thermal shipping label
{ "size": "label_4_6_in",
  "elements": [{
    "type": "barcode",
    "format": "code128",
    "content": "1Z999AA10123456784" }]}
Shipping-label use case

Relacionados