{"openapi":"3.0.0","info":{"title":"FullCash — API de Contas a Pagar","version":"0.1.0","description":"API pública de Contas a Pagar. Espelho do papel cliente: ver, criar, comentar e anexar, escopado à empresa da chave. Inclui a consulta (só leitura) dos arquivos de todos os módulos, com o escopo arquivos:read."},"servers":[{"url":"/"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Chave de API do FullCash: Authorization: Bearer fc_live_..."}},"schemas":{"Me":{"type":"object","properties":{"key":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"rate_limit_per_min":{"type":"number"}},"required":["id","name","scopes","rate_limit_per_min"]},"companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"sigla":{"type":"string","nullable":true}},"required":["id","name","sigla"]}}},"required":["key","companies"]},"Conta":{"type":"object","properties":{"id":{"type":"string"},"company_id":{"type":"string"},"titulo":{"type":"string"},"descricao":{"type":"string","nullable":true},"tipo_transacao":{"type":"string"},"status":{"type":"string","nullable":true},"status_documento":{"type":"string","nullable":true},"valor":{"type":"number"},"data":{"type":"string"},"fornecedor_id":{"type":"string","nullable":true},"plano_conta_id":{"type":"string","nullable":true},"centro_custo_id":{"type":"string","nullable":true},"conta_bancaria_id":{"type":"string","nullable":true},"numero_documento":{"type":"string","nullable":true},"codigo":{"type":"string","nullable":true,"description":"Código de rastreio do lançamento (ex.: CP20260007)."},"vencimento":{"type":"string","nullable":true},"competencia":{"type":"string","nullable":true},"data_emissao":{"type":"string","nullable":true},"data_liquidacao":{"type":"string","nullable":true},"tipo_documento":{"type":"string","nullable":true},"meio_pagamento":{"type":"string","nullable":true},"historico":{"type":"string","nullable":true},"parcela":{"type":"string","nullable":true},"status_titulo":{"type":"string","nullable":true},"uso_interno":{"type":"boolean","nullable":true},"dados_avancados":{"nullable":true,"description":"Valores avançados/originais do lançamento."},"dados_avancados_origem":{"nullable":true,"description":"Valores avançados da conta de origem (transferências)."},"dados_editados":{"nullable":true,"description":"Correções feitas na finalização (valores editados pelo operador)."},"created_via":{"type":"string","nullable":true},"created_at":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true}},"required":["id","company_id","titulo","descricao","tipo_transacao","status","status_documento","valor","data","fornecedor_id","plano_conta_id","centro_custo_id","conta_bancaria_id","numero_documento","codigo","vencimento","competencia","data_emissao","data_liquidacao","tipo_documento","meio_pagamento","historico","parcela","status_titulo","uso_interno","created_via","created_at","updated_at"]},"ListaContas":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Conta"}},"page":{"type":"number"},"size":{"type":"number"},"total":{"type":"number"}},"required":["data","page","size","total"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"validation_error"},"message":{"type":"string","example":"Campo obrigatório faltando."},"details":{"nullable":true}},"required":["code","message"]},"request_id":{"type":"string","example":"5f0b…"}},"required":["error","request_id"]},"ContaEnvelope":{"type":"object","properties":{"conta":{"$ref":"#/components/schemas/Conta"}},"required":["conta"]},"CriarConta":{"type":"object","properties":{"company_id":{"type":"string","format":"uuid","description":"Empresa-alvo. Só é usada para escolher entre as empresas liberadas da chave; nunca dá acesso fora delas."},"tipo_transacao":{"type":"string","enum":["entrada","saida","transferencia"],"default":"saida"},"status":{"type":"string","nullable":true,"enum":["a_receber","recebida","a_pagar","paga"]},"valor":{"type":"number","minimum":0,"exclusiveMinimum":true,"example":1250.9},"data":{"type":"string","description":"Data de competência/lançamento (YYYY-MM-DD).","example":"2026-09-10"},"titulo":{"type":"string","minLength":1,"example":"NF 12345 — Fornecedor X"},"descricao":{"type":"string","default":""},"fornecedor_id":{"type":"string","nullable":true,"format":"uuid"},"plano_conta_id":{"type":"string","nullable":true,"format":"uuid","description":"Deve ser uma folha do plano (nivel = conta)."},"centro_custo_id":{"type":"string","nullable":true,"format":"uuid","description":"Deve estar vinculado à empresa-alvo."},"conta_bancaria_id":{"type":"string","nullable":true,"format":"uuid","description":"Conta bancária do lançamento (saída/entrada). Deve ser da empresa-alvo."},"conta_origem_id":{"type":"string","nullable":true,"format":"uuid","description":"Conta de origem (obrigatória em transferência)."},"conta_destino_id":{"type":"string","nullable":true,"format":"uuid","description":"Conta de destino (obrigatória em transferência)."},"numero_documento":{"type":"string","nullable":true},"competencia":{"type":"string","nullable":true},"data_emissao":{"type":"string","nullable":true},"data_liquidacao":{"type":"string","nullable":true,"description":"Só com status paga/recebida."},"tipo_documento":{"type":"string","nullable":true},"meio_pagamento":{"type":"string","nullable":true},"historico":{"type":"string","nullable":true},"codigo_barras":{"type":"string","nullable":true},"parcelas":{"type":"array","nullable":true,"items":{"type":"object","properties":{"numero":{"type":"integer","minimum":1},"total":{"type":"integer","minimum":1},"vencimento":{"type":"string","description":"Data (YYYY-MM-DD).","example":"2026-10-05"},"valor":{"type":"number","minimum":0,"exclusiveMinimum":true}},"required":["numero","total","vencimento","valor"]},"description":"Vazio/ausente = parcela única."},"tem_rateio":{"type":"boolean","nullable":true,"description":"Marca o lançamento como rateado."},"rateio_tipos":{"type":"array","nullable":true,"items":{"type":"string","enum":["centro_custo","plano_conta"]},"description":"Dimensões do rateio quando tem_rateio = true."}},"required":["valor","data","titulo"]},"Fornecedor":{"type":"object","properties":{"id":{"type":"string"},"nome":{"type":"string"},"documento":{"type":"string","nullable":true},"company_id":{"type":"string","nullable":true,"description":"null = fornecedor geral (compartilhado)."},"plano_conta_padrao_id":{"type":"string","nullable":true,"description":"Plano de contas padrão do fornecedor (para pré-selecionar no lançamento)."}},"required":["id","nome","documento","company_id","plano_conta_padrao_id"]},"ListaFornecedores":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Fornecedor"}},"page":{"type":"number"},"size":{"type":"number"},"total":{"type":"number"}},"required":["data","page","size","total"]},"PlanoConta":{"type":"object","properties":{"id":{"type":"string"},"nome":{"type":"string"},"nivel":{"type":"string"},"codigo_externo":{"type":"string","nullable":true}},"required":["id","nome","nivel","codigo_externo"]},"ListaPlanos":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PlanoConta"}},"page":{"type":"number"},"size":{"type":"number"},"total":{"type":"number"}},"required":["data","page","size","total"]},"CentroCusto":{"type":"object","properties":{"id":{"type":"string"},"nome":{"type":"string"},"codigo_externo":{"type":"string","nullable":true},"principal":{"type":"boolean","description":"Centro pré-selecionado da empresa."}},"required":["id","nome","codigo_externo","principal"]},"ListaCentros":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CentroCusto"}}},"required":["data"]},"ContaBancaria":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"principal":{"type":"boolean","nullable":true},"padrao":{"type":"boolean","nullable":true,"description":"Conta padrão da empresa (pré-selecionada)."}},"required":["id","name","principal","padrao"]},"ListaContasBancarias":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ContaBancaria"}}},"required":["data"]},"Usuario":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"role":{"type":"string","nullable":true},"is_company_manager":{"type":"boolean","nullable":true,"description":"Cliente gestor da empresa."}},"required":["id","name","role","is_company_manager"]},"ListaUsuarios":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Usuario"}}},"required":["data"]},"TiposDocumento":{"type":"object","properties":{"tipos_documento":{"type":"array","items":{"type":"string"}},"meios_pagamento":{"type":"array","items":{"type":"string"}}},"required":["tipos_documento","meios_pagamento"]},"UploadRegras":{"type":"object","properties":{"max_size_bytes":{"type":"number"},"max_size_mb":{"type":"number"},"extensoes":{"type":"array","items":{"type":"string"}},"mimes":{"type":"array","items":{"type":"string"}}},"required":["max_size_bytes","max_size_mb","extensoes","mimes"]},"Mensagem":{"type":"object","properties":{"id":{"type":"string"},"message":{"type":"string"},"message_type":{"type":"string","nullable":true},"user_id":{"type":"string","nullable":true},"user_name":{"type":"string","nullable":true,"description":"Nome do autor (resolvido de profiles)."},"autor_externo":{"type":"object","nullable":true,"properties":{"nome":{"type":"string"},"email":{"type":"string","nullable":true},"id":{"type":"string","nullable":true}},"required":["nome"],"description":"Quem escreveu de verdade, quando a mensagem veio pela API em nome de alguém do seu sistema."},"created_at":{"type":"string","nullable":true},"anexos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"file_name":{"type":"string"},"file_type":{"type":"string","nullable":true},"file_size":{"type":"number","nullable":true},"url":{"type":"string","nullable":true},"preview_url":{"type":"string","nullable":true,"description":"Link fixo de visualização (imagem/PDF), válido por 30 dias e enquanto a chave estiver ativa. Null para outros tipos."}},"required":["id","file_name","file_type","file_size","url"]},"description":"Anexos desta mensagem."}},"required":["id","message","message_type","user_id","user_name","autor_externo","created_at","anexos"]},"ListaMensagens":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Mensagem"}}},"required":["data"]},"MensagemEnvelope":{"type":"object","properties":{"mensagem":{"$ref":"#/components/schemas/Mensagem"}},"required":["mensagem"]},"AutorExterno":{"type":"object","nullable":true,"properties":{"nome":{"type":"string","minLength":1,"maxLength":120,"example":"Murillo Guimarães"},"email":{"type":"string","nullable":true,"maxLength":200,"format":"email"},"id":{"type":"string","nullable":true,"minLength":1,"maxLength":120,"description":"Id da pessoa no seu sistema."}},"required":["nome"],"additionalProperties":false,"description":"Quem escreveu de verdade no seu sistema. A mensagem continua assinada pelo usuário de integração da chave e aparece no FullCash como \"Nome · via <integração>\". Não precisa de conta no FullCash."},"EnviarMensagem":{"type":"object","properties":{"message":{"type":"string","minLength":1},"user_id":{"type":"string","nullable":true,"format":"uuid","description":"Autor da mensagem (usuário da empresa). Se ausente, usa o usuário de integração da chave."},"autor_externo":{"$ref":"#/components/schemas/AutorExterno"}},"required":["message"]},"Anexo":{"type":"object","properties":{"id":{"type":"string"},"file_name":{"type":"string"},"file_type":{"type":"string","nullable":true},"file_size":{"type":"number","nullable":true},"url":{"type":"string","nullable":true,"description":"URL assinada temporária (1 h) — para baixar."},"preview_url":{"type":"string","nullable":true,"description":"Link fixo de visualização (imagem/PDF), válido por 30 dias e enquanto a chave estiver ativa. Funciona direto em <img>/<iframe>. Null para outros tipos."}},"required":["id","file_name","file_type","file_size","url"]},"ListaAnexos":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Anexo"}}},"required":["data"]},"AnexoEnvelope":{"type":"object","properties":{"anexo":{"$ref":"#/components/schemas/Anexo"}},"required":["anexo"]},"ReenvioEnvelope":{"type":"object","properties":{"conta":{"$ref":"#/components/schemas/Conta"},"mensagem":{"allOf":[{"$ref":"#/components/schemas/Mensagem"},{"nullable":true,"description":"A mensagem enviada junto (ou null)."}]}},"required":["conta","mensagem"]},"ReenviarAnalise":{"type":"object","properties":{"mensagem":{"type":"string","nullable":true,"minLength":1,"maxLength":10000,"description":"Resposta à pendência. Vai pro chat antes do aviso de reenvio (precisa do escopo chat:write).","example":"Segue o boleto corrigido, pode seguir."},"user_id":{"type":"string","nullable":true,"format":"uuid","description":"Quem reenviou, se tem conta no FullCash (usuário da empresa). Sem ele, assina o usuário de integração da chave."},"autor_externo":{"$ref":"#/components/schemas/AutorExterno"}},"additionalProperties":false},"FornecedorSugestao":{"type":"object","properties":{"nome_extraido":{"type":"string","nullable":true},"documento":{"type":"string","nullable":true},"fornecedor_id":{"type":"string","nullable":true,"description":"Preenchido quando o documento casa com um fornecedor já cadastrado (da empresa ou geral)."}},"required":["nome_extraido","documento","fornecedor_id"]},"PlanoSugestao":{"type":"object","nullable":true,"properties":{"codigo":{"type":"string","nullable":true},"nome":{"type":"string","nullable":true},"plano_conta_id":{"type":"string","nullable":true}},"required":["codigo","nome","plano_conta_id"]},"AnaliseDocumento":{"type":"object","properties":{"poor_quality":{"type":"boolean"},"tipo_documento":{"type":"string","nullable":true},"tipo_transacao":{"type":"string"},"valor":{"type":"string","nullable":true},"data_emissao":{"type":"string","nullable":true},"data_vencimento":{"type":"string","nullable":true},"data_liquidacao":{"type":"string","nullable":true},"competencia":{"type":"string","nullable":true},"numero_documento":{"type":"string","nullable":true},"meio_pagamento":{"type":"string","nullable":true},"titulo":{"type":"string","nullable":true},"historico":{"type":"string","nullable":true},"parcelamento":{"type":"object","properties":{"parcelado":{"type":"boolean"},"parcela":{"type":"number","nullable":true},"total":{"type":"number","nullable":true}},"required":["parcelado","parcela","total"]},"fornecedor":{"$ref":"#/components/schemas/FornecedorSugestao"},"plano_conta_sugerido":{"$ref":"#/components/schemas/PlanoSugestao"},"centro_custo_sugerido":{"type":"string","nullable":true}},"required":["poor_quality","tipo_documento","tipo_transacao","valor","data_emissao","data_vencimento","data_liquidacao","competencia","numero_documento","meio_pagamento","titulo","historico","parcelamento","fornecedor","plano_conta_sugerido","centro_custo_sugerido"]},"AnaliseEnvelope":{"type":"object","properties":{"analise":{"$ref":"#/components/schemas/AnaliseDocumento"}},"required":["analise"]},"PastaArquivos":{"type":"object","properties":{"chave":{"type":"string","example":"agendamento-bancario"},"rotulo":{"type":"string","example":"Agendamento Bancário"},"qtd_arquivos":{"type":"number"},"total_bytes":{"type":"number"},"ultimo_envio":{"type":"string","nullable":true},"filtro":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"}]},"description":"Como descer um nível: nos níveis de pasta, repita estes parâmetros em GET /api/v1/arquivos/pastas; no nível de registro, use-os em GET /api/v1/arquivos."},"registro":{"type":"object","nullable":true,"properties":{"tipo":{"type":"string"},"id":{"type":"string"},"valor":{"type":"number","nullable":true}},"required":["tipo","id","valor"],"description":"Só no nível `registros`."}},"required":["chave","rotulo","qtd_arquivos","total_bytes","ultimo_envio","filtro","registro"]},"PastasArquivos":{"type":"object","properties":{"nivel":{"type":"string","enum":["modulos","anos","meses","dias","registros"]},"data":{"type":"array","items":{"$ref":"#/components/schemas/PastaArquivos"}}},"required":["nivel","data"]},"PastaEquipe":{"type":"object","properties":{"id":{"type":"string"},"nome":{"type":"string"},"parent_id":{"type":"string","nullable":true},"criada_em":{"type":"string"},"qtd_arquivos":{"type":"number"},"qtd_subpastas":{"type":"number"},"total_bytes":{"type":"number"}},"required":["id","nome","parent_id","criada_em","qtd_arquivos","qtd_subpastas","total_bytes"]},"ListaPastasEquipe":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PastaEquipe"}}},"required":["data"]},"Arquivo":{"type":"object","properties":{"id":{"type":"string","description":"Id do arquivo (use em GET /api/v1/arquivos/{id})."},"file_name":{"type":"string"},"file_type":{"type":"string","nullable":true},"file_size":{"type":"number","nullable":true},"origem":{"type":"string","enum":["arquivos","chat"],"description":"`arquivos` = anexo do registro; `chat` = enviado numa mensagem."},"do_lote":{"type":"boolean","description":"Anexo do lote de agendamento: aparece em cada item do lote."},"enviado_em":{"type":"string"},"enviado_por":{"type":"string","nullable":true},"enviado_por_id":{"type":"string","nullable":true,"description":"Id de quem enviou (use no filtro `enviado_por`)."},"modulo":{"type":"string"},"data_referencia":{"type":"string","nullable":true,"description":"Data do registro (não do envio). Nula em pastas da equipe."},"registro":{"type":"object","properties":{"tipo":{"type":"string"},"id":{"type":"string"},"titulo":{"type":"string","nullable":true}},"required":["tipo","id","titulo"]}},"required":["id","file_name","file_type","file_size","origem","do_lote","enviado_em","enviado_por","enviado_por_id","modulo","data_referencia","registro"]},"ListaArquivos":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Arquivo"}},"page":{"type":"number"},"size":{"type":"number"},"total":{"type":"number"},"total_bytes":{"type":"number","description":"Soma do tamanho de TODOS os arquivos do filtro (não só da página)."}},"required":["data","page","size","total","total_bytes"]},"FacetasArquivos":{"type":"object","properties":{"mes":{"type":"array","items":{"type":"object","properties":{"chave":{"type":"string"},"rotulo":{"type":"string","nullable":true},"qtd":{"type":"number"}},"required":["chave","rotulo","qtd"]},"description":"`chave` = mês com 2 dígitos (\"10\"); `rotulo` = nome do mês."},"registro":{"type":"array","items":{"type":"object","properties":{"chave":{"type":"string"},"rotulo":{"type":"string","nullable":true},"qtd":{"type":"number"}},"required":["chave","rotulo","qtd"]},"description":"`chave` = \"registro_tipo.registro_id\"."},"pessoa":{"type":"array","items":{"type":"object","properties":{"chave":{"type":"string"},"rotulo":{"type":"string","nullable":true},"qtd":{"type":"number"}},"required":["chave","rotulo","qtd"]},"description":"`chave` = id de quem enviou (filtro `enviado_por`)."},"origem":{"type":"array","items":{"type":"object","properties":{"chave":{"type":"string"},"rotulo":{"type":"string","nullable":true},"qtd":{"type":"number"}},"required":["chave","rotulo","qtd"]},"description":"`arquivos` ou `chat`."}},"required":["mes","registro","pessoa","origem"]},"ConferenciaZip":{"type":"object","properties":{"arquivos":{"type":"number"},"bytes":{"type":"number"}},"required":["arquivos","bytes"]},"PedidoZip":{"type":"object","properties":{"registro_tipo":{"type":"string","enum":["cash_closing","daily_safe","conta_pagar","bank_scheduling_item","solicitation","arquivo_pasta"]},"registro_id":{"type":"string","format":"uuid","description":"Exige `registro_tipo`."},"pasta_id":{"type":"string","format":"uuid","description":"Arquivos de uma pasta da equipe."},"modulo":{"type":"string","enum":["fechamento-caixa","cofre-diario","contas-pagar","agendamento-bancario","conciliacao-bancaria","solicitacoes-gerais","pasta-manual"]},"ano":{"type":"integer","minimum":2000,"maximum":2100,"description":"Ano da data do registro (o nível onde as pastas param)."},"mes":{"type":"integer","minimum":1,"maximum":12,"description":"Exige `ano`."},"dia":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Data do registro exata (AAAA-MM-DD)."},"desde":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Data do registro ≥ (AAAA-MM-DD)."},"ate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Data do registro ≤ (AAAA-MM-DD)."},"origem":{"type":"string","enum":["arquivos","chat"]},"enviado_por":{"type":"string","format":"uuid","description":"Id de quem enviou (`enviado_por_id`, ou as opções de GET /api/v1/arquivos/facetas)."},"busca":{"type":"string","minLength":1,"maxLength":120,"description":"Parte do nome do arquivo (sem diferenciar maiúsculas)."},"incluir_subpastas":{"type":"boolean","description":"Com `pasta_id`: inclui as subpastas (padrão `true` no .zip)."},"chaves":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f-]{36}\\|[0-9a-f-]{36}\\|(arquivos|chat)$"},"minItems":1,"maxItems":500,"description":"Só estas linhas da lista, no formato `id|registro.id|origem`. É a LINHA e não o arquivo: um anexo do lote de agendamento aparece em cada item do lote. Os outros filtros continuam valendo."},"nome":{"type":"string","minLength":1,"maxLength":120,"description":"Nome do .zip (sem extensão) e da pasta dentro dele. Sem nome: \"arquivos\".","example":"Contas a Pagar 2026 - Outubro"},"somente_conferir":{"type":"boolean","description":"Só confere: devolve `{ arquivos, bytes }` em JSON, sem montar o .zip."}}},"ArquivoDetalhe":{"allOf":[{"$ref":"#/components/schemas/Arquivo"},{"type":"object","properties":{"url":{"type":"string","description":"Link de download temporário (60 min)."},"url_expira_em":{"type":"string"}},"required":["url","url_expira_em"]}]}},"parameters":{}},"paths":{"/api/v1/me":{"get":{"tags":["Meta"],"summary":"Dados da chave","description":"Empresas liberadas, escopos e rate limit. Primeiro endpoint para validar a integração.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Me"}}}}}}},"/api/v1/contas-pagar":{"get":{"tags":["Contas a Pagar"],"summary":"Lista lançamentos","description":"Filtros por período, fase, fornecedor e valor. Sempre limitado à empresa da chave.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"},{"schema":{"type":"integer","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"size","in":"query"},{"schema":{"type":"string","description":"Busca por título ou código do lançamento.","example":"NF 12"},"required":false,"name":"busca","in":"query"},{"schema":{"type":"string","example":"em_analise"},"required":false,"name":"status_documento","in":"query"},{"schema":{"type":"string","format":"uuid"},"required":false,"name":"fornecedor_id","in":"query"},{"schema":{"type":"string","example":"2026-09-01"},"required":false,"name":"data_de","in":"query"},{"schema":{"type":"string","example":"2026-09-30"},"required":false,"name":"data_ate","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"valor_min","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"valor_max","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaContas"}}}},"401":{"description":"Chave inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Contas a Pagar"],"summary":"Cria um lançamento","description":"Manda o lançamento. Idempotente via header Idempotency-Key. Referências (fornecedor, plano, centro, conta) são validadas contra a empresa da chave.","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CriarConta"}}}},"responses":{"201":{"description":"Criado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContaEnvelope"}}}},"422":{"description":"Regra de negócio","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/contas-pagar/{id}":{"get":{"tags":["Contas a Pagar"],"summary":"Consulta um lançamento","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContaEnvelope"}}}},"404":{"description":"Não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/cadastros/fornecedores":{"get":{"tags":["Cadastros"],"summary":"Consulta fornecedores","description":"Fornecedores da empresa + os gerais (compartilhados). Busca por nome ou documento.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"},{"schema":{"type":"string","description":"Busca por nome ou documento."},"required":false,"name":"termo","in":"query"},{"schema":{"type":"integer","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"default":50},"required":false,"name":"size","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaFornecedores"}}}}}}},"/api/v1/cadastros/plano-contas":{"get":{"tags":["Cadastros"],"summary":"Consulta plano de contas","description":"Somente as folhas selecionáveis (nivel = conta), ativas, com código externo para de-para.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"},{"schema":{"type":"string","description":"Busca por nome ou documento."},"required":false,"name":"termo","in":"query"},{"schema":{"type":"integer","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"default":50},"required":false,"name":"size","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaPlanos"}}}}}}},"/api/v1/cadastros/centros-custo":{"get":{"tags":["Cadastros"],"summary":"Consulta centros de custo da empresa","description":"Somente os centros vinculados à empresa da chave (nunca a lista global).","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaCentros"}}}}}}},"/api/v1/cadastros/contas-bancarias":{"get":{"tags":["Cadastros"],"summary":"Consulta contas bancárias da empresa","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaContasBancarias"}}}}}}},"/api/v1/cadastros/usuarios":{"get":{"tags":["Cadastros"],"summary":"Usuários vinculados à empresa","description":"Usuários ativos da empresa (para escolher o autor da mensagem no chat do lançamento).","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaUsuarios"}}}}}}},"/api/v1/cadastros/tipos-documento":{"get":{"tags":["Cadastros"],"summary":"Domínios de tipo de documento e meio de pagamento","description":"Listas fechadas que espelham as do FullCash — para preencher os selects do lançamento.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TiposDocumento"}}}}}}},"/api/v1/cadastros/upload-regras":{"get":{"tags":["Cadastros"],"summary":"Regras de upload de anexos (tamanho e formatos)","description":"Tamanho máximo e formatos/MIME aceitos — valem para anexos da conta e do chat.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadRegras"}}}}}}},"/api/v1/contas-pagar/{id}/mensagens":{"get":{"tags":["Chat"],"summary":"Lê o chat do lançamento","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaMensagens"}}}},"404":{"description":"Não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Chat"],"summary":"Escreve no chat do lançamento","description":"Conta finalizada (`status_documento` = `validado`, rótulo \"Finalizado\") é somente consulta → `409 conta_finalizada`.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnviarMensagem"}}}},"responses":{"201":{"description":"Criado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MensagemEnvelope"}}}},"404":{"description":"Não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conta finalizada (somente consulta)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/contas-pagar/{id}/mensagens/{msgId}/anexos":{"post":{"tags":["Chat"],"summary":"Anexa um arquivo a uma mensagem do chat","description":"multipart/form-data com o campo `file`. Respeita a allowlist de MIME e o tamanho máximo. Só na mensagem que **esta chave** mandou e **até 2 minutos** depois dela; fora disso → `409 anexo_fora_da_janela` (mande uma mensagem nova com o arquivo). Conta finalizada (`status_documento` = `validado`) → `409 conta_finalizada`.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"msgId","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"Criado","content":{"application/json":{"schema":{"type":"object","properties":{"anexo":{"type":"object","properties":{"id":{"type":"string"},"file_name":{"type":"string"},"file_type":{"type":"string","nullable":true},"file_size":{"type":"number","nullable":true},"url":{"type":"string","nullable":true},"preview_url":{"type":"string","nullable":true,"description":"Link fixo de visualização (imagem/PDF), válido por 30 dias e enquanto a chave estiver ativa. Null para outros tipos."}},"required":["id","file_name","file_type","file_size","url"]}},"required":["anexo"]}}}},"404":{"description":"Conta ou mensagem não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Fora da janela (mensagem de outra origem ou com mais de 2 min) ou conta finalizada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"MIME/tamanho inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/contas-pagar/{id}/anexos":{"get":{"tags":["Anexos"],"summary":"Lista anexos do lançamento","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaAnexos"}}}},"404":{"description":"Não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Anexos"],"summary":"Envia um anexo ao lançamento (só na janela de criação)","description":"multipart/form-data com o campo `file`. Respeita a allowlist de MIME do bucket. Só é permitido **até 2 minutos após a criação** da conta; passada a janela, retorna `409 anexo_apos_lancamento` e o arquivo novo deve ir como anexo de mensagem no chat.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"Criado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnexoEnvelope"}}}},"422":{"description":"MIME não permitido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/contas-pagar/{id}/reenviar-analise":{"post":{"tags":["Contas a Pagar"],"summary":"Reenvia para análise uma conta em Pendência","description":"O mesmo botão \"Reenviar para análise\" da tela do cliente. Só com a conta em `pendencias`; ela volta para `em_analise`, o chat ganha o aviso \"Conta Reenviada para Análise\" e a equipe é notificada. Pode mandar a resposta junto em `mensagem`. Outra fase → `409 conta_fora_de_pendencia`.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReenviarAnalise"}}}},"responses":{"200":{"description":"Reenviada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReenvioEnvelope"}}}},"404":{"description":"Não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"A conta não está em Pendência","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Autor inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/contas-pagar/analisar-documento":{"post":{"tags":["Contas a Pagar"],"summary":"Lê um documento por IA e sugere os campos do lançamento","description":"Envie a NF/boleto (multipart `file`) e a API lê o documento por IA, devolvendo os campos extraídos + sugestões já resolvidas: fornecedor casado com o cadastro (`fornecedor_id`), plano de contas sugerido e mais. Use o retorno para montar o `POST /contas-pagar`. Não cria nada — é só leitura.","security":[{"bearerAuth":[]}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"tipo_transacao":{"type":"string","description":"saida (padrão) ou entrada."}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnaliseEnvelope"}}}},"422":{"description":"Documento ilegível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"IA indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/arquivos/pastas":{"get":{"tags":["Arquivos"],"summary":"Pastas automáticas: módulos e anos","description":"Mesma organização do módulo de Arquivos do FullCash: as pastas param no ANO. Sem parâmetros: os módulos; com `modulo`: os anos. Cada item traz `filtro`. No nível `anos`, use o `filtro` em GET /api/v1/arquivos (a lista com filtros de mês, dia, registro…) e em GET /api/v1/arquivos/facetas. Só pastas com arquivo aparecem. A data é a do registro (dia do fechamento, vencimento…), não a do envio. Compatibilidade: `ano`, `mes` e `dia` ainda descem até meses, dias e registros, como antes.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Empresa-alvo (obrigatório se a chave acessa mais de uma)."},"required":false,"name":"company_id","in":"query"},{"schema":{"type":"string","enum":["fechamento-caixa","cofre-diario","contas-pagar","agendamento-bancario","conciliacao-bancaria","solicitacoes-gerais"],"description":"Sem módulo: lista os módulos."},"required":false,"name":"modulo","in":"query"},{"schema":{"type":"integer","minimum":2000,"maximum":2100,"description":"Exige `modulo`."},"required":false,"name":"ano","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":12,"description":"Exige `ano`."},"required":false,"name":"mes","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":31,"description":"Exige `mes`. Devolve os registros do dia."},"required":false,"name":"dia","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PastasArquivos"}}}},"403":{"description":"Sem o escopo arquivos:read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Nível pulado (ex.: mês sem ano)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/arquivos/pastas-equipe":{"get":{"tags":["Arquivos"],"summary":"Pastas criadas pela equipe","description":"Pastas manuais da empresa (só a administração cria). Para os arquivos de uma pasta, use GET /api/v1/arquivos?pasta_id={id}.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"},{"schema":{"type":"string","format":"uuid","description":"Sem `parent_id`: pastas da raiz."},"required":false,"name":"parent_id","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaPastasEquipe"}}}},"403":{"description":"Sem o escopo arquivos:read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/arquivos":{"get":{"tags":["Arquivos"],"summary":"Lista arquivos (paginado, com filtros)","description":"A lista do Explorador. Sem link de download (para não gerar centenas de links): use GET /api/v1/arquivos/{id} para um, ou POST /api/v1/arquivos/zip para vários. Filtros combináveis: `modulo` + `ano` (+ `mes` ou `dia`), um registro (`registro_tipo` + `registro_id`), uma pasta da equipe (`pasta_id`, com `incluir_subpastas`), `origem`, `enviado_por`, `busca` no nome e período (`desde`/`ate`). As opções com contagem vêm de GET /api/v1/arquivos/facetas. Padrão: mais recentes primeiro; `ordem=data` ordena pela data do registro (como a tela, que agrupa por mês). Anexo do lote de agendamento aparece em cada item do lote (`do_lote: true`).","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1,"example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"example":50},"required":false,"name":"size","in":"query"},{"schema":{"type":"string","enum":["cash_closing","daily_safe","conta_pagar","bank_scheduling_item","solicitation","arquivo_pasta"]},"required":false,"name":"registro_tipo","in":"query"},{"schema":{"type":"string","format":"uuid","description":"Exige `registro_tipo`."},"required":false,"name":"registro_id","in":"query"},{"schema":{"type":"string","format":"uuid","description":"Arquivos de uma pasta da equipe."},"required":false,"name":"pasta_id","in":"query"},{"schema":{"type":"string","enum":["fechamento-caixa","cofre-diario","contas-pagar","agendamento-bancario","conciliacao-bancaria","solicitacoes-gerais","pasta-manual"]},"required":false,"name":"modulo","in":"query"},{"schema":{"type":"integer","minimum":2000,"maximum":2100,"description":"Ano da data do registro (o nível onde as pastas param)."},"required":false,"name":"ano","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":12,"description":"Exige `ano`."},"required":false,"name":"mes","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Data do registro exata (AAAA-MM-DD)."},"required":false,"name":"dia","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Data do registro ≥ (AAAA-MM-DD)."},"required":false,"name":"desde","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Data do registro ≤ (AAAA-MM-DD)."},"required":false,"name":"ate","in":"query"},{"schema":{"type":"string","enum":["arquivos","chat"]},"required":false,"name":"origem","in":"query"},{"schema":{"type":"string","format":"uuid","description":"Id de quem enviou (`enviado_por_id`, ou as opções de GET /api/v1/arquivos/facetas)."},"required":false,"name":"enviado_por","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Parte do nome do arquivo (sem diferenciar maiúsculas)."},"required":false,"name":"busca","in":"query"},{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"},{"schema":{"type":"boolean","description":"Com `pasta_id`: inclui os arquivos das subpastas."},"required":false,"name":"incluir_subpastas","in":"query"},{"schema":{"type":"string","enum":["data","nome","enviado_em","tamanho","registro","por"],"default":"enviado_em","description":"`data` = data do registro (para agrupar por mês/dia, como a tela); `enviado_em` = envio (padrão)."},"required":false,"name":"ordem","in":"query"},{"schema":{"type":"boolean","description":"Decrescente (padrão `true`)."},"required":false,"name":"desc","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaArquivos"}}}},"403":{"description":"Sem o escopo arquivos:read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Filtros inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/arquivos/facetas":{"get":{"tags":["Arquivos"],"summary":"Opções dos filtros, com contagem","description":"Para montar os filtros da lista: meses, registros, quem enviou e origens, cada um com quantos arquivos tem — no recorte `modulo` + `ano` (o nível onde as pastas param) ou numa pasta da equipe.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"},{"schema":{"type":"string","enum":["fechamento-caixa","cofre-diario","contas-pagar","agendamento-bancario","conciliacao-bancaria","solicitacoes-gerais"]},"required":false,"name":"modulo","in":"query"},{"schema":{"type":"integer","minimum":2000,"maximum":2100,"description":"Exige `modulo`."},"required":false,"name":"ano","in":"query"},{"schema":{"type":"string","format":"uuid","description":"Pasta da equipe (com as subpastas). Não combina com `modulo`."},"required":false,"name":"pasta_id","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacetasArquivos"}}}},"403":{"description":"Sem o escopo arquivos:read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Filtros inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/arquivos/zip":{"post":{"tags":["Arquivos"],"summary":"Baixa vários arquivos num .zip","description":"Os mesmos filtros da lista, no corpo (JSON). Ou só as linhas marcadas (`chaves`). Limite por download: 500 arquivos ou 1 GB — passou, `413 limite_zip` com a contagem (filtre um período menor). Dentro do .zip vem UMA pasta, com o `nome` pedido, e todos os arquivos direto nela (nome repetido ganha \" (2)\"); pasta da equipe mantém as subpastas. Arquivo que não puder ser lido entra num LEIA-ME dentro do .zip. Com `somente_conferir: true`, devolve só `{ arquivos, bytes }`.","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PedidoZip"}}}},"responses":{"200":{"description":"O .zip (ou, com `somente_conferir`, a contagem em JSON)","content":{"application/zip":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/ConferenciaZip"}}}},"403":{"description":"Sem o escopo arquivos:read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Nenhum arquivo com esses filtros","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Passou de 500 arquivos ou 1 GB","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Filtros inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/arquivos/{id}":{"get":{"tags":["Arquivos"],"summary":"Um arquivo, com link de download","description":"Dados do arquivo + `url` assinada, válida por 60 minutos. Peça de novo para um link novo.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":false,"name":"company_id","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArquivoDetalhe"}}}},"403":{"description":"Sem o escopo arquivos:read","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Não encontrado (ou fora das regras: outra empresa, uso interno, módulo desligado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/anexos/{id}/ver":{"get":{"tags":["Anexos"],"summary":"Visualiza um anexo (link do preview_url)","description":"Link fixo de visualização que vem no `preview_url` de anexos de imagem/PDF (30 dias, enquanto a chave estiver ativa). Não leva Authorization: quem autoriza é o token `t`. Redireciona (302) para um link curto do arquivo. Token inválido, chave revogada/sem escopo ou anexo fora das empresas da chave → 404 genérico; vencido → 410 link_expirado.","parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Token assinado que vem pronto no preview_url."},"required":true,"name":"t","in":"query"}],"responses":{"302":{"description":"Redireciona para o arquivo (link do Storage válido por 5 min)."},"404":{"description":"Não encontrado (não diz o motivo)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"link_expirado — pegue um preview_url novo no GET /mensagens ou /anexos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}