Crear Orden de Trabajo

Este endpoint realiza la creación de una orden de trabajo

HTTP Request

POST https://admin.cmmshere.com/api/v1/workOrders

Body / Form Data

Provee información para la nueva orden de trabajo

Parámetro	Tipo	Requerido	Observaciones
ot_service	Int	true	Indica si se trata de una orden de trabajo de servicio o de activo: 1: Servicio 2: Activo
client_id	Int	true	ID del cliente de la orden de trabajo
contact_id	Int	false	ID del contacto del cliente de la orden trabajo
asset_id	Int	Requerido solo si es una OT de activo	ID del activo
city_id	Int	Requerido si es una OT de servicio.	ID de ciudad de la OT. Se definirá automáticamente si es un OT de activo
work_address	String	true
maintenance_program_id	Int	true	ID del formulario del procedimiento de mantenimiento vinculado al activo o servicio
responsible_validator_id	Int	true	ID del usuario responsable de la validación de procedimiento de mantenimiento
request_id	Int	false	ID de la solicitud de trabajo
date	Date	true	Fecha posterior a la actual en formato Y-m-d H:i:s
title	String	true
description	String	true
priority	Int	true	Debe elegir entre los siguientes valores: 0 = Ninguna 1 = Baja 2 = Media 3 = Alta
emergency	String	false	En caso de ser emergencia, envíe el carácter "E"
duration_type	String	true	Tipo de duración: h = Horas d = Días
duration	Decimal	true	Numero con la duración de horas o días
cost_hour	Decimal	true	Costo por hora
tech_type	String	true	Indica la forma de asignación de los técnicos a cargo: T:Seleccionar equipo de trabajo E:Seleccionar técnicos específicos
team_id	Int	Requerido si tech_type es T	ID del equipo , en caso de que tech_type sea T
responsible_tech_id	Int	Requerido si tech_type es E	ID del técnico responsable a cargo
aditional_tech_ids	Array	Requerido si tech_type es E	IDs de técnicos asignados adicionales.
work_weekend	Int	false	Enviar el valor "1" si la duración del trabajo incluye fines de semana
attach	File	false	Archivo adjunto de la orden de trabajo. (Un solo archivo permitido) Formatos permitidos: gif, jpg, jpeg, png, pdf. Tamaño máximo: 5MB
toolkit_id	Int	false	ID del kit de herramientas
inventorykity_id	Int	false	ID de kit de fungibles
authorizer_inventorykit_id	Int	false	ID de autorizador para la solicitud del kit de fungibles
signatures_quantity	Int	true	Cantidad de firmas en la OT
reminder	String	true	Número de horas antes para enviar un correo recordatorio, con valores: 0, 5m, 10m, 15m, 30m, 45m, 1, 2 , 3, 6, 12, 24, 48, 120, 240
not_view	String	true

Ejemplo de petición

curl --location 'https://admin.cmmshere.com/api/v1/workOrders' \
--header 'Authorization: Bearer 804|fCkDcz43egLAubMzPinRCIVUIjPUsGkvbVJ864IP' \
--header 'Cookie: XSRF-TOKEN=eyJpdiI6IktwckY2VTNIOU5UYVZvUjg5eUxXV2c9PSIsInZhbHVlIjoiOTlpVEZIVGRnZEJoRnN3RnpVK3lLMjZZQnBHVGFrc2VNZU5XVUplamswTjl1RC8yVk1JY0lUWGVSVDlIN0YxZnEzQldLQjRyUUFmTEQ2WWFhbDNDNXVVSTZ2QVg2aEkxTTNaZWI3NzlvZVJGV3dmRlFXUU5qVWhhelFCOFpRaTgiLCJtYWMiOiIwMzU2Y2YyNTk5YjE2ZmYyN2Y4MmJkMzQyNjg4MTU2MGJjZjY1MWZjYTAxMDdjNjlkYTkxYjIzZTkwZjZlMmZhIn0%3D; laravel_session=eyJpdiI6IkpMOHR1c3pYOHpXem9vZmhUa0RqUXc9PSIsInZhbHVlIjoiWGY3RGlUV3A3WGJyQ3JvZ29nWVdYWFRtbFA5U0VmU3RLdmVuMVZQcEMwa3B4VGlYb1M2SG5TYTA5U1hxclJNT2tyRDdoanhqWVFITHB3SEdENzZzaTl5RlBZR3hOc2VJNGQzczVxZDdTNC9pMVRobXBTckM4emlzTWtNNjFGS1kiLCJtYWMiOiIyZGZkODQ2YjI2YmU0NGUyYmU0YTAwNTBiNDk3ODU2MTMwMjEyOGUyOGE0YzIzOTMzZjAxZGQzMGY0MGVkOGU1In0%3D' \
--form 'ot_service="1"' \
--form 'client_id="215"' \
--form 'city_id="45"' \
--form 'work_address="Av. Libertador 1234, Oficina 5"' \
--form 'maintenance_program_id="38"' \
--form 'responsible_validator_id="30"' \
--form 'title="Mantenimiento preventivo aire acondicionado"' \
--form 'description="Revisión y limpieza de los equipos de aire acondicionado de la oficina principal."' \
--form 'priority="1"' \
--form 'duration_type="d"' \
--form 'duration="5"' \
--form 'cost_hour="21.2"' \
--form 'tech_type="E"' \
--form 'team_id="1"' \
--form 'signatures_quantity="3"' \
--form 'reminder="5m"' \
--form 'not_review="1"' \
--form 'date="2026/01/02 12:20"' \
--form 'valor[]="219"' \
--form 'valor[]="335"' \
--form 'valor[]="29"' \
--form 'responsible_tech_id="219"' \
--form 'aditional_tech_ids[]="335"' \
--form 'aditional_tech_ids[]="29"' \
--form 'asset_id="319024"' \
--form 'work_weekend="1"'

La petición de arriba devuelve un JSON estructurado de la siguiente manera

{
    "success": true,
    "code": 200,
    "result": {
        "id": 112666,
        "cod": "OT006440",
        "user_id": 21,
        "client_id": 215,
        "contact_id": null,
        "asset_id": null,
        "location_id": null,
        "work_address": "Av. Libertador 1234, Oficina 5",
        "team_id": null,
        "toolkit_id": null,
        "inventorykit_id": null,
        "request_id": null,
        "title": "Mantenimiento preventivo aire acondicionado",
        "description": "Revisión y limpieza de los equipos de aire acondicionado de la oficina principal.",
        "emergency": null,
        "end_date": "2026-01-02 12:20:00",
        "init_work_date": null,
        "priority": "1",
        "status": "0",
        "period": "0",
        "duration": "5.00",
        "duration_type": "d",
        "reminder": "2026-01-02 16:15:00",
        "cost_hour": "21.20",
        "number_signatures": 3,
        "work_weekend": "1",
        "attach": null,
        "not_review": "1",
        "created_at": "2026-05-19T13:20:14.000000Z"
    }
}