API Endpoints
Fracttal →

Actualizar un activo

Mediante esta API puedes actualizar cualquier activo existente en Fracttal.

-El parámetro en la url "code" es el código del activo por actualizar. Se puede consultar aquí. (campo code)

-En caso que el activo no posea un código, es posible también actualizar el activo usando el id interno de Fracttal Se puede consultar aquí.. El endpoint en ese caso se debe utilizar así:

https://app.fracttal.com/api/items/?id_fracttal={id}


Para Fracttal, solo los campos identificados en la siguiente documentación, son obligatorios. Los demás parámetros estarán sujetos a la configuración específica de la compañía.

Parámetros de entrada

La siguiente información debe ser enviada en el body de la petición.

ParámetroTipoObligatorioDescripción
codeTextoSiCódigo del activo por actualizar. Puede obtenerlo aquí. (campo code)
id_type_itemEnteroSiTipo de activo. Puede ser:
1- Ubicaciones
2- Equipos
3- Herramientas
4- Repuestos y suministros
5- Digital
activeBooleanoOpcionalIndica si el activo está activo o no
barcodeTextoOpcionalCódigo de barras
notesTextoOpcionalNotas
weightTextoOpcionalPeso
is_serial_controlBooleanoOpcionalIndica si el activo es controlado por serial. Por defecto false
groupTextoOpcionalTipo
group_1TextoOpcionalClasificación 1
group_2TextoOpcionalClasificación 2
id_priority EnteroOpcionalId de prioridad

1 : Muy alta
2 : Alta
3 : Media
4 : Baja
5 : Muy baja
code_parent_locationTextoOpcionalCódigo del activo donde está ubicado o es parte de
latitudeTextoOpcionalLatitud
longitudTextoOpcionalLongitud
unit_codeTextoOpcional(Si el tipo de activo es Repuesto o suministro es obligatorio)Código de la unidad
unit_descriptionTextoOpcional(Si el tipo de activo es Repuesto o suministro es obligatorio)Descripción de la unidad
visible_to_allBooleanoOpcionalTrue si el activo se puede visualizar a todas las personas de la empresa
purchase_dateTextoOpcionalFecha de compra. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC' Ejemplo:'2016-07-12T20:00:00-03'
total_costTextoOpcionalCosto total
startup_dateTextoOpcionalFecha de inicio para la depreciación. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC' Ejemplo:'2016-07-12T20:00:00-03'.
costs_centerTextoOpcionalDescripción Centro de costos
budgetsTextoOpcionalCosto total de la depreciación lineal

Parámetros a ser actualizados de acuerdo al tipo de activo:

ParámetroTipoObligatorioUbicaciones (id_type_item = 1)Equipos (id_type_item = 2)Herramientas (id_type_item = 3)Repuestos y suministros (id_type_item = 4)Digital (id_type_item = 5)
field_1TextoSiNombreNombreNombreNombreNombre
field_2TextoOpcionalDirecciónFabricanteNúmero de parteNúmero de parteFabricante
field_3TextoOpcionalCiudadModeloFabricanteFabricanteNúmero de serial
field_4TextoOpcionalCódigo de áreaNúmero de serialModeloModeloVersión
field_5TextoOpcionalDepartamento / Estado / RegionOtro 1Otro 1Otro 1
field_6TextoOpcionalPaísOtro 2Otro 2Otro 2

**Nota:Enviar sólo los los parámetros que se desean actualizar

Parámetros de salida

ParámetroTipoDescripción
id EnteroID del activo en Fracttal
code TextoCódigo del activo
description TextoDescripción del activo
id_type_item EnteroTipo de activo. Pode ser:
1 - para Localización
2 - para Equipos
3 - para Herramientas
4 - para Repuestos y suminitros
5 - para Digital
notes TextoNotas
min_stock_warningEnteroCantidad minima esperada del activo
weight TextoPeso
is_serial_control BooleanoIndica si el activo es controlado por serial
is_tool BooleanoPendiente
activeTextoIndica si el activo está activo o no
barcode TextoCódigo de barras
field_1 TextoCampo personalizado #1
field_2 TextoCampo personalizado #2
lead_time PendientePendiente
path_image TextoRuta de la imagen del activo
field_3 TextoCampo personalizado #3
field_4 TextoCampo personalizado #4
field_5 TextoCampo personalizado #5
field_6 TextoCampo personalizado #6
is_changed BooleanoIndica si el activo ha sido modificado
import_code PendientePendiente
total_replacement_cost TextoCosto total de la depreciación lineal
salvage_value TextoValor de sustitución (depreciación)
purchase_dateDate UTC-0Fecha de compra
total_cost TextoCosto total
anual_depreciation TextoPorcentaje depreciación anual
startup_date Date UTC-0Fecha de inicio para la depreciación
latitude TextoLatitud
longitud TextoLongitud
visible_to_allBooleanoIndica si el activo es visible para todos
hours_average_daily_use EnteroHoras de uso promedio diario (Tiempo en segundos, por defecto son 86400 = 24 horas)
parent_description TextoUbicado o es parte de
path_node TextoPendiente
public_qr TextoCódigo QR

Ejemplo:

Petición: (PUT) https://app.fracttal.com/api/items/EQM028

{
	"id_type_item":2,
	"code":"EQM028",
	"field_1":"REFRIGERADOR DE VACUNAS",
	"field_2":"SAMSUNG",
	"field_3":"C13 D",
	"field_4":"001827",
	"field_5":"02 RACKS",
	"field_6":"750X580X390",
	"barcode":"123987123AAC",
	"id_priority":"1",
	"purchase_date":"2015-10-27T20:00:00-05",
	"is_serial_control":"false",
	"is_tool":"false",
	"active":"true",
	"is_changed":"false"
}
{
    "success": true,
    "message": "200",
    "data": {
        "id": 21790172,
        "id_company": 1190,
        "code": "EQM028",
        "description": "{ EQM028 } REFRIGERADOR DE VACUNAS SAMSUNG 001827",
        "id_type_item": 2,
        "id_group": null,
        "id_group_2": 57741,
        "notes": null,
        "min_stock_warning": null,
        "weight": null,
        "id_unit": null,
        "is_serial_control": false,
        "is_tool": false,
        "active": true,
        "barcode": "123987123AAC",
        "field_1": "REFRIGERADOR DE VACUNAS",
        "field_2": "SAMSUNG",
        "lead_time": null,
        "id_custom_field_group": null,
        "path_image": null,
        "id_parent": null,
        "id_priority": null,
        "id_group_1": 58977,
        "id_group_task": null,
        "id_cost_center": null,
        "field_3": "C13 D",
        "field_4": "001827",
        "is_changed": true,
        "field_5": "02 RACKS",
        "field_6": "750X580X390",
        "import_code": null,
        "total_replacement_cost": null,
        "salvage_value": null,
        "purchase_date": "2015-10-27",
        "total_cost": null,
        "anual_depreciation": null,
        "startup_date": null,
        "id_third_party": null,
        "id_budget": null,
        "latitude": null,
        "longitud": null,
        "id_items_import": null,
        "visible_to_all": false,
        "hours_average_daily_use": 86400,
        "parent_description": "// ",
        "path_node": "21790172",
        "statistics": {
            "leaf": true,
            "cost_average": null,
            "last_date_out": null
        },
        "public_qr": null
    },
    "total": 1
}
Language