Fracttal →

Crear documentos y asociarlos a un activo

Mediante esta API se crea un documento de gestión documental (Garantía o Documento) y se asocia a un activo.

Mediante esta API se crea un documento de gestión documental (Garantía o Documento) y se asocia a un activo.

Parámetros de entrada

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

ParámetroTipoRequeridoDescripción
codeTextoCódigo del activo. Se puede obtener aquí (campo code)
id_type_itemEnteroOpcionalTipo del activo. Los valores disponibles son:
1: Ubicaciones
2: Equipos
3: Herramientas
4: Repuestos y suministros
5: Digital
nameTextoNombre de la garantía
descriptionTextoOpcionalDescripción de la garantía
group_descriptionTextoOpcionalGrupo de la garantía. Si se asociará un grupo existente se debe enviar el nombre como está creado en Fracttal, en caso tal de que no se encuentre un grupo con la descripción enviada se creará uno nuevo
versionTextoOpcionalVersión del documento
valid_fromDateOpcionalFecha de inicio de validez
valid_throughDateOpcionalFecha finalización de la validez
warrantyBooleanoOpcionalIndica si es una garantía o no
iso_codeTextoOpcionalCódigo ISO del documento
authorTextoOpcionalAutor

Enviar los campos obligatorios y los parámetros con los valores adicionales que se desea insertar.

Parámetros de salida

ParámetroTipoDescripción
idTextoID del documento
groups_attached_descriptionTextoPendiente
descriptionTextoDescripción de la garantía
nameTextoNombre del documento asociado
versionTextoVersión del documento asociado
valid_fromTextoFecha de inicio de validez del documento asociado
valid_throughTextoFecha de finalización de validez del documento asociado
authorTextoAutor del documento asociado
code_isoTextoCódigo ISO del documento
is_warrantyBooleano¿Documento es garantía?
statusBooleanoIndica si el documento está activo o no
item_descriptionTextoDescripción del activo al que se asoció el documento
item_codeTextoCódigo del activo

Ejemplo:

Petición: (POST) https://app.fracttal.com/api/items_document_management

{
    "code": "EQM033",
    "id_type_item": null,
    "name": "Documento de prueba",
    "description": "Este es un documento de prueba",
    "group_description": "Grupo de garantía",
    "version": "1.0",
    "valid_from": "2022-10-27",
    "valid_until": "2023-09-07",
    "warranty": true,
    "iso_code": null,
    "author": "Juan Perez"
}
{
    "success": true,
    "message": "200",
    "data": [
        {
            "id_company": 119,
            "id_group_attached": 1687,
            "groups_attached_description": "Grupo de garantía",
            "description": "Este es un documento de prueba",
            "name": "Documento de prueba",
            "version": "1.0",
            "valid_from": "2022-10-27T00:00:00+00:00",
            "valid_through": "2023-09-07T00:00:00+00:00",
            "author": "Juan Prieto",
            "code_iso": null,
            "is_warranty": true,
            "id_item": 30519376,
            "id_attached": 88134,
            "id": 77728,
            "status": false,
            "item_description": "{ EQM033 } escavadora  ",
            "id_type_item": 2,
            "item_code": "EQM033"
        }
    ],
    "total": 1
}
Language