Pular para o conteúdo principal

Delivery (Entrega)

O Delivery representa uma entrega de produtos ou servicos ao cliente.

Descricao​

O sistema de entregas controla todo o processo de envio de produtos vendidos ou busca/entrega de pets (taxidog), desde a criacao ate a finalizacao.

Dados​

Informacoes da Entrega​

CampoTipoObrigatorioDescricao
referenceTextoAutoCodigo da entrega
typeSelecaoSimTipo de entrega
statusSelecaoSimStatus atual
scheduled_dateDataNaoData agendada
scheduled_timeHoraNaoHorario agendado
delivered_atDataHoraAutoData/hora da entrega
notesTextoNaoObservacoes

Tipos de Entrega​

TipoDescricaoOrigem
saleEntrega de vendaSale
taxidog_getBuscar petBeautyAppointment
taxidog_deliveryEntregar petBeautyAppointment
transferTransferencia entre lojasStockTransfer

Status​

StatusDescricao
pendingPendente
scheduledAgendada
in_transitEm transito
deliveredEntregue
returnedDevolvida
canceledCancelada

Relacionamentos​

Pertence a​

EntidadeObrigatorioDescricao
AccountSimConta do petshop
StoreSimFilial de origem
CustomerSimCliente
AddressSimEndereco de entrega
SaleCondicionalVenda (se type=sale)
BeautyAppointmentCondicionalAgendamento (se taxidog)
DeliveryAreaNaoArea de entrega
DeliveryPersonNaoEntregador

Possui​

EntidadeDescricao
DeliveryItemsItens da entrega
DeliveryAttemptsTentativas de entrega
DeliveryPhotosFotos de comprovacao

Ciclo de Vida​

Fluxo de Entrega​

DeliveryItem​

Dados​

CampoTipoDescricao
sale_product_idReferenciaProduto
quantityDecimalQuantidade
descriptionTextoDescricao
weightDecimalPeso (kg)

Taxa de Entrega​

Calculo​

A taxa pode ser calculada por:

MetodoDescricao
FixaValor fixo por entrega
Por areaValor por area/regiao
Por distanciaValor por km
Por pesoValor por kg
GratisSem cobranca

DeliveryFee​

CampoTipoDescricao
fee_typeSelecaoTipo de calculo
valueMonetarioValor da taxa
min_valueMonetarioPedido minimo para gratis
free_aboveMonetarioGratis acima de X

Exemplo​

Taxa por area:
Centro: R$ 5,00
Zona Sul: R$ 10,00
Zona Norte: R$ 15,00

Gratis para pedidos acima de R$ 200,00

Areas de Entrega​

DeliveryArea​

CampoTipoDescricao
nameTextoNome da area
zip_codesArrayCEPs atendidos
neighborhoodsArrayBairros atendidos
citiesArrayCidades atendidas
polygonGeoJSONPoligono geografico
feeMonetarioTaxa da area
delivery_timeTextoPrazo de entrega
activeBooleanoSe esta ativa

Verificacao de Cobertura​

Entregadores​

DeliveryPerson​

CampoTipoDescricao
user_idReferenciaUsuario do sistema
nameTextoNome
phoneTextoTelefone
vehicle_typeSelecaoTipo de veiculo
vehicle_plateTextoPlaca
activeBooleanoSe esta ativo

Tipos de Veiculo​

TipoDescricao
motorcycleMoto
carCarro
bicycleBicicleta
vanVan/Furgao
on_footA pe

Roteirizacao​

Otimizacao de Rota​

O sistema pode sugerir ordem de entregas:

  1. Agrupar por regiao
  2. Calcular melhor sequencia
  3. Estimar tempo total

Rota do Entregador​

Entregador: Joao
Veiculo: Moto ABC-1234

Rota do dia:
1. 09:00 - Cliente A (Centro)
2. 09:30 - Cliente B (Centro)
3. 10:15 - Cliente C (Zona Sul)
4. 11:00 - Retorno

Tentativas de Entrega​

DeliveryAttempt​

Cada tentativa registra:

CampoTipoDescricao
date_timeDataHoraData/hora da tentativa
statusSelecaoResultado
reasonTextoMotivo (se nao entregue)
notesTextoObservacoes
photoImagemFoto do local

Motivos de Nao Entrega​

MotivoDescricao
absentCliente ausente
wrong_addressEndereco incorreto
refusedCliente recusou
inaccessibleLocal inacessivel
otherOutro

Comprovacao​

Metodos de Comprovacao​

MetodoDescricao
AssinaturaCliente assina no dispositivo
FotoFoto do produto entregue
CodigoCliente informa codigo
NenhumSem comprovacao

DeliveryPhoto​

CampoTipoDescricao
photoImagemFoto
typeSelecaoTipo (produto, local, assinatura)
captured_atDataHoraData/hora da captura
locationGeoJSONLocalizacao GPS

Taxidog​

Buscar Pet (taxidog_get)​

Entregar Pet (taxidog_delivery)​

Notificacoes​

Eventos que Disparam Notificacao​

EventoNotificacao
Agendada"Sua entrega foi agendada para..."
Em rota"Sua entrega esta a caminho"
Chegando"Entregador chegando em X minutos"
Entregue"Sua entrega foi realizada"
Problema"Houve um problema com sua entrega"

Canais​

CanalUso
WhatsAppNotificacao principal
SMSFallback
EmailConfirmacao
PushApp do cliente

Validacoes​

CampoRegra
customer_idObrigatorio
address_idObrigatorio
typeObrigatorio

Regras de Negocio​

Horario de Entrega​

RegraDescricao
Horario comercialSeg-Sex 8h-18h
Sabado8h-12h
DomingoNao entrega

Reagendamento​

  • Cliente pode reagendar ate 24h antes
  • Limite de 2 reagendamentos
  • Apos 3 tentativas, entrega cancelada

Devolucao​

Se entrega devolvida:

  • Produtos retornam ao estoque
  • Venda pode ser cancelada ou aguardar nova entrega
  • Taxa de entrega pode ou nao ser devolvida

Relatorios​

RelatorioDescricao
Entregas por periodoTotal de entregas
Entregas por entregadorPerformance
Taxa de sucesso% entregas na primeira tentativa
Tempo medioTempo entre criacao e entrega
Custo de entregaValor total de taxas

Permissoes​

AcaoDescricao
CriarCriar entrega
AgendarAgendar/reagendar
AtribuirAtribuir entregador
Iniciar rotaMarcar em transito
EntregarConfirmar entrega
CancelarCancelar entrega