Pular para o conteúdo principal

DeliveryArea (Area de Entrega)

O DeliveryArea representa uma regiao geografica atendida pelo servico de entregas.

Descricao​

Areas de entrega definem as regioes onde o petshop realiza entregas, com configuracoes especificas de taxa, prazo e disponibilidade para cada area.

Dados​

Identificacao​

CampoTipoObrigatorioDescricao
nameTextoSimNome da area
codeTextoNaoCodigo interno
activeBooleanoSimSe esta ativa

Cobertura Geografica​

CampoTipoDescricao
zip_codesArrayLista de CEPs atendidos
zip_code_rangesArrayFaixas de CEP (inicio-fim)
neighborhoodsArrayBairros atendidos
citiesArrayCidades atendidas
statesArrayEstados atendidos
polygonGeoJSONPoligono geografico
radius_kmDecimalRaio em km (a partir da loja)

Configuracoes de Entrega​

CampoTipoDescricao
delivery_feeMonetarioTaxa de entrega
free_aboveMonetarioGratis acima deste valor
min_order_valueMonetarioPedido minimo
delivery_timeTextoPrazo de entrega (ex: "1-2 dias")
delivery_daysArrayDias de entrega (0=dom, 1=seg...)

Relacionamentos​

Pertence a​

EntidadeObrigatorioDescricao
AccountSimConta do petshop
StoreSimFilial

Possui​

EntidadeDescricao
DeliveriesEntregas nesta area

Tipos de Cobertura​

Por CEP​

Lista de CEPs especificos:

CEPs: 80010-000, 80020-000, 80030-000

Por Faixa de CEP​

Intervalos de CEP:

Faixa 1: 80000-000 a 80099-999
Faixa 2: 80100-000 a 80199-999

Por Bairro​

Lista de bairros:

Bairros: Centro, Batel, Agua Verde, Bigorrilho

Por Cidade​

Lista de cidades:

Cidades: Curitiba, Sao Jose dos Pinhais, Colombo

Por Raio​

Distancia a partir da loja:

Raio: 10 km a partir da loja

Por Poligono​

Area geografica definida por coordenadas:

{
"type": "Polygon",
"coordinates": [
[
[-49.2733, -25.4284],
[-49.2500, -25.4284],
[-49.2500, -25.4500],
[-49.2733, -25.4500],
[-49.2733, -25.4284]
]
]
}

Verificacao de Cobertura​

Fluxo​

Prioridade​

Quando multiplas areas atendem o mesmo endereco:

  1. Area mais especifica (CEP exato)
  2. Area com menor taxa
  3. Area cadastrada primeiro

Calculo de Taxa​

Taxa Fixa​

Taxa = delivery_fee da area

Taxa por Distancia​

Taxa = taxa_base + (distancia_km * valor_por_km)

Frete Gratis​

Se valor_pedido >= free_above:
Taxa = 0

Exemplo​

Area: Centro
Taxa: R$ 8,00
Gratis acima de: R$ 150,00

Pedido R$ 80,00 -> Taxa R$ 8,00
Pedido R$ 200,00 -> Taxa R$ 0,00

Dias de Entrega​

Configuracao​

DiaCodigo
Domingo0
Segunda1
Terca2
Quarta3
Quinta4
Sexta5
Sabado6

Exemplo​

Area: Zona Sul
Dias de entrega: [1, 3, 5] (Seg, Qua, Sex)

Calculo de Data Prevista​

Se pedido feito em dia sem entrega, calcula proximo dia disponivel.

Horarios de Entrega​

DeliverySlot​

Horarios disponiveis por area:

CampoTipoDescricao
start_timeHoraInicio do slot
end_timeHoraFim do slot
max_deliveriesNumeroMaximo de entregas no slot
daysArrayDias disponiveis

Exemplo​

Slots da Area Centro:
- 08:00 - 12:00 (max 10 entregas)
- 14:00 - 18:00 (max 10 entregas)
- 18:00 - 21:00 (max 5 entregas)

Restricoes​

Pedido Minimo​

Se valor_pedido < min_order_value:
Nao permite entrega nesta area

Peso/Volume Maximo​

CampoDescricao
max_weightPeso maximo (kg)
max_volumeVolume maximo (m3)

Produtos Restritos​

Alguns produtos podem nao ser entregues em certas areas:

  • Produtos refrigerados
  • Produtos pereciveis
  • Produtos de grande porte

Integracao com Checkout​

No Checkout​

  1. Cliente informa endereco
  2. Sistema busca areas que atendem
  3. Exibe taxa e prazo
  4. Cliente confirma

Mensagens​

SituacaoMensagem
Atendido"Entrega disponivel - R$ X,XX"
Gratis"Frete gratis!"
Nao atendido"Endereco fora da area de entrega"
Pedido minimo"Pedido minimo de R$ X,XX para entrega"

Mapa de Cobertura​

Visualizacao​

O sistema pode exibir mapa com:

  • Areas cobertas (coloridas)
  • Localizacao das lojas
  • Raio de atendimento

Validacoes​

CampoRegra
nameObrigatorio
coberturaMinimo 1 criterio (CEP, bairro, etc)
delivery_feeMaior ou igual a zero

Regras de Negocio​

Area Padrao​

Se nenhuma area especifica atende:

  • Usar area padrao (se existir)
  • Ou informar que nao entrega

Sobreposicao​

Areas podem se sobrepor:

  • Sistema usa a mais especifica
  • Ou a com menor taxa (configuravel)

Desativacao​

Ao desativar area:

  • Entregas pendentes continuam
  • Novas entregas nao sao aceitas

Relatorios​

RelatorioDescricao
Entregas por areaVolume de entregas
Taxa mediaTaxa media cobrada
Cobertura% de pedidos atendidos

Permissoes​

AcaoDescricao
CriarCriar area de entrega
EditarAlterar configuracoes
Ativar/DesativarMudar status
Ver mapaVisualizar cobertura