# Localidades

## Localidades de Entrega — Guia de Uso

### Visão Geral

A página de **Localidades de Entrega** permite cadastrar as regiões atendidas pela loja e definir a taxa de entrega para cada uma. O cliente seleciona sua localidade ao fazer o pedido e o valor da entrega é aplicado automaticamente.

> **Atenção:** Não é possível editar localidades existentes enquanto a loja estiver aberta. Novas localidades podem ser criadas normalmente. Feche a loja para editar.

***

### Lista de Localidades

As localidades são exibidas em uma tabela com as colunas:

| Coluna          | Descrição                                   |
| --------------- | ------------------------------------------- |
| Localidade      | Nome da região cadastrada                   |
| Status          | **Ativo** (verde) ou **Inativo** (vermelho) |
| Taxa de Entrega | Valor cobrado para entrega nessa região     |
| Ações           | Botão de edição                             |

<figure><img src="/files/OrQ0eOnqgyojUmlrUPWt" alt=""><figcaption></figcaption></figure>

***

### Filtros e Busca

A barra de filtros aparece quando há localidades cadastradas:

* **Busca por nome** — filtra localidades pelo nome digitado
* **Filtro de status** — exibe todas, apenas ativas ou apenas inativas

O total de resultados filtrados é exibido abaixo dos campos quando algum filtro está ativo.

<figure><img src="/files/atuRrNoHv6vWO96pmkCk" alt=""><figcaption></figcaption></figure>

***

### Criar uma Localidade

{% stepper %}
{% step %}

### **Clique em "Nova Localidade" no canto superior direito e o** painel lateral será aberto

<figure><img src="/files/BV7bbOIfv7J7MNhwhfYy" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Preencha os campos e clique em "Criar Localidade"**

<figure><img src="/files/NMAxmZMqk2Q6FoMn7Fyp" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### Editar uma Localidade

{% stepper %}
{% step %}

### Clique no ícone de lápis na linha da localidade desejada e o painel lateral abrirá com os dados já preenchidos

<figure><img src="/files/z9b462OxmIou8kudORVF" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/pUR89DdHzclWZSplsJ0A" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Faça as alterações e clique em "Salvar Alterações"**

<figure><img src="/files/VGurHXNowrAtPX4s0gOP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PxZs80eGZLPBy1dJuOmF" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

> O botão de edição fica desabilitado enquanto a loja estiver aberta.

***

### Campos do Formulário

| Campo              | Obrigatório | Descrição                                                            |
| ------------------ | ----------- | -------------------------------------------------------------------- |
| Nome da Localidade | Sim         | Nome da região (ex: `QNM 22`, `Centro`, `Setor Norte`)               |
| Preço da Entrega   | Não         | Taxa em R$ cobrada para entrega. Use `0.00` para entrega gratuita    |
| Localidade Ativa   | —           | Marque para disponibilizar a localidade para os clientes no cardápio |

***

### Paginação

Quando há muitas localidades, a tabela é paginada. Use os controles no rodapé para navegar entre páginas e ajustar a quantidade de itens exibidos por página.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://traga-ja.gitbook.io/traga-ja/funcionamento/localidades.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.