El parámetro en la url "code" es el id de la solicitud. Se puede encontrar en este mismo endpoint, campo id_code

GET https://app.fracttal.com/api/work_requests/{code}

Parámetros de entrada

Parámetro Tipo Requerido Descripción

code Texto Opcional Id de la solicitud. Se puede encontrar en este mismo endpoint, campo id_code

since Texto Opcional Fecha de inicio de la consulta. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC' Ejemplo:'2016-07-12T20:00:00-03'.

until Texto Opcional Fecha de finalización de la consulta. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC' Ejemplo:'2016-07-12T20:00:00-03'.

type_date

Texto

Opcional

Tipo de data para hacer la consulta. Puede ser:

Valor	Descripción
`date`	Fecha de creación de la Solicitud (Valor por defecto)
`date_incident`	Fecha del incidente
`date_solution`	Fecha de Solución de la solicitud

id_status

Texto

Opcional

Id de estado de solicitud de trabajo, los valores disponibles son:

1 - Abierto
2 - En proceso
3 - Sistema operativo en proceso
4 - Resuelto sin OT
5 - Cancelado
6 - Resuelto con OT
7 - Esperando un OT
8 - OT en revisión
9 - OT cancelado
10 - Esperando otro OT
11 - Solicitud eliminada de Tareas pendientes
12 - Rechazado
13 - Creado por el Portal de Invitados

code_creator Texto Opcional Código del personal creador de la solicitud (campo code de personnel_log). Queda NULL/vacío si el creador es un tercero o si la solicitud proviene del Portal de Invitados (contacts_log no tiene code).

code_item Texto Opcional Código del activo/ítem asociado a la solicitud (campo code de items_log).

identifier Texto Opcional Referencia

page Entero Opcional Número de página a consultar.

start Entero Opcional Nú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 Entero Opcional Cantidad de registros que mostrará la petición. El valor por defecto es 100.

Nota sobre code_creator y code_item
Ambos filtros usan NULLIF internamente — un string vacío se trata como no enviado (no filtra). code_creator puede venir NULL en la respuesta cuando el creador es un tercero o cuando la solicitud se originó en el Portal de Invitados, ya que contacts_log no tiene el campo code.

Parámetros de salida

