Feirin (Jota)

Aplica ou cancela uma proposta de ajuste IN, OUT ou COUNT preparada por preparar_ajuste. O ajuste confirmado é imutável; correções exigem outro ajuste confirmado. A proposta pertence à mesma conta e conexão. proposalId, previewFingerprint e confirmationSummary identificam a prévia vigente sem alterações. decision=confirm exige confirmação explícita e específica do usuário por texto ou voz para essa prévia na conversa; cancel descarta a proposta. Valores diferentes exigem nova prévia e confirmação. O resultado contém estado e recibo: applied com successConfirmed=true e verification.status=verified indica persistência conferida no banco após COMMIT; verification_pending indica conferência pendente, consultável por consultar_operacao com o mesmo proposalId. Repetir a mesma proposta retorna o mesmo recibo sem duplicar a operação. Permissão de ferramenta não substitui a confirmação de cada alteração.

confirmar_ajuste

Aplica ou cancela uma proposta de cadastro de ingrediente novo preparada por preparar_ingrediente. Inclui a primeira compra quando informada em initialPurchase; cadastro e compra são atômicos. A proposta pertence à mesma conta e conexão. proposalId, previewFingerprint e confirmationSummary identificam a prévia vigente sem alterações. decision=confirm exige confirmação explícita e específica do usuário por texto ou voz para essa prévia na conversa; cancel descarta a proposta. Valores diferentes exigem nova prévia e confirmação. O resultado contém estado e recibo: applied com successConfirmed=true e verification.status=verified indica persistência conferida no banco após COMMIT; verification_pending indica conferência pendente, consultável por consultar_operacao com o mesmo proposalId. Repetir a mesma proposta retorna o mesmo recibo sem duplicar a operação. Permissão de ferramenta não substitui a confirmação de cada alteração.

confirmar_ingrediente

Aplica ou cancela uma proposta cancel_purchase preparada por preparar_cancelamento_compra. O cancelamento preserva o histórico e recalcula saldo e custo do estoque; não estorna pagamentos nem movimenta dinheiro. A proposta pertence à mesma conta e conexão. proposalId, previewFingerprint e confirmationSummary identificam a prévia vigente sem alterações. decision=confirm exige confirmação explícita e específica do usuário por texto ou voz para essa prévia na conversa; cancel descarta a proposta. Valores diferentes exigem nova prévia e confirmação. O resultado contém estado e recibo: applied com successConfirmed=true e verification.status=verified indica persistência conferida no banco após COMMIT; verification_pending indica conferência pendente, consultável por consultar_operacao com o mesmo proposalId. Repetir a mesma proposta retorna o mesmo recibo sem duplicar a operação. Permissão de ferramenta não substitui a confirmação de cada alteração.

confirmar_cancelamento_compra

Aplica ou cancela uma proposta update_ingredient preparada por preparar_atualizacao_ingrediente. Altera apenas os campos cadastrais apresentados: nome, unidade usual, mínimo ou validade, sem alterar o saldo. A proposta pertence à mesma conta e conexão. proposalId, previewFingerprint e confirmationSummary identificam a prévia vigente sem alterações. decision=confirm exige confirmação explícita e específica do usuário por texto ou voz para essa prévia na conversa; cancel descarta a proposta. Valores diferentes exigem nova prévia e confirmação. O resultado contém estado e recibo: applied com successConfirmed=true e verification.status=verified indica persistência conferida no banco após COMMIT; verification_pending indica conferência pendente, consultável por consultar_operacao com o mesmo proposalId. Repetir a mesma proposta retorna o mesmo recibo sem duplicar a operação. Permissão de ferramenta não substitui a confirmação de cada alteração.

confirmar_atualizacao_ingrediente

