Stock SISVIU

Base URL da API: https://api.sisviu.com.br/stock/

Método: Todas as rotas são POST

Formato: application/json

Autenticação: Primeiro passo: gerar token via rota /auth

PARTE TÉCNICA – PARA DESENVOLVEDORES

1. Autenticação

Endpoint: /auth Descrição: Gera token para uso nas demais rotas.

Requisição:

{
  "user": "teste02",
  "secret": "abCdEfGhIjKlMnOpQrStUvWxYz12345teste0267890"
}

2. Listar Estoque:

Endpoint: /estoque Descrição: Retorna todos os produtos disponíveis.

Resposta:

[
  {
    "codigo": "OC12346",
    "marca": "Ray-Ban",
    "linha": "Premium",
    "material_haste": "Acetato",
    ...
  }
]

1. Adicionar Estoque

Endpoint: /adicionarEstoque Descrição: Soma a quantidade ao estoque existente.

Requisição:

{
  "id_produto_server_cliente": "OC12345",
  "quantidade": 5
}

1. Atualizar Produto

Endpoint: /atualizarProduto Descrição: Atualiza informações completas de um produto.

Requisição:

{
  "id_produto_server_cliente": "OC12345",
  "marca": "Ray-Ban",
  "modelo_referencia": "RB3016",
  ...
}

1. Conferir Estoque de um Produto

Endpoint: /conferirEstoque Descrição: Consulta estoque individual.

Requisição:

{
  "id_produto_server_cliente": "OC12345"
}

1. Marcar Produto como Estoque Zerado

Endpoint: /estoqueZerado Descrição: Indica que um produto ficou com zero no estoque.

Requisição:

{
  "codigo": "OC12345",
  "data": "2025-04-17T15:34:00Z"
}

1. Registrar Venda

Endpoint: /registrarVenda Descrição: Registra uma nova venda no sistema.

Requisição:

{
  "data_compra": "2025-04-17T10:50:00Z",
  "numero_pedido": "PED014",
  "cliente_nome": "João da Silva",
  ...
}

8. Reabastecimento de Estoque

Endpoint: /estoqueReabastecido Descrição: Atualiza a quantidade de um produto após reabastecimento.

Requisição:

{
  "codigo_produto": "OC12345",
  "nova_quantidade": 10,
  "data_reabastecimento": "2025-04-17T09:00:00Z"
}

1. Reservar Produto Temporariamente

Endpoint: /reservaTemporaria Descrição: Reserva um item para compra futura.

Requisição:

{
  "codigo_produto": "OC12345",
  "quantidade": 1,
  "sessao_id": "5afc0e4f-d51b-4f6e-9f6c-2fa6cabb3221"
}

1. Liberar Reserva

Endpoint: /liberarReserva Descrição: Cancela a reserva de um produto.

Requisição:

{
  "codigo_produto": "OC12345",
  "quantidade": 1,
  "sessao_id": "5afc0e4f-d51b-4f6e-9f6c-2fa6cabb3221",
  "motivo": "tempo_expirado"
}

PARTE SIMPLES – PARA ENTENDIMENTO GERAL

Recurso Para que serve

Endpoint	Descrição
/auth	Gera uma chave de acesso para usar a API.
/estoque	Lista todos os óculos disponíveis no sistema.
/adicionarEstoque	Aumenta o número de peças de um produto já cadastrado.
/atualizarProduto	Atualiza todas as informações de um óculos específico.
/conferirEstoque	Verifica quantos itens ainda restam de um produto.
/estoqueZerado	Informa quando um produto acabou no estoque.
/registrarVenda	Registra uma venda, com dados do cliente e dos produtos vendidos.
/estoqueReabastecido	Atualiza o estoque após reabastecimento, com data e nova quantidade.
/reservaTemporaria	Reserva um item temporariamente (ex: carrinho de compras).
/liberarReserva	Libera uma reserva que expirou ou foi cancelada.