​

Catalog Management API

​

Available Catalogs

​

Request & Mission Catalogs

• Request Status - Manage request statuses with workflow ordering
• Mission Status - Track mission states
• Priority Type - Define request priority levels
• Service Type - Categorize service types for requests
• Expense Type - Define expense types for mission invoicing

​

Vehicle Catalogs

• Vehicle Status - Control vehicle availability states
• Vehicle Class - Categorize vehicle types
• Fuel Type - Manage fuel type options

​

Driver Catalogs

• License Type - Define driver license categories
• Availability Type - Manage driver availability statuses

​

Common Features

​

CRUD Operations

• POST / - Create new catalog entry
• GET / - Retrieve single entry by ID
• GET / - List entries with pagination and filters
• GET /todos/lista - List all active entries (no pagination, ideal for dropdowns)
• PUT / - Update existing entry
• DELETE / - Soft delete entry

​

Validation Rules

• Unique constraints - Code and name fields must be unique across active records
• Code formatting - Codes are uppercase, no spaces allowed
• Soft deletion - Records are marked inactive rather than physically deleted
• Referential integrity - Cannot delete entries referenced by active records

​

Response Format

{
  "success": true,
  "message": "Operación exitosa",
  "data": { ... }
}

​

Error Handling

• 400 - Bad request (validation errors)
• 404 - Not found
• 409 - Conflict (duplicate code/name)
• 500 - Internal server error

​

Filter Capabilities

• codigo - Partial match on code field
• nombre - Partial match on name field
• busqueda - General search across multiple fields
• Catalog-specific filters (e.g., esEstadoFinal, permiteAsignacion)

​

Pagination

• pagina - Page number (min: 1)
• por_pagina - Records per page (min: 1, max: 100)

{
  "items": [...],
  "total": 50,
  "pagina": 1,
  "porPagina": 10,
  "totalPaginas": 5
}