RECURSO DE API

Estoque

Ficha de estoque, movimento de entrada/saída e alerta de nível crítico. Os movimentos são registrados; o saldo é derivado dos movimentos.

Acesso Antecipado Toda a API

Endpoints

6 endpoint

Endpoints deste recurso. Cada endpoint é limitado aos dados da clínica à qual a chave de API está vinculada; os endpoints de gravação suportam o cabeçalho Idempotency-Key.

GET /v1/stock Lista as fichas de estoque Todos os papéis autorizados

GET /v1/stock/critical Lista os itens de estoque em nível crítico Todos os papéis autorizados

POST /v1/stock Cria uma ficha de estoque admin

PUT /v1/stock/{id} Atualiza a ficha de estoque admin

POST /v1/stock/{id}/movement Adiciona um movimento de estoque (entrada/saída) admin · secretário

GET /v1/stock/{id}/movements Lista os movimentos de estoque Todos os papéis autorizados

Exemplo de Uso

Obter estoques críticos

Requisição

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

Resposta

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

Segurança neste recurso

Segurança não é um recurso, é a própria arquitetura. As garantias que se aplicam a este recurso:

Criação/atualização de ficha de estoque por admin; adição de movimento por admin/secretário. Todos os dados são isolados à sua clínica.

Os movimentos de estoque são baseados em registros; a correção é feita com um movimento reverso, o histórico não é apagado.

Todo o modelo de segurança →

Formato de Erro

Os erros retornam em um envelope consistente; o código é destinado à máquina, a mensagem ao usuário. Erro interno/stack nunca é vazado.

{
  "error": {
    "code": "validation_failed",
    "message": "Campo inválido: e-mail"
  }
}

Outros Recursos

Pacientes Agendamentos e calendário Odontograma & Tratamento Cobrança e Finanças Imagem Laboratório Lead & CRM Turismo de saúde Relatórios & BI Webhooks Transferência de Dados (Export API)

Deseja acesso antecipado?

Seja o primeiro a saber quando a API for lançada.

Entre em Contato