# Opções de Envio

As opções de envio definem como os pedidos são entregues aos clientes. Cada opção tem um preço, um país de destino e restrições opcionais de localização (estados e cidades). Você também pode configurar regras de entrega para restringir entregas a dias específicos da semana com um tempo mínimo de antecedência. Tudo que você configurar aqui é refletido no checkout da loja.

## Visualizando suas opções de envio

Abra **Shipping** na barra lateral do admin (em Checkout) para ver a lista completa. A tabela exibe o nome, preço, país, status e data de criação de cada opção.

![Lista de opções de envio](/features/shipping-options/shipping-list.png)

| Coluna     | Descrição                                           |
| ---------- | --------------------------------------------------- |
| Name       | Nome da opção de envio (clique para editar)         |
| Price      | Custo de envio na moeda da loja                     |
| Country    | O país que esta opção atende                        |
| Status     | **Active** (disponível no checkout) ou **Inactive** |
| Created At | Data em que a opção foi criada                      |
| Actions    | Menu com opções de Edit e Delete                    |

Você pode **ordenar** clicando em qualquer cabeçalho de coluna, **pesquisar** digitando na barra de busca e **filtrar** por país usando o botão **Filter**.

## Criando uma opção de envio

Clique em **New Shipping Option** na página de lista para abrir o formulário de criação. O formulário é organizado em três seções.

![Criar opção de envio — informações gerais e localização](/features/shipping-options/create-shipping-top.png)

### Informações gerais

| Campo              | Obrigatório | Descrição                                                                                              |
| ------------------ | ----------- | ------------------------------------------------------------------------------------------------------ |
| Name               | Sim         | O nome exibido para os clientes no checkout (ex.: "Standard Delivery", "Express Shipping")             |
| Price              | Sim         | Custo de envio. Defina como 0 para frete grátis                                                        |
| Min Order Amount   | Não         | Valor mínimo do pedido para usar esta opção. O limite é comparado com subtotal + imposto menos qualquer desconto de mercadoria, alinhado ao resumo do pedido visto pelo cliente (cupons exclusivos de envio não entram no desconto). Clientes abaixo do limite veem a opção desabilitada. |
| Estimated Delivery | Não         | Texto exibido para os clientes (ex.: "3-5 business days"). Apenas informativo, não afeta cálculos      |
| Active Status      | Não         | Ative ou desative esta opção no checkout. Ativa por padrão                                             |

### Cobertura de localização

| Campo   | Obrigatório | Descrição                                                                                                                          |
| ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Country | Sim         | O país onde esta opção de envio está disponível. Cada opção atende um país                                                         |
| States  | Não         | Restrinja a estados específicos dentro do país. Se nenhum estado for selecionado, todos os estados são incluídos                   |
| Cities  | Não         | Restrinja a cidades específicas. Se nenhuma cidade for selecionada, todas as cidades dentro dos estados selecionados são incluídas |

> **Dica:** Os campos de localização são hierárquicos — selecionar um país carrega os estados disponíveis, e selecionar estados carrega as cidades disponíveis. Deixe estados e cidades vazios para disponibilizar a opção em todo o país.

### Regras de entrega

![Criar opção de envio — regras de entrega](/features/shipping-options/create-shipping-bottom.png)

As regras de entrega permitem restringir entregas a dias específicos da semana e definir um tempo mínimo de antecedência. Elas são desativadas por padrão.

| Campo                     | Obrigatório          | Descrição                                                                                                                                   |
| ------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable Delivery Rules     | Não                  | Ative para habilitar restrições de dia da semana e tempo de antecedência                                                                    |
| Delivery Days             | Sim (quando ativado) | Selecione em quais dias da semana as entregas são aceitas (ex.: segunda a sexta)                                                            |
| Minimum Lead Time (hours) | Não                  | Horas mínimas entre o pedido e a entrega. Por exemplo, 96 horas significa que um pedido feito na sexta não pode ser entregue antes de terça |

> **Importante:** Quando as regras de entrega estão ativadas, os clientes devem escolher uma data de entrega em um calendário durante o checkout. Apenas datas que correspondem aos dias permitidos e atendem ao tempo de antecedência serão selecionáveis.

## Editando uma opção de envio

Clique em qualquer nome de opção na lista (ou escolha **Edit** no menu de ações) para abrir o formulário de edição. Ele contém os mesmos campos do formulário de criação, preenchidos com os dados atuais.

![Editar opção de envio](/features/shipping-options/edit-shipping.png)

Clique em **Save Changes** quando terminar.

## Excluindo uma opção de envio

Para excluir uma opção de envio, clique no menu de ações na linha e selecione **Delete**. Um diálogo de confirmação aparecerá antes que a opção seja permanentemente removida.

## Como as opções de envio aparecem na loja

Durante o checkout, após o cliente selecionar seu endereço de entrega, as opções de envio disponíveis são exibidas como cartões selecionáveis na seção **Shipping**.

![Opções de envio no checkout](/features/shipping-options/storefront-checkout-shipping.png)

| Configuração do admin   | Comportamento na loja                                                                                                             |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Name                    | Exibido como rótulo do cartão                                                                                                     |
| Price                   | Exibido no lado direito do cartão. Mostrado como **Free** quando o preço é 0                                                      |
| Estimated Delivery      | Exibido abaixo do nome (apenas quando as regras de entrega estão desativadas)                                                     |
| Min Order Amount        | Se o valor do pedido (subtotal + imposto − desconto de mercadoria) estiver abaixo do mínimo, a opção é exibida mas desabilitada com a mensagem "Minimum order of X required" |
| Active Status           | Apenas opções ativas são exibidas                                                                                                 |
| Country, States, Cities | Apenas opções que correspondem ao endereço de entrega do cliente são exibidas                                                     |

### Seleção de data de entrega

Quando uma opção de envio tem regras de entrega ativadas, um calendário aparece após o cliente selecionar essa opção. O calendário desabilita automaticamente:

- Datas passadas
- Dias da semana não incluídos na configuração de **Delivery Days**
- Datas que estão dentro da janela de **Minimum Lead Time**

O cliente deve selecionar uma data de entrega válida antes de prosseguir para a etapa de pagamento.

### Frete grátis

Para oferecer frete grátis, crie uma opção de envio com preço **0**. Você pode combinar isso com um valor mínimo de pedido para oferecer frete grátis em pedidos acima de um determinado valor (ex.: "Frete grátis em pedidos acima de R$ 50").
