Skip to main content
POST
/
estoque
curl -X POST https://api.vidaplus.com/estoque/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_item": "Medicamento",
    "nome": "Paracetamol",
    "quantidade": 100,
    "unidade": "mg",
    "data_validade": "2025-12-31"
  }'

{
  "id": 1,
  "tipo_item": "Medicamento",
  "nome": "Paracetamol",
  "quantidade": 100,
  "unidade": "mg",
  "data_validade": "2025-12-31"
}

​
Authentication

This endpoint requires a valid Bearer token with admin/superuser privileges.

​
Request Body

​
tipo_item
enum
required
Type of inventory item
  • Medicamento - Medication
  • Insumo - Supply
  • Equipamento - Equipment
​
nome
string
required
Name of the inventory itemExample: Paracetamol
​
quantidade
integer
required
Quantity available in stockExample: 100
​
unidade
string
required
Unit of measurementExample: mg, ml, unidade
​
data_validade
date
required
Expiration date in ISO format (YYYY-MM-DD)Example: 2025-12-31

​
Response

​
id
integer
Unique identifier of the created inventory item
​
tipo_item
enum
Type of inventory item (Medicamento, Insumo, or Equipamento)
​
nome
string
Name of the inventory item
​
quantidade
integer
Quantity available in stock
​
unidade
string
Unit of measurement
​
data_validade
date
Expiration date
curl -X POST https://api.vidaplus.com/estoque/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_item": "Medicamento",
    "nome": "Paracetamol",
    "quantidade": 100,
    "unidade": "mg",
    "data_validade": "2025-12-31"
  }'

{
  "id": 1,
  "tipo_item": "Medicamento",
  "nome": "Paracetamol",
  "quantidade": 100,
  "unidade": "mg",
  "data_validade": "2025-12-31"
}

​
Error Codes

Status CodeDescription
201Inventory item created successfully
401Authentication token missing or invalid
403User does not have admin/superuser privileges
409An inventory item with the same name already exists

Build docs developers (and LLMs) love

Get started for freeTalk to us