Resumo: o item
FORM é o formulário que a sua organização monta uma vez, no modelo, e que o destinatário responde pelo link. Ele tem duas partes: campos prontos, escolhidos por marcação, e campos livres, criados por você.Esta página trata do item
FORM, respondido dentro de uma solicitação já aberta. O link aberto que qualquer pessoa usa para começar o próprio cadastro ou pedido é outra coisa: está em Formulário público.Onde o formulário mora
O formulário é declarado no item do modelo, no campoformSpec. Item FORM sem formSpec é recusado: não haveria o que perguntar.
Campos prontos
Escolhidos por marcação, já vêm com rótulo, máscara e validação.Campos livres
Cada campo livre precisa dekey, label, type e required. Aceita ainda hint (dica curta abaixo do campo) e maxLength.
Regras da chave
Akey é kebab-case (faturamento-medio-mensal), até 60 caracteres, e é ela que vira chave na resposta gravada. Mudar a chave depois de publicado desliga a resposta que já existia, então trate a chave como estável entre versões.
Limites
Sócios
ComallowPartners: true, o destinatário pode acrescentar sócios ao formulário: nome, documento, função, participação, e-mail e telefone. Para sócio pessoa física, o formulário pergunta também estado civil e regime de bens, a menos que o modelo desligue com partnerFields: []. É o caminho para o quadro societário que a empresa declara, ao lado do que a fonte oficial diz.
Para onde vai a resposta
A resposta enviada não fica presa na solicitação. Ela vai para o cadastro:
É por isso que a etapa Solicitação da esteira, no modo dos sócios, já encontra o contato de quem o cliente acabou de informar, sem esperar um primeiro envio.
Pré-preenchimento pela extração
Quando o cadastro já tem documento validado, o formulário chega pré-preenchido com o que a IA leu. A pessoa confere em vez de digitar. Três coisas acontecem em volta disso, e todas viram trilha:Correção de sugestão e contestação de fonte oficial são ações separadas de propósito. A primeira mede a qualidade da extração; divergência de cadastro não diz nada sobre a leitura do PDF, e misturar as duas estragaria a única métrica que diz se a IA está lendo direito.
O formulário no termo
As respostas do formulário podem ser citadas dentro de um termo, pela variável<<form.CHAVE>>. Quando o termo cita uma resposta, ele só fica assinável depois que o formulário concluir (comportamento blockSignatureUntilDependenciesMet, ligado por padrão).