# Cotação

O modelo de Cotação permite gerar propostas comerciais personalizadas. Este artigo contém a relação completa de variáveis que o sistema pode substituir automaticamente.

**1. Onde configurar o Modelo**


1. Acesse o menu **Configurações**.
2. No bloco **Geral**, selecione **Modelos de Documento**.
3. Clique em **+ Novo Registro** (ou edite um existente) e defina o tipo como **"Cotação"**.

**2. Regras de Arquivo**

* **Formato:** OBRIGATORIAMENTE **.DOCX**.
* **Restrição:** Não utilize caixas de texto ou formas geométricas do Word.
* **Dica:** A melhor forma de garantir que o modelo não desconfigure é utilizando o **LibreOffice**.

**3. Tabela Completa de Variáveis**

**Variáveis da Entidade: Cotação (Dados Gerais)**

| **Variável** | **Informação** | **Variável** | **Informação** |
|----------|------------|----------|------------|
| `[cotacao.cotacao]` | Número da Cotação | `[cotacao.versao]` | Versão da Cotação |
| `[cotacao.data]` | Data de criação | `[cotacao.dt_hr_atual]` | Data/Hora da Impressão |
| `[cotacao.total]` | Total Geral | `[cotacao.total_itens]` | Total (exceto recorrentes) |
| `[cotacao.total_recorrente]` | Total de Recorrentes | `[cotacao.valor_total]` | Valor Total |
| `[cotacao.desconto]` | Valor do Desconto | `[cotacao.tipo_desconto]` | Tipo do Desconto (% ou $) |
| `[cotacao.valor_frete]` | Valor do Frete | `[cotacao.moeda]` | Moeda utilizada |
| `[cotacao.forma_pagamento]` | Forma de Pagamento | `[cotacao.tab_preco]` | Tabela de Preço |
| `[cotacao.qtd_parcelas]` | Quantidade de Parcelas | `[cotacao.vl_parcela]` | Valor da Parcela |
| `[cotacao.dia_mes_vencimento]` | Vencimento Recorrentes | `[cotacao.situacao]` | Situação da cotação |
| `[cotacao.usuario]` | Usuário Responsável | `[cotacao.usuario_email]` | E-mail do Usuário |
| `[cotacao.usuario_telefone]` | Telefone do Usuário | `[cotacao.obs_cotacao]` | Observação da cotação |
| `[cotacao.oportunidade]` | Nome da Oportunidade | `[cotacao.logradouro]` | Logradouro de entrega |
| `[cotacao.numero]` | Número (Endereço) | `[cotacao.complemento]` | Complemento |
| `[cotacao.bairro]` | Bairro     | `[cotacao.cep]` | CEP        |
| `[cotacao.nome_cidade]` | Cidade     | `[cotacao.uf]` | UF (Estado) |
| `[cotacao.referencia]` | Ponto de Referência |          |            |

**Variáveis da Entidade: Cliente (Comprador)**

| **Variável** | **Informação** | **Variável** | **Informação** |
|----------|------------|----------|------------|
| `[cliente.nome]` | Razão Social | `[cliente.nome_fantasia]` | Nome Fantasia |
| `[cliente.nome_abreviado]` | Nome Abreviado | `[cliente.cpf_cnpj]` | CPF/CNPJ   |
| `[cliente.ie_rg]` | IE / RG    | `[cliente.insc_municipal]` | Inscrição Municipal |
| `[cliente.email]` | E-mail Principal | `[cliente.email_financeiro]` | E-mail Financeiro |
| `[cliente.email_nfe]` | E-mail NF-e | `[cliente.telefone1]` | Telefone   |
| `[cliente.ramal1]` | Ramal      | `[cliente.telefone2]` | Telefone Alternativo |
| `[cliente.ramal2]` | Ramal Alternativo | `[cliente.website]` | Website    |
| `[cliente.logradouro]` | Logradouro | `[cliente.numero]` | Número     |
| `[cliente.complemento]` | Complemento | `[cliente.bairro]` | Bairro     |
| `[cliente.cep]` | CEP        | `[cliente.nome_cidade]` | Cidade     |
| `[cliente.uf_cidade]` | Estado (UF) | `[cliente.referencia]` | Referência |
| `[cliente.logradouro_cob]` | Logradouro Cobrança | `[cliente.numero_cob]` | Número Cobrança |
| `[cliente.complemento_cob]` | Complem. Cobrança | `[cliente.bairro_cob]` | Bairro Cobrança |
| `[cliente.cep_cob]` | CEP Cobrança | `[cliente.nome_cidade_cob]` | Cidade Cobrança |
| `[cliente.uf_cidade_cob]` | Estado Cobrança | `[cliente.referencia_cob]` | Referência Cobrança |
| `[cliente.ramoatividade]` | Ramo de Atividade | `[cliente.atividade_economica]` | Atividade Econômica |
| `[cliente.dt_abertura]` | Data Abertura (Sintegra) | `[cliente.dtcadastro]` | Data Cadastro |
| `[cliente.origem]` | Origem     | `[cliente.regiao]` | Região     |
| `[cliente.tipo_pessoa]` | Tipo Pessoa (F/J) | `[cliente.fax]` | Fax        |

