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

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

| Campo | XML | Tipo | Ocorrência | Descrição |
|---|---|---|---|---|
| `cep` | `CEP` | `TSCEP` | 1, escolha 1 | Número do CEP |
| `end_ext` | `endExt` | `Nfse.Schema.V1_01.TCEnderExtSimples` | 1, escolha 1 | Grupo de informações específicas de endereço no exterior |
| `x_lgr` | `xLgr` | `TSLogradouro` | 1 | Tipo e nome do logradouro da localização do imóvel |
| `nro` | `nro` | `TSNumeroEndereco` | 1 | Número do imóvel |
| `x_cpl` | `xCpl` | `TSComplementoEndereco` | 0..1 | Complemento do endereço |
| `x_bairro` | `xBairro` | `TSBairro` | 1 | Bairro |

Escolha 1: exatamente um entre `cep` e `end_ext`.

# `t`

```elixir
@type t() :: %Nfse.Schema.V1_01.TCEnderecoSimples{
  cep: String.t() | nil,
  end_ext: Nfse.Schema.V1_01.TCEnderExtSimples.t() | nil,
  nro: String.t() | nil,
  x_bairro: String.t() | nil,
  x_cpl: String.t() | nil,
  x_lgr: String.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*