Operação de doca — Visão Geral

O módulo Operação de Docas (config-docks) é responsável por configurar quais serviços de transporte podem operar em uma doca, agrupados por modal, modalidade e tipo de carga. Para cada serviço vinculado, é possível definir um período de vigência. O módulo também permite delimitar as faixas de CEP atendidas pela operação, por meio do upload de uma planilha de mapeamento.

Localização no produto

Rota de UI: /[businessID]/transport?tab=operational-docks

O módulo é acessado pela aba "Operação de docas" dentro do módulo de Transporte.

Permissões necessárias

Operação	Permissão
Visualizar listagem	PERMISSIONS.LOADING_BAY.READ
Criar operação	PERMISSIONS.LOADING_BAY.CREATE
Editar / Ativar / Desativar	PERMISSIONS.LOADING_BAY.UPDATE
Excluir	PERMISSIONS.LOADING_BAY.DELETE

A coluna de ações na tabela só é exibida quando o usuário possui ao menos uma das permissões UPDATE ou DELETE.

Módulos e serviços dependentes

Dependência	Finalidade
useWarehouse.list	Lista armazéns (hubs) para seleção da doca
useLoadingBay.list	Docas filtradas pelo armazém selecionado
useModality.list	Modalidades de transporte disponíveis
useCargoType.list	Tipos de carga disponíveis
useMapCep.list	Mapas de CEP publicados
useCarrierService.list	Serviços de transporte compatíveis com a tupla da operação
@/shared	Componentes de UI, toasts, paginação, permissões
nuqs	Gerenciamento de estado na URL (mode, id, filtros de listagem)
next-intl	Traduções de labels

Endpoints da API

Base de todas as chamadas: /logistics/loading-bay-operations

Método	URL	Descrição
GET	/logistics/loading-bay-operations	Lista operações com paginação e filtros
POST	/logistics/loading-bay-operations	Cria nova operação
GET	/logistics/loading-bay-operations/:id	Busca operação por ID
PATCH	/logistics/loading-bay-operations/:id	Atualiza operação (parcial)
DELETE	/logistics/loading-bay-operations/:id	Remove operação
GET	.../:operationId/services	Lista serviços da operação
POST	.../:operationId/services	Vincula serviço à operação
PATCH	.../:operationId/services/:serviceId	Atualiza serviço vinculado
DELETE	.../:operationId/services/:serviceId	Remove serviço vinculado
GET	.../:operationId/zipcode-mapping/spreadsheet-template	Baixa template XLSX
POST	.../zipcode-mapping/spreadsheet-upload/validate-errors	Valida erros na planilha
POST	.../zipcode-mapping/spreadsheet-upload/validate-warnings	Valida avisos na planilha
POST	.../zipcode-mapping/spreadsheet-upload/apply-mapping	Aplica o mapeamento de CEP
GET	.../:operationId/zipcode-mappings	Lista mapeamentos de CEP paginados