RECURSO DE LA API

Inventario

Ficha de stock, movimiento de entrada/salida y alerta de nivel crítico. Los movimientos quedan registrados; el saldo se deriva de los movimientos.

Acceso anticipado Toda la API

Endpoints

6 endpoint

Endpoints de este recurso. Cada endpoint se limita a los datos de la clínica a la que está vinculada la clave de la API; los endpoints de escritura admiten la cabecera Idempotency-Key.

GET /v1/stock Lista las fichas de stock Todos los roles autorizados

GET /v1/stock/critical Lista los stocks en nivel crítico Todos los roles autorizados

POST /v1/stock Crea una ficha de stock admin

PUT /v1/stock/{id} Actualiza la ficha de stock admin

POST /v1/stock/{id}/movement Añade un movimiento de stock (entrada/salida) admin · secretaria

GET /v1/stock/{id}/movements Lista los movimientos de stock Todos los roles autorizados

Ejemplo de uso

Obtener stocks críticos

Solicitud

curl https://api.udentiva.com/v1/stock/critical \
  -H "Authorization: Bearer udk_live_xxx"

Respuesta

HTTP/1.1 200 OK
[
  {
    "id": "itm-12",
    "name": "Kompozit A2",
    "on_hand": 3,
    "critical_level": 5
  }
]

Seguridad en este recurso

La seguridad no es una función, es la propia arquitectura. Las garantías vigentes en este recurso:

Creación/actualización de fichas de stock por admin; adición de movimientos por admin/secretaria. Todos los datos están aislados en su clínica.

Los movimientos de stock son basados en registros; la corrección se realiza con un movimiento inverso, el historial no se elimina.

Todo el modelo de seguridad →

Formato de error

Los errores se devuelven con un sobre coherente; el código va dirigido a la máquina, el mensaje al usuario. El error interno o el stack nunca se filtran.

{
  "error": {
    "code": "validation_failed",
    "message": "Campo no válido: correo electrónico"
  }
}

Otros recursos

Pacientes Citas y calendario Odontograma y Tratamiento Cobros y finanzas Imágenes Laboratorio Lead y CRM Turismo de salud Informes y BI Webhooks Transferencia de Datos (Export API)

¿Quiere acceso anticipado?

Sea el primero en enterarse cuando se abra la API.

Contactar