Pular para o conteúdo principal

Documentos adicionais do leilão

Documentos adicionais são documentos próprios do leiloeiro: carta de arrematação, termo de autorização de entrega, capa de processo, ofícios, petições. Você cria o modelo uma vez, liga o modelo à classificação dos leilões em que ele vale (ex.: "Público", "Judicial") e, daí em diante, a equipe gera o documento em qualquer leilão dessa classificação, para todos os lotes ou para um lote só, já preenchido com os dados do leilão, do lote e do arrematante.

Visão geral: os 4 passos​

PassoOndeQuem fazQuantas vezes
1. Criar o modelo do documentoGestão → Documentos → Documentos e TemplatesAdministradorUma vez por documento
2. Ligar o modelo à classificaçãoSistema → Cadastros → Classificações de LeilãoAdministradorUma vez por classificação
3. Preencher os campos do leilãoLeilão → Relatórios → Campos para documentosEquipeUma vez por leilão
4. EmitirLeilão → Relatórios (todos os lotes) ou lote → Emissão (um lote)EquipeSempre que precisar

Passo 1 — Criar o modelo​

  1. Acesse Gestão → Documentos → Documentos e Templates e clique em Novo documento.
  2. Dê um Nome (ex.: "Carta de Arrematação — Leilão Público") e um Código único sem espaços (ex.: meuleilao.carta-arrematacao).
  3. Em Categoria, escolha Termos (dentro de Documentos de leilão).
  4. Deixe Receber atualizações em Não, para o seu modelo nunca ser sobrescrito pelo sistema.
  5. Escreva o documento no editor, de preferência na aba HTML / Source (veja Como escrever o modelo abaixo).
  6. No painel Preview, informe em Leilão nº o ID de um leilão real para conferir o resultado com dados de verdade (sem informar, a prévia usa dados de exemplo).
  7. Clique em Criar documento.
dica

Recebeu o documento do cliente em Word? Copie o texto para o editor e troque cada parte que muda (nome do arrematante, valor do lance, nº do lote...) pela variável correspondente da tabela abaixo. O que muda de leilão para leilão, mas não existe no cadastro (órgão, nº do edital, processo), vira um campo para documentos (passo 3).

Detalhes do editor, da pré-visualização e dos filtros de formatação: Documentos e Templates.

Passo 2 — Ligar o modelo à classificação​

  1. Acesse Sistema → Cadastros → Classificações de Leilão e abra a classificação (lápis ou duplo clique).
  2. No bloco Documentos adicionais, clique em + Adicionar documento adicional.
  3. Em Nome do botão, escreva o nome que a equipe vai ver (ex.: "Carta de Arrematação").
  4. Em Modelo de documento, digite parte do nome e escolha o modelo criado no passo 1.
  5. Repita para cada documento e clique em Salvar.

Documentos adicionais na classificação

O documento passa a aparecer em todos os leilões dessa classificação. Detalhes: Classificações de Leilão.

Passo 3 — Preencher os campos do leilão​

Dados que o documento usa mas que não existem no cadastro do leilão ficam em Campos para documentos, na tela de Relatórios de cada leilão:

  1. Abra o leilão → Relatórios.
  2. No bloco Documentos adicionais deste leilão, clique em Campos para documentos.
  3. Preencha os campos que o modelo usa. Abaixo de cada nome aparece como ele é chamado no modelo (ex.: campos.processo).
  4. Para um dado que não está na lista, clique em + Outro campo, dê um nome sem espaços nem acentos (ex.: numeroContrato) e preencha.
  5. Clique em Salvar.

Campos para documentos e documentos adicionais

Passo 4 — Emitir​

  • Todos os lotes: em Leilão → Relatórios, no cartão do documento, clique em Imprimir. O documento abre numa nova aba com uma página por lote vendido e a janela de impressão aparece (dali você imprime ou salva em PDF).
  • Um lote: abra o lote e, no menu Emissão, escolha o documento no grupo Documentos adicionais. Sai só a página daquele lote.
  • Fila de vendas: o menu do lote na fila de vendas também lista os documentos adicionais.

Documentos adicionais no menu Emissão do lote

Como escrever o modelo​

O modelo é HTML com variáveis entre {{ }} e comandos entre {% %}. O documento recebe o leilão inteiro: para gerar uma página por lote vendido, percorra os lotes e mostre só os vendidos.

Esqueleto pronto​

Copie, cole no editor e adapte o texto. Ele já faz uma página por lote vendido, usa os campos do leilão e mostra uma mensagem quando não há lote vendido:

{% set meses = ['janeiro','fevereiro','março','abril','maio','junho','julho','agosto','setembro','outubro','novembro','dezembro'] %}
{% set total = 0 %}
<style>
@page { size: A4; margin: 18mm 20mm; }
body { font-family: Arial, sans-serif; font-size: 11.5px; }
.pagina { page-break-after: always; }
.pagina:last-child { page-break-after: auto; }
</style>

{% for lote in leilao.lotes %}
{% if lote.vendido and lote.arremate and lote.arremate.arrematante %}
{% set total = total + 1 %}
{% set arr = lote.arremate.arrematante %}
<div class="pagina">
<h1 style="text-align:center">CARTA DE ARREMATAÇÃO</h1>
<p style="text-align:center">{{ campos.orgao|default('____________') }} — Edital nº {{ campos.numeroEdital|default('___/____') }}</p>

