Agregar activos a la pauta

curl --request POST \
  --url https://api.ugps.io/api/maintenance/programs/{id}/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetIds": [
    "<string>"
  ],
  "groupId": "<string>",
  "notApplicableOnConflict": true
}
'

import requests

url = "https://api.ugps.io/api/maintenance/programs/{id}/assets"

payload = {
    "assetIds": ["<string>"],
    "groupId": "<string>",
    "notApplicableOnConflict": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({assetIds: ['<string>'], groupId: '<string>', notApplicableOnConflict: true})
};

fetch('https://api.ugps.io/api/maintenance/programs/{id}/assets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ugps.io/api/maintenance/programs/{id}/assets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'assetIds' => [
        '<string>'
    ],
    'groupId' => '<string>',
    'notApplicableOnConflict' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ugps.io/api/maintenance/programs/{id}/assets"

	payload := strings.NewReader("{\n  \"assetIds\": [\n    \"<string>\"\n  ],\n  \"groupId\": \"<string>\",\n  \"notApplicableOnConflict\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.ugps.io/api/maintenance/programs/{id}/assets")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assetIds\": [\n    \"<string>\"\n  ],\n  \"groupId\": \"<string>\",\n  \"notApplicableOnConflict\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/maintenance/programs/{id}/assets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assetIds\": [\n    \"<string>\"\n  ],\n  \"groupId\": \"<string>\",\n  \"notApplicableOnConflict\": true\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Volvo",
    "description": "<string>",
    "status": "active",
    "sourceGroup": {
      "id": "<string>",
      "name": "<string>",
      "takenAt": "2023-11-07T05:31:56Z"
    },
    "taskCount": 123,
    "assetCount": 123,
    "dueCounts": {
      "overdue": 123,
      "dueSoon": 123,
      "ok": 123,
      "assumedOk": 123,
      "missingLastService": 123,
      "assumedLastService": 123
    },
    "toScheduleAssetCount": 123,
    "recipients": {
      "userIds": [
        "507f1f77bcf86cd799439011"
      ],
      "emails": [
        "taller@empresa.cl"
      ]
    },
    "requiresAttachment": true,
    "requiresCost": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "recipientUsers": [
      {
        "id": "<string>",
        "name": "Jefe Taller",
        "email": "<string>"
      }
    ],
    "tasks": [
      {
        "id": "<string>",
        "taskDefinition": {
          "id": "<string>",
          "code": "ACM",
          "name": "Cambio de aceite de motor",
          "status": "active"
        },
        "conditions": {
          "odometer": {
            "everyKm": 40000,
            "remindBeforeKm": 4000
          },
          "engineHours": {
            "everyHours": 2,
            "remindBeforeHours": 1
          },
          "date": {
            "every": 2,
            "unit": "days",
            "remindBefore": 1,
            "remindUnit": "days"
          }
        },
        "exceptionCounts": {
          "notApplicable": 123,
          "ownInterval": 123
        }
      }
    ],
    "assets": [
      {
        "id": "<string>",
        "name": "<string>",
        "plate": "<string>",
        "make": "<string>",
        "model": "<string>",
        "year": 123,
        "kilometer": 123,
        "kilometerSource": "tracker",
        "addedAt": "2023-11-07T05:31:56Z",
        "exceptions": [
          {
            "taskId": "<string>",
            "notApplicable": true,
            "conditions": {
              "odometer": {
                "everyKm": 40000,
                "remindBeforeKm": 4000
              },
              "engineHours": {
                "everyHours": 2,
                "remindBeforeHours": 1
              },
              "date": {
                "every": 2,
                "unit": "days",
                "remindBefore": 1,
                "remindUnit": "days"
              }
            }
          }
        ]
      }
    ],
    "groupDifference": {
      "groupId": "<string>",
      "groupName": "<string>",
      "missingAssets": [
        {
          "id": "<string>",
          "name": "<string>",
          "plate": "<string>"
        }
      ]
    }
  }
}

{
  "error": "El email es requerido"
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "No tiene permisos para realizar esta acción"
}

{
  "error": "Recurso no encontrado"
}

{
  "status": "failed",
  "code": "TRACKER_SENSOR_DIN_CONFLICT",
  "message": "Esa entrada digital ya está asignada a otro sensor del dispositivo"
}

{
  "message": "Error interno del servidor"
}

Mantenimiento - Pautas

Agregar activos a la pauta

Agrega activos elegidos (assetIds) o los de un grupo (groupId), uno de los dos. Cada activo nuevo queda asignado, sin último servicio, a todas las tareas de la pauta; los que ya estaban no cambian. Responde 400 MAINTENANCE_PROGRAM_ASSETS_INVALID si un activo elegido no es de la empresa, y 409 MAINTENANCE_PROGRAM_TASK_IN_OTHER_PROGRAM si un activo nuevo ya tiene una de las tareas de la pauta activa por otra pauta (se resuelve con «No aplica» en una de las dos o con notApplicableOnConflict).

