salvar_campo_formulario_proposta
Add or move a simple field in a proposal form. Specify the field key, target section, and whether it should occupy full width.
Instructions
Adicionar ou mover um campo simples no formulário de um modelo de
Proposta/Venda/Documento.
Se o campo (FieldKey) já existir no formulário, ele é movido para a
seção/posição indicada em vez de ser duplicado.
Observações:
1. Use buscar_templates_documentos para obter o template_id, ou
informe form_id diretamente.
2. Use buscar_formulario_proposta para ver os campos já existentes,
os IDs de seção e os FieldKeys nativos (ex.: quote_amount,
quote_expiration_date) ou personalizados (via
buscar_campos_entidades).
3. largura_total=True faz o campo ocupar a linha inteira do
formulário.
4. Esta ferramenta só cria campos simples (um valor por campo).
Blocos repetíveis (produtos/parcelas) NÃO são criados por uma API
de campo de formulário — o Ploomes deriva o formulário a partir
do parsing do HTML do modelo (BodySourceCode). Tentar forçar um
bloco por aqui cria um campo com QuickFormId nulo (quebrado, sem
efeito). Para o bloco de Produtos, use
montar_bloco_produtos_proposta em vez desta ferramenta.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| form_id | No | ||
| secao_id | No | ||
| ordenacao | No | ||
| chave_campo | Yes | ||
| template_id | No | ||
| largura_total | No |