# Extrato de Serviço

O Extrato de Serviço é o relatório utilizado para prestar contas ao cliente sobre as atividades realizadas. Este artigo detalha todas as variáveis disponíveis para que você possa personalizar seu modelo em Word.

## 1. Regras de Formatação e Arquivo

Para que a substituição dos dados ocorra corretamente, o modelo deve seguir estas especificações:

* **Extensão:** Deve ser, obrigatoriamente, **.DOCX** (formato Microsoft Word 2007 ou superior).
* **Restrição Crítica:** Não é permitido o uso de **caixas de texto** ou **formas geométricas** do Word.
* **Layout:** Sinta-se à vontade para usar imagens, tabelas e estilos de fonte, desde que o texto das variáveis esteja livre no corpo do documento ou dentro de células de tabelas comuns.

## 2. Tabela Completa de Variáveis

Insira as variáveis exatamente como aparecem abaixo, incluindo os colchetes.

### Bloco: Extrato de Serviço

| **Variável** | **Informação** |
|----------|------------|
| `[extrato_servico.cod]` | Código do extrato |
| `[extrato_servico.nota_fiscal]` | Nome da nota fiscal atrelada |
| `[extrato_servico.data]` | Data do extrato |
| `[extrato_servico.valor_fechado]` | Valor fechado |
| `[extrato_servico.valor_despesas]` | Valor de despesas |
| `[extrato_servico.valor_total]` | Valor total |
| `[extrato_servico.situacao]` | Situação atual do extrato |
| `[extrato_servico.nome_cliente]` | Nome do cliente no extrato |
| `[extrato_servico.dt_hr_atual]` | Data e hora atual da geração |
| `[extrato_servico.emitente]` | Nome do emitente |

### Bloco: Cliente (Dados Cadastrais e Cobrança)

| **Variável** | **Informação** |
|----------|------------|
| `[cliente.nome]` | Nome/Razão Social |
| `[cliente.tipo_pessoa]` | Tipo (J/F) |
| `[cliente.nome_fantasia]` | Nome fantasia |
| `[cliente.logradouro]` | Logradouro (Endereço) |
| `[cliente.numero]` | Número     |
| `[cliente.complemento]` | Complemento |
| `[cliente.bairro]` | Bairro     |
| `[cliente.cep]` | CEP        |
| `[cliente.referencia]` | Ponto de referência |
| `[cliente.nome_cidade]` | Nome da cidade |
| `[cliente.uf_cidade]` | UF da cidade |
| `[cliente.logradouro_cob]` | Logradouro de cobrança |
| `[cliente.numero_cob]` | Número de cobrança |
| `[cliente.complemento_cob]` | Complemento de cobrança |
| `[cliente.bairro_cob]` | Bairro de cobrança |
| `[cliente.cep_cob]` | CEP de cobrança |
| `[cliente.referencia_cob]` | Referência de cobrança |
| `[cliente.nome_cidade_cob]` | Cidade de cobrança |
| `[cliente.uf_cidade_cob]` | UF de cobrança |

### Bloco: Informações Adicionais do Cliente

| **Variável** | **Informação** |
|----------|------------|
| `[cliente.ramoatividade]` | Ramo de atividade |
| `[cliente.email]` | E-mail principal |
| `[cliente.website]` | Website    |
| `[cliente.cpf_cnpj]` | CPF ou CNPJ |
| `[cliente.ie_rg]` | Inscrição Estadual ou RG |
| `[cliente.dtcadastro]` | Data de cadastro |
| `[cliente.insc_municipal]` | Inscrição Municipal |
| `[cliente.telefone1]` / `[cliente.ramal1]` | Telefone 1 e Ramal 1 |
| `[cliente.telefone2]` / `[cliente.ramal2]` | Telefone 2 e Ramal 2 |
| `[cliente.origem]` | Origem do cliente |
| `[cliente.regiao]` | Região do cliente |
| `[cliente.email_financeiro]` | E-mail financeiro |
| `[cliente.nome_abreviado]` | Nome abreviado |

### Bloco: Parcelas e Ordens de Serviço (Tabelas Dinâmicas)

Utilize a tag `;block=tbs:row` para que o sistema repita as linhas da tabela automaticamente.

* **Parcelas:** `[parcelas.cod;block=tbs:row]` e `[parcelas.valor]`
* **Ordens de Serviço:** `[ordens_servico.cod;block=tbs:row]` e `[ordens_servico.data]`

## 3. Exemplo de Modelo Configurado

Abaixo, um exemplo de como organizar as variáveis dentro do seu documento Word:

> **RELATÓRIO DE EXTRATO DE SERVIÇO**
>
> **Cliente:** `[cliente.nome]` (Cod: `[extrato_servico.nome_cliente]`)
>
> **Data do ES:** `[extrato_servico.data]`
>
> **Emitente:** `[extrato_servico.emitente]`
>
> **Data de Emissão:** `[extrato_servico.dt_hr_atual]`
>
> 
> ---
>
> **Resumo de Valores:**
>
> * **Despesas:** `[extrato_servico.valor_despesas]`
> * **Valor Total:** `[extrato_servico.valor_total]`
>
> 
> ---
>
> **Ordens de Serviço Realizadas:**
>
> `[ordens_servico.narrativa]`
> 
> | **Cód. Projeto** | **Valor da Parcela** |
> |--------------|------------------|
> | `[parcelas.cod;block=tbs:row]` | `[parcelas.valor]` |

---

**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)