{"openapi":"3.1.0","info":{"title":"Genesis — utilidades para o dia a dia","version":"1.0.0","description":"Calculadoras e utilidades brasileiras da Genesis Innovation (tabelas de 2026), só leitura e sem login. Mesmo conteúdo do servidor MCP em https://genesisinnovation.io/mcp.","contact":{"name":"Genesis Innovation","url":"https://genesisinnovation.io"},"x-servidor":"genesis"},"servers":[{"url":"https://genesisinnovation.io"}],"paths":{"/api/v1/ferramentas":{"get":{"operationId":"listarFerramentas","summary":"Lista todas as ferramentas","description":"Devolve o id, a descrição e o esquema de parâmetros de cada ferramenta da Genesis. Chame primeiro quando não souber qual usar; depois use executarFerramenta com o id escolhido.","responses":{"200":{"description":"Ferramentas","content":{"application/json":{"schema":{"type":"object","properties":{"ferramentas":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/v1/executar":{"post":{"operationId":"executarFerramenta","summary":"Executa uma ferramenta pelo id","description":"Roda a ferramenta `ferramenta` com `parametros` (o esquema vem de listarFerramentas). Valores em reais nos campos *_brl e porcentagens em % (12 = 12%). A resposta traz resultado, premissas e o link da página humana.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ferramenta":{"type":"string","enum":["salario_liquido","decimo_terceiro","ferias","rescisao","clt_ou_pj","juros_compostos","financiamento","porcentagem","churrascometro","racha_conta","dias_uteis","dias_entre_datas","idade","vida_em_numeros","idade_em_planetas","dia_em_que_voce_nasceu","difal","mei_ou_simples","margem_mercado_livre","margem_shopee","margem_amazon","comparar_marketplaces","frete_peso_cubado","checar_titulo_anuncio","gerar_link_utm","quanto_trabalho_custa","salario_em_coisas","custo_processo_manual","validar_cpf_cnpj","gerar_cpf_cnpj","calculadora","presente_criancas","mochila_certa","lista_material_escolar","lancheira_da_semana","bolsa_empresa","bolsa_buscar","bolsa_triagem","bolsa_netnet","bolsa_juros","bolsa_opcao_calcular","bolsa_grafico","bolsa_cotacao_em_data","sugerir_ferramenta"]},"parametros":{"type":"object"}},"required":["ferramenta","parametros"]}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"Ferramenta desconhecida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/salario_liquido":{"post":{"operationId":"salario_liquido","summary":"Salário líquido CLT 2026","description":"Calcula o salário líquido CLT de 2026 a partir do bruto: INSS progressivo, IRRF (escolhe o mais vantajoso entre deduções legais e desconto simplificado, com o redutor da Lei 15.270/2025), dependentes, pensão e outros descontos.","tags":["Trabalho"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"salario_bruto_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Salário bruto mensal, em reais"},"dependentes":{"type":"integer","minimum":0,"maximum":30,"description":"Dependentes para o IRRF","default":0},"pensao_alimenticia_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Pensão alimentícia descontada em folha, em reais","default":0},"outros_descontos_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Outros descontos (vale-transporte, plano de saúde); não mudam o IRRF, em reais","default":0},"modo_irrf":{"type":"string","enum":["auto","legal","simplificado"],"default":"auto","description":"auto escolhe o menor imposto"}},"required":["salario_bruto_brl"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"salario_bruto_brl":{"type":"number","description":"Bruto"},"inss_brl":{"type":"number","description":"INSS"},"irrf_brl":{"type":"number","description":"IRRF depois do redutor"},"redutor_irrf_brl":{"type":"number","description":"Redutor da Lei 15.270"},"modo_irrf":{"type":"string"},"total_descontos_brl":{"type":"number","description":"Todos os descontos"},"salario_liquido_brl":{"type":"number","description":"Líquido"}},"required":["salario_bruto_brl","inss_brl","irrf_brl","redutor_irrf_brl","modo_irrf","total_descontos_brl","salario_liquido_brl"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/decimo_terceiro":{"post":{"operationId":"decimo_terceiro","summary":"13º salário","description":"Calcula o 13º salário de 2026: valor bruto pelos meses trabalhados (avos), 1ª parcela (metade, sem desconto) e 2ª parcela com INSS e IRRF.","tags":["Trabalho"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"remuneracao_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Remuneração mensal (salário + médias), em reais"},"meses_trabalhados":{"type":"integer","minimum":0,"maximum":12,"description":"Meses com 15 dias ou mais de trabalho no ano (avos)","default":12},"dependentes":{"type":"integer","minimum":0,"maximum":30,"description":"Dependentes para o IRRF","default":0}},"required":["remuneracao_mensal_brl"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"bruto_brl":{"type":"number","description":"13º bruto"},"primeira_parcela_brl":{"type":"number","description":"Até 30/11"},"segunda_parcela_brl":{"type":"number","description":"Até 20/12, já com descontos"},"inss_brl":{"type":"number","description":"INSS"},"irrf_brl":{"type":"number","description":"IRRF"},"liquido_brl":{"type":"number","description":"Total líquido"}},"required":["bruto_brl","primeira_parcela_brl","segunda_parcela_brl","inss_brl","irrf_brl","liquido_brl"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/ferias":{"post":{"operationId":"ferias","summary":"Férias CLT","description":"Calcula férias CLT: dias de direito pelas faltas (art. 130), férias + 1/3, abono pecuniário (vender 1/3, sem INSS/IRRF), INSS, IRRF e líquido.","tags":["Trabalho"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"remuneracao_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Remuneração mensal, em reais"},"faltas_injustificadas":{"type":"integer","minimum":0,"maximum":365,"description":"Faltas sem justificativa no período aquisitivo","default":0},"vender_um_terco":{"type":"boolean","default":false,"description":"Vender 1/3 das férias (abono pecuniário)"},"dependentes":{"type":"integer","minimum":0,"maximum":30,"description":"Dependentes para o IRRF","default":0}},"required":["remuneracao_mensal_brl"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"dias_de_direito":{"type":"integer","description":"Dias de férias"},"ferias_brl":{"type":"number","description":"Férias dos dias gozados"},"terco_constitucional_brl":{"type":"number","description":"1/3"},"inss_brl":{"type":"number","description":"INSS"},"irrf_brl":{"type":"number","description":"IRRF"},"bruto_brl":{"type":"number","description":"Bruto"},"liquido_brl":{"type":"number","description":"Líquido"}},"required":["dias_de_direito","ferias_brl","terco_constitucional_brl","inss_brl","irrf_brl","bruto_brl","liquido_brl"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/rescisao":{"post":{"operationId":"rescisao","summary":"Rescisão CLT","description":"Estima as verbas de rescisão CLT (sem justa causa, pedido de demissão, acordo ou justa causa): saldo de salário, aviso prévio, férias, 13º, descontos, multa e saque do FGTS.","tags":["Trabalho"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tipo":{"type":"string","enum":["sem-justa-causa","pedido-demissao","acordo","justa-causa"],"description":"Tipo: sem-justa-causa (Dispensa sem justa causa), pedido-demissao (Pedido de demissão), acordo (Acordo (art. 484-A)), justa-causa (Dispensa por justa causa)"},"remuneracao_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Remuneração mensal, em reais"},"data_admissao":{"type":"string","format":"date","maxLength":10,"description":"Data de admissão (AAAA-MM-DD ou DD/MM/AAAA)"},"data_desligamento":{"type":"string","format":"date","maxLength":10,"description":"Último dia trabalhado (AAAA-MM-DD ou DD/MM/AAAA)"},"aviso_previo":{"type":"string","enum":["trabalhado","indenizado","descontado"],"default":"trabalhado","description":"trabalhado, indenizado (dispensa/acordo) ou descontado (pedido sem cumprir)"},"ferias_vencidas_periodos":{"type":"integer","minimum":0,"maximum":10,"description":"Períodos de férias vencidas não tiradas","default":0},"dependentes":{"type":"integer","minimum":0,"maximum":30,"description":"Dependentes para o IRRF","default":0},"saldo_fgts_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Saldo atual do FGTS, para a multa, em reais","default":0},"decimo_terceiro_ja_pago_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Adiantamento do 13º já recebido, em reais","default":0}},"required":["tipo","remuneracao_mensal_brl","data_admissao","data_desligamento"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"liquido_brl":{"type":"number","description":"Total líquido a receber"},"total_proventos_brl":{"type":"number","description":"Proventos"},"total_descontos_brl":{"type":"number","description":"Descontos"},"proventos":{"type":"array","items":{"type":"object"},"description":"Verbas"},"descontos":{"type":"array","items":{"type":"object"},"description":"Descontos"},"multa_fgts_brl":{"type":"number","description":"Multa do FGTS"}},"required":["liquido_brl","total_proventos_brl","total_descontos_brl","proventos","descontos","multa_fgts_brl"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/clt_ou_pj":{"post":{"operationId":"clt_ou_pj","summary":"CLT ou PJ","description":"Compara CLT com PJ no Simples Nacional: quanto o PJ precisa faturar por mês para empatar com o pacote CLT líquido anual (salário, 13º, férias, FGTS, benefícios) e, se informado, se uma proposta PJ compensa.","tags":["Trabalho"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"salario_clt_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Salário bruto CLT mensal, em reais"},"vale_refeicao_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Vale-refeição/alimentação mensal, em reais","default":0},"plano_saude_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Quanto o PJ pagaria pelo mesmo plano de saúde por mês, em reais","default":0},"plr_anual_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"PLR anual, em reais","default":0},"incluir_fgts":{"type":"boolean","default":true,"description":"Somar o FGTS (8%) no pacote CLT"},"anexo":{"type":"string","enum":["III","V"],"default":"III","description":"Anexo do Simples da atividade PJ (III ou V; o fator R pode mudar)"},"meses_faturados_pj":{"type":"integer","minimum":1,"maximum":12,"description":"Meses por ano que o PJ fatura (11 = um mês de férias sem receita)","default":11},"contador_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Contador por mês, em reais","default":0},"faturamento_pj_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Opcional: faturamento mensal da proposta PJ a avaliar, em reais"}},"required":["salario_clt_brl"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"clt_liquido_anual_brl":{"type":"number","description":"Pacote CLT líquido por ano"},"faturamento_pj_equivalente_mensal_brl":{"type":["number","null"]}},"required":["clt_liquido_anual_brl","faturamento_pj_equivalente_mensal_brl"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/juros_compostos":{"post":{"operationId":"juros_compostos","summary":"Juros compostos","description":"Simula investimento com juros compostos: aporte inicial e mensal, taxa anual ou mensal, prazo, IR regressivo da renda fixa e valor corrigido pela inflação.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aporte_inicial_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Aporte inicial, em reais","default":0},"aporte_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Aporte no fim de cada mês, em reais","default":0},"taxa_pct":{"type":"number","minimum":0,"maximum":1000,"description":"Taxa de juros em % (10 = 10%)"},"tipo_taxa":{"type":"string","enum":["anual","mensal"],"default":"anual","description":"A taxa é ao ano ou ao mês"},"meses":{"type":"integer","minimum":1,"maximum":1200,"description":"Prazo em meses"},"descontar_ir":{"type":"boolean","default":false,"description":"Descontar IR regressivo da renda fixa no resgate"},"inflacao_anual_pct":{"type":"number","minimum":0,"maximum":1000,"default":0,"description":"Inflação anual em %, para o valor real"}},"required":["taxa_pct","meses"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"total_investido_brl":{"type":"number","description":"Soma dos aportes"},"saldo_bruto_brl":{"type":"number","description":"Saldo final"},"juros_brl":{"type":"number","description":"Juros ganhos"},"saldo_liquido_brl":{"type":"number","description":"Saldo depois do IR"}},"required":["total_investido_brl","saldo_bruto_brl","juros_brl","saldo_liquido_brl"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/financiamento":{"post":{"operationId":"financiamento","summary":"Financiamento (Price ou SAC)","description":"Simula financiamento pela tabela Price ou SAC: primeira e última parcela, juros totais, total pago, prazo real com amortização extra e CET aproximado.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"valor_financiado_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Valor financiado, em reais"},"taxa_pct":{"type":"number","minimum":0,"maximum":1000,"description":"Taxa de juros em % (12 = 12%)"},"tipo_taxa":{"type":"string","enum":["anual","mensal"],"default":"anual","description":"A taxa é ao ano ou ao mês"},"meses":{"type":"integer","minimum":1,"maximum":600,"description":"Prazo em meses"},"sistema":{"type":"string","enum":["price","sac"],"default":"price","description":"price (parcela fixa) ou sac (amortização constante)"},"seguro_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Seguro mensal, em reais","default":0},"tarifa_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Tarifa cobrada na contratação, em reais","default":0},"amortizacao_extra_mensal_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Amortização extra todo mês (reduz o prazo), em reais","default":0}},"required":["valor_financiado_brl","taxa_pct","meses"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"primeira_parcela_brl":{"type":"number","description":"1ª parcela (juros + amortização)"},"ultima_parcela_brl":{"type":"number","description":"Última parcela"},"juros_total_brl":{"type":"number","description":"Juros pagos"},"total_pago_brl":{"type":"number","description":"Total pago"},"prazo_real_meses":{"type":"integer","description":"Meses até quitar"}},"required":["primeira_parcela_brl","ultima_parcela_brl","juros_total_brl","total_pago_brl","prazo_real_meses"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/porcentagem":{"post":{"operationId":"porcentagem","summary":"Porcentagem e regra de três","description":"Contas de porcentagem e regra de três: X% de Y, X é quantos % de Y, aumento, desconto, variação %, valor antes do aumento/desconto e regra de três simples (direta ou inversa).","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operacao":{"type":"string","enum":["percentual_de","quanto_porcento","aumento","desconto","variacao","antes_do_aumento","antes_do_desconto","regra_de_tres","regra_de_tres_inversa"],"description":"percentual_de: a% de b | quanto_porcento: a é quantos % de b | aumento: b com a% a mais | desconto: b com a% a menos | variacao: de a para b | antes_do_aumento: b já com a% de aumento | antes_do_desconto: b já com a% de desconto | regra_de_tres: a está para b como c está para x | regra_de_tres_inversa"},"a":{"type":"number","description":"Primeiro número (veja operacao)"},"b":{"type":"number","description":"Segundo número (veja operacao)"},"c":{"type":"number","description":"Terceiro número, só na regra de três"}},"required":["operacao","a","b"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"resultado":{"type":"number","description":"Resultado"},"explicacao":{"type":"string"}},"required":["resultado","explicacao"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/churrascometro":{"post":{"operationId":"churrascometro","summary":"Churrascômetro","description":"Lista de compras do churrasco: carne por corte conforme o estilo, legumes para vegetariano, carvão em sacos de 3/5 kg, sal grosso, gelo, cerveja em fardos, refrigerante, água, caipirinha, acompanhamentos e descartáveis, com custo estimado e a conta por adulto.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"adultos_normal":{"type":"integer","minimum":0,"maximum":500,"description":"Adultos que comem normal","default":0},"adultos_muito":{"type":"integer","minimum":0,"maximum":500,"description":"Adultos que comem muito (25% a mais de carne)","default":0},"criancas":{"type":"integer","minimum":0,"maximum":500,"description":"Crianças (comem metade e não pagam)","default":0},"vegetarianos":{"type":"integer","minimum":0,"maximum":500,"description":"Adultos vegetarianos (não entram na carne; ganham legumes)","default":0},"nao_bebem_alcool":{"type":"integer","minimum":0,"maximum":500,"description":"Quantos dos adultos não bebem álcool","default":0},"duracao":{"type":"string","enum":["curto","longo"],"default":"curto","description":"curto: umas 3 h | longo: tarde inteira"},"estilo":{"type":"string","enum":["economico","tradicional","premium"],"default":"tradicional","description":"economico: costela, contrafilé, fraldinha | tradicional: picanha, fraldinha, maminha, contrafilé | premium: mais picanha"},"bebidas":{"type":"array","items":{"type":"string","enum":["cerveja","refri","agua","caipirinha"]},"description":"Bebidas servidas (padrão: cerveja, refri, agua)"},"acompanhamentos":{"type":"array","items":{"type":"string","enum":["pao_de_alho","farofa","vinagrete","arroz","maionese","queijo_coalho","linguica","frango","abacaxi"]},"description":"O que vai ter além da carne bovina (padrão: pao_de_alho, farofa, vinagrete, linguica, frango)"},"alcool_so_quem_bebe":{"type":"boolean","default":true,"description":"Na divisão, cerveja e caipirinha ficam só com quem bebe álcool"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"itens":{"type":"array","items":{"type":"object"},"description":"Um por item: id, nome, grupo, quantidade, embalagem, preco_unitario_brl, custo_brl"},"carne_kg":{"type":"number","description":"Carne comprada, em kg"},"carvao_kg":{"type":"number","description":"Carvão, em kg (sacos de 3 e 5 kg)"},"gelo_kg":{"type":"number","description":"Gelo, em kg (sacos de 5 kg)"},"cerveja_latas":{"type":"integer","description":"Latas de cerveja de 350 ml (fardos de 12)"},"custo_total_brl":{"type":"number","description":"Custo estimado com os preços de referência"},"por_adulto_que_bebe_brl":{"type":["number","null"],"description":"Quanto paga cada adulto que bebe álcool"},"por_adulto_que_nao_bebe_brl":{"type":["number","null"],"description":"Quanto paga cada adulto que não bebe álcool"},"data_precos":{"type":"string","description":"Data da tabela de preços de referência"}},"required":["itens","carne_kg","carvao_kg","gelo_kg","cerveja_latas","custo_total_brl","por_adulto_que_bebe_brl","por_adulto_que_nao_bebe_brl","data_precos"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/racha_conta":{"post":{"operationId":"racha_conta","summary":"Racha conta do bar e restaurante","description":"Divide a conta do bar ou restaurante pelo que cada um consumiu (item de todos, de um grupo ou de uma pessoa), com taxa de serviço, couvert, desconto e quem já pagou, e monta o acerto com o menor número de Pix.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pessoas":{"type":"array","items":{"type":"string","minLength":1,"maxLength":40},"description":"Nomes de quem está na mesa (sem repetir)"},"itens":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["nome","preco_brl"],"properties":{"nome":{"type":"string","maxLength":40,"description":"Nome do item (cerveja, porção)"},"preco_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Preço de UMA unidade, em reais"},"quantidade":{"type":"integer","minimum":1,"maximum":999,"description":"Quantas unidades (padrão 1)"},"quem":{"type":"array","items":{"type":"string","maxLength":40},"description":"Nomes de quem consumiu; vazio ou ausente = todos"}}},"description":"Itens da conta"},"taxa_servico_pct":{"type":"number","minimum":0,"maximum":100,"default":10,"description":"Taxa de serviço em % sobre o consumo (10 = 10%; 0 = sem taxa)"},"couvert_por_pessoa_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Couvert artístico por pessoa, em reais","default":0},"couvert_quem":{"type":"array","items":{"type":"string","maxLength":40},"description":"Quem paga o couvert; vazio = todos"},"desconto_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Desconto no total da conta, em reais","default":0},"desconto_pct":{"type":"number","minimum":0,"maximum":100,"description":"Desconto em % do total (usa no lugar de desconto_brl)"},"pagamentos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["pessoa","valor_brl"],"properties":{"pessoa":{"type":"string","maxLength":40,"description":"Nome de quem pagou"},"valor_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Valor pago, em reais"}}},"description":"Quem já pagou e quanto (ex.: alguém passou a conta toda no cartão)"}},"required":["pessoas","itens"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"total_brl":{"type":"number","description":"Total da conta"},"pessoas":{"type":"array","items":{"type":"object"},"description":"Quanto cada um deve, com a abertura"},"transferencias":{"type":"array","items":{"type":"object"},"description":"Acerto: quem manda quanto para quem"},"numero_de_pix":{"type":"integer","description":"Pix entre pessoas no acerto"},"resumo_whatsapp":{"type":"string"}},"required":["total_brl","pessoas","transferencias","numero_de_pix","resumo_whatsapp"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/dias_uteis":{"post":{"operationId":"dias_uteis","summary":"Dias úteis","description":"Conta dias úteis entre duas datas ou acha a data daqui a N dias úteis, com os feriados nacionais do Brasil (fixos e móveis); feriado estadual/municipal entra em feriados_extras.","tags":["Datas"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operacao":{"type":"string","enum":["contar","somar"],"default":"contar","description":"contar: dias úteis entre data_inicio e data_fim | somar: data que cai dias_uteis depois (negativo = antes) de data_inicio"},"data_inicio":{"type":"string","format":"date","maxLength":10,"description":"Data inicial (AAAA-MM-DD ou DD/MM/AAAA)"},"data_fim":{"type":"string","format":"date","maxLength":10,"description":"Data final (operacao contar) (AAAA-MM-DD ou DD/MM/AAAA)"},"dias_uteis":{"type":"integer","minimum":-100000,"maximum":100000,"description":"Quantos dias úteis somar (operacao somar)"},"sabado_util":{"type":"boolean","default":false,"description":"Sábado conta como dia útil"},"incluir_pontos_facultativos":{"type":"boolean","default":true,"description":"Carnaval e Corpus Christi contam como folga"},"contar_data_inicial":{"type":"boolean","default":true,"description":"Na contagem, a data inicial entra se for útil (como DIAS.ÚTEIS do Excel)"},"feriados_extras":{"type":"array","items":{"type":"string","format":"date","maxLength":10},"description":"Feriados locais a mais"}},"required":["data_inicio"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"operacao":{"type":"string"}},"required":["operacao"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/dias_entre_datas":{"post":{"operationId":"dias_entre_datas","summary":"Dias entre datas","description":"Diferença entre duas datas em dias, semanas e anos/meses/dias de calendário, ou soma/subtrai anos, meses, semanas e dias de uma data.","tags":["Datas"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operacao":{"type":"string","enum":["diferenca","somar","subtrair"],"default":"diferenca","description":"diferenca entre data_inicio e data_fim | somar ou subtrair tempo de data_inicio"},"data_inicio":{"type":"string","format":"date","maxLength":10,"description":"Data inicial (AAAA-MM-DD ou DD/MM/AAAA)"},"data_fim":{"type":"string","format":"date","maxLength":10,"description":"Data final (operacao diferenca) (AAAA-MM-DD ou DD/MM/AAAA)"},"anos":{"type":"integer","minimum":0,"maximum":1000,"description":"Anos a somar/subtrair","default":0},"meses":{"type":"integer","minimum":0,"maximum":12000,"description":"Meses a somar/subtrair","default":0},"semanas":{"type":"integer","minimum":0,"maximum":52000,"description":"Semanas a somar/subtrair","default":0},"dias":{"type":"integer","minimum":0,"maximum":365000,"description":"Dias a somar/subtrair","default":0}},"required":["data_inicio"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"operacao":{"type":"string"}},"required":["operacao"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/idade":{"post":{"operationId":"idade","summary":"Idade exata","description":"Idade exata em anos, meses e dias a partir da data de nascimento, total de dias vividos e o próximo aniversário (data, dias que faltam, dia da semana).","tags":["Datas"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data_nascimento":{"type":"string","format":"date","maxLength":10,"description":"Data de nascimento (AAAA-MM-DD ou DD/MM/AAAA)"},"data_referencia":{"type":"string","format":"date","maxLength":10,"description":"Data em que a idade é medida; sem ela, hoje no horário de Brasília (AAAA-MM-DD ou DD/MM/AAAA)"}},"required":["data_nascimento"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"anos":{"type":"integer","description":"Anos"},"meses":{"type":"integer","description":"Meses além dos anos"},"dias":{"type":"integer","description":"Dias além dos meses"},"dias_totais":{"type":"integer","description":"Dias vividos"}},"required":["anos","meses","dias","dias_totais"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/vida_em_numeros":{"post":{"operationId":"vida_em_numeros","summary":"Sua vida em números","description":"Estimativas da vida de alguém a partir da data de nascimento: dias vividos, horas dormidas, batimentos, respirações, piscadas, refeições, luas cheias, voltas ao Sol, aniversários até os 100 e tempo no celular. São médias com fonte, não medição.","tags":["Datas"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data_nascimento":{"type":"string","format":"date","maxLength":10,"description":"Data de nascimento (AAAA-MM-DD ou DD/MM/AAAA)"},"data_referencia":{"type":"string","format":"date","maxLength":10,"description":"Data de hoje para a conta; sem ela, hoje no horário de Brasília (AAAA-MM-DD ou DD/MM/AAAA)"},"sono_horas_por_noite":{"type":"number","minimum":0,"maximum":16,"default":8,"description":"Horas de sono por noite"},"celular_horas_por_dia":{"type":"number","minimum":0,"maximum":24,"default":5.2,"description":"Horas de celular por dia; padrão 5,2 (média brasileira, DataReportal 2025)"},"refeicoes_por_dia":{"type":"number","minimum":0,"maximum":12,"default":3,"description":"Refeições por dia"}},"required":["data_nascimento"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"dias_vividos":{"type":"integer","description":"Dias vividos"},"horas_dormidas":{"type":"integer","description":"Horas dormidas estimadas"},"batimentos":{"type":"integer","description":"Batimentos cardíacos estimados"},"respiracoes":{"type":"integer","description":"Respirações estimadas"},"piscadas":{"type":"integer","description":"Piscadas estimadas (só acordado)"},"refeicoes":{"type":"integer","description":"Refeições"},"luas_cheias":{"type":"integer","description":"Luas cheias desde o nascimento"},"voltas_ao_sol":{"type":"integer","description":"Voltas completas da Terra em volta do Sol"},"aniversarios_ate_100":{"type":"integer","description":"Aniversários que faltam até os 100"},"celular_horas":{"type":"integer","description":"Horas estimadas no celular"}},"required":["dias_vividos","horas_dormidas","batimentos","respiracoes","piscadas","refeicoes","luas_cheias","voltas_ao_sol","aniversarios_ate_100","celular_horas"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/idade_em_planetas":{"post":{"operationId":"idade_em_planetas","summary":"Idade em anos de cachorro, gato, Marte e Júpiter","description":"Idade em anos de Mercúrio a Plutão (NASA) com o próximo aniversário em cada planeta, em anos de cachorro (Wang et al. 2020, não ×7) e de gato (iCatCare), e % dos brasileiros mais novos (Censo 2022). Também converte a idade do seu cão ou gato em anos humanos.","tags":["Datas"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data_nascimento":{"type":"string","format":"date","maxLength":10,"description":"Data de nascimento da pessoa (AAAA-MM-DD ou DD/MM/AAAA)"},"ano_nascimento":{"type":"integer","minimum":1890,"maximum":2100,"description":"Só o ano de nascimento (sem a data; conta pelo meio do ano, aproximado)"},"data_referencia":{"type":"string","format":"date","maxLength":10,"description":"Data em que a idade é medida; sem ela, hoje no horário de Brasília (AAAA-MM-DD ou DD/MM/AAAA)"},"idade_cachorro_anos":{"type":"number","minimum":0,"maximum":35,"description":"Idade do SEU cachorro em anos (0,5 = seis meses), para converter em anos humanos"},"idade_gato_anos":{"type":"number","minimum":0,"maximum":40,"description":"Idade do SEU gato em anos (0,5 = seis meses), para converter em anos humanos"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"modo":{"type":"string","description":"pessoa ou bicho"},"anos":{"type":"integer","description":"Idade da pessoa em anos terrestres completos"},"planetas":{"type":"array","items":{"type":"object"},"description":"Por planeta: anos (com fração), anos completos e próximo aniversário (null se só o ano)"},"cachorro":{"type":"object","description":"Pessoa em anos de cachorro, ou cão em anos humanos"},"gato":{"type":"object","description":"Pessoa em anos de gato, ou gato em anos humanos"},"brasil":{"type":"object","description":"% dos brasileiros (Censo 2022) mais novos, da mesma idade e mais velhos"},"fontes":{"type":"array","items":{"type":"object"},"description":"Fontes citadas (título e URL)"}},"required":["modo","fontes"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/dia_em_que_voce_nasceu":{"post":{"operationId":"dia_em_que_voce_nasceu","summary":"O dia em que você nasceu","description":"Cápsula do tempo de uma data (1960 em diante): dia da semana, fase da lua, signo, dias vividos, novelas da Globo (18h, 19h, 21h), presidente, salário mínimo na moeda da época, Copa e as 5 músicas mais tocadas do ano, com fonte.","tags":["Datas"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data_nascimento":{"type":"string","format":"date","maxLength":10,"description":"Data de nascimento, de 01/01/1960 até hoje (AAAA-MM-DD ou DD/MM/AAAA)"},"data_referencia":{"type":"string","format":"date","maxLength":10,"description":"Data de hoje para contar dias vividos e aniversários; sem ela, hoje no horário de Brasília (AAAA-MM-DD ou DD/MM/AAAA)"}},"required":["data_nascimento"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"dia_da_semana":{"type":["string","null"],"description":"Dia da semana"},"fase_da_lua":{"type":"object"},"novelas":{"type":"array","items":{"type":"object"},"description":"Novela por faixa"},"presidente":{"type":"object"},"salario_minimo":{"type":"object"}},"required":["dia_da_semana","fase_da_lua","novelas","presidente","salario_minimo"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/difal":{"post":{"operationId":"difal","summary":"DIFAL do ICMS","description":"Calcula o DIFAL do ICMS na venda interestadual a consumidor final não contribuinte (EC 87/2015, LC 190/2022): alíquota interestadual pela UF, ICMS de origem, DIFAL e FCP, base única ou dupla.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"valor_operacao_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Valor da venda (produto + frete + despesas), em reais"},"uf_origem":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"],"description":"UF de quem vende"},"uf_destino":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"],"description":"UF do comprador"},"produto_importado":{"type":"boolean","default":false,"description":"Produto importado (alíquota interestadual de 4%)"},"aliquota_interna_destino_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Alíquota interna do destino; sem ela, usa o padrão da UF (confira), em % (12 = 12%)"},"fcp_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Fundo de Combate à Pobreza do destino, em % (12 = 12%)","default":0},"base":{"type":"string","enum":["unica","dupla"],"default":"unica","description":"unica (Convênio 236/2021) ou dupla (ICMS por dentro, algumas UFs)"}},"required":["valor_operacao_brl","uf_origem","uf_destino"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"aliquota_interestadual_pct":{"type":"number","description":"%"},"aliquota_interna_destino_pct":{"type":"number","description":"%"},"icms_origem_brl":{"type":"number","description":"ICMS da origem"},"difal_brl":{"type":"number","description":"DIFAL"},"fcp_brl":{"type":"number","description":"FCP"},"total_destino_brl":{"type":"number","description":"DIFAL + FCP"}},"required":["aliquota_interestadual_pct","aliquota_interna_destino_pct","icms_origem_brl","difal_brl","fcp_brl","total_destino_brl"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/mei_ou_simples":{"post":{"operationId":"mei_ou_simples","summary":"MEI ou Simples Nacional","description":"Compara o DAS do MEI com o DAS do Simples Nacional pelo faturamento dos últimos 12 meses e a atividade (anexo e fator R), e avisa sobre desenquadramento pelos limites de 2026.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"faturamento_12_meses_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Receita bruta dos últimos 12 meses (RBT12), em reais"},"faturamento_mes_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Receita do mês a calcular, em reais"},"atividade":{"type":"string","enum":["comercio","industria","servicos_iii","servicos_fator_r","servicos_iv"],"description":"Atividade no Simples: comercio (Comércio (Anexo I)), industria (Indústria (Anexo II)), servicos_iii (Serviços do Anexo III (sem fator R)), servicos_fator_r (Serviços com fator R (Anexo III ou V)), servicos_iv (Serviços do Anexo IV (CPP fora do DAS))"},"folha_12_meses_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Folha de salários + pró-labore dos últimos 12 meses (fator R), em reais","default":0},"atividade_mei":{"type":"string","enum":["comercio_industria","servicos","ambos"],"description":"Como MEI: comercio_industria, servicos ou ambos; sem ela, deduz da atividade"}},"required":["faturamento_12_meses_brl","faturamento_mes_brl","atividade"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"das_mei_mensal_brl":{"type":["number","null"]},"das_simples_mes_brl":{"type":["number","null"]},"situacao_mei":{"type":"object"}},"required":["das_mei_mensal_brl","das_simples_mes_brl","situacao_mei"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/margem_mercado_livre":{"post":{"operationId":"margem_mercado_livre","summary":"Margem no Mercado Livre","description":"Margem e lucro por unidade no Mercado Livre a partir da comissão e tarifa fixa que o vendedor vê no anúncio, ou o menor preço que atinge uma margem desejada. Não presume tarifa: peça a comissão ao usuário.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"modo":{"type":"string","enum":["margem_do_preco","preco_para_margem"],"default":"margem_do_preco","description":"margem_do_preco: tenho o preço | preco_para_margem: quero a margem"},"preco_venda_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Preço de venda (modo margem_do_preco), em reais"},"margem_desejada_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Margem de lucro desejada sobre o preço (modo preco_para_margem), em % (12 = 12%)"},"comissao_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Comissão do Mercado Livre no anúncio (ex.: 12 clássico, 17 premium), em % (12 = 12%)"},"tarifa_fixa_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Tarifa fixa por unidade que o ML mostra, em reais","default":0},"imposto_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Imposto sobre a venda (ex.: Simples), em % (12 = 12%)","default":0},"custo_produto_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Custo do produto, em reais","default":0},"frete_vendedor_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Frete pago pelo vendedor, em reais","default":0},"embalagem_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Embalagem, em reais","default":0},"outros_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Outros custos por unidade, em reais","default":0}},"required":["comissao_pct"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"preco_brl":{"type":["number","null"]},"lucro_brl":{"type":["number","null"]},"margem_pct":{"type":["number","null"]}},"required":["preco_brl","lucro_brl","margem_pct"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/margem_shopee":{"post":{"operationId":"margem_shopee","summary":"Margem na Shopee","description":"Margem e lucro por unidade na Shopee com a comissão e a taxa fixa da faixa de preço (2026, já com o Programa de Frete Grátis), ou o menor preço que atinge uma margem desejada.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"modo":{"type":"string","enum":["margem_do_preco","preco_para_margem"],"default":"margem_do_preco","description":"margem_do_preco: tenho o preço | preco_para_margem: quero a margem"},"preco_venda_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Preço de venda (modo margem_do_preco), em reais"},"margem_desejada_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Margem de lucro desejada sobre o preço (modo preco_para_margem), em % (12 = 12%)"},"custo_produto_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Custo do produto, em reais","default":0},"frete_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Frete pago pelo vendedor, em reais","default":0},"embalagem_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Embalagem, em reais","default":0},"outros_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Outros custos por unidade, em reais","default":0},"imposto_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Imposto sobre a venda, em % (12 = 12%)","default":0},"vendedor_cpf":{"type":"boolean","default":false,"description":"Vendedor pessoa física com menos de 450 pedidos em 90 dias (adicional por item)"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"preco_brl":{"type":["number","null"]},"lucro_brl":{"type":["number","null"]},"margem_pct":{"type":["number","null"]}},"required":["preco_brl","lucro_brl","margem_pct"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/margem_amazon":{"post":{"operationId":"margem_amazon","summary":"Margem na Amazon","description":"Margem e lucro por unidade na Amazon Brasil: comissão por categoria (tabela oficial), tarifa do plano Individual, logística DBA/FBA, parcelamento, ou o menor preço para uma margem desejada.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"modo":{"type":"string","enum":["margem_do_preco","preco_para_margem"],"default":"margem_do_preco","description":"margem_do_preco: tenho o preço | preco_para_margem: quero a margem"},"preco_venda_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Preço de venda (modo margem_do_preco), em reais"},"margem_desejada_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Margem desejada sobre a receita (modo preco_para_margem), em % (12 = 12%)"},"categoria":{"type":"string","enum":["comidas-bebidas","linha-branca","saude","bebidas-alcoolicas","pneus","industria-ciencia","bebes","pets","cuidado-pessoal","cozinha","jardim-piscina","brinquedos","tv-audio","pc","eletronicos-portateis","automotivo","casa","beleza","beleza-luxo","celulares","camera-foto","videogames","esportes","ferramentas","papelaria","bagagem","roupas","calcados","relogios","joias","livros","acessorios-eletronicos","moveis","video-dvd","musica","instrumentos","demais"],"default":"demais","description":"Categoria da tabela oficial: comidas-bebidas (Comidas e bebidas), linha-branca (Eletrodomésticos de linha branca (inclui ar-condicionado)), saude (Saúde e cuidados pessoais), bebidas-alcoolicas (Bebidas alcoólicas), pneus (Pneus e rodas), industria-ciencia (Indústria e Ciência), bebes (Produtos para bebês), pets (Produtos para animais de estimação), cuidado-pessoal (Eletroportáteis de cuidado pessoal), cozinha (Cozinha), jardim-piscina (Jardim e Piscina), brinquedos (Brinquedos e jogos), tv-audio (TV, áudio e cinema em casa), pc (PC), eletronicos-portateis (Eletrônicos portáteis), automotivo (Peças e acessórios automotivos), casa (Casa), beleza (Beleza), beleza-luxo (Beleza de luxo), celulares (Celulares), camera-foto (Câmera e fotografia), videogames (Videogames e consoles), esportes (Esportes, aventura e lazer), ferramentas (Ferramentas e Construção), papelaria (Papelaria e Escritório), bagagem (Bagagem e acessórios de viagem), roupas (Roupas e acessórios), calcados (Calçados, bolsas e óculos escuros), relogios (Relógios), joias (Joias), livros (Livros), acessorios-eletronicos (Acessórios para eletrônicos e para PC), moveis (Móveis), video-dvd (Vídeo e DVD), musica (Música (CDs, LPs etc.)), instrumentos (Instrumentos musicais e acessórios), demais (Demais categorias)"},"plano":{"type":"string","enum":["individual","profissional"],"default":"profissional","description":"individual (R$ 2 por item) ou profissional (mensalidade)"},"logistica":{"type":"string","enum":["nenhuma","dba","valor_fixo"],"default":"nenhuma","description":"nenhuma, dba (tarifa oficial abaixo de R$ 79) ou valor_fixo (FBA/DBA digitado)"},"logistica_valor_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Tarifa de logística por unidade (valor_fixo, ou DBA a partir de R$ 79), em reais","default":0},"parcelamento_sem_juros":{"type":"boolean","default":false,"description":"Inscrito no parcelamento sem juros (1,5% a partir de R$ 40)"},"frete_cobrado_cliente_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Frete cobrado do comprador, em reais","default":0},"custo_produto_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Custo do produto, em reais","default":0},"frete_vendedor_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Frete pago pelo vendedor, em reais","default":0},"embalagem_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Embalagem, em reais","default":0},"imposto_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Imposto sobre a venda, em % (12 = 12%)","default":0}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"preco_brl":{"type":["number","null"]},"lucro_brl":{"type":["number","null"]},"margem_pct":{"type":["number","null"]}},"required":["preco_brl","lucro_brl","margem_pct"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/comparar_marketplaces":{"post":{"operationId":"comparar_marketplaces","summary":"Comparador de marketplaces","description":"Compara Mercado Livre, Shopee e Amazon para o mesmo produto: lucro em reais no mesmo preço (e quem ganha), ou o menor preço em cada um para a mesma margem. Usa as mesmas contas das calculadoras de margem.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"modo":{"type":"string","enum":["mesmo_preco","mesma_margem"],"default":"mesmo_preco","description":"mesmo_preco: lucro de cada um no preço dado | mesma_margem: menor preço de cada um para a margem"},"preco_venda_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Preço de venda (modo mesmo_preco), em reais"},"margem_desejada_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Margem desejada (modo mesma_margem), em % (12 = 12%)"},"custo_produto_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Custo do produto, em reais","default":0},"frete_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Frete pago pelo vendedor, em reais","default":0},"embalagem_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Embalagem, em reais","default":0},"imposto_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Imposto sobre a venda, em % (12 = 12%)","default":0},"comissao_ml_pct":{"type":"number","minimum":0,"maximum":99.99,"description":"Comissão do Mercado Livre no anúncio, em % (12 = 12%)","default":12},"tarifa_fixa_ml_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Tarifa fixa do Mercado Livre por unidade, em reais","default":0},"vendedor_cpf_shopee":{"type":"boolean","default":false,"description":"Vendedor CPF na Shopee (adicional por item)"},"categoria_amazon":{"type":"string","enum":["comidas-bebidas","linha-branca","saude","bebidas-alcoolicas","pneus","industria-ciencia","bebes","pets","cuidado-pessoal","cozinha","jardim-piscina","brinquedos","tv-audio","pc","eletronicos-portateis","automotivo","casa","beleza","beleza-luxo","celulares","camera-foto","videogames","esportes","ferramentas","papelaria","bagagem","roupas","calcados","relogios","joias","livros","acessorios-eletronicos","moveis","video-dvd","musica","instrumentos","demais"],"default":"demais","description":"Categoria na Amazon"},"plano_amazon":{"type":"string","enum":["individual","profissional"],"default":"profissional","description":"Plano na Amazon"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"marketplaces":{"type":"array","items":{"type":"object"},"description":"Uma linha por marketplace"}},"required":["marketplaces"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/frete_peso_cubado":{"post":{"operationId":"frete_peso_cubado","summary":"Peso cubado e limites dos Correios","description":"Calcula o peso cubado e o peso que cada transportadora cobra (Correios, Mercado Envios, Jadlog) pelas medidas da caixa, a UF pelo CEP e se a caixa cabe nos limites dos Correios. Não cota preço de frete.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comprimento_cm":{"type":"number","minimum":0,"maximum":1000,"description":"Comprimento da caixa em cm"},"largura_cm":{"type":"number","minimum":0,"maximum":1000,"description":"Largura em cm"},"altura_cm":{"type":"number","minimum":0,"maximum":1000,"description":"Altura em cm"},"peso_kg":{"type":"number","minimum":0,"maximum":1000,"description":"Peso real em kg"},"cep_origem":{"type":"string","maxLength":9,"description":"CEP de origem (opcional)"},"cep_destino":{"type":"string","maxLength":9,"description":"CEP de destino (opcional)"}},"required":["comprimento_cm","largura_cm","altura_cm","peso_kg"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"volume_cm3":{"type":"number","description":"Volume"},"transportadoras":{"type":"array","items":{"type":"object"},"description":"Peso cubado e cobrado por transportadora"},"cabe_nos_correios":{"type":"boolean"}},"required":["volume_cm3","transportadoras","cabe_nos_correios"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/checar_titulo_anuncio":{"post":{"operationId":"checar_titulo_anuncio","summary":"Checador de título de anúncio","description":"Dá nota de 0 a 100 ao título de um anúncio no Mercado Livre, Shopee e Amazon (limite de caracteres, símbolos, emoji, palavras proibidas, repetição, caixa alta) e sugere uma versão limpa.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titulo":{"type":"string","minLength":1,"maxLength":500,"description":"Título do anúncio"},"marketplace":{"type":"string","enum":["ml","shopee","amazon","todos"],"default":"todos","description":"Onde checar"}},"required":["titulo"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"resultados":{"type":"array","items":{"type":"object"},"description":"Um por marketplace"}},"required":["resultados"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/gerar_link_utm":{"post":{"operationId":"gerar_link_utm","summary":"Gerador de link com UTM","description":"Monta um link com parâmetros UTM (source, medium, campaign, term, content) para medir campanhas no Google Analytics, normalizando para minúsculas sem acento e sem duplicar UTMs existentes.","tags":["Vendas online"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":2000,"description":"URL de destino (https://...)"},"source":{"type":"string","maxLength":100,"description":"utm_source: de onde vem (instagram, google, newsletter)"},"medium":{"type":"string","maxLength":100,"description":"utm_medium: o canal (social, cpc, email)"},"campaign":{"type":"string","maxLength":100,"description":"utm_campaign: nome da campanha"},"term":{"type":"string","maxLength":100,"description":"utm_term: palavra-chave (opcional)"},"content":{"type":"string","maxLength":100,"description":"utm_content: variação do anúncio (opcional)"}},"required":["url","source","medium","campaign"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"link":{"type":"string"}},"required":["link"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/quanto_trabalho_custa":{"post":{"operationId":"quanto_trabalho_custa","summary":"Quanto do seu trabalho custa isso?","description":"Converte um preço em tempo de trabalho (meses, dias e horas da jornada da pessoa), com o valor da hora líquida e da hora real (descontando deslocamento e gastos para trabalhar), e o inverso: o que 1 hora de trabalho compra.","tags":["Trabalho"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"salario_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Salário mensal, em reais"},"tipo_salario":{"type":"string","enum":["bruto","liquido"],"default":"liquido","description":"bruto: passa pelo INSS e IRRF de 2026 | liquido: já é o que cai na conta"},"preco_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Preço da coisa (ou use coisa), em reais"},"coisa":{"type":"string","enum":["iphone","ps5","show","netflix","viagem","carro","aluguel","apartamento","cesta"],"description":"Item com preço de referência no lugar de preco_brl: iphone, ps5, show, netflix, viagem, carro, aluguel, apartamento, cesta"},"horas_semana":{"type":"number","minimum":1,"maximum":168,"default":44,"description":"Horas de trabalho por semana"},"dias_semana":{"type":"integer","minimum":1,"maximum":7,"description":"Dias de trabalho por semana","default":5},"deslocamento_min_dia":{"type":"integer","minimum":0,"maximum":1440,"description":"Minutos de deslocamento por dia, ida e volta (conta como hora de trabalho real)","default":0},"transporte_dia_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Gasto com transporte por dia de trabalho, em reais"},"almoco_dia_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Gasto com almoço por dia de trabalho, em reais"},"outros_gastos_mes_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Outros gastos mensais para trabalhar, em reais"}},"required":["salario_brl"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"frase":{"type":"string","description":"Ex.: 5 meses, 11 dias, 5 horas e 10 minutos"},"meses":{"type":"integer","description":"Meses de trabalho"},"dias":{"type":"integer","description":"Dias de trabalho"},"horas":{"type":"integer","description":"Horas"},"minutos":{"type":"integer","description":"Minutos"},"preco_brl":{"type":"number","description":"Preço usado"},"referencia":{"type":["object","null"],"description":"Fonte e data do preço de referência, quando coisa foi usada"},"salario_liquido_brl":{"type":"number","description":"Líquido mensal"},"hora_liquida_brl":{"type":"number","description":"Líquido ÷ horas de trabalho"},"hora_real_brl":{"type":"number","description":"Líquido menos gastos ÷ horas de trabalho e deslocamento"},"com_uma_hora":{"type":"array","items":{"type":"object"},"description":"O que 1 hora real compra: [{ item, quantidade, preco_brl }]"}},"required":["frase","meses","dias","horas","minutos","preco_brl","referencia","salario_liquido_brl","hora_liquida_brl","hora_real_brl","com_uma_hora"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/salario_em_coisas":{"post":{"operationId":"salario_em_coisas","summary":"Seu salário em coisas","description":"Quantos Big Macs, kg de picanha, cafezinhos, passagens de ônibus, litros de gasolina, ingressos de cinema e cestas básicas cabem num salário (bruto ou líquido), com preço de referência, fonte e data de cada item.","tags":["Trabalho"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"salario_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Salário mensal, em reais"},"tipo_salario":{"type":"string","enum":["bruto","liquido"],"default":"liquido","description":"bruto: passa pelo INSS e IRRF de 2026 | liquido: já é o que cai na conta"}},"required":["salario_brl"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"salario_liquido_brl":{"type":"number","description":"Líquido mensal usado na conta"},"itens":{"type":"array","items":{"type":"object"},"description":"[{ id, item, quantidade (unidades inteiras), preco_brl, sobra_brl, fonte, data }]"}},"required":["salario_liquido_brl","itens"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/custo_processo_manual":{"post":{"operationId":"custo_processo_manual","summary":"Quanto sua empresa perde com processo manual","description":"Calcula quanto a empresa perde por mês e por ano com um processo manual: horas da equipe pelo custo da hora, erros e retrabalho, e o quanto sobraria automatizando uma fração do processo.","tags":["Trabalho"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pessoas":{"type":"integer","minimum":0,"maximum":100000,"description":"Pessoas envolvidas no processo manual","default":3},"horas_por_pessoa_mes":{"type":"number","minimum":0,"maximum":744,"description":"Horas por mês que cada pessoa dedica ao processo, em horas (8 = 8 h por semana × 4,33)"},"custo_hora_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Custo da hora dessas pessoas (salário + encargos + estrutura), em reais"},"erros_mes":{"type":"integer","minimum":0,"maximum":1000000,"description":"Erros e retrabalhos por mês, em ocorrências","default":0},"custo_erro_brl":{"type":"number","minimum":0,"maximum":100000000,"description":"Custo de cada erro (correção, atraso, cliente perdido), em reais","default":0},"pct_automatizavel":{"type":"number","minimum":0,"maximum":100,"default":70,"description":"Fração do processo que dá para automatizar, em % (70 = 70%)"}},"required":["pessoas","horas_por_pessoa_mes","custo_hora_brl"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"perda_horas_brl":{"type":"number","description":"Perda mensal com as horas da equipe"},"perda_erros_brl":{"type":"number","description":"Perda mensal com erros e retrabalho"},"perda_mensal_brl":{"type":"number","description":"Perda total por mês"},"perda_anual_brl":{"type":"number","description":"Perda total por ano (mês × 12)"},"economia_mensal_brl":{"type":"number","description":"O que sobraria por mês automatizando o percentual informado"},"economia_anual_brl":{"type":"number","description":"O que sobraria por ano"},"sobra_mensal_brl":{"type":"number","description":"Perda residual por mês depois de automatizar"},"pct_automatizavel":{"type":"number","description":"Percentual automatizável usado, em %"}},"required":["perda_horas_brl","perda_erros_brl","perda_mensal_brl","perda_anual_brl","economia_mensal_brl","economia_anual_brl","sobra_mensal_brl","pct_automatizavel"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/validar_cpf_cnpj":{"post":{"operationId":"validar_cpf_cnpj","summary":"Validar CPF e CNPJ (inclusive o alfanumérico)","description":"Valida até 100 CPFs ou CNPJs (inclusive o CNPJ alfanumérico de 2026) e diz o motivo de cada erro (tamanho, caractere, todos iguais, 1º ou 2º dígito verificador, com o dígito certo). Detecta o tipo; aceita máscara. Confere a conta, não se o documento existe na Receita.","tags":["Documentos"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documentos":{"type":"array","items":{"type":"string","maxLength":40},"description":"De 1 a 100 CPFs ou CNPJs, com ou sem máscara (ex.: \"529.982.247-25\", \"12.ABC.345/01DE-35\")","minItems":1,"maxItems":100}},"required":["documentos"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"validos":{"type":"integer","description":"Quantos passaram"},"invalidos":{"type":"integer","description":"Quantos não passaram"},"resultados":{"type":"array","items":{"type":"object"},"description":"Um por entrada, na mesma ordem: documento (CPF|CNPJ|null), valido, motivo (ok, vazio, caractere, tamanho, dv-letra, repetido, dv1, dv2), mensagem, formatado, esperado (DVs certos), tipo e matriz (CNPJ), regiao_fiscal (CPF)"}},"required":["validos","invalidos","resultados"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/gerar_cpf_cnpj":{"post":{"operationId":"gerar_cpf_cnpj","summary":"Gerar CPF e CNPJ válidos para teste","description":"Gera de 1 a 100 CPFs ou CNPJs fictícios que passam no dígito verificador, para teste de software: CPF de uma UF (região fiscal), CNPJ numérico ou alfanumérico, matriz ou filial. Não são de ninguém de propósito; usar como documento de verdade é crime (falsidade ideológica).","tags":["Documentos"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tipo":{"type":"string","enum":["cpf","cnpj","cnpj_alfanumerico"],"description":"O que gerar"},"quantidade":{"type":"integer","minimum":1,"maximum":100,"description":"Quantos gerar, sem repetir","default":1},"uf":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"],"description":"Só CPF: UF da região fiscal (9º dígito)"},"filial":{"type":"integer","minimum":1,"maximum":9999,"description":"Só CNPJ: número da ordem (1 = matriz 0001)","default":1},"com_mascara":{"type":"boolean","default":true,"description":"Devolver com pontuação"},"semente":{"type":"integer","minimum":0,"maximum":4294967295,"description":"Opcional: com a mesma semente sai a mesma lista (bom para teste automatizado); sem ela, sorteio novo"}},"required":["tipo"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"tipo":{"type":"string"},"quantidade":{"type":"integer","description":"Quantos saíram"},"documentos":{"type":"array","items":{"type":"string"},"description":"Os documentos gerados"}},"required":["tipo","quantidade","documentos"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/calculadora":{"post":{"operationId":"calculadora","summary":"Calculadoras, conversões e comparativas","description":"Roda uma das calculadoras de calculadora.genesisinnovation.io pelo tipo: conversão de unidades, xícara em gramas, regra de três, MMC, IMC, consumo, álcool ou gasolina, IPCA acumulado, CDB × poupança × Tesouro, alugar × financiar e outras. Campos errados voltam com a lista certa.","tags":["Contas do dia a dia"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tipo":{"type":"string","enum":["regra-de-tres","regra-de-tres-inversa","mmc","mdc","simplificar-fracao","operacoes-com-fracoes","potencia","raiz","media-mediana-moda","desvio-padrao","media-ponderada","area-do-retangulo","area-do-triangulo","area-do-circulo","area-do-trapezio","volume-da-caixa","volume-do-cilindro","volume-da-esfera","pitagoras","equacao-do-segundo-grau","fatorial","logaritmo","numero-primo","consumo-de-combustivel","alcool-ou-gasolina","consumo-de-energia","velocidade-media","tempo-de-viagem","custo-da-viagem-de-carro","gorjeta","desconto-progressivo","qual-embalagem-compensa","preco-por-quilo","rendimento-de-tinta","imc","agua-por-dia","taxa-metabolica-basal","frequencia-cardiaca-maxima","juros-simples","inflacao-acumulada-ipca","rendimento-real","tempo-para-dobrar","cdb-poupanca-ou-tesouro-selic","alugar-ou-financiar","carro-ou-aplicativo","eletrico-gasolina-ou-etanol","a-vista-ou-parcelado","comprar-ou-assinar","comprimento","massa","volume","area","temperatura","velocidade","tempo","dados","pressao","energia","xicaras-e-colheres-em-gramas"],"description":"Id da calculadora (ex.: regra-de-tres, comprimento, imc, cdb-poupanca-ou-tesouro-selic)"},"valores":{"type":"object","description":"Valores dos campos da calculadora, por nome (ex.: {\"valor\": 5, \"de\": \"pe\", \"para\": \"m\"}). Campo omitido usa o padrão da página; mande {} para ver os campos no erro"}},"required":["tipo"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"calculadora":{"type":"string"},"resultado":{"type":"object","description":"Saídas pelo nome (números sem arredondar)"},"resultado_formatado":{"type":"object","description":"Saídas como a página mostra, com unidade"},"valores_usados":{"type":"object"},"pagina":{"type":"string"}},"required":["calculadora","resultado","resultado_formatado","valores_usados","pagina"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/presente_criancas":{"post":{"operationId":"presente_criancas","summary":"Ideias de presente para crianças (0 a 12 anos)","description":"Recomenda ideias de presente de qualquer tipo (brinquedo, livro, experiência, esporte, arte, ciência) para criança de 0 a 12 anos pela idade, interesses, orçamento e ocasião, com faixa de preço típica e o porquê. Segurança é exclusão dura; gênero nunca muda o resultado.","tags":["Família"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["idade_anos"],"properties":{"idade_anos":{"type":"integer","minimum":0,"maximum":12,"description":"Idade em anos completos"},"idade_meses":{"type":"integer","minimum":0,"maximum":11,"default":0,"description":"Meses além dos anos completos (bebês)"},"interesses":{"type":"array","items":{"type":"string","enum":["esportes","arte","ciencia","leitura","musica","tecnologia","faz-de-conta","ar-livre","construcao","jogos","bichos","moda","culinaria","veiculos"]},"description":"Interesses da criança"},"genero":{"type":"string","enum":["tanto-faz","menina","menino"],"default":"tanto-faz","description":"Aceito por compatibilidade; não muda o resultado"},"personagem":{"type":"string","maxLength":60,"description":"Personagem favorito (bônus para ideias que aceitam tema)"},"contexto":{"type":"string","enum":["dia-das-criancas","aniversario","natal","volta-as-aulas"],"default":"dia-das-criancas","description":"Ocasião"},"evitar_telas":{"type":"boolean","default":false,"description":"Tira toda ideia com tela"},"limite":{"type":"integer","minimum":1,"maximum":24,"default":8,"description":"Quantas ideias devolver"},"orcamento_min_brl":{"type":"number","minimum":0,"description":"Orçamento mínimo, em reais","maximum":100000},"orcamento_max_brl":{"type":"number","minimum":1,"description":"Orçamento máximo, em reais","maximum":100000}}}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","required":["quantidade","total_elegiveis","itens","explicacao","loja"],"properties":{"quantidade":{"type":"integer"},"total_elegiveis":{"type":"integer","description":"Ideias que passaram nas regras de idade, segurança, telas e orçamento"},"explicacao":{"type":"string"},"itens":{"type":"array","items":{"type":"object","required":["id","nome","categoria","faixa_preco","por_que"],"properties":{"id":{"type":"string"},"nome":{"type":"string"},"categoria":{"type":"string"},"tipo":{"type":"string","enum":["objeto","experiencia"]},"faixa_preco":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"}},"description":"Faixa típica em reais, não cotação"},"por_que":{"type":"array","items":{"type":"string"},"description":"Frases geradas das regras que pontuaram"},"avisos":{"type":"array","items":{"type":"string"},"description":"Avisos de uso seguro"},"ver_opcoes_url":{"type":"string"},"produtos_loja":{"type":"array","items":{"type":"object","properties":{"nome":{"type":"string"},"preco_brl":{"type":"number"},"preco_pix_brl":{"type":["number","null"]},"link":{"type":"string"},"imagem_url":{"type":["string","null"]}},"required":["nome","preco_brl","link"]},"description":"Até 2 produtos da loja My Bag Center para esta ideia, só quando há personagem e a ideia é mochila, estojo ou lancheira"}}},"description":"Ideias em ordem, já diversificadas"},"loja":{"type":"object","properties":{"consultada":{"type":"boolean"},"respondeu":{"type":["boolean","null"]}},"required":["consultada","respondeu"],"description":"A loja só é consultada com personagem e ideia que ela vende; se não responder, as ideias vêm sem produto"}}},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/mochila_certa":{"post":{"operationId":"mochila_certa","summary":"Mochila certa","description":"Diz quanto peso a criança pode levar na mochila escolar (10% do peso, pela SBOP; faixa de 5% a 15% entre leis estaduais e a AAP), se a mochila deve ser de rodinha ou de costas, a altura máxima e um checklist de ajuste. Não substitui orientação médica.","tags":["Família"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"idade_anos":{"type":"integer","minimum":1,"maximum":18,"description":"Idade da criança, em anos completos"},"peso_kg":{"type":"number","minimum":5,"maximum":150,"description":"Peso da criança, em kg"},"altura_cm":{"type":"number","minimum":60,"maximum":210,"description":"Altura da criança, em cm (opcional)"},"trajeto":{"type":"string","enum":["a-pe","carro","onibus","van"],"default":"a-pe","description":"Como vai à escola"},"escadas":{"type":"boolean","default":false,"description":"A escola tem escada no caminho até a sala"},"carga_kg":{"type":"number","minimum":0,"maximum":40,"description":"Peso da mochila cheia num dia comum, em kg (opcional)"}},"required":["idade_anos","peso_kg"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"carga_maxima_kg":{"type":"number","description":"10% do peso corporal"},"faixa_min_kg":{"type":"number","description":"Teto mais rígido entre as fontes (5% em leis estaduais para os menores)"},"faixa_max_kg":{"type":"number","description":"Teto mais frouxo entre as fontes (15%, AAP)"},"carga_pct":{"type":["number","null"],"description":"Carga informada em % do peso"},"situacao_carga":{"type":["string","null"],"enum":["dentro","acima-do-recomendado","acima-de-todas-as-fontes",null]},"tipo":{"type":"string","enum":["costas","rodinha"]},"porque":{"type":"string"},"altura_maxima_mochila_cm":{"type":["number","null"],"description":"Regra prática: 30% da altura"},"faixa_loja":{"type":"string","enum":["0-3","4-7","8-mais"]},"link_loja":{"type":"string"},"checklist":{"type":"array","items":{"type":"string"}},"premissas":{"type":"array","items":{"type":"string"}},"fontes":{"type":"array","items":{"type":"object"}}},"required":["carga_maxima_kg","faixa_min_kg","faixa_max_kg","tipo","porque","faixa_loja","link_loja","premissas","fontes"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/lista_material_escolar":{"post":{"operationId":"lista_material_escolar","summary":"Lista de material escolar","description":"Monta a lista típica de material escolar de uma etapa (infantil, 1º ao 9º ano, médio), tira o que a família já tem e soma o custo só com preços informados. Com a lista da escola em texto, aponta o que a escola não pode exigir (Lei 12.886/2013). Não inventa preço.","tags":["Família"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["etapa"],"properties":{"etapa":{"type":"string","minLength":1,"maxLength":40,"description":"Ano ou etapa: \"ef-3\", \"3º ano\", \"maternal\", \"pré\", \"4 anos\", \"2ª série\", \"ensino médio\"."},"ja_tem":{"type":"array","items":{"type":"string","enum":["agenda","apontador","borracha","brinquedo","caderno-brochura","caderno-desenho","caderno-materias","caderno-quadriculado","caderno-redacao","calculadora","camiseta-pintura","caneta-azul","canetinha","cola-bastao","cola-branca","esquadros","estojo","garrafa","giz-cera","higiene-bebe","jogo","lancheira","lapis-cor","lapis-cor-jumbo","lapis-preto","livro-infantil","marca-texto","massinha","mochila","muda-roupa","necessaire","pasta-catalogo","pasta-elastico","pincel","regua","tesoura","tinta","toalhinha","transferidor"],"description":"Id do item, como aparece em itens[].id"},"uniqueItems":true,"maxItems":39,"description":"Itens que a família já tem na quantidade toda (ids)"},"ja_tem_parcial":{"type":"array","maxItems":39,"items":{"type":"object","additionalProperties":false,"required":["id","quantidade"],"properties":{"id":{"type":"string","enum":["agenda","apontador","borracha","brinquedo","caderno-brochura","caderno-desenho","caderno-materias","caderno-quadriculado","caderno-redacao","calculadora","camiseta-pintura","caneta-azul","canetinha","cola-bastao","cola-branca","esquadros","estojo","garrafa","giz-cera","higiene-bebe","jogo","lancheira","lapis-cor","lapis-cor-jumbo","lapis-preto","livro-infantil","marca-texto","massinha","mochila","muda-roupa","necessaire","pasta-catalogo","pasta-elastico","pincel","regua","tesoura","tinta","toalhinha","transferidor"],"description":"Id do item, como aparece em itens[].id"},"quantidade":{"type":"integer","minimum":0,"maximum":100,"description":"Unidades que já tem"}}},"description":"Itens que a família tem só em parte: { id, quantidade }"},"precos":{"type":"array","maxItems":39,"items":{"type":"object","additionalProperties":false,"required":["id","preco_brl"],"properties":{"id":{"type":"string","enum":["agenda","apontador","borracha","brinquedo","caderno-brochura","caderno-desenho","caderno-materias","caderno-quadriculado","caderno-redacao","calculadora","camiseta-pintura","caneta-azul","canetinha","cola-bastao","cola-branca","esquadros","estojo","garrafa","giz-cera","higiene-bebe","jogo","lancheira","lapis-cor","lapis-cor-jumbo","lapis-preto","livro-infantil","marca-texto","massinha","mochila","muda-roupa","necessaire","pasta-catalogo","pasta-elastico","pincel","regua","tesoura","tinta","toalhinha","transferidor"],"description":"Id do item, como aparece em itens[].id"},"preco_brl":{"type":"number","minimum":0,"maximum":10000,"description":"Preço por unidade, em reais"}}},"description":"Preço por unidade de cada item, em reais. Sem preço, não há custo: a ferramenta não inventa"},"lista_da_escola":{"type":"string","maxLength":8000,"description":"Opcional: a lista da escola colada como texto, uma linha por item, para conferir o que a Lei 12.886/2013 não deixa exigir."}}}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"etapa":{"type":"object","properties":{"id":{"type":"string"},"grupo":{"type":"string"},"nome":{"type":"string"}}},"itens":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"nome":{"type":"string"},"categoria":{"type":"string"},"qtd":{"type":"integer"},"ja_tem":{"type":"integer"},"falta":{"type":"integer"},"preco_brl":{"type":["number","null"]},"subtotal_brl":{"type":["number","null"]},"fontes":{"type":"array","items":{"type":"string"}}},"required":["id","nome","qtd","ja_tem","falta"]}},"totais":{"type":"object","properties":{"linhas":{"type":"integer"},"unidades":{"type":"integer"},"ja_tem":{"type":"integer"},"faltam":{"type":"integer"},"linhas_que_faltam":{"type":"integer"},"custo_brl":{"type":["number","null"],"description":"Só com preço informado"},"itens_sem_preco":{"type":"integer"}},"required":["linhas","unidades","ja_tem","faltam","custo_brl"]},"fontes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titulo":{"type":"string"},"url":{"type":"string"}}}},"aviso":{"type":"string"},"checagem_da_escola":{"type":["object","null"],"properties":{"linhas_analisadas":{"type":"integer"},"proibidos":{"type":"array","items":{"type":"object","properties":{"regra":{"type":"string"},"nome":{"type":"string"},"linha":{"type":"integer"},"texto":{"type":"string"}}}},"atencao":{"type":"array","items":{"type":"object","properties":{"regra":{"type":"string"},"nome":{"type":"string"},"linha":{"type":"integer"},"texto":{"type":"string"}}}},"loja_ou_marca":{"type":"array","items":{"type":"object","properties":{"regra":{"type":"string"},"nome":{"type":"string"},"linha":{"type":"integer"},"texto":{"type":"string"}}}}},"description":"Só com lista_da_escola: itens de uso coletivo (proibidos, Lei 12.886/2013), itens que só valem para o próprio aluno (atencao) e exigência de loja ou marca"}},"required":["etapa","itens","totais","fontes","aviso","checagem_da_escola"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/lancheira_da_semana":{"post":{"operationId":"lancheira_da_semana","summary":"Lancheira da semana","description":"Monta o cardápio de lanche escolar (1 a 12 anos) dos dias escolhidos e a lista de compras: fruta + cereal + proteína ou laticínio + água, pelos guias do Ministério da Saúde, sem ultraprocessado, sem alergênico informado e sem açúcar antes dos 2 anos. Repita ao usuário o campo aviso.","tags":["Família"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["idade_anos"],"properties":{"idade_anos":{"type":"integer","minimum":1,"maximum":12,"description":"Idade da criança em anos completos"},"turno":{"type":"string","enum":["manha","tarde","integral"],"default":"manha","description":"manha ou tarde = 1 lanche por dia; integral = 2 (manhã e tarde)"},"dias":{"type":"array","items":{"type":"string","enum":["seg","ter","qua","qui","sex"]},"uniqueItems":true,"default":["seg","ter","qua","qui","sex"],"description":"Dias com aula"},"alergias":{"type":"array","items":{"type":"string","enum":["leite","ovo","gluten","amendoim","castanhas","soja"]},"uniqueItems":true,"default":[],"description":"Alergênicos que nunca podem aparecer"},"dietas":{"type":"array","items":{"type":"string","enum":["sem-lactose","vegetariano","vegano"]},"uniqueItems":true,"default":[],"description":"Restrições de dieta"},"lancheira_termica":{"type":"boolean","default":false,"description":"true se a criança leva lancheira ou bolsa térmica com gelo"},"sem_acucar":{"type":"boolean","default":false,"description":"Tira tudo com açúcar adicionado (sempre ligado para menor de 2 anos)"},"max_repeticoes":{"type":"integer","minimum":1,"maximum":10,"default":2,"description":"Máximo de vezes que o mesmo item aparece na semana"},"variacao":{"type":"integer","minimum":0,"default":0,"description":"0 = primeira sugestão; 1, 2... = outras combinações"}}}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","required":["dias","lista_compras","aviso","fontes","avisos"],"properties":{"dias":{"type":"array","description":"Um item por dia: { dia, nome, lanches: [{ momento, itens: [{ id, nome, grupo, porcao }] }] }"},"lista_compras":{"type":"array","description":"{ id, nome, grupo, porcao, vezes } por item da semana"},"fora_do_cardapio":{"type":"object","description":"ids que ficaram de fora, por motivo (idade, acucar, alergia, dieta, refrigerar, ultraprocessado)"},"avisos":{"type":"array","items":{"type":"string"}},"aviso":{"type":"string","description":"Aviso de que não substitui pediatra ou nutricionista"},"fontes":{"type":"array","description":"Guias do Ministério da Saúde com ano e link"},"semente":{"type":"integer"}}},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/bolsa_empresa":{"post":{"operationId":"bolsa_empresa","summary":"Bolsa: ficha de uma companhia","description":"Ficha de uma companhia da B3 por ticker (PETR4) ou CNPJ: P/L, P/VP, ROE, margem, dívida/PL e dividend yield, cada um com a conta, mais resultados anuais, tickers e links (Fichário, Licitações). Dado público da CVM e B3; não é recomendação.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ticker":{"type":"string","minLength":4,"maxLength":7,"pattern":"^[A-Za-z]{4}[0-9]{1,2}$","description":"Ticker na B3, como PETR4 ou TAEE11 (qualquer classe da companhia)"},"cnpj":{"type":"string","minLength":11,"maxLength":18,"description":"CNPJ da companhia, com ou sem pontuação"}}}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker principal"},"nome":{"type":"string","description":"Nome de pregão"},"cnpj":{"type":"string","description":"CNPJ, 14 dígitos"},"setor":{"type":"string","description":"Setor"},"indicadores":{"type":"object","description":"P/L, P/VP, margem, ROE, dívida/PL, dividend yield e valor de mercado: valor, unidade, fórmula e os números da conta. Razões como fração (0,12 = 12%); null = não informado"},"anos":{"type":"object","description":"Resultados por exercício, em reais"},"links":{"type":"object","description":"Página da Bolsa, Fichário e Licitações da companhia"},"fonte":{"type":"object","description":"Datas das fontes: último pregão da B3 e últimas demonstrações da CVM"},"aviso":{"type":"string","description":"Aviso: informação de fonte pública, não é recomendação"}},"required":["ticker","nome","cnpj","setor","indicadores","links"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/bolsa_buscar":{"post":{"operationId":"bolsa_buscar","summary":"Bolsa: buscar companhia","description":"Acha companhias da B3 por nome, ticker ou setor (ex.: petro, WEGE3, bancos) e devolve ticker, setor, CNPJ e o endereço da ficha. Use antes de bolsa_empresa quando não souber o ticker.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"consulta":{"type":"string","minLength":2,"maxLength":60,"description":"Parte do nome, ticker ou setor, sem diferenciar acento ou maiúscula"},"limite":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Quantas empresas devolver (1 a 50)"}},"required":["consulta"]}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"total_encontradas":{"type":"integer","description":"Quantas companhias casam, antes do limite"},"empresas":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker principal (o mais negociado)"},"nome":{"type":"string","description":"Nome de pregão"},"setor":{"type":"string","description":"Setor (classificação da CVM)"},"cnpj":{"type":"string","description":"CNPJ, 14 dígitos"},"ficha_json":{"type":"string","description":"Endereço da ficha completa"}},"required":["ticker","nome","setor"]},"description":"Do melhor casamento (ticker igual, depois prefixo, nome, setor) ao pior"},"fonte":{"type":"object","description":"Datas das fontes: último pregão da B3 e últimas demonstrações da CVM"},"aviso":{"type":"string","description":"Aviso"}},"required":["total_encontradas","empresas"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/bolsa_triagem":{"post":{"operationId":"bolsa_triagem","summary":"Bolsa: ranking e triagem por indicadores","description":"Filtra as companhias da B3 por indicadores (P/L, P/VP, ROE, margem, dividend yield, dívida/PL, valor de mercado, liquidez) e ordena por UM indicador, com a fórmula dele. Dado público, sem pontuação nem recomendação; quem não tem o indicador fica de fora.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ordenar_por":{"type":"string","enum":["pl","pvp","roe","margem","dy","divida_pl","valor_mercado","liquidez"],"description":"O único indicador de ordenação (companhias sem ele ficam de fora)"},"ordem":{"type":"string","enum":["asc","desc"],"default":"desc","description":"asc = do menor ao maior; desc = do maior ao menor"},"setor":{"type":"string","maxLength":60,"description":"Parte do nome do setor (ex.: bancos, energia)"},"pl_min":{"type":"number","description":"P/L mínimo, em vezes (P/L negativo não existe: prejuízo vem como não se aplica)"},"pl_max":{"type":"number","description":"P/L máximo, em vezes"},"pvp_max":{"type":"number","description":"P/VP máximo, em vezes"},"roe_min_pct":{"type":"number","description":"ROE mínimo, em % (15 = 15%)"},"margem_min_pct":{"type":"number","description":"Margem líquida mínima, em %"},"dy_min_pct":{"type":"number","description":"Dividend yield mínimo, em %"},"divida_pl_max":{"type":"number","description":"Dívida líquida/PL máxima, em vezes (bancos ficam de fora)"},"valor_mercado_min_brl":{"type":"number","minimum":0,"description":"Valor de mercado mínimo, em reais"},"liquidez_min_brl":{"type":"number","minimum":0,"description":"Volume financeiro médio mínimo por pregão, em reais"},"limite":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Quantas empresas devolver (1 a 50)"}},"required":["ordenar_por"]}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"ordenado_por":{"type":"object","description":"Indicador, sentido e a fórmula do indicador"},"total_que_passaram":{"type":"integer","description":"Quantas companhias passam nos filtros, antes do limite"},"empresas":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker principal (o mais negociado)"},"nome":{"type":"string","description":"Nome de pregão"},"setor":{"type":"string","description":"Setor (classificação da CVM)"},"cnpj":{"type":"string","description":"CNPJ, 14 dígitos"},"ficha_json":{"type":"string","description":"Endereço da ficha completa"},"pl":{"type":["number","null"],"description":"P/L em vezes"},"pvp":{"type":["number","null"],"description":"P/VP em vezes"},"roe_pct":{"type":["number","null"],"description":"ROE em %"},"margem_pct":{"type":["number","null"],"description":"Margem líquida em %"},"dy_pct":{"type":["number","null"],"description":"Dividend yield em %"}},"required":["ticker","nome","setor"]}},"fonte":{"type":"object","description":"Datas das fontes: último pregão da B3 e últimas demonstrações da CVM"},"aviso":{"type":"string","description":"Aviso"}},"required":["ordenado_por","total_que_passaram","empresas"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/bolsa_netnet":{"post":{"operationId":"bolsa_netnet","summary":"Bolsa: net-net (NCAV de Graham)","description":"Lista companhias da B3 com NCAV (ativo circulante − passivo total) e o desconto do valor de mercado sobre ele, com a conta, % do controlador, free float e liquidez. Triagem objetiva à la Graham: dado bruto, sem pontuação nem recomendação.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"desconto_min_pct":{"type":"number","minimum":-1000,"maximum":100,"default":0,"description":"Desconto mínimo sobre o NCAV, em % (0 = só valor de mercado abaixo do NCAV; -1000 mostra todas)"},"liquidez_min_brl":{"type":"number","minimum":0,"default":0,"description":"Volume financeiro médio mínimo por pregão, em reais"},"setor":{"type":"string","maxLength":60,"description":"Parte do nome do setor"},"limite":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Quantas empresas devolver (1 a 50)"}}}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"calculado":{"type":"boolean","description":"false = a carga atual da Bolsa ainda não traz o NCAV"},"formula":{"type":"string","description":"A conta do NCAV e do desconto"},"total_que_passaram":{"type":"integer","description":"Quantas passam nos filtros, antes do limite"},"empresas":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker principal (o mais negociado)"},"nome":{"type":"string","description":"Nome de pregão"},"setor":{"type":"string","description":"Setor (classificação da CVM)"},"cnpj":{"type":["string","null"],"description":"CNPJ, 14 dígitos"},"ficha_json":{"type":"string","description":"Endereço da ficha completa"},"ncav_brl":{"type":["number","null"],"description":"NCAV, em reais"},"desconto_pct":{"type":["number","null"],"description":"1 − valor de mercado ÷ NCAV, em %"},"conta":{"type":"object","description":"Os dois números da divisão"},"controlador_pct":{"type":["number","null"],"description":"% do controlador"},"free_float_pct":{"type":["number","null"],"description":"% em circulação"}},"required":["ticker","nome","ncav_brl","desconto_pct","conta"]},"description":"Ordenadas pelo desconto, do maior ao menor"},"fonte":{"type":"object","description":"Datas das fontes: último pregão da B3 e últimas demonstrações da CVM"},"aviso":{"type":"string","description":"Aviso"}},"required":["calculado","total_que_passaram","empresas"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/bolsa_juros":{"post":{"operationId":"bolsa_juros","summary":"Bolsa: juros e dólar de hoje","description":"Último valor, com data e fonte, da meta Selic, Selic efetiva, CDI, IPCA em 12 meses e dólar PTAX (Banco Central). É a taxa livre de risco para bolsa_opcao_calcular. Dado bruto, sem recomendação de investimento.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"series":{"type":"object","description":"Por série: nome, valor, data, unidade, fonte e o arquivo completo na API"},"cdi_aa_pct":{"type":["number","null"],"description":"CDI anualizado (base 252), em % a.a., atalho para a taxa do cálculo de opções"},"aviso":{"type":"string","description":"Aviso"}},"required":["series"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/bolsa_opcao_calcular":{"post":{"operationId":"bolsa_opcao_calcular","summary":"Bolsa: Black-Scholes de uma opção","description":"Valor teórico (Black-Scholes-Merton), Greeks e volatilidade implícita de uma opção europeia, com a conta. Informe tipo, preço do ativo, strike, dias úteis e volatilidade ou prêmio. Cálculo, não recomendação de investimento.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"tipo":{"type":"string","enum":["call","put"],"description":"call ou put"},"preco_ativo":{"type":"number","minimum":0.0001,"description":"Preço do ativo-objeto, em reais (ex.: o preço de bolsa_empresa)"},"strike":{"type":"number","minimum":0.0001,"description":"Preço de exercício, em reais"},"dias_uteis":{"type":"integer","minimum":0,"maximum":1260,"description":"Dias úteis até o vencimento (T = dias ÷ 252)"},"volatilidade_pct":{"type":"number","minimum":0.0001,"maximum":500,"description":"Volatilidade anual, em % (ex.: 30). Obrigatória se não houver prêmio"},"premio":{"type":"number","minimum":0.0001,"description":"Prêmio de mercado da opção, em reais; devolve a volatilidade implícita"},"taxa_aa_pct":{"type":"number","minimum":-50,"maximum":500,"description":"Taxa livre de risco efetiva anual, em %. Omitida = último CDI (bolsa_juros)"},"dividendos_aa_pct":{"type":"number","minimum":0,"maximum":100,"default":0,"description":"Rendimento contínuo de dividendos do ativo, em % a.a."}},"required":["tipo","preco_ativo","strike","dias_uteis"]}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"valor_teorico_brl":{"type":["number","null"],"description":"Valor teórico da opção, em reais (só com volatilidade_pct)"},"greeks":{"type":["object","null"],"description":"delta, gamma, vega (por 1 p.p. de volatilidade), theta (por dia útil) e rho (por 1 p.p. de juro)"},"volatilidade_implicita_pct":{"type":["number","null"],"description":"Volatilidade que reproduz o prêmio, em % a.a. (só com premio); null se o prêmio estiver fora dos limites"},"entradas":{"type":"object","description":"O que foi usado: r contínuo, T em anos, q, σ, e de onde veio a taxa"},"conta":{"type":"string","description":"A conta, passo a passo"},"aviso":{"type":"string","description":"Aviso"}},"required":["greeks","entradas","conta"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/bolsa_grafico":{"post":{"operationId":"bolsa_grafico","summary":"Bolsa: gráfico de uma companhia","description":"Gráfico em SVG, com os pontos e a conta, de uma companhia da B3: cotação (últimos pregões) ou receita e lucro por exercício. Dado público de CVM e B3, sem recomendação de investimento.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ticker":{"type":"string","minLength":4,"maxLength":7,"pattern":"^[A-Za-z]{4}[0-9]{1,2}$","description":"Ticker na B3, como PETR4"},"grafico":{"type":"string","enum":["cotacao","receita_lucro"],"default":"cotacao","description":"cotacao = fechamento por pregão; receita_lucro = barras por exercício (DFP)"},"pregoes":{"type":"integer","minimum":20,"maximum":500,"default":250,"description":"Quantos pregões da cotação (20 a 500)"}},"required":["ticker"]}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker"},"grafico":{"type":"string","description":"Qual gráfico"},"svg":{"type":"string","description":"O gráfico em SVG, pronto para exibir ou salvar"},"pontos":{"type":"array","description":"Os pontos do gráfico: [data, fechamento] ou {ano, receita_brl, lucro_brl}"},"conta":{"type":"string","description":"O que foi calculado sobre os pontos e a fonte"},"pagina":{"type":"string","description":"Página da companhia, com os demais gráficos"},"fonte":{"type":"object","description":"Datas das fontes: último pregão da B3 e últimas demonstrações da CVM"},"aviso":{"type":"string","description":"Aviso"}},"required":["ticker","grafico","svg","pontos","conta"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/bolsa_cotacao_em_data":{"post":{"operationId":"bolsa_cotacao_em_data","summary":"Bolsa: cotação de uma ação em uma data","description":"Fechamento, mínima e máxima de uma ação da B3 em qualquer data desde 2000 (ex.: PETR4 em 2017-07-10). Sem pregão na data, devolve o último anterior. Preço como negociado, sem ajuste de proventos. Dado público, sem recomendação de investimento.","tags":["Dinheiro"],"x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ticker":{"type":"string","minLength":4,"maxLength":7,"pattern":"^[A-Za-z]{4}[0-9]{1,2}$","description":"Ticker na B3, como PETR4"},"data":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$","description":"Data no formato AAAA-MM-DD (ex.: 2017-07-10)"}},"required":["ticker","data"]}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker"},"data_pedida":{"type":"string","description":"A data pedida"},"data_do_pregao":{"type":"string","description":"Data do pregão que respondeu (igual à pedida se houve pregão)"},"exato":{"type":"boolean","description":"true = houve pregão na data pedida; false = é o último pregão anterior"},"fechamento_brl":{"type":["number","null"],"description":"Fechamento, em reais por ação"},"minima_brl":{"type":["number","null"],"description":"Mínima do dia"},"maxima_brl":{"type":["number","null"],"description":"Máxima do dia"},"conta":{"type":"string","description":"De onde vem o número e o que ele não é"},"historico_de":{"type":"string","description":"Primeiro pregão disponível"},"historico_ate":{"type":"string","description":"Último pregão disponível"},"pagina":{"type":"string","description":"Página da companhia"},"aviso":{"type":"string","description":"Aviso"}},"required":["ticker","data_pedida","data_do_pregao","exato","fechamento_brl","conta"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/sugerir_ferramenta":{"post":{"operationId":"sugerir_ferramenta","summary":"Sugerir uma ferramenta","description":"Registra a ideia de uma ferramenta que a Genesis ainda não tem. Use quando nenhuma ferramenta resolver o pedido, depois de perguntar se o usuário quer sugerir. Ideias iguais somam voto. E-mail só com o consentimento explícito do usuário.","tags":["Sugestões"],"x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"texto":{"type":"string","minLength":10,"maxLength":500,"description":"O que a ferramenta faria, em uma ou duas frases, sem dados pessoais"},"categoria":{"type":"string","enum":["Trabalho","Dinheiro","Datas","Vendas online","Família","Outra"],"default":"Outra","description":"Área da ideia"},"email":{"type":"string","maxLength":254,"description":"Opcional: e-mail para avisar quando ficar no ar. Só com consentimento explícito do usuário"},"consentimento_email":{"type":"boolean","default":false,"description":"true só se o usuário concordou em guardar o e-mail para esse aviso"}},"required":["texto"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"ferramenta":{"type":"string"},"resultado":{"type":"object","properties":{"id":{"type":"integer","description":"Id da sugestão"},"nova":{"type":"boolean"},"votos":{"type":"integer","description":"Votos"},"mensagem":{"type":"string"}},"required":["id","nova","votos","mensagem"]},"premissas":{"type":"array","items":{"type":"string"},"description":"Regras e tabelas usadas na conta"},"fontes":{"type":"array","items":{"type":"string"}},"link":{"type":"string","description":"Página humana da ferramenta, para o usuário conferir"},"aviso_afiliado":{"type":"string","description":"Presente quando a resposta traz link de compra: mostre ao usuário"}},"required":["ok","ferramenta","resultado","link"]}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"Conta recusada pela regra (ex.: data de desligamento antes da admissão)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite por minuto ou teto diário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Serviço externo fora do ar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}},"components":{"schemas":{"Erro":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"ferramenta":{"type":"string"},"erro":{"type":"object","properties":{"codigo":{"type":"string","enum":["FERRAMENTA_DESCONHECIDA","ENTRADA_INVALIDA","CALCULO_RECUSADO","LIMITE_POR_MINUTO","TETO_DIARIO","SERVICO_INDISPONIVEL","ERRO_INTERNO"]},"mensagem":{"type":"string","description":"O que corrigir ou o que dizer ao usuário"},"campos":{"type":"array","items":{"type":"object","properties":{"campo":{"type":"string"},"mensagem":{"type":"string"}}}}},"required":["codigo","mensagem"]},"link":{"type":"string"}},"required":["ok","erro"]}}}}