Aplica ou cancela uma proposta de exclusão lógica de ingrediente (delete_ingredient) da mesma conta e conexão. A proposta vem de preparar_exclusao_ingrediente e contém proposalId, previewFingerprint e confirmationSummary; esses valores identificam a prévia vigente sem alterações. A decisão confirm corresponde à confirmação explícita do usuário para essa prévia; cancel descarta a proposta. A exclusão preserva o histórico e depende da ausência de saldo, compra ativa ou vínculo impeditivo. O resultado contém o estado da proposta e o recibo; applied com successConfirmed=true e verification.status=verified indica persistência conferida no banco. verification_pending indica conferência pendente. Repetir a mesma proposta retorna o mesmo recibo, sem nova exclusão.

confirmar_exclusao_ingrediente

Aplica ou cancela uma proposta create_purchase de uma nova compra de ingrediente existente, preparada por preparar_compra. Pode atualizar validade e custo conforme a prévia. É registro de estoque, sem pagamento ou transferência. A proposta pertence à mesma conta e conexão. proposalId, previewFingerprint e confirmationSummary identificam a prévia vigente sem alterações. decision=confirm exige confirmação explícita e específica do usuário por texto ou voz para essa prévia na conversa; cancel descarta a proposta. Valores diferentes exigem nova prévia e confirmação. O resultado contém estado e recibo: applied com successConfirmed=true e verification.status=verified indica persistência conferida no banco após COMMIT; verification_pending indica conferência pendente, consultável por consultar_operacao com o mesmo proposalId. Repetir a mesma proposta retorna o mesmo recibo sem duplicar a operação. Permissão de ferramenta não substitui a confirmação de cada alteração.

confirmar_compra

Aplica ou cancela uma proposta purchase_group preparada por preparar_compras_agrupadas. Registra as novas compras conjuntamente, de forma atômica, sem pagamentos ou transferências. A proposta pertence à mesma conta e conexão. proposalId, previewFingerprint e confirmationSummary identificam a prévia vigente sem alterações. decision=confirm exige confirmação explícita e específica do usuário por texto ou voz para essa prévia na conversa; cancel descarta a proposta. Valores diferentes exigem nova prévia e confirmação. O resultado contém estado e recibo: applied com successConfirmed=true e verification.status=verified indica persistência conferida no banco após COMMIT; verification_pending indica conferência pendente, consultável por consultar_operacao com o mesmo proposalId. Repetir a mesma proposta retorna o mesmo recibo sem duplicar a operação. Permissão de ferramenta não substitui a confirmação de cada alteração.

confirmar_compras_agrupadas

Leitura paginada de ingredientes, detalhes, compras, grupos, revisões e ajustes da conta. view seleciona a visão; referenceId identifica compra/grupo/ajuste; ingredientId restringe ao ingrediente. period omitido/null consulta todo o histórico; from/to limitam o período. Em purchases/adjustments, query resolve o ingrediente; pagination.totalMatching conta o escopo completo. fields=[] mostra cadastro; máximo 3 campos específicos. filter=expiring inclui estoque positivo com vencimento até 3 dias, inclusive vencidos. nextCursor continua com os mesmos filtros; cada página é apenas parte do conjunto. Totais e janela personalizada pertencem a resumir_estoque. Não altera dados nem confirma gravações. Alterações pertencem às propostas de preparar_ingrediente, preparar_atualizacao_ingrediente, preparar_compra ou preparar_ajuste e às respectivas confirmações específicas.

consultar_estoque

Lista ingredientes da conta autorizada em páginas de 10, com total e totalPages. search busca por nome; filter aceita all/low/negative/no-cost/expiry; sort e direction seguem a interface. page seleciona a página. Somente leitura, sem alteração de cadastro ou saldo. Alterações pertencem às propostas de preparar_ingrediente, preparar_atualizacao_ingrediente, preparar_compra ou preparar_ajuste e às respectivas confirmações específicas.

consultar_ingredientes

Consulta estado e recibo de uma proposta da mesma conexão, sem reaplicá-la. verification.changedSinceOperation=true indica recibo histórico com alteração posterior; verification contém os valores canônicos atuais. Não cria proposta nem altera estoque.

consultar_operacao