Estoque

GET /v1/inputs exige inputs:read; GET /v1/intermediaries exige intermediaries:read. A sessão autenticada do restaurante também é aceita, sempre vinculada ao restaurante assinado. Chaves tk_ não acessam dados diretamente: troque a chave por um access token OAuth.

Na V1, as rotas mantêm inputs ou intermediaries, total, count, remaining, offset e limit. As versões /v2/inputs e /v2/intermediaries retornam { data, pagination }. O limite é sempre 100. Use pagination.next.offset na próxima consulta e mantenha os filtros até pagination.has_more=false. pagination.total informa o total filtrado. Registros cancelados ficam fora da consulta. A ordem é nome crescente, com ID como desempate. Veja o formato comum de paginação.

Os campos quantidade, ideal_stock e minimum_stock preservam o texto armazenado; estoques ideal e mínimo podem ser nulos. total_value e unitary_price são strings com duas casas decimais. Valores inválidos já armazenados no legado preservam a string NaN, sem converter para zero. Insumos incluem is_master e cash_flow_category_subcategory no formato Categoria: Subcategoria ou uma string vazia quando não há vínculo. Nenhuma rota expõe escrita ou exclusão; as respostas legadas não incluem o ID do registro.

O offset segue o legado: ausente, inválido ou negativo vira zero, e um prefixo inteiro é aceito (12abc vira 12). Valores acima de 2147483647 retornam 400. Não acrescente limit: o tamanho da página é fixo.

A gestão de fichas técnicas usa novos contratos /v1/inventory e rotas technical-sheet de produtos/complementos. A V1 mantém os campos e envelopes anteriores; as coleções da V2 usam o formato comum de paginação.