Actuaciones
Las actuaciones en Vendomia representan el progreso realizado en cada parte de trabajo, por parte de un miembro del equipo. Una actuación debe estar siempre vinculada a un trabajo, y estar asignada a un usuario autor.
Uso general

El proceso de autenticación funciona mediante un token de acceso, que se corresponde con unos de los usuarios de tu cuenta.

El nivel de acceso del que dispones con la API dependerá del usuario con el que accedas a ella. Los permisos otorgados según el grupo del usuario a través de la aplicación serán los mismos durante el uso de la API.

Para autenticarse con la API, es necesario enviar el token a través de una cabecera Authorization en cada una de tus solicitudes:

Authorization: Bearer <API_KEY>

Solicitud de ejemplo (PHP)
$data = array(
    "key" => "value",
);

$headers = array(
    "Authorization: Bearer <API_KEY>",
    "Content-Type: application/json",
);

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "<API_URL>");
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "GET/POST/PUT/DELETE");
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($curl);
curl_close($curl);
GET Listado de Actuaciones
Devuelve un listado de elementos.
act_id
number
ID
La ID asociada a la actuación, generada por Vendomia.
act_number
text
Número
El número asociado a la actuación. La numeración es generada automáticamente por Vendomia.
act_description
text
Nombre
La descripción de las tareas realizadas para esta actuación
act_comments
text
Comentarios
Comentarios adicionales en torno al parte de actuación.
act_date
date
Fecha de Actuación
act_total_hours
number
Total de Horas
El recuento total de horas de trabajo para esta actuación. Se calcula automáticamente en base a los productos de tipo hora indicados dentro de la actuación.
act_total_materials
number
Total de Materiales
El recuento total de materiales de trabajo para esta actuación. Se calcula automáticamente en base a los productos de tipo materiales indicados dentro de la actuación.
act_status
select
Estado
El estado del parte de actuación. Las actuaciones pueden ser aprobadas a través de un supervisor.
0
Pendiente
1
Aprobado
act_user
remoteselect
Usuario Asignado
El usuario asignado como responsable de la actuación.
limit
integer
limit
Indica el número máximo de resultados a devolver. Máximo de 24 resultados.
offset
integer
offset
Indica el número de resultados a omitir, a fin de paginar los resultados. Por ejemplo, indicar 100 para comenzar a partir del resultado 101.
GET https://vendomia.app/api/work_acts
Payload de ejemplo
{
    "act_id": "123",
    "act_number": "123",
    "act_description": "Mi Trabajo",
    "act_comments": "Mi Trabajo",
    "act_date": "2026-01-23",
    "act_total_hours": "123",
    "act_total_materials": "123",
    "act_status": "123",
    "limit": "24",
    "offset": "0",
}
Respuesta de ejemplo
{
    "status": 200,
    "message": "OK.",
    "body": {
        "objects": {
            "12345": {
                "act_id": "123",
                "act_number": "123",
                "act_description": "Mi Trabajo",
                "act_comments": "Mi Trabajo",
                "act_date": "2026-01-23",
                "act_total_hours": "123",
                "act_total_materials": "123",
                "act_status": "123",
            }
        }
    }
}
GET Recuperar Actuación
Devuelve un único elemento a través de su identificador primario.
GET https://vendomia.app/api/work_acts/{id}
Respuesta de ejemplo
{
    "status": 200,
    "message": "OK.",
    "body": {
        "object": {
            "act_id": "123",
            "act_number": "123",
            "act_description": "Mi Trabajo",
            "act_comments": "Mi Trabajo",
            "act_date": "2026-01-23",
            "act_total_hours": "123",
            "act_total_materials": "123",
            "act_status": "123",
        }
    }
}
POST Crear Actuación
Crea un nuevo elemento.
act_to_work
remoteselect
ID de Trabajo
El ID de trabajo al que pertenece la actuación. Obligatorio a la hora de crear actuaciones.
act_description
text
Nombre
La descripción de las tareas realizadas para esta actuación
act_comments
text
Comentarios
Comentarios adicionales en torno al parte de actuación.
act_date
date
Fecha de Actuación
act_user
remoteselect
Usuario Asignado
El usuario asignado como responsable de la actuación.
POST https://vendomia.app/api/work_acts
Payload de ejemplo
{
    "act_to_work": "123",
    "act_description": "Mi Trabajo",
    "act_comments": "Mi Trabajo",
    "act_date": "2026-01-23",
}
Respuesta de ejemplo
{
    "status": 200,
    "message": "OK.",
    "body": {
        "object": {
            "act_id": "123",
            "act_number": "123",
            "act_description": "Mi Trabajo",
            "act_comments": "Mi Trabajo",
            "act_date": "2026-01-23",
            "act_total_hours": "123",
            "act_total_materials": "123",
            "act_status": "123",
        }
    }
}
PUT Modificar Actuación
Modifica un elemento existente según su identificador primario.
act_description
text
Nombre
La descripción de las tareas realizadas para esta actuación
act_comments
text
Comentarios
Comentarios adicionales en torno al parte de actuación.
act_date
date
Fecha de Actuación
PUT https://vendomia.app/api/work_acts/{id}
Payload de ejemplo
{
    "act_description": "Mi Trabajo",
    "act_comments": "Mi Trabajo",
    "act_date": "2026-01-23",
}
Respuesta de ejemplo
{
    "status": 200,
    "message": "OK.",
    "body": {
        "object": {
            "act_id": "123",
            "act_number": "123",
            "act_description": "Mi Trabajo",
            "act_comments": "Mi Trabajo",
            "act_date": "2026-01-23",
            "act_total_hours": "123",
            "act_total_materials": "123",
            "act_status": "123",
        }
    }
}
DELETE Borrar Actuación
Borra un elemento existente.
DELETE https://vendomia.app/api/work_acts/{id}
Respuesta de ejemplo
{
    "status": 200,
    "message": "OK.",
    "body": {}
}