Parámetro	Tipo de campo	Descripción
`id_code`	Texto	Id de solicitud
`date`	Fecha UTC-0	Solicitud de fecha de creación
`is_urgent`	Texto	True si la solicitud es urgente, false en caso contrario
`description`	Texto	Solicitar descripción
`rating`	Texto	Solicitar calificación
`rating_notes`	Texto	Notas de calificación de la aplicación
`observation`	Texto	Solicitar notas
`date_solution`	Fecha UTC-0	fecha de solución
`types_description`	Texto	Grupo
`items_description`	Texto	Activo asociado con la solicitud
`date_status`	Texto	Fecha del último cambio de estado
`requests_x_status_notes`	Texto	Nota de cambio de estado
`requests_x_status_description`	Texto	Descripción del estado actual
`accounts_name`	Texto	Usuario que creó la solicitud
`accounts_email`	Texto	Email del usuario que creó la solicitud
`requests_x_key_words_descriptions`	Texto	ordenar palabras clave
`wo_folio`	Texto	ID del OT relacionado con la solicitud
`date_incident`	Fecha UTC-0	fecha del incidente
`parent_description`	Texto	Ubicación del activo que está asociado con la solicitud
`requests_x_status_accounts_name`	Texto	Nombre de la persona que realizó la última solicitud de cambio de estado
`requested_by`	Texto	Solicitado por
`types_1_description`	Texto	Clasificación 1
`types_2_description`	Texto	Clasificación 2
`identifier`	Texto	Referencia
`geolocation`	Texto	Geolocalización
`id_company`	Entero	Id interno de la compañía (multi-tenancy)
`id_work_order`	Entero	Id interno de la orden de trabajo generada desde la solicitud, si existe. Ver `wo_folio` para el folio visible
`id_type`	Entero	Id interno del tipo de solicitud. Ver `types_description`
`id_item`	Entero	Id interno del activo/ítem asociado a la solicitud
`id_requests_x_status`	Entero	Id interno del registro de historial que originó el estado actual
`id_type_1`	Entero	Id interno de la clasificación 1. Ver `types_1_description`
`id_type_2`	Entero	Id interno de la clasificación 2. Ver `types_2_description`
`id_personnel_log`	Entero	Id interno del registro histórico del personal creador, cuando el creador es personal interno. Viene vacío si el creador es un tercero
`id_contacts_log`	Entero	Id interno del registro histórico del contacto de terceros creador, cuando la solicitud proviene del Portal de Invitados. Viene vacío si el creador es personal interno
`id_account`	Entero	Id interno de la cuenta de usuario del creador de la solicitud
`id_user`	Entero	Id de personal o de contacto del creador, según corresponda
`id_group_task`	Entero	Id interno del grupo de tareas asociado al activo/ítem
`id_item_log`	Entero	Id interno del registro histórico del activo/ítem asociado a la solicitud
`id_priority`	Entero	Id interno de la prioridad del activo/ítem asociado
`id_cost_center`	Entero	Id interno del centro de costos del activo/ítem asociado
`id_group`	Entero	Id interno del grupo (nivel base) del activo/ítem
`id_group_1`	Entero	Id interno del grupo nivel 1 del activo/ítem
`id_group_2`	Entero	Id interno del grupo nivel 2 del activo/ítem
`id_related`	Texto	Id de un elemento relacionado con la solicitud. Puede venir vacío
`status_path_image`	Texto	URL del ícono asociado al estado actual de la solicitud
`requests_x_key_words_id_key_words`	Array de entero	Ids de las palabras clave asociadas a la solicitud. Complementa a `requests_x_key_words_descriptions`
`types_color`	Texto	Color asociado al tipo de solicitud, en formato hexadecimal
`priorities_description`	Texto	Descripción de la prioridad del activo/ítem asociado
`code_item`	Texto	Código del activo/ítem asociado a la solicitud
`costs_center_description`	Texto	Descripción del centro de costos del activo/ítem asociado
`groups_description`	Texto	Descripción del grupo (nivel base) del activo/ítem
`groups_1_description`	Texto	Descripción del grupo nivel 1 del activo/ítem
`groups_2_description`	Texto	Descripción del grupo nivel 2 del activo/ítem
`requests_x_status_third_parties_name`	Texto	Nombre del contacto de terceros que registró el último cambio de estado, si aplica
`annotations`	Objeto	Anotaciones internas asociadas a la solicitud, en formato JSON. Estructura sujeta a cambios
`parent_path_node`	Texto	Ruta jerárquica de la ubicación/nodo padre del activo/ítem asociado
`code_creator`	Texto	Código del personal creador de la solicitud. Viene vacío si el creador es un tercero o si la solicitud proviene del Portal de Invitados
`date_maintenance`	Fecha UTC-0	Fecha de mantenimiento asociada a la solicitud
`visible_to_all`	Booleano	Indica si el activo/ítem asociado es visible para todos los usuarios
`email_requested_by`	Texto	Correo electrónico de quien solicitó, como campo de texto libre (independiente de `accounts_email`)
`from_guest_portal`	Booleano	Indica si la solicitud fue creada desde el Portal de Invitados

Ejemplo:

Petición: (GET)https://app.fracttal.com/api/work_requests/381