<p><strong>Arrematante:</strong> {{ arr.pessoa.name|upper }}<br>
<strong>CPF/CNPJ:</strong> {{ arr.magic.documento }}<br>
<strong>Endereço:</strong> {{ arr.magic.endereco }}</p>

<p><strong>Lote:</strong> {{ lote.numero }} — {{ lote.descricaoNota|semHtml }}<br>
<strong>Lance:</strong> {{ lote.valorArremate|moeda }}<br>
<strong>Comissão:</strong> {{ lote.valorComissao|moeda }}</p>

<p>Processo nº {{ campos.processo|default('____________') }}.</p>

<p style="text-align:right">{{ 'now'|date('d') }} de {{ meses['now'|date('n') - 1] }} de {{ 'now'|date('Y') }}.</p>
</div>
{% endif %}
{% endfor %}

{% if total == 0 %}<p>Nenhum lote vendido neste leilão.</p>{% endif %}

Variáveis disponíveis​

VariávelO que traz
{{ leilao.titulo }}, {{ leilao.codigo }}Título e código do leilão
{{ leilao.data1|date('d/m/Y') }}Data do leilão (1ª praça)
{{ leilao.leiloeiro.nome }}, .matricula, .documentoNome, matrícula na Junta e CPF do leiloeiro
{{ leilao.leiloeiro.endereco }}, .telefones, .emailsContato do leiloeiro (bom para rodapé)
{{ leilao.leiloeiro.urlLogomarca }}Endereço da logomarca: <img src="{{ leilao.leiloeiro.urlLogomarca }}">
{% for lote in leilao.lotes %}Percorre os lotes (só o lote escolhido quando emitido pelo menu do lote)
{{ lote.numero }}Número do lote
{{ lote.descricaoNota }}Descrição do lote com placa e chassi, quando houver
{{ lote.bem.siteDescricao }}Descrição completa do bem
{{ lote.valorMinimo }}, {{ lote.valorArremate }}Valor mínimo e valor do lance vencedor
{{ lote.valorComissao }}, {{ lote.taxasSemComissao }}Comissão do leiloeiro e demais taxas
{{ lote.bem.comitente.pessoa.name }}Nome do comitente
lote.vendidoVerdadeiro quando o lote foi vendido (use no {% if %})
{{ arr.pessoa.name }}Nome do arrematante (com {% set arr = lote.arremate.arrematante %})
{{ arr.magic.documento }}CPF/CNPJ formatado
{{ arr.magic.endereco }}Endereço completo com CEP
{{ arr.magic.telefones }}, {{ arr.magic.emails }}Telefones e e-mails
{{ arr.magic.rgIe }}RG ou inscrição estadual
{{ campos.orgao }}, {{ campos.processo }}...Campos para documentos preenchidos no leilão (passo 3)

Filtros de formatação (moeda, cpfCnpj, date, upper, default...) estão em Documentos e Templates → Formatação de valores.

Regras para o modelo funcionar​

  • Uma página por lote: envolva cada lote num bloco com page-break-after: always (como no esqueleto).
  • Campo vazio: use |default('____') para sair uma linha para preencher à mão quando o campo não foi preenchido.
  • Contador fora do laço: para saber se houve lote vendido, crie a variável antes do {% for %} ({% set total = 0 %}) e some dentro dele, como no esqueleto.
  • Recursos permitidos: os documentos rodam num ambiente protegido. Use só if, for, set e filtros de formatação; o filtro filter(...) e funções de programação não são aceitos e a pré-visualização mostra o erro com a linha.
  • Sempre pré-visualize com um leilão real (campo Leilão nº do Preview) antes de ligar o modelo à classificação. Com dados de exemplo, a prévia já traz campos fictícios (órgão, processo...) para você ver o layout.

Regras de negócio e permissões​

  • Só modelos da classificação: um leilão só gera os documentos ligados à classificação dele. Trocar a classificação do leilão troca os documentos disponíveis.
  • Só lotes do leilão: pelo menu do lote, o documento sai apenas com aquele lote.
  • Permissões: emitir e ver os campos exige Gerar documentos adicionais do leilão; salvar os campos para documentos exige Atualizar Leilão; criar e editar modelos exige Criar Documento / Atualizar Documento.
  • Campos para documentos são de cada leilão: preencher num leilão não muda os outros.

Erros comuns​

SituaçãoO que fazer
O documento não aparece em Relatórios nem no menu do loteConfira se o modelo está ligado à classificação deste leilão (passo 2) e se o leilão tem classificação.
"Este modelo não está entre os documentos adicionais da classificação deste leilão"O modelo foi desligado da classificação ou o leilão mudou de classificação. Ligue de novo no passo 2.
Sai uma linha ____ onde devia ter um dadoO campo não foi preenchido em Campos para documentos (passo 3) ou o nome no modelo está diferente (ex.: campos.Processo × campos.processo).
"Nenhum lote vendido"O leilão ainda não tem lote vendido com arrematante.
Aparece p-n/d ou v-n/d no documentoA variável não existe; confira o nome na tabela acima.
A pré-visualização acusa erro de segurançaO modelo usa um recurso não permitido (ex.: filter). Reescreva com {% if %} dentro do {% for %}, como no esqueleto.
Pop-up bloqueadoLibere pop-ups do ERP no navegador; o documento abre numa nova aba.

Veja também​