Os modelos de documentos no Bitrix24 geram contrato, fatura ou ata direto da ficha do negócio: um arquivo docx com campos de substituição é preenchido com os dados do CRM em um clique. Isso economiza horas enquanto o modelo é simples — e depois começam o «valor por extenso», as datas no caso gramatical certo e os dados de registro vazios no contrato pronto. Vamos ver a criação do modelo, a sintaxe das substituições e a técnica que resolve todos os casos difíceis: preparar os valores com robôs antes da geração.

Como criar um modelo de documento?

CRM → Configurações → Modelos de documentos (ou direto da ficha: «Documento» → «Adicionar novo modelo»). O modelo é um arquivo docx comum, em que no lugar dos dados ficam os códigos dos campos entre chaves: {DocumentNumber}, {Today}, {Client}, além dos campos do negócio e dos dados das partes — a lista completa de códigos o Bitrix24 mostra na página do modelo. Carregue o arquivo, marque a quais seções do CRM ele está atrelado (negócios, processos inteligentes) e de quais «Meus dados» inserir o vendedor. Depois o documento é criado a partir da ficha: os valores são inseridos, o arquivo é salvo na linha do tempo, e pelo link ficam disponíveis a versão impressa e o PDF.

Quais campos e modificadores estão disponíveis no modelo?

São inseridos três grupos de dados: campos do documento (negócio, lead, processo inteligente) — inclusive os personalizados; dados de registro das duas partes — por códigos separados para a organização e os dados bancários; campos de serviço — número, data, autor. Aos campos aplicam-se modificadores de formato: número sem centavos, data em formato curto, casos gramaticais para o nome completo. Os modificadores resolvem a tipografia, mas não a lógica: «se o campo estiver vazio — colocar um traço», «prazo = data de assinatura mais cinco dias úteis», «valor com desconto» — isso não existe nos modelos. A fronteira é assim: o formato do valor — por modificador, o cálculo do valor — pelo processo antes da geração.

Como inserir o valor por extenso e valores calculados?

A técnica é uma só e funciona para qualquer campo «fora do padrão»: crie no negócio ou no processo inteligente um campo personalizado para o resultado, calcule-o com um robô no processo de negócios e referencie o campo no modelo. Valor por extenso: o robô «Valor por extenso (RUB)» transforma «125 000» em «Cento e vinte e cinco mil rublos e 00 copeques» e grava no campo «Valor por extenso» — o modelo o insere ao lado do número. Datas no formato certo: «Formatação de data» prepara «12 de junho de 2026» a partir do valor do sistema. Valores calculados — imposto, saldo, prazo de validade — são apurados por uma cadeia de robôs para o mesmo lugar. Assim o modelo continua um docx simples, e toda a lógica vive no processo, onde é visível e pode ser alterada.

Como não gerar um contrato com campos vazios?

O erro mais caro dos modelos é «INN: __» em um contrato assinado. A proteção é colocada no processo de negócios antes da geração: o robô «Verificar preenchimento de campo» verifica os campos críticos (valor, dados de registro, prazo), e «Obter dado de registro da empresa» — se a contraparte tem INN e conta corrente preenchidos. Vazio — o processo não gera o documento, e sim cria uma tarefa para o gerente com a lista do que falta. A geração por botão permanece, mas em cenários regulamentados o documento é criado pelo próprio processo — depois de todas as verificações.

Problemas frequentes com modelos

O campo não foi inserido — o código no modelo não bate com o código real do campo: copie o código da página do modelo de novo, não redigite à mão. A formatação se desfez — o docx com substituições dentro de tabelas e cabeçalhos é caprichoso: mantenha os campos em parágrafos e células comuns, sem tabelas aninhadas. Dados de registro errados do vendedor — no modelo foi escolhido outro conjunto de «Meus dados»: com várias pessoas jurídicas, faça um modelo separado para cada uma. O número do documento se duplica — o numerador é único por modelo: para séries separadas (contratos/faturas) use modelos diferentes com numeradores diferentes.

Resumo

Um modelo de documento é docx mais disciplina de dados: os valores são preparados pelo processo de negócios, a verificação de preenchimento fica antes da geração, e o valor por extenso e as datas formatadas são feitos por robôs do catálogo do Roboteka — de graça, no mesmo designer. Não há a transformação necessária — descreva a tarefa, fazemos o robô.