Fracttal →

Query an Asset

Through this API you can consult the detailed information of an asset. You can consult the list of your assets or make filters by code and/or type of asset.

Input parameters

ParameterTypeRequiredDescription
codeTextOptionalCode of the asset to be obtained.
id_fracttalnumberOptionalFracttal's internal Id of the asset.
item_typeTextOptionalFilter by asset type. The following table shows the number to send according to the type of asset you want to obtain: 1: Locations 2: Equipment 3: Tools 4: Spare Parts and Supplies 5: Digital
location_code TextOptionalCode of the parent asset whose children are to be consulted,
active BooleanOptionalTrue - Active enabled
False - Active disabled
available BooleanOptionalTrue - Active available
False - Active out of service
field_1TextOptionalDepends on asset type (see parameters varying by asset type)
field_2TextOptionalDepends on asset type (see parameters varying by asset type)
field_3TextOptionalDepends on asset type (see parameters varying by asset type)
field_4TextOptionalDepends on asset type (see parameters varying by asset type)
field_5TextOptionalDepends on asset type (see parameters varying by asset type)
field_6TextOptionalDepends on asset type (see parameters varying by asset type)
start numberOptionalRecord number from which the query will start. By default it starts at item 0.
limit numberOptionalNúmero de registro final que retornará la consulta. Por defecto se retornan 100 registros (Valor máximo)

Output parameters

Configurable output parameters that vary according to the type of asset:

ParameterTypeLocation (id_type_item = 1)Equipments (id_type_item = 2)Tools (id_type_item = 3)Spare (id_type_item = 4)Digital (id_type_item = 5)
field_1 TextNameNameNameNameName
field_2 TextAddressManufacturerPart numberPart numberManufacturer
field_3 TextCityModelManufacturerManufacturerSerial number
field_4 TextArea codeSerial numberModelModelVersion
field_5 TextDepartment / State / RegionOther 1Other 1Other 1
field_6 TextCountry.Other 2Other 2Other 2

Example:

Petition: (GET) https://app.fracttal.com/api/accounts/

id NumberFracttal internal id of the asset
active BooleanTrue if the asset is active, False otherwise.
code TextAsset code
description TextDescription
id_type_item NumberType of asset. Can be: 1: for Locations 2: for Equipment 3: for Tools 4: for Spare Parts and Supplies 5: for Digital
notes TextNotas
weight TextWeight
min_stock_warning numberMinimum quantity in stock.
is_serial_control BooleanTrue when it is a serial controlled item
items_types_description TextName of asset type
groups_description TextType
groups_1_description TextClassification 1
groups_2_description TextClassification 2
custom_fields_groups_description TextName of the group of custom fields associated to the asset
units_description TextDescription of the unit
priorities_description TextPriority
parent_description TextLocated in or is part of
purchase_date TextDate of purchase
total_cost TextTotal cost
anual_depreciation TextAnnual depreciation percentage
startup_date TextStart date for depreciation
total_replacement_cost TextTotal straight-line depreciation cost
salvage_value TextReplacement value (depreciation)
costs_center_description TextDescription Cost center
budgets_description TextBudget
total_replacement_cost TextTotal straight-line depreciation cost
cost_average TextAverage Cost
latitude TextLatitude
longitud TextLongitud
groups_tasks_description TextTask list to which it belongs
units_code TextUnit code
visible_to_all BooleanTrue, if the asset can be displayed to all people in the company
id_parent NumberId of the task list to which it belongs
hours_average_daily_use NumberHours of average daily use (Time in seconds, default is 86400 = 24 hours)
available BooleanTrue when the asset is available, false otherwise
initial_date_out_of_service UTC-0 DateInitial date of decommissioning (Applies when the asset is not available)
last_final_date_available UTC-0 DateEnd date of last out of service
item_url TextURL of the asset within Fracttal. Used to generate the QR code
id_company TextCompany Id

Example

Request: (GET) https://app.fracttal.com/api/items_details/654545445354

{
  "success": true,
  "message": "200",
  "data": [
    {
      "active": true,
      "code": "654545445354",
      "description": "CAMION TOLVA IKA-2 FLOTA",
      "id_type_item": 2,
      "barcode": "654545445354",
      "field_1": "CAMION TOLVA IKA-2 FLOTA",
      "field_2": "MERCEDEZ BENZ",
      "field_3": "HD 370-1",
      "field_4": "6111723818212",
      "field_5": "Configuraci\u00f3n 8x4",
      "field_6": "",
      "notes": null,
      "min_stock_warning": false,
      "weight": null,
      "is_serial_control": false,
      "lead_time": null,
      "items_types_description": "EQUIPMENTS",
      "groups_description": null,
      "groups_1_description": null,
      "groups_2_description": null,
      "custom_fields_groups_description": "CAMION",
      "units_description": null,
      "priorities_description": null,
      "parent_description": "\/\/ AMERICA DEL SUR\/ ANTOFAGASTA\/ MINERIA\/ MINERA CENTINELA\/ ",
      "purchase_date": "2016-12-01",
      "total_cost": 10000000,
      "anual_depreciation": 20,
      "startup_date": "2016-01-01",
      "total_replacement_cost": 6000000,
      "salvage_value": 4000000,
      "costs_center_description": "PRODUCCI\u00d3N (  )",
      "budgets_description": "MANTENIMIENTO PREVENTIVO (  )",
      "cost_average": 0,
      "latitude": null,
      "longitud": null,
      "groups_tasks_description": "PLAN DE MANTENIMIENTO FLOTA DE CAMIONES",
      "units_code": null,
      "visible_to_all": false,
      "available": true,
      "initial_date_out_of_service": null,
      "last_final_date_available": null,
      "item_url": "https://apps.fracttal.com/#inventories/2717",
    }
  ],
  "total": 1
}

Test It

Test It

Language