Saltar al contenido
P4 Software P4 Software / activoHQ - Español

Agrega esta documentación a Claude

Hazle preguntas a Claude sobre esta documentación. Claude lee las páginas publicadas y te enlaza a ellas. Copia esta dirección:

https://p4-software.opendocs.page/mcp

En claude.ai o Claude Desktop: abre Configuración, luego Conectores, elige Agregar conector personalizado y pega la dirección.

En Claude Code, ejecuta:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Activos y empresas

API: Activos y empresas

Esta página requiere el encabezado X-Api-Key y el parámetro ?companyId= descritos en la descripción general de la API REST para desarrolladores.


Endpoints

GET /api/v1/companies

Lista las Empresas activas de su tenant. No se necesita el parámetro companyId.

curl -s "https://acme.activohq.cloud/api/v1/companies" \
  -H "X-Api-Key: $ACTIVOHQ_API_KEY"

Respuesta:

{
  "items": [
    { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Acme Corp" }
  ],
  "total": 1,
  "skip": 0,
  "take": 50
}

GET /api/v1/assets

Lista paginada de Activos. Opcionalmente filtre con search (coincide con AssetCode, Name o RFID EPC).

curl -s "https://acme.activohq.cloud/api/v1/assets?companyId=3fa85f64-5717-4562-b3fc-2c963f66afa6&search=laptop&skip=0&take=20" \
  -H "X-Api-Key: $ACTIVOHQ_API_KEY"

Los elementos de la respuesta incluyen el AssetDto completo (ver más abajo).


GET /api/v1/assets/

Recupera un único activo por su GUID.

curl -s "https://acme.activohq.cloud/api/v1/assets/f47edba8-67fe-42ce-8209-0e20e1abc17e?companyId=3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "X-Api-Key: $ACTIVOHQ_API_KEY"

Los campos de la respuesta incluyen accumulatedDepreciation y netBookValue (solo lectura, calculados). Los registros vinculados (ubicación, centro de costo, custodio, libro de depreciación y empleado asignado) se devuelven como objetos { "id", "code", "name" }. El clasificador del activo se devuelve en model (el modelo de activo), cuyo code viene vacío porque los modelos se identifican por nombre.


POST /api/v1/assets

Crea un activo. Devuelve 201 Created con un encabezado Location que apunta al nuevo recurso.

curl -s -X POST "https://acme.activohq.cloud/api/v1/assets?companyId=3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "X-Api-Key: $ACTIVOHQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assetCode": "LAP-0042",
    "name": "Dell Latitude 5540",
    "assetModelId": "b1e2c3d4-e5f6-7890-abcd-ef1234567890",
    "acquisitionDate": "2024-01-15",
    "acquisitionCost": 1250.00,
    "salvageValue": 100.00,
    "usefulLifeMonths": 60,
    "depreciationMethod": "StraightLine",
    "status": "Active",
    "availability": "Available"
  }'

Si se alcanza el límite de Activos de su plan, la API devuelve 400 con {"error":"Asset limit reached - upgrade your plan."}.

Otros errores 400 posibles (los mensajes están en inglés): Asset Code 'LAP-0042' already exists. si el código ya existe en la empresa; Asset Model not found., Location not found., Cost Center not found., Custodian not found., Depreciation Book not found. o Assigned Employee not found. si un id no existe en la empresa; y mensajes de campo como Asset Code is required., Name is required., Asset Model is required., Acquisition Date is required., Acquisition Cost must be zero or positive., Salvage Value must be zero or positive. y Useful Life (months) must be zero or positive.


PUT /api/v1/assets/

Actualiza un activo existente. Devuelve 200 OK con el activo actualizado. Un id desconocido devuelve 404.

El PUT reemplaza el registro completo. Todo campo que no envíe se guarda vacío: locationId, costCenterId, custodianId, depreciationBookId y assignedEmployeeId quedan sin valor; rfidEpc, description y serialNumber quedan en blanco; salvageValue y usefulLifeMonths quedan en cero. Los campos depreciationMethod, status y availability conservan su valor actual si los omite. Por eso lea primero el activo con GET /api/v1/assets/{id} y reenvíe todos los campos con los cambios aplicados. El ejemplo siguiente solo muestra los campos obligatorios y borraría los demás.

curl -s -X PUT "https://acme.activohq.cloud/api/v1/assets/f47edba8-67fe-42ce-8209-0e20e1abc17e?companyId=3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "X-Api-Key: $ACTIVOHQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assetCode": "LAP-0042",
    "name": "Dell Latitude 5540 (updated)",
    "assetModelId": "b1e2c3d4-e5f6-7890-abcd-ef1234567890",
    "acquisitionDate": "2024-01-15",
    "acquisitionCost": 1250.00
  }'

Campos del cuerpo de escritura (POST / PUT)

Todos los campos son JSON en camelCase. Inclúyalos al crear o actualizar un activo.

Campo Tipo Requerido Notas
assetCode string Sí Código único dentro de la empresa.
name string Sí Nombre de visualización.
rfidEpc string No Código electrónico de producto RFID.
description string No Descripción en texto libre.
serialNumber string No Número de serie del fabricante.
assetModelId guid Sí Modelo de activo (el clasificador). No existe un endpoint de catálogo de modelos: obtenga el id desde model.id de un activo existente o desde la aplicación.
locationId guid No Use GET /api/v1/locations.
costCenterId guid No Use GET /api/v1/cost-centers.
custodianId guid No Use GET /api/v1/custodians.
depreciationBookId guid No Use GET /api/v1/depreciation-books.
assignedEmployeeId guid No Use GET /api/v1/employees.
acquisitionDate fecha (ISO) Sí Ej. "2024-01-15".
inServiceDate fecha (ISO) No Fecha en que el activo fue puesto en servicio.
acquisitionCost decimal Sí Costo original de adquisición.
salvageValue decimal No Valor residual al final de la vida útil.
usefulLifeMonths entero No Se usa para los métodos de línea recta y saldo decreciente.
totalEstimatedUnits decimal No Se usa únicamente para el método UnitsOfProduction.
depreciationMethod string No StraightLine, DecliningBalance, o UnitsOfProduction.
status string No Draft, Active, u otros estados definidos. Si se omite o no se reconoce, un activo nuevo toma el valor predeterminado y uno existente conserva el actual.
availability string No Available o CheckedOut. Se aplica la misma regla de omisión.

Campos de respuesta de solo lectura

El AssetDto devuelto por GET y POST/PUT incluye estos campos calculados adicionales:

Campo Notas
accumulatedDepreciation Total de depreciación registrada hasta la fecha.
netBookValue acquisitionCost - accumulatedDepreciation.

¿Te resultó útil esta página?