O Document Wake é o recurso da plataforma que permite aos lojistas criar e guardar dados estruturados no e-commerce. Até então, a funcionalidade suportava apenas o armazenamento de texto. Quando a operação precisava vincular um arquivo (como um PDF de ficha técnica, manual de instruções ou foto adicional) a um registro, era necessário hospedar a mídia em um servidor próprio (externo) e salvar apenas a URL pública na Wake.
Essa limitação gerava dois grandes impactos: o custo financeiro e a complexidade de manter uma infraestrutura externa de hospedagem, além do risco de dessincronização onde o link poderia quebrar ou o arquivo ser removido na origem sem que o registro no e-commerce fosse atualizado.
A partir de agora, a Wake assume a hospedagem e a gestão desse vínculo de ponta a ponta. Cada registro do Document Wake pode receber um arquivo diretamente via API.
O que muda na prática?
- Envio Unificado via API: O arquivo é enviado na mesma requisição de criação ou edição do registro (através das chamadas documentCreate e documentUpdate em formato multipart).
- Formatos Suportados e Tamanho: O recurso aceita os formatos PDF, JPG, JPEG, PNG, GIF e WEBP, com limite de até 5 MB (1 arquivo por registro).
- Gestão e Limpeza Automática: Ao atualizar o arquivo, a URL antiga é instantaneamente substituída. Da mesma forma, se o registro for deletado, o arquivo correspondente é removido do nosso storage, garantindo a limpeza do ambiente.
- Retorno da URL Pública: Ao consultar o registro por ID, a plataforma retorna a URL pública da mídia e a data de envio no campo files.
Pontos de Atenção:
- Acesso Público: A URL gerada para o arquivo é pública, portanto, a funcionalidade não deve ser utilizada para o armazenamento de documentos confidenciais ou com dados sensíveis (alinhado à nossa Política de Classificação da Informação).
- Busca em Lote (documentsSearch): Por questões de performance, a busca em lote via API não retorna a propriedade files preenchida. Para recuperar a URL do arquivo, o integrador deve realizar a consulta individual baseada no ID do registro.
Principais Benefícios:
- Redução de Custos e Complexidade: A loja elimina a necessidade de pagar ou gerenciar repositórios externos de arquivos (como AWS S3, Google Drive, entre outros) para dados complementares do catálogo.
- Mais Eficiência no Storefront: Facilita significativamente a exibição de manuais, guias de medidas, certificados e fichas técnicas diretamente na vitrine.
- Eliminação do Risco de Link Quebrado: O dado em texto e o arquivo vinculado nascem, são modificados e removidos juntos, garantindo total integridade dentro do ecossistema da plataforma.
Ainda sobrou alguma dúvida ou quer entender todos os detalhes de configuração e começar a aplicar agora mesmo? Confira o passo a passo completo na nossa documentação oficial:
Publicado em 04/11/2026
Comentários
0 comentário
Por favor, entre para comentar.