**Variáveis da Entidade: Contato (Interlocutor)**

| **Variável** | **Informação** | **Variável** | **Informação** |
|----------|------------|----------|------------|
| `[contato.nome]` | Nome do Contato | `[contato.cargo]` | Cargo      |
| `[contato.email]` | E-mail     | `[contato.telefone]` | Telefone 1 |
| `[contato.celular]` | Celular    | `[contato.ramal]` | Ramal      |
| `[contato.cpf]` | CPF        | `[contato.skype]` | Skype      |

**Variáveis da Entidade: Empresa (Seus Dados/Emitente)**

| **Variável** | **Informação** | **Variável** | **Informação** |
|----------|------------|----------|------------|
| `[empresa.nome]` | Nome da Empresa | `[empresa.cnpj]` | CNPJ       |
| `[empresa.ins_estadual]` | Inscrição Estadual | `[empresa.logradouro]` | Logradouro |
| `[empresa.numero]` | Número     | `[empresa.complemento]` | Complemento |
| `[empresa.bairro]` | Bairro     | `[empresa.cep]` | CEP        |
| `[empresa.nome_cidade]` | Cidade     | `[empresa.uf]` | UF         |
| `[empresa.nome_representante]` | Nome Representante | `[empresa.cpf_representante]` | CPF Representante |

**Variáveis da Entidade: Oportunidade**

| **Variável** | **Informação** |
|----------|------------|
| `[oportunidade.data_finalizacao]` | Data em que a oportunidade foi finalizada |

**Variáveis de Tabelas (Itens e Recorrentes)**

Para listar todos os itens na tabela do Word, você deve adicionar `;block=tbs:row` dentro da variável de código.

**Itens da Cotação (Produtos/Serviços):**

`[itens.item_codigo;block=tbs:row]`, `[itens.cod_complemen]`, `[itens.nome_item]`, `[itens.narrativa_item]`, `[itens.obs_item]`, `[itens.quantidade]`, `[itens.preco_original]`, `[itens.preco]`, `[itens.preco_total]`, `[itens.desc_perc]`, `[itens.desc_val]`, `[itens.familia]`, `[itens.class_fiscal]`, `[itens.peso_bruto]`, `[itens.peso_liq]`.

**Produtos Recorrentes (Mensalidades):**

`[recorrente.item_codigo;block=tbs:row]`, `[recorrente.cod_complemen]`, `[recorrente.nome_item]`, `[recorrente.narrativa_item]`, `[recorrente.obs_item]`, `[recorrente.quantidade]`, `[recorrente.preco_original]`, `[recorrente.preco]`, `[recorrente.preco_total]`, `[recorrente.desc_perc]`, `[recorrente.desc_val]`, `[recorrente.familia]`, `[recorrente.class_fiscal]`.

**4. Exemplo de Layout**

**[empresa.nome]**

CNPJ: **[empresa.cnpj]**

PROPOSTA COMERCIAL Nº **[cotacao.cotacao]**

Cliente: **[cliente.nome]**

| **Cód** | **Item** | **Qtd** | **Valor Total** |
|-----|------|-----|-------------|
| `[itens.item_codigo;block=tbs:row]` | `[itens.nome_item]` | `[itens.quantidade]` | `[itens.preco_total]` |

**Total da Proposta: [cotacao.total]**


---

**⚠️ Atenção:** Verifique sempre se as variáveis de tabela terminam com `;block=tbs:row` antes do fechamento do colchete para que o sistema repita as linhas corretamente.

---

**Documents**

- [Changelog](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/changelog-Zm8YRaLsX2)
- [Comercial e Vendas](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/comercial-e-vendas-mLzQaeyoTV)
- [Configurações Gerais](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/configuracoes-gerais-J7dm490z1m)
- [Gestão de Relacionamento (CRM)](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/gestao-de-relacionamento-crm-74VyXWo680)
- [Integrações](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/integracoes-zJfkJOXdix)
- [Operações e Produtividade](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/operacoes-e-produtividade-k2U2Vd3Fk8)
- [Projetos](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/projetos-jaD6SWGAB9)
- [Relatórios](https://hub.procedo.dev/s/1deab281-1e68-456b-841a-f04b2c82b04d/doc/relatorios-uab6Sta2qa)