API Endpoints
Fracttal →

Consultar un activo

Mediante esta API se puede consultar la información de los activos.
Puedes consultar algún activo en especifico o realizar filtros por el fechas, tipos de activo, entre otros.

El parámetro de la url "code" se usa para obtener el detalle de un activo. Se puede obtener en este mismo endpoint. (campo code)

Parámetros de entrada

Se puede filtrar la información mediante los siguientes query_params:

ParámetrosTipoObligatorioDescripción
code TextoOpcionalCódigo del activo a obtener Se puede obtener en este mismo endpoint. (campo code)
id EnteroOpcionalID del activo en Fracttal. Se puede obtener en este mismo endpoint. (campo id)
item_type TextoOpcionalPermite filtrar por tipos de activo. Los disponibles son los siguientes:
1: Ubicaciones
2: Equipos
3: Herramientas
4: Repuestos y Suministros
5: Digital
location_code TextoOpcionalCódigo del activo tipo ubicación padre del cual se desea consultar sus hijos. Se puede obtener en este mismo endpoint. (campo code)
active BooleanoOpcionalIndica si el activo está activo o no
available BooleanoOpcionalIndica si el activo en servicio o no
field_1TextoOpcionalDepende del tipo de activo (ver parámetros de salida de acuerdo al tipo de activo)
field_2TextoOpcionalDepende del tipo de activo (ver parámetros de salida de acuerdo al tipo de activo)
field_3TextoOpcionalDepende del tipo de activo (ver parámetros de salida de acuerdo al tipo de activo)
field_4TextoOpcionalDepende del tipo de activo (ver parámetros de salida de acuerdo al tipo de activo)
field_5TextoOpcionalDepende del tipo de activo (ver parámetros de salida de acuerdo al tipo de activo)
field_6TextoOpcionalDepende del tipo de activo (ver parámetros de salida de acuerdo al tipo de activo)
start EnteroOpcionalNúmero de registro donde iniciará la consulta. Por defecto 0.
Todas las consultas están limitadas a 100 registros, cuando hay más de esa cantidad se debe utilizar este parámetro para la paginación.
limit EnteroOpcionalCantidad de registros que mostrará la petición. El valor por defecto es 100.

Parámetros de salida

Parámetros de salida de acuerdo al tipo de activo:

ParámetroTipoUbicaciones (id_type_item = 1)Equipos (id_type_item = 1)Herramientas (id_type_item = 3)Repuestos y suministros (id_type_item = 4)Digital (id_type_item = 5)
field_1 TextoNombreNombreNombreNombreNombre
field_2 TextoDirecciónFabricanteNúmero de parteNúmero de parteFabricante
field_3 TextoCiudadModeloFabricanteFabricanteNúmero de serial
field_4 TextoCódigo de ÁreaNúmero de serialModeloModeloVersión
field_5 TextoDepartamento / Estado / RegionOtros 1Otros 1Otros 1
field_6 TextoPaísOtros 2Otros 2Otros 2
ParámetroTipoDescripción
id EnteroID del activo en Fracttal
active BooleanoIndica si el activo está activo o no
code TextoCódigo del activo
description TextoDescripción del activo
id_type_item EnteroTipo de activo. Puede ser:
1 - Localización
2 - Equipos
3 - Herramientas
4 - Repuestos y suminitros
5 - Digital
notes TextoNotas
weight TextoPeso
is_serial_control BooleanoIndica si es un activo controlado por serial
items_types_description TextoNombre del tipo de activo
groups_description TextoTipo
groups_1_description TextoClasificación 1
groups_2_description TextoClasificación 2
custom_fields_groups_description TextoNombre del grupo de campos personalizados que tiene asociado el activo
units_description TextoDescripción de la unidad
priorities_description TextoPrioridad
parent_description TextoUbicado o es parte de
purchase_date TextoFecha de compra
total_cost TextoCosto total
anual_depreciation TextoPorcentaje depreciación anual
startup_date TextoFecha de inicio para la depreciación
total_replacement_cost TextoCosto total de la depreciación lineal
salvage_value TextoValor de sustitución (depreciación)
costs_center_description TextoDescripción Centro de costos
budgets_description TextoPresupuesto
cost_average TextoCosto Promedio
latitude TextoLatitud
longitud TextoLongitud
groups_tasks_description TextoPlan de tareas al que pertenece
units_code TextoCódigo de la unidad
visible_to_all BooleanoTrue si el activo se puede visualizar a todas las personas de la empresa
id_parent Enteroid de la localización
hours_average_daily_use EnteroHoras de uso promedio diario (Tiempo en segundos, por defecto son 86400 = 24 horas)
available BooleanoTrue cuando el activo está disponible, false en caso contrario
initial_date_out_of_service Data UTC-0Fecha inicial del fuera de servicio (Aplica cuando el activo no está disponible)
last_final_date_available Data UTC-0Fecha final del último fuera de servicio
item_url TextoURL del activo dentro de Fracttal. Sirve para generar el códiigo QR
id_company TextoID de la empresa
BarcodeTextoCódigo qr
min_stock_warningEnteroCantidad minima esperada del activo

Ejemplo

Petición: (GET) https://app.fracttal.com/api/items/654545445354

{
  "success": true,
  "message": "200",
  "data": [
    	{
        "id": 28859188,
        "active": true,
        "code": "PPC.T.CA8.006",
        "description": " Cadena de sujeción de 3/8\\ G8 de 8m { PPC.T.CA8.006 }",
        "id_type_item": 4,
        "barcode": null,
        "field_1": "Cadena de sujeción de 3/8\\ G8 de 8m",
        "field_2": null,
        "field_3": null,
        "field_4": null,
        "field_5": null,
        "field_6": null,
        "notes": null,
        "min_stock_warning": false,
        "weight": null,
        "is_serial_control": false,
        "lead_time": null,
        "items_types_description": "SPARE_PARTS_AND_SUPPLIES",
        "groups_description": null,
        "groups_1_description": null,
        "groups_2_description": null,
        "custom_fields_groups_description": null,
        "units_description": "UND",
        "priorities_description": null,
        "parent_description": "// ",
        "purchase_date": null,
        "total_cost": null,
        "anual_depreciation": null,
        "startup_date": null,
        "total_replacement_cost": null,
        "salvage_value": null,
        "costs_center_description": "",
        "budgets_description": "",
        "cost_average": null,
        "latitude": null,
        "longitud": null,
        "id_group_task": null,
        "groups_tasks_description": null,
        "units_code": "UND",
        "custom_fields_values": null,
        "third_parties_name": null,
        "id_parent": null,
        "visible_to_all": false,
        "hours_average_daily_use": null,
        "available": true,
        "initial_date_out_of_service": null,
        "last_final_date_available": null,
        "item_url": "https://apps.fracttal.com/#inventories/28859188",
        "id_company": 1190
      }
  ],
  "total": 1
}
Language