Endpoints / Medidas

POST

Crear Medida

Registra una nueva unidad de medida dentro de la empresa del usuario autenticado.

POST/medidas

cURLPor defecto

curl -X POST "https://api.ferreconst.space/medidas"   -H "Authorization: Bearer <token>"   -H "Content-Type: application/json"   -d '{
    "mdiaemid": "e2f7b231-fc3d-4010-9ec0-47ed08a34593",
    "mdianombre": "Unidad",
    "mdiaabreviatura": "UND"
  }'

Respuesta201 Created

{  "mdiaid": "7f4f7a99-f7dc-4b10-9326-9e4ec8300e89",  "mdiaemid": "e2f7b231-fc3d-4010-9ec0-47ed08a34593",  "mdianombre": "Unidad",  "mdiaabreviatura": "UND",  "mdiafchregistro": "2026-05-23T17:29:01.621Z",  "mdiaestado": "activo"}

Caso de Uso

Se usa cuando la aplicación necesita crear una nueva unidad de medida para usar en productos, stock u otros procesos del inventario. Al usarlo, el usuario obtiene los datos completos de la medida creada, incluyendo su identificador único y fecha de registro.

Autenticación

Requiere token JWT en el header `Authorization: Bearer <token>`. Permite acceso a usuarios con rol jefe o empleado. La empresa y el usuario autenticado deben estar activos.

Parámetros de ruta

Este endpoint no recibe parámetros de ruta.

Body

mdiaemidstringobligatorio

Identificador de la empresa a la que pertenecerá la medida; debe coincidir con la empresa del usuario autenticado.

mdianombrestringobligatorio

Nombre de la medida; debe ser único dentro de la empresa.

mdiaabreviaturastringobligatorio

Abreviatura de la medida; debe ser única dentro de la empresa.

Reglas de negocio

Solo un usuario con rol jefe o empleado puede registrar medidas.

Solo permite crear medidas en la misma empresa del usuario autenticado.

La empresa del usuario autenticado debe estar activa.

El usuario autenticado debe estar activo.

Todos los campos del body son obligatorios.

mdianombre no puede repetirse dentro de la misma empresa.

mdiaabreviatura no puede repetirse dentro de la misma empresa.

La medida se crea con estado activo.

Errores esperados

401No autorizado

No se envió un token JWT válido o el token no contiene información válida del usuario.

500El id de empresa es requerido

mdiaemid fue enviado vacío.

500El nombre de medida es requerido

mdianombre fue enviado vacío.

500La abreviatura de medida es requerida

mdiaabreviatura fue enviado vacío.

500La empresa no existe

La empresa asociada al usuario autenticado no fue encontrada.

500La empresa no está activa

La empresa asociada al usuario autenticado está inactiva.

500El usuario no existe

El usuario autenticado no fue encontrado dentro de su empresa.

500El usuario no pertenece a la empresa

El usuario autenticado no pertenece a la empresa indicada por su sesión.

500El usuario no puede acceder a otra empresa

mdiaemid pertenece a una empresa distinta a la del usuario autenticado.

500El usuario no es jefe, empleado o administrador

El rol del usuario no está permitido para acceder al módulo de medidas.

500El usuario no es jefe o empleado

El usuario autenticado no tiene un rol permitido para crear medidas.

500El usuario no está activo

El usuario autenticado está inactivo y no puede usar el sistema.

500Ya existe una medida con ese nombre

Ya hay una medida registrada con el mismo mdianombre dentro de la empresa.

500Ya existe una medida con esa abreviatura

Ya hay una medida registrada con la misma mdiaabreviatura dentro de la empresa.

500La medida no fue creada

La medida fue guardada, pero no pudo consultarse para devolver la respuesta.

500Error saving medida

Ocurrió un error interno al guardar la medida.

Notas de uso

Este endpoint no recibe parámetros de ruta ni query params.

mdianombre y mdiaabreviatura deben ser únicos dentro de la empresa; pueden repetirse entre empresas distintas.

mdiaemid debe coincidir con la empresa del usuario autenticado; no se permite crear medidas para otras empresas.