Eliminar los movimientos de una bolsa por empleado

Este endpoint permite eliminar los movimientos de una bolsa asociados a un empleado dentro de un periodo de tiempo determinado.

DELETE /api/v1/businesses/{businessId}/bags/{bagId}/employees/{employeeId}/movements?from={yyyy-MM-dd}&to={yyyy-MM-dd}

Si los datos incluidos en la petición son correctos, se eliminarán todos los movimientos de ese empleado, para la bolsa indicada, dentro del periodo de tiempo especificado en la URL.

A continuación, se muestra un ejemplo:

DELETE /api/v1/businesses/BUSINESSID/bags/DT/employees/1006357/movements?from=2024-09-22&to=2024-09-26

La respuesta de esta petición contendrá todos los movimientos encontrados y el estado de cada uno de ellos:

[
    {
        "status": "DELETE",
        "employeeId": "1006357",
        "destinationBagId": "DT",
        "destinationDate": "2024-09-23",
        "value": 1.0,
        "reason": "Data adjustment 23"
    },
    {
        "status": "DELETE",
        "employeeId": "1006357",
        "destinationBagId": "DT",
        "destinationDate": "2024-09-24",
        "value": 2.0,
        "reason": "Data adjustment 24"
    },
    {
        "status": "DELETE",
        "employeeId": "1006357",
        "destinationBagId": "DT",
        "destinationDate": "2024-09-25",
        "value": 1.0,
        "reason": "Data adjustment 25"
    }
]

En este ejemplo, el campo status indica en cada movimiento que ha sido borrado: DELETE. Si alguno de los movimientos provoca un error al intentar borrarlo, en el campo status del movimiento aparecerá ERROR y también habrá un campo cause que indicará la causa del error.

Aspectos que tener en cuenta

La petición elimina todos los movimientos vinculados con la bolsa pasada por parámetro: tanto los movimientos en los que la bolsa es el origen como aquellos en los que es el destino.

Si no hay movimientos que eliminar en el periodo de tiempo indicado en la URL, la petición devolverá un error 404 Not Found, indicando Not Movements to Delete […​].

Si el identificador del empleado o de la bolsa no son correctos, la petición devolverá un error 404 Not Found.

Si alguno de los movimientos provoca un error al intentar borrarlo, la petición devolverá un error 409 Conflict.

Enlaces de interés

¿Qué es una bolsa?