Ordenes de trabajo

Obtener listado de OT's

GET https://{clave}.admintotal.com/api/v2/ordenes_servicio/

Headers

Name	Type	Description
Api-key	string	Token de autenticación

Query Parameters

Name	Type	Description
status	integer	Filtrar las ordenes de trabajo por estado: 1 = "Abierta" 2 = "En proceso" 3 = "Terminada" 4 = "Cancelada" 5 = "Confirmada"

200

{
    "count": 23,
    "next": "https://{clave}.admintotal.com/api/v2/ordenes_servicio/",
    "previous": null,
    "results": [
        {
            "id": 11106,
            "status": 5,
            "prioridad": null,
            "bitacora_inicio_cliente": null,
            "bitacora_llegada_base": null,
            "descripcion": "<p>MANTENIMIENTO A INMUEBLES MANO DE OBRA</p>",
            "status_display": "Confirmada",
            "clave": "2761-13-1/1",
            "periodicidad": "Mensual",
            "prioridad_display": null,
            "tipo_servicio": "MANO DE OBRA",
            "sucursal": {
                "id": 29,
                "municipio": "Mérida",
                "nombre": "CAC MERIDA IV ORIENTE",
                "cliente": "MICLIENTE",
                "direccion": "Direccion"
            },
            "cliente": {
                "id": 1532,
                "regimen_fiscal": "601",
                "rfc": "XXXXX",
                "razon_social": "MICLIENTE",
                "direccion": "Dirección completa del cliente.",
                "colonia": "Ampliación Granada",
                "nombre": "MICLIENTE",
                "telefono": "(999) 1111-0002",
                "email": "",
                "representante_legal": "MICLIENTE"
            }
        },
        ...
    ]
}

Obtener una OT

GET https://{clave}.admintotal.com/api/v2/ordenes_servicio/:id/

Path Parameters

Name	Type	Description
ID	integer	ID de la OT

Headers

Name	Type	Description
Api-key	string	Token de autenticación

200

{
    "id": 11448,
    "status": 5,
    "prioridad": null,
    "bitacora_inicio_cliente": "2026-01-01T09:44:27-06:00",
    "bitacora_llegada_base": "2026-01-27T09:44:27-06:00",
    "descripcion": "<p>FALTA DE AGUA</p>",
    "status_display": "Confirmada",
    "clave": "7136-1-1/1",
    "periodicidad": "-----",
    "prioridad_display": null,
    "tipo_servicio": "TRABAJOS CORRECTIVOS",
    "sucursal": {
        "id": 228,
        "municipio": "Carmen",
        "nombre": "XXXX CD DEL CARMEN",
        "cliente": "Nombre del cliente",
        "direccion": "Dirección ..."
    },
    "cliente": {
        "id": 1547,
        "regimen_fiscal": "601",
        "rfc": "XXXXX",
        "razon_social": "Nombre del cliente",
        "direccion": "Dirección ...",
        "colonia": "Hipódromo Condesa",
        "nombre": "Nombre del cliente",
        "telefono": "[phone]",
        "email": "",
        "representante_legal": "Nombre del cliente"
    },
    "empleados": [
        {
            "id": 1650,
            "rfc": "XXXXXXXX",
            "nombre": "NOMBRE DEL EMPLEADO",
            "apellido_paterno": "DEL",
            "apellido_materno": "EMPLEADO"
        }
    ],
    "archivos": [
        {
            "id": 554877,
            "url": "https://....",
            "titulo": "Antes del servicio - 20260127_150310.jpg",
            "creado": "2026-01-27T22:20:56.787815+00:00"
        }
    ]
}
 

Editar una OT

PATCH https://{clave}.admintotal.com/api/v2/ordenes_servicio/:id/

Request Body

Name	Tipo	Descripción
status	Integer	Estados disponibles: 1 = "Abierta" 2 = "En proceso" 3 = "Terminada" 4 = "Cancelada" 5 = "Confirmada"
prioridad	integer	Prioridad de la OT, opciones disponibles: 1 = "Alta" 2 = "Media" 3 = "Baja"
descripción	string	Descripción de la visita
bitacora_inicio_cliente	string	Formato ISO 8601 ejemplo: 2026-01-01T09:44:27-06:00
bitacora_llegada_base	string	Formato ISO 8601 ejemplo: 2026-01-01T09:44:27-06:00

200

{
    "id": 11448,
    "status": 5,
    "prioridad": null,
    "bitacora_inicio_cliente": "2026-01-01T09:44:27-06:00",
    "bitacora_llegada_base": "2026-01-27T09:44:27-06:00",
    "descripcion": "<p>FALTA DE AGUA</p>",
    "status_display": "Confirmada",
    "clave": "7136-1-1/1",
    "periodicidad": "-----",
    "prioridad_display": null,
    "tipo_servicio": "TRABAJOS CORRECTIVOS",
    "sucursal": {
        "id": 228,
        "municipio": "Carmen",
        "nombre": "XXXX CD DEL CARMEN",
        "cliente": "Nombre del cliente",
        "direccion": "Dirección ..."
    },
    "cliente": {
        "id": 1547,
        "regimen_fiscal": "601",
        "rfc": "XXXXX",
        "razon_social": "Nombre del cliente",
        "direccion": "Dirección ...",
        "colonia": "Hipódromo Condesa",
        "nombre": "Nombre del cliente",
        "telefono": "[phone]",
        "email": "",
        "representante_legal": "Nombre del cliente"
    },
    "empleados": [
        {
            "id": 1650,
            "rfc": "XXXXXXXX",
            "nombre": "NOMBRE DEL EMPLEADO",
            "apellido_paterno": "DEL",
            "apellido_materno": "EMPLEADO"
        }
    ],
    "archivos": [
        {
            "id": 554877,
            "url": "https://....",
            "titulo": "Antes del servicio - 20260127_150310.jpg",
            "creado": "2026-01-27T22:20:56.787815+00:00"
        }
    ]
}
 

Adjuntar imagen a la Visita de una OT

POST https://{clave}.admintotal.com/api/v2/ordenes_servicio/:id/adjuntar_imagen/

Query Parameters

Path Parameters

Name	Type	Description
ID	integer	ID de la OT

Headers

Name	Type	Description
Api-key	string	Token de autenticación

Request Body

Name	Type	Description
titulo	string	Título de la imagen
proceso	integer	ID del proceso: 1 = Antes del servicio 2 = Durante el servicio 3 = Después del servicio
imagen	string	Formato: Base64

201

{
    "id": 555417,
    "url": "https://...",
    "titulo": "Imágen antes del servicio",
    "creado": "2026-01-28T17:53:36.346193+00:00"
}