montar_bloco_produtos_proposta
Inserts a repeatable products block into a proposal template HTML page to automatically derive form fields for product items.
Instructions
Inserir o bloco repetível de "Produtos" (itens da proposta) no HTML de
uma página de um modelo de Proposta/Venda/Documento (PVD).
CONTEXTO: no Ploomes, o formulário de uma proposta (os campos que o
usuário preenche ao gerar uma PVD) não é criado por uma API de "campo
de formulário" isolada — ele é DERIVADO pelo backend a partir do
parsing do HTML salvo em Pages[].BodySourceCode. Isso vale
especialmente para blocos repetíveis (produtos, parcelas): não existe
endpoint para criar o FormField de um bloco diretamente (tentar isso
via salvar_campo_formulario_proposta cria um campo com QuickFormId
nulo, ou seja, quebrado). A forma real de criar um bloco funcional é
escrever a tag HTML correta no corpo do modelo e deixar o Ploomes
derivar o FormField (com QuickFormId) ao salvar — que é exatamente o
que esta ferramenta faz.
Parâmetros:
template_id: Id do DocumentTemplate (use buscar_templates_documentos).
pagina_id: Id da página (Pages) onde inserir o bloco. Se omitido,
usa a primeira página do modelo (menor Ordination).
nome_secao/codigo_secao: viram section-name/section-code no HTML.
codigo_secao deve ser único entre os blocos deste modelo — use
0 para o primeiro bloco (é o valor usado em todo modelo padrão
observado). Não testado com mais de um bloco de produto.
campos: lista de FieldKeys das colunas do bloco, na ordem desejada.
Suportados hoje: product_name, product_code,
product_measurement_unit, quote_product_quantity,
quote_product_unit_price, quote_product_discount,
quote_product_total.
posicao: "fim" (default) ou "inicio" — onde no HTML atual da
página o bloco é inserido.
oculto: se True, marca a seção como oculta por padrão no HTML
(data-hidden="true") — mesmo comportamento observado em
modelos padrão do Ploomes.
Limitação conhecida: não testado com mais de um bloco de produto por
modelo — trate como risco em contas com múltiplos blocos. Bloco de
PARCELAS ainda não tem tool equivalente; configure manualmente no
admin do Ploomes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campos | No | ||
| oculto | No | ||
| posicao | No | fim | |
| pagina_id | No | ||
| nome_secao | No | Produtos/Serviços | |
| template_id | Yes | ||
| codigo_secao | No | ||
| titulo_coluna | No | Itens |