Guia Arquivos (PDF)

Arquivos do produto (`files`)

⚠️ FUNCIONALIDADE EM DESENVOLVIMENTO. O campo ainda não está disponível. Esta seção será atualizada quando o recurso for liberado.

Permite enviar arquivos PDF relacionados ao produto, como manuais, fichas técnicas e certificados. Os arquivos são exibidos na loja B2B, na área Informações Adicionais / Arquivos do produto.

Regras do campo

Obrigatório: não.

Formato: lista de arquivos. Cada arquivo tem name e content.

name: nome do arquivo com extensão, ex.: "manual.pdf".

content: conteúdo do PDF codificado em base64.

Tipo aceito: somente PDF.

Limite: até 40 MB por produto, somando todos os arquivos.

Ordem: a ordem dos arquivos na lista define a ordem de exibição na loja.

Não enviado: mantém os arquivos já cadastrados.

Lista vazia ([]): remove todos os arquivos do produto.

Lista preenchida: substitui todos os arquivos do produto pelos enviados. Para manter um arquivo existente, envie-o novamente junto com os novos.

Rotas que utilizam o campo

POST /products: em cada produto de data.

PUT /products/{product_key}: na raiz do corpo.

Exemplo — POST /products

{
    "data": [
        {
            "code": "001",
            "name": "Produto 001",
            "files": [
                {
                    "name": "manual.pdf",
                    "content": "JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI..."
                },
                {
                    "name": "ficha-tecnica.pdf",
                    "content": "JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI..."
                }
            ]
        }
    ]
}

Exemplo — PUT /products/{product_key} removendo todos os arquivos

{
    "files": []
}

Dúvidas frequentes

Preciso enviar os arquivos em toda atualização do produto?
Não. Se files não for enviado, os arquivos atuais são mantidos.

Como adiciono um arquivo sem perder os que já existem?
Envie a lista completa: os arquivos atuais e o novo. Toda lista enviada substitui os arquivos do produto.

Como removo um único arquivo?
Envie a lista sem esse arquivo.

Arquivos do produto (files)#

Regras do campo#

Rotas que utilizam o campo#

Exemplo — POST /products#

Arquivos do produto (`files`)

Regras do campo

Rotas que utilizam o campo

Exemplo — POST /products