List all shipments
GET/company/delivery/
Obtém uma lista paginada de todos os envios da empresa com múltiplas opções de filtragem.
Objetivo
Permitir que as empresas consultem e filtrem seu histórico completo de envios para análise, relatórios e gestão operacional.
Casos de Uso
- Visualizar o histórico completo de envios da empresa
- Filtrar envios por datas (criação, leilão, início, fim, ETL, ETD) para relatórios periódicos
- Buscar envios específicos por código, referência personalizada ou tipo de carga
- Excluir envios cancelados ou reclamados das listas por padrão
- Analisar envios ativos vs. históricos
Lógica de Filtragem
flowchart TD
A[Receber Solicitação] --> B{Tem minDate?}
B -->|Sim| C[Filtrar date_start OU etl_date >= minDate]
B -->|Não| D{Tem maxDate?}
D -->|Sim| E[Filtrar date_end OU etd_date <= maxDate]
C --> F{Tem Filtro de Status?}
E --> F
F -->|Sim| G[Aplicar correspondência exata de status]
F -->|Não| H{Excluir Cancelados?}
H -->|show_canceled=false| I[Remover status=canceled]
H -->|show_canceled=true| J{Excluir Reclamados?}
J -->|show_claimed=false| K[Remover status=claimed]
J -->|show_claimed=true| L[Aplicar filtros]
I --> L
K --> L
G --> L
L --> M[Retornar Resultados Paginados]
Request
Responses
- 200
- 401
- 404
Lista de envios paginada com sucesso
Não autorizado. O token JWT é inválido ou expirou. É necessário autenticar novamente.
Empresa não encontrada. A empresa associada ao token não existe ou não tem permissões para acessar esses dados.