# `Nfse.Schema.V1_01.TCValoresNFSe`
[🔗](https://github.com/ideia4it/nfse/blob/v0.1.0/lib/nfse/schema/v1_01/tc_valores_nf_se.ex#L2)

Tipo `TCValoresNFSe` do leiaute 1.01, em `tiposComplexos_v1.01.xsd`.

| Campo | XML | Tipo | Ocorrência | Descrição |
|---|---|---|---|---|
| `v_calc_dr` | `vCalcDR` | `TSDec15V2` | 0..1 | Valor monetário (R$) de dedução/redução da base de cálculo (BC) do ISSQN. |
| `tp_bm` | `tpBM` | `TBMISSQN` | 0..1 | Tipo Benefício Municipal (BM): 1) Isenção; 2) Redução da BC em 'ppBM' %; 3) Redução da BC em R$ 'vInfoBM'; 4) Alíquota Diferenciada de 'aliqDifBM' %; |
| `v_calc_bm` | `vCalcBM` | `TSDec15V2` | 0..1 | Valor monetário (R$) do percentual de redução da base de cálculo (BC) do ISSQN devido a um benefício municipal (BM). |
| `v_bc` | `vBC` | `TSDec15V2` | 0..1 | Valor da Base de Cálculo do ISSQN (R$) = Valor do Serviço - Desconto Incondicionado - Deduções/Reduções - Benefício Municipal vBC = vServ - descIncond - (vDR ou vCalcDR + vCalcReeRepRes) - (vRedBCBM ou VCalcBM) |
| `p_aliq_aplic` | `pAliqAplic` | `TSDec1V2` | 0..1 | Alíquota aplicada sobre a base de cálculo para apuração do ISSQN. |
| `v_issqn` | `vISSQN` | `TSDec15V2` | 0..1 | Valor do ISSQN (R$) = Valor da Base de Cálculo x Alíquota ISSQN = vBC x pAliqAplic |
| `v_total_ret` | `vTotalRet` | `TSDec15V2` | 0..1 | Valor total das retenções de tributos da NFS-e. Valor total de retenções (R$) = Σ(vRetCP + vRetIRRF+ vRetCSLL + ISSQN*) |
| `v_liq` | `vLiq` | `TSDec15V2` | 1 | Valor líquido da NFS-e. Valor líquido (R$) = Valor do serviço - Desconto condicionado - Desconto incondicionado - Valores retidos |

# `t`

```elixir
@type t() :: %Nfse.Schema.V1_01.TCValoresNFSe{
  p_aliq_aplic: Decimal.t() | nil,
  tp_bm: String.t() | nil,
  v_bc: Decimal.t() | nil,
  v_calc_bm: Decimal.t() | nil,
  v_calc_dr: Decimal.t() | nil,
  v_issqn: Decimal.t() | nil,
  v_liq: Decimal.t() | nil,
  v_total_ret: Decimal.t() | nil
}
```

# `decode`

```elixir
@spec decode(Saxy.SimpleForm.t()) :: {:ok, t()} | {:error, Nfse.Error.t()}
```

Lê o elemento, na árvore do `Saxy.SimpleForm`, como este struct e valida o resultado.

# `encode`

```elixir
@spec encode(t(), String.t(), [Nfse.Schema.Runtime.attribute()]) :: iodata()
```

Escreve o struct já validado como o elemento `tag`, na forma canônica. Os `extra_attributes`,
como as declarações de namespace, saem antes dos atributos do struct.

# `new`

```elixir
@spec new(map() | keyword() | t()) :: {:ok, t()} | {:error, Nfse.Error.t()}
```

Converte `attrs` (mapa, lista de palavras-chave ou o próprio struct, também nos campos
aninhados) neste struct e valida o resultado. As regras estão em `Nfse.Schema.Runtime`.

# `validate`

```elixir
@spec validate(t()) :: :ok | {:error, Nfse.Error.t()}
```

Valida o struct contra o XSD e devolve cada erro com o caminho do campo.

---

*Consult [api-reference.md](api-reference.md) for complete listing*