Insertar ASIGNADA

Para insertar una Orden de Trabajo en estado ASIGNADA, debemos hacer un request al siguiente endpoint

POST https://api.persat.com.ar/v1/work-orders

Headers

Name	Type	Description
Authorization*	String	Bearer API_KEY
Content-Type*	String	application/json

Request Body

Name	Type	Description
uid_client*	String	El número/identificador de cliente (es un valor alfanumérico). Es el cliente en el que queremos realizar el trabajo.
wo_data.schema_id*	Number	Identificador de la plantilla/esquema de la OT que estamos insertando.
wo_data.service_time*	Number	Numero representando los minutos de duración estimado del trabajo
labels_ids	Number[]	Array de numeros. Cada item representa una etiqueta que deberia estar creada en el sistema. De todas maneras, si no existe la etiqueta la consulta continua sin problemas.
wo_data.instructions.formvalues*	JSON Object	Valores de cada uno de los widgets del formulario de instrucciones
assignation_info.date*	String	Fecha en formato yyyy-MM-ddT00:00:00.000Z. Notese que por mas que se envien las horas o minutos, no se tendran en cuenta. Lo que se usa es la Fecha. Sin importar en que país nos encontremos
assignation_info.starts_min*	Number	numero representando los minutos transcurridos desde las 00:00 hs del día.
assignation_info.responsibles_required*	Number	Cantidad de tecnicos que requiere el trabajo. Min: 1
responsibles*	Array<Number>	Array con los users_ids de los tecnicos asignados a la OT. El tamaño del array debe coincidir con assignation_info.responsibles_required

200: OK La consulta se ejecutó con éxito

{
    "success": true,
    "data": {
        "_id": "13",
        "note_id": 299,
        "state": "ASIGNADA",
        "created": "2024-07-16T14:46:35.000Z",
        "created_by_user_name": "Creado por Api",
        "created_by_user_id": -1,
        "labels_ids": [],
        "client": {
            "id": 1,
            "name": "Fabrica de Motores",
            "uid_client": "AABC9098"
        },
        "wo_data": {
            "schema_id": 13,
            "wo_instance": null,
            "wo_rule_id": null,
            "service_time": 45,
            "instructions": {
                "formvalues": {
                    "FWRzVXA7e": "Revisar la caldera"
                }
            }
        },
        "assignation_info": {
            "date": "2024-07-16T00:00:00.000Z",
            "starts_min": 480,
            "responsibles_required": 1,
            "responsibles": [
                {
                    "user_id": 24,
                    "user_name": "[e-mail]"
                }
            ]
        }
    }
}

400: Bad Request Error en alguno de los campos enviados. userMessage contiene informacipon adicional.

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'uid_client' es obligatorio y debe ser un string identificando al cliente"
    }
}

404: Not Found El cliente o el schema_id no existen

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No hay un cliente con este nro."
    }
}

Ejemplo de request

body

{
    "uid_client": "AABC9098",
    "labels_ids": [1,6],        /* Opcional */
    "wo_data": {
        "schema_id": 452,
        "service_time": 45,
        "instructions": {        
            "formvalues": {    /* los fields de formvalues van a depender de cada schema */
                "FWRzVXA7e": "Revisar la caldera"
            }
        }         
    },
    "assignation_info": {
        "responsibles_required": 1,
        "date": "2022-04-26T00:00:00.000Z",
        "starts_min": 480,
        "responsibles": [24]    /* El largo del array debe coincidir con assignation_info.responsibles_required */
    }
}

Los campos se describen en Obtener OT

Algunas consideraciones durante la inserción:

labels_ids: Es opcional. En caso de no enviarse, la OT será cargada con las etiquetas por defecto definidas en el schema_id. Ahora si lo que quiero es que quede con ninguna etiqueta, entonces hay que enviar un array vacio.

"labels_ids": [],

assignation_info.responsibles. Es un array de numbers obligatorio. Indica el user_id de el/los técnico/s al que quiero asignar la OT. Para obtener la lista de técnicos disponibles, consulta Listar Técnicos Activos

Análisis de la respuesta

{
    "success": true,
    "data": {
        "_id": "13",
        "note_id": 299,
        "state": "ASIGNADA",
        "created": "2024-07-16T14:46:35.000Z",
        "created_by_user_name": "Creado por Api",
        "created_by_user_id": -1,
        "labels_ids": [],
        "client": {
            "id": 1,
            "name": "Fabrica de Motores",
            "uid_client": "AABC9098"
        },
        "wo_data": {
            "schema_id": 13,
            "wo_instance": null,
            "wo_rule_id": null,
            "service_time": 45,
            "instructions": {
                "formvalues": {
                    "FWRzVXA7e": "Revisar la caldera"
                }
            }
        },
        "assignation_info": {
            "date": "2024-07-16T00:00:00.000Z",
            "starts_min": 480,
            "responsibles_required": 1,
            "responsibles": [
                {
                    "user_id": 24,
                    "user_name": "[e-mail]"
                }
            ]
        }
    }
}

Los campos se describen en Obtener OT - Asignada