> For the complete documentation index, see [llms.txt](https://manual.kartado.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.kartado.com.br/exportacoes/construtor-de-relatorios/construtor-de-relatorios-pdf-apontamentos.md).
# Construtor de Relatórios PDF - Apontamentos
Aprenda mais sobre o Construtor de Relatórios PDF: onde encontrar e como criar seus próprios modelos de relatório em PDF a partir dos dados de apontamentos.
{% hint style="info" %} **IMPORTANTE!** Caso o Construtor de Relatórios não esteja disponível na sua unidade, entre em contato com o time de Suporte e solicite a parametrização.
{% endhint %}
{% hint style="danger" %} **ATENÇÃO!** O Construtor de Relatórios PDF funciona apenas com dados de **apontamentos**. Não é possível gerar relatórios de Inventário, RDO ou outros módulos.
{% endhint %}
Com o **Construtor de Relatórios PDF**, você monta e mantém seus próprios modelos de exportação direto na plataforma, no formato que seu órgão concedente exige, sem depender de ajuste feito pela Kartado — reproduzindo o layout pedido por cada concedente, com o relatório já saindo pronto com os dados do apontamento.
### **O que você vai precisar**
* Funcionalidade liberada e acesso ao painel de '**Configurações**'.
* Permissão de visualizar/criar modelos.
* Permissão para exportação de relatórios.
***
## Passo a passo
### Criar Modelo
1. Acesse **Configurações > Customização > Modelos de Relatório**.
2. Clique em **NOVO MODELO**, escolha **Em branco** e, em seguida, a opção **PDF**. No PDF você monta o modelo do zero: os templates pré-prontos existem apenas para Excel.
3. Preencha o **nome do modelo** e o **nome do arquivo** (o nome do arquivo é sugerido automaticamente a partir do nome do modelo).
4. Selecione a **Natureza** e, em seguida, a **Classe**. Depois de selecionar a Classe, o painel à esquerda passa a mostrar também uma seção própria de **Campos da Classe**, além dos Componentes e Campos Fixos.
5. Monte o relatório arrastando os componentes (**Título**, **Texto**, **Label**, **Divisor Horizontal**, **Divisor Vertical**, **Contêiner**, **Imagem**):
* Soltar na borda direita de um componente já posicionado coloca os dois lado a lado, redistribuindo as larguras proporcionalmente.
* Soltar na borda inferior cria uma nova linha.
* Para reordenar, é só arrastar — tanto no canvas quanto dentro de um Contêiner.
* Ajuste as propriedades do componente selecionado no painel direito: largura em colunas, cor de fonte e de fundo, alinhamento, negrito/itálico/sublinhado, tamanho e fonte.
#### Label
O **Label** junta o título e o valor de um campo, lado a lado. É o que dá sentido ao dado no relatório:
* **Sem Label**: ao arrastar só o campo '**km**', o relatório mostra apenas o valor — '100+000' —, sem dizer o que aquele número significa.
* **Com Label**: você escreve o título que quiser, por exemplo '**Km inicial**', e encaixa o campo ao lado. O relatório sai '**Km inicial: 100+000**'.
#### Contêiner
O **Contêiner** agrupa outros componentes dentro dele, lado a lado ou em linhas, e ajusta a altura ao conteúdo. Nas propriedades, você define largura em colunas, alinhamento, cor de fundo e cor da borda — e pode marcá-lo como cabeçalho, para que o conteúdo se repita em todas as páginas.
{% hint style="success" %} **DICA:** o Contêiner é o caminho mais completo para o cabeçalho, porque aceita divisor, imagem e outros componentes dentro dele — não apenas texto.
{% endhint %}
#### Adicionar Imagens
No bloco de **Imagem**, arraste para dentro dele o campo '**Fotos do apontamento**', um campo de imagem da '**Classe**', ou selecione uma imagem do computador para usar como logo.
* Para '**Fotos do apontamento**' ou imagem da '**Classe**', você pode definir:
* **Tipo de imagem**
* **Ordenação das fotos** (da mais nova para a mais antiga ou o contrário)
* **Quantidade** (de 1 a 20)
* **Fotos por linha** (até 6)
* **Altura da imagem**, em pixels
* **Ajuste da foto**: Conter mostra a imagem inteira; Preencher recorta o que não couber
* **Cor de fundo** e **cor da borda**, transparentes por padrão
* Para logo, você ajusta:
* **Largura** em colunas (12 por padrão)
* **Alinhamento**
* **Altura da imagem**
* **Ajuste da foto**
* **Cor de fundo** e **cor da borda**
* As ações **Trocar imagem** e **Remover imagem**
O logo não tem **Tipo de imagem**, **Quantidade** nem **Fotos por linha**.
{% hint style="danger" %} **ATENÇÃO!**
1. O campo de imagem só é aceito dentro do bloco de Imagem.
2. O aviso '**Configuração duplicada**' aparece no topo do painel quando dois blocos de imagem estão com as mesmas configurações. Para resolver, mude o tipo ou a ordenação de um deles — o aviso some assim que ficarem diferentes.
{% endhint %}
6. Clique em **SALVAR**.
{% hint style="success" %} **DICA:** Para criar um cabeçalho que se repete em toda folha, há duas formas: colocar um **Título** como primeiro elemento da página, ou inserir um **Contêiner** e marcar como cabeçalho nas suas propriedades.
{% endhint %}
### Escolher quais fotos entram nos relatórios
Por padrão, toda foto do apontamento é considerada pelos modelos do construtor. Para deixar uma foto de fora sem apagá-la do apontamento, desligue o interruptor '**Incluir nos relatórios do construtor**':
* **No apontamento**: acesse '**Arquivos e Imagens**', clique sobre a foto e desligue o interruptor na página de detalhes. A alteração é gravada na hora, sem precisar salvar.
* **Na lista de apontamentos (individual)**: clique no ícone de foto ao lado do apontamento, clique sobre a foto para abrir o carrossel, clique em editar, desligue o interruptor e salve.
* **Na lista de apontamentos (em massa)**: selecione os apontamentos (no máximo **300** por vez), clique em '**Incluir fotos em relatórios do construtor**', desmarque as fotos que não devem sair e confirme. Nada é gravado até a confirmação.
{% hint style="info" %} **IMPORTANTE!** O interruptor e a ação em massa só aparecem para quem tem permissão de criar modelos do construtor.
{% endhint %}
### Exportar Relatório
1. Na lista de apontamentos, aplique o filtro de '**Classe**' correspondente ao modelo.
2. Clique em **BAIXAR** e escolha o modelo — ele aparece no fim do menu, depois dos relatórios pré-definidos, em ordem alfabética. Os modelos criados em PDF não têm opção de exportar em Excel.
{% hint style="info" %} **IMPORTANTE!** O arquivo sai em **A4, retrato**, com o nome definido no campo '**nome do arquivo**' do modelo e a extensão **.pdf**. Se o modelo tiver cabeçalho, ele aparece uma vez por página, com os apontamentos organizados abaixo. Todo relatório tem um rodapé com '**Kartado**', a **data da geração** e o **número da página**. Campos não preenchidos no apontamento — de imagem ou não — saem em branco.
{% endhint %}
{% hint style="danger" %} **ATENÇÃO!** Sem o filtro de '**Classe**' aplicado, ou com mais de uma '**Classe**' no filtro, o modelo fica desabilitado. O limite é de **1.500 apontamentos por exportação**. Modelos do construtor só aparecem no botão **BAIXAR** da lista de Apontamentos.
{% endhint %}
### Editar Modelo
1. Na listagem, clique no ícone :pen: (lápis) do modelo desejado.
2. O canvas abre já montado, com nome, nome do arquivo, Natureza, Classe e componentes preenchidos.
3. Faça as alterações e clique em **SALVAR**.
{% hint style="info" %} **IMPORTANTE!** O formato (PDF ou Excel) não pode ser trocado na edição. Se precisar do outro formato, crie um modelo novo.
{% endhint %}
### Excluir Modelo
1. Na listagem, clique no ícone :trash: (lixeira) do modelo desejado.
2. Confirme clicando em **APAGAR** no diálogo '**Excluir modelo?**' (ou **CANCELAR** para desistir).
{% hint style="danger" %} **ATENÇÃO!** A exclusão é **permanente** e não pode ser desfeita.
{% endhint %}
***
## **Artigos Relacionados**
{% content-ref url="/pages/irLZ9WLx8VEP2bmks6XN" %}
[FAQ - Construtor de Relatórios PDF](/faq/faq-construtor-de-relatorios-pdf.md)
{% endcontent-ref %}
{% content-ref url="/pages/bfe9wT6cEfOlc721XA75" %}
[Construtor de Relatórios Excel - Apontamentos](/exportacoes/construtor-de-relatorios/construtor-de-relatorios-excel-apontamentos.md)
{% endcontent-ref %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://manual.kartado.com.br/exportacoes/construtor-de-relatorios/construtor-de-relatorios-pdf-apontamentos.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
