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

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

| Campo | XML | Tipo | Ocorrência | Descrição |
|---|---|---|---|---|
| `x_nome` | `xNome` | `TSDesc255` | 1 | Descrição do evento Artístico, Cultural, Esportivo, etc |
| `dt_ini` | `dtIni` | `TSData` | 1 | Data de início da atividade de evento. Ano, Mês e Dia (AAAA-MM-DD) |
| `dt_fim` | `dtFim` | `TSData` | 1 | Data de fim da atividade de evento. Ano, Mês e Dia (AAAA-MM-DD) |
| `id_atv_evt` | `idAtvEvt` | `TSIdeEvento` | 1, escolha 1 | Identificação da Atividade de Evento (código identificador de evento determinado pela Administração Tributária Municipal) |
| `end` | `end` | `Nfse.Schema.V1_01.TCEnderecoSimples` | 1, escolha 1 | Grupo de informações relativas ao endereço da atividade, evento ou local do serviço prestado |

Escolha 1: exatamente um entre `id_atv_evt` e `end`.

# `t`

```elixir
@type t() :: %Nfse.Schema.V1_01.TCAtvEvento{
  dt_fim: Date.t() | nil,
  dt_ini: Date.t() | nil,
  end: Nfse.Schema.V1_01.TCEnderecoSimples.t() | nil,
  id_atv_evt: String.t() | nil,
  x_nome: 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*