POST

api

maintenance

programs

{id}

assets

Agregar activos a la pauta

curl --request POST \
  --url https://api.ugps.io/api/maintenance/programs/{id}/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetIds": [
    "<string>"
  ],
  "groupId": "<string>",
  "notApplicableOnConflict": true
}
'

import requests

url = "https://api.ugps.io/api/maintenance/programs/{id}/assets"

payload = {
    "assetIds": ["<string>"],
    "groupId": "<string>",
    "notApplicableOnConflict": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({assetIds: ['<string>'], groupId: '<string>', notApplicableOnConflict: true})
};

fetch('https://api.ugps.io/api/maintenance/programs/{id}/assets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ugps.io/api/maintenance/programs/{id}/assets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'assetIds' => [
        '<string>'
    ],
    'groupId' => '<string>',
    'notApplicableOnConflict' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ugps.io/api/maintenance/programs/{id}/assets"

	payload := strings.NewReader("{\n  \"assetIds\": [\n    \"<string>\"\n  ],\n  \"groupId\": \"<string>\",\n  \"notApplicableOnConflict\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.ugps.io/api/maintenance/programs/{id}/assets")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assetIds\": [\n    \"<string>\"\n  ],\n  \"groupId\": \"<string>\",\n  \"notApplicableOnConflict\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/maintenance/programs/{id}/assets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assetIds\": [\n    \"<string>\"\n  ],\n  \"groupId\": \"<string>\",\n  \"notApplicableOnConflict\": true\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Volvo",
    "description": "<string>",
    "status": "active",
    "sourceGroup": {
      "id": "<string>",
      "name": "<string>",
      "takenAt": "2023-11-07T05:31:56Z"
    },
    "taskCount": 123,
    "assetCount": 123,
    "dueCounts": {
      "overdue": 123,
      "dueSoon": 123,
      "ok": 123,
      "assumedOk": 123,
      "missingLastService": 123,
      "assumedLastService": 123
    },
    "toScheduleAssetCount": 123,
    "recipients": {
      "userIds": [
        "507f1f77bcf86cd799439011"
      ],
      "emails": [
        "taller@empresa.cl"
      ]
    },
    "requiresAttachment": true,
    "requiresCost": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "recipientUsers": [
      {
        "id": "<string>",
        "name": "Jefe Taller",
        "email": "<string>"
      }
    ],
    "tasks": [
      {
        "id": "<string>",
        "taskDefinition": {
          "id": "<string>",
          "code": "ACM",
          "name": "Cambio de aceite de motor",
          "status": "active"
        },
        "conditions": {
          "odometer": {
            "everyKm": 40000,
            "remindBeforeKm": 4000
          },
          "engineHours": {
            "everyHours": 2,
            "remindBeforeHours": 1
          },
          "date": {
            "every": 2,
            "unit": "days",
            "remindBefore": 1,
            "remindUnit": "days"
          }
        },
        "exceptionCounts": {
          "notApplicable": 123,
          "ownInterval": 123
        }
      }
    ],
    "assets": [
      {
        "id": "<string>",
        "name": "<string>",
        "plate": "<string>",
        "make": "<string>",
        "model": "<string>",
        "year": 123,
        "kilometer": 123,
        "kilometerSource": "tracker",
        "addedAt": "2023-11-07T05:31:56Z",
        "exceptions": [
          {
            "taskId": "<string>",
            "notApplicable": true,
            "conditions": {
              "odometer": {
                "everyKm": 40000,
                "remindBeforeKm": 4000
              },
              "engineHours": {
                "everyHours": 2,
                "remindBeforeHours": 1
              },
              "date": {
                "every": 2,
                "unit": "days",
                "remindBefore": 1,
                "remindUnit": "days"
              }
            }
          }
        ]
      }
    ],
    "groupDifference": {
      "groupId": "<string>",
      "groupName": "<string>",
      "missingAssets": [
        {
          "id": "<string>",
          "name": "<string>",
          "plate": "<string>"
        }
      ]
    }
  }
}

{
  "error": "El email es requerido"
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "No tiene permisos para realizar esta acción"
}

{
  "error": "Recurso no encontrado"
}

{
  "status": "failed",
  "code": "TRACKER_SENSOR_DIN_CONFLICT",
  "message": "Esa entrada digital ya está asignada a otro sensor del dispositivo"
}

{
  "message": "Error interno del servidor"
}

Authorizations

Authorization

string

header

required

Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.

Path Parameters

string

required

Body

application/json

assetIds

string[]

Required array length: 1 - 1000 elements

groupId

string

notApplicableOnConflict

boolean

Si otra pauta activa ya tiene la misma Tarea del catálogo activa en un activo, la agrega con «No aplica» en esta pauta en vez de responder 409 MAINTENANCE_PROGRAM_TASK_IN_OTHER_PROGRAM.

Response

La pauta con los activos agregados

status

string

Example:

"success"

data

object

Pauta de mantención con sus conteos.

Show child attributes