{
  "success": true,
  "message": "200",
  "data": [
    {
      "id_code": 385,
      "date": "2016-11-30T19:44:07.361543+00:00",
      "is_urgent": false,
      "description": "AVERIA",
      "rating": null,
      "rating_notes": null,
      "observation": "REAPRAR",
      "date_solution": null,
      "types_description": "Electricidad",
      "items_description": "EQUIPO PARA EJEMPLO    ",
      "id_status": 7,
      "date_status": "2016-11-30T19:45:24.225016+00:00",
      "requests_x_status_notes": "REQUEST_TODO",
      "requests_x_status_description": "REQUEST_TODO",
      "accounts_name": "RICARDO ROMAN",
      "accounts_email": "[email protected]",
      "requests_x_key_words_descriptions": "Equipo Falla., Equipo en Cliente",
      "wo_folio": null,
      "date_incident": "2016-11-30T16:47:03",
      "parent_description": "// AMERICA/ UBICACION DE EJEMPLO/ EQUIPO PARA EJEMPLO/ ",
      "requests_x_status_accounts_name": "RICARDO ROMAN",
      "requested_by": "RICARDO ROMAN",
      "types_1_description": "EQUIPO FALLA",
      "types_2_description": "CLASIFICACIÓN 2",
      "identifier": "",
      "geolocation": "{\"latitude\":-33.4213982,\"longitude\":-70.60434660000001,\"hour\":\"2016-11-30 4:47 PM\",\"address\":\"San Pío X 2449, Providencia, Región Metropolitana, Chile\"}",
      "id_company": 3832,
      "id_work_order": null,
      "id_type": 12,
      "id_item": 5021,
      "id_requests_x_status": 771,
      "id_type_1": 4,
      "id_type_2": 9,
      "id_personnel_log": 158,
      "id_contacts_log": null,
      "id_account": 942,
      "id_user": 158,
      "id_group_task": null,
      "id_item_log": 5044,
      "id_priority": 2,
      "id_cost_center": 15,
      "id_group": 100,
      "id_group_1": 101,
      "id_group_2": 102,
      "id_related": null,
      "status_path_image": "https://cdn.fracttal.com/status/icons/waiting.svg",
      "requests_x_key_words_id_key_words": [12, 47],
      "types_color": "#F4B400",
      "priorities_description": "Media",
      "code_item": "EQ-0042",
      "costs_center_description": "Mantenimiento General",
      "groups_description": "Planta Norte",
      "groups_1_description": "Área Eléctrica",
      "groups_2_description": "Subestación 2",
      "requests_x_status_third_parties_name": null,
      "annotations": null,
      "parent_path_node": "1.4.12",
      "code_creator": "RROMAN",
      "date_maintenance": null,
      "visible_to_all": true,
      "email_requested_by": "[email protected]",
      "from_guest_portal": false
    }
  ],
  "total": 1
}

Ejemplo — filtrando por creador y activo:

Petición: (GET)https://app.fracttal.com/api/work_requests?code_creator=JCDIAZ&code_item=EQ-0042

{
  "success": true,
  "message": "200",
  "data": [
    {
      "id_code": 3884,
      "description": "PRUEBA ALEJANDRO DE ESTABILIDAD",
      "items_description": "EQUIPO PARA EJEMPLO",
      "id_status": 1
    }
  ],
  "total": 1
}

Path Params

code — string — required

OpenAPI definition

{
  "openapi": "3.1.0",
  "info": {
    "title": "solicitudes",
    "version": "1-Es"
  },
  "servers": [
    {
      "url": "https://app.fracttal.com/api/work_requests"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/{code}": {
      "get": {
        "summary": "Consulta de Solicitud",
        "description": "Este EndPoint se puede utilizar para consultar información sobre todas las solicitudes de trabajo o alguna en especifico.",
        "operationId": "consulta-de-solicitud",
        "security": [],
        "parameters": [
          {
            "in": "path",
            "name": "code",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ]
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}

Parámetros de entrada

Nota sobre code_creator y code_item

Parámetros de salida

Ejemplo:

Ejemplo — filtrando por creador y activo:

Path Params

OpenAPI definition

Nota sobre `code_creator` y `code_item`