Onde Ficam os Comprovantes Anexados
Como os comprovantes de nota enviados no hotsite são guardados e publicados e por que essa solução é provisória
O que e?
É a decisão técnica (ADR-004, aceita e revisada em outubro de 2026) sobre onde ficam as fotos e PDFs de nota que o participante anexa no hotsite. Eles são gravados numa pasta persistente do servidor e abertos pelo endereço do próprio site (/files/Campanhas/nome-da-campanha/...). A API recebe só o endereço do arquivo.
Como funciona?
- Cada arquivo recebe um nome aleatório e fica guardado de forma permanente. As publicações de novas versões não apagam a pasta.
- Antes de gravar, o site confere tamanho (até 10 MB), formato (JPG, PNG ou PDF) e o conteúdo real do arquivo. Arquivo com extensão trocada é recusado.
- Pedir a lista de arquivos da pasta não funciona: só abre quem tem o endereço exato.
- A API só confere se o endereço do arquivo tem formato válido. Se a pasta não estiver publicada corretamente, a nota é aceita, o número sai, e o comprovante não abre. Por isso abrir um comprovante faz parte do teste após cada publicação.
- A solução é provisória. Ela existe porque a API ainda não recebe o arquivo do participante. Quando a API ganhar o envio de arquivos com armazenamento privado, este caminho será substituído.
Como explicar ao cliente?
Os comprovantes enviados pelos participantes ficam armazenados de forma permanente e servem para a conferência e a auditoria da campanha. O site aceita só formatos seguros (JPG, PNG e PDF) e confere o conteúdo de cada arquivo antes de guardar.
Possiveis falhas, causas e solucoes
- Falha: o comprovante de uma nota aceita não abre (erro 404).
- Possivel causa: a pasta de comprovantes não está publicada no servidor ou o endereço configurado para os arquivos está errado.
- Como orientar: registre o CPF e o número da nota. O participante não precisa reenviar se a nota já foi aceita.
- Quando escalar: acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV), porque afeta a auditoria do sorteio.
- Falha: o anexo é recusado no envio.
- Possivel causa: arquivo acima de 10 MB, formato diferente de JPG, PNG ou PDF ou extensão trocada.
- Como orientar: oriente salvar a foto em JPG ou tirar um print da nota e anexar de novo.
- Quando escalar: se arquivos válidos forem recusados, abrir issue no Jira (projeto DEV).
Exemplo de resposta pronta
Olá! O comprovante que você anexou fica guardado com segurança junto da sua nota. Para o envio, use uma foto em JPG ou PNG, ou um arquivo PDF, de até 10 MB. Se a sua nota já aparece em "Minha participação", não é preciso enviar de novo.
Quando escalar?
Acione urgentemente o time de desenvolvimento e abra issue no Jira (projeto DEV) quando comprovantes de notas aceitas não abrirem, quando arquivos sumirem depois de uma publicação ou quando o envio de anexos falhar para todos. Envie o link da campanha, o CPF, o número da nota e o horário.
Artigos relacionados
Campos e anexo e validações e mensagens da tela Cadastrar Compra do hotsite
Onde o hotsite roda e como novas versões são publicadas e o que conferir quando algo sai do ar
Resumo das decisões técnicas registradas do hotsite e o efeito prático de cada uma no atendimento