# Que documentos enviar para a Dri e como escrevê-los

> Para o administrador: que documentos enviar para a base de conhecimento da Dri, os formatos aceitos, o tipo certo e como escrevê-los.

Fonte: https://vendria.com/ajuda/o-que-enviar-para-a-base-da-dri

## Onde fica

No menu da sua conta, em **Conhecimento da Dri**, aba **Documentos**, botão
**Subir documento**. É lá que você escolhe o arquivo, o **Título (opcional)**, o
**Tipo** e a **Origem** de cada documento.

## Quais formatos de arquivo a base da Dri aceita

A janela **Subir documento** aceita:

- **PDF**: com texto ou escaneado;
- **Word** (.docx);
- **planilha** (.xlsx);
- **texto** (.csv, .txt, .md) e **HTML**;
- **imagem** (PNG, JPEG, WEBP).

Cada arquivo pode ter **até 20 MB**, e a organização pode ter **até 200
documentos** na base. Passou disso, a tela recusa o envio e diz o motivo.

Arquivo **.md** ou **.txt** também pode virar página da **Central de Ajuda**,
como o texto escrito na tela: abra o documento e use **Publicar na Central de
Ajuda**. Ele precisa estar salvo em UTF-8 e ter até 100 mil caracteres. PDF,
Word, planilha e imagem a Dri lê, mas não viram página.

Você também pode **arrastar** o arquivo para a lista de **Documentos**: a janela
**Subir documento** abre com ele já escolhido.

## O arquivo .md que já vem classificado

Um arquivo .md ou .txt pode trazer, no topo, um cabeçalho com a classificação
dele. Assim você não escolhe nada na janela: arrasta, clica em **Subir**, e o
documento entra classificado (e publicado, se o cabeçalho pedir).

```
---
titulo: Pedidos e integração com o ERP
tipo: perguntas-frequentes
origem: curado
quem_pode_ler: equipe-de-vendas
publicar: sim
---

## Vocês enviam o pedido para o ERP?

Sim. ...
```

- **titulo**: o título do documento.
- **tipo**: organizacional, politica-comercial, ficha-tecnica,
  perguntas-frequentes ou outro.
- **origem**: coletado ou curado.
- **quem_pode_ler**: todos, equipe-de-vendas ou administradores.
- **publicar**: sim ou nao (publica na **Central de Ajuda** ao subir). Com
  **sim**, a linha **quem_pode_ler** é obrigatória.

Todas as linhas são opcionais; o que faltar segue a escolha da janela. O que o
cabeçalho diz vale mais que a janela, e a janela mostra o que ele já decidiu. O
modelo também está na própria janela, em **Ver modelo de cabeçalho**.

Para mudar quem pode ler ou a publicação de um documento que já subiu, corrija o
cabeçalho e arraste o mesmo arquivo de novo: o texto igual não vira outro
documento, e o que o cabeçalho diz sobre **quem_pode_ler** e **publicar** é
aplicado ao que já existe.
O arquivo com cabeçalho precisa estar salvo em **UTF-8**: fora dele, o
cabeçalho não pode ser lido e o envio é recusado (no Bloco de Notas, use
**Salvar como** e escolha a codificação UTF-8).
Uma chave ou um valor que a tela não conhece faz o envio ser recusado, com a
linha do erro: um cabeçalho lido pela metade subiria o documento para quem não
devia ler. O cabeçalho não entra no texto: a Dri não o lê e a página não o mostra.

PDF escaneado e imagem são lidos por visão: o texto que aparece na página é
transcrito como está, não interpretado. ⚠️ Num PDF escaneado muito longo, só as
**primeiras 30 páginas** são transcritas: se o material importante está no fim,
divida o arquivo ou envie a versão com texto (exportada do Word, não digitalizada).

## Subir vários arquivos .md de uma vez, num .zip

Para subir muitos textos de uma vez, junte os arquivos .md ou .txt num **.zip**
e suba o .zip pela mesma janela **Subir documento** (ou arraste-o para a lista
de **Documentos**). Cada arquivo de dentro do .zip entra como um documento
separado, com a classificação do próprio cabeçalho.

- Até **50 arquivos** por .zip, e até 20 MB no total.
- Só entram arquivos **.md** e **.txt**. PDF, Word, planilha e imagem dentro do
  .zip aparecem como ignorados: suba esses um por vez, pela janela.
- Arquivo **sem cabeçalho** usa o **Tipo** e a **Origem** escolhidos na janela,
  e o título é o primeiro `# Título` do texto (ou o nome do arquivo).
- Um arquivo recusado (um cabeçalho com erro, por exemplo) não impede os
  outros de entrar.

Depois do envio, a janela mostra o que aconteceu com cada arquivo: **Entrou**
(e se foi publicado na **Central de Ajuda**), **Já estava na base**,
**Recusado** ou **Ignorado**, com o motivo.

Mandar o mesmo .zip de novo é seguro: o texto que já estava na base não vira
documento repetido, e o que o cabeçalho diz sobre **quem_pode_ler** e
**publicar** é aplicado de novo. Para mudar só quem lê ou a publicação, corrija
o cabeçalho e suba o .zip inteiro outra vez.

Corrigir o **texto** é diferente: o arquivo com o texto mudado entra como um
documento novo, e o antigo continua na base (e publicado, se estava). Quando já
existe outro documento com o mesmo título, a linha do relatório avisa: remova o
antigo pela lista de **Documentos**.

**Como organizar a pasta antes de compactar:**

1. Uma pasta por conjunto (por exemplo, a empresa ou o assunto), com **um
   arquivo por assunto**: um sobre pedidos e ERP, outro sobre condições
   comerciais, outro sobre cadastro de cliente. Arquivo curto e de um assunto
   só responde melhor que um arquivo enorme.
2. **Todo arquivo com cabeçalho completo**, dizendo quem pode ler. Assim nada
   depende do que estiver escolhido na janela.
3. Nome de arquivo simples, sem acento, que diga o assunto
   (`pedidos-e-erp.md`). O nome aparece no relatório do envio.
4. Antes de publicar para **todos**, confira se o texto não tem nada que o
   comprador não deva ler: preço negociado, desconto, crédito de cliente,
   contato pessoal.

## Formatos que a base ainda não lê, e o que fazer

A tela recusa na hora, com a receita do que fazer:

| arquivo | o que fazer |
|---|---|
| Word ou Excel antigo (.doc, .xls, .ppt) | abra no Word/Excel e salve como PDF, .docx ou .xlsx |
| foto de iPhone em HEIC | exporte como JPEG ou PNG |
| .rtf | salve como PDF ou .docx |
| apresentação (.pptx) | exporte os slides como PDF |
| arquivo compactado (.zip) com PDF, Word ou imagem | suba esses documentos um por vez; .zip só leva .md e .txt |

Subir o **mesmo arquivo** duas vezes não duplica nada: a tela avisa **"Este
arquivo já está na base: nada mudou."**

## Que tipo de documento vale a pena enviar

A base da Dri é para o que é **durável e específico da sua empresa**: o que um
cliente pergunta e a resposta não muda de uma semana para outra:

- política de frete, prazos de entrega por região, pedido mínimo;
- filiais, endereços, horários, quem atende o quê;
- condições de pagamento, garantia, troca e devolução;
- políticas de desconto que não têm prazo, escritas como **Curado**;
- fichas técnicas e compatibilidade de produtos;
- perguntas frequentes que a equipe já responde de cabeça.

## O que não adianta enviar para a base da Dri

- **Preço de produto, estoque e promoção com prazo.** A leitura separa esses
  trechos de propósito, na gaveta **Volátil**: guardados, virariam resposta com o
  número de ontem. A Dri nunca informa preço de produto ou estoque a partir da
  base: isso vem do catálogo, das tabelas de preço e do ERP.
- **O catálogo de produtos.** Cadastro de produto entra pela importação de
  catálogo, não aqui. Ver [Importar o catálogo por planilha](/ajuda/importar-catalogo-por-planilha).
- **Material de propaganda sem fato.** Slogan e texto institucional viram
  **Ruído** e não respondem pergunta nenhuma.

## Como escolher o Tipo do documento

O **Tipo** muda como o texto é lido **e onde a Dri procura**:

| Tipo | quando usar |
|---|---|
| **Organizacional** | filiais, departamentos, responsáveis, prazos de entrega |
| **Política comercial** | regras de frete, desconto, pagamento, devolução |
| **Ficha técnica** | especificações e compatibilidade de produtos |
| **Perguntas frequentes** | perguntas e respostas já escritas |
| **Outro** | quando nenhum dos acima descreve |

Quando um cliente faz uma pergunta **técnica**, a Dri procura nas fichas
técnicas e nas perguntas frequentes. Quando a pergunta é **comercial ou sobre a
empresa** (prazo, frete, pagamento, filial), ela procura nas políticas
comerciais, nos documentos organizacionais e nas perguntas frequentes.

⚠️ Um documento do tipo **Outro** fica fora dessas duas buscas e só é consultado
quando a pergunta não se encaixa claramente em nenhuma delas. Prefira sempre um
tipo específico. **Perguntas frequentes** entra nas duas buscas.

## Coletado ou Curado: qual Origem escolher

- **Coletado** (o padrão): material que já existia: catálogo de fornecedor,
  manual de fabricante, apresentação comercial. A leitura é mais rigorosa: o que
  ela não souber classificar vai para **Revisar**.
- **Curado**: texto que a sua empresa escreveu para esta finalidade. A leitura
  é mais permissiva (na dúvida, vira fato) e ele **ganha a preferência** quando
  contradiz um documento coletado.

Num documento **Curado**, uma **política comercial sem prazo** vai para
**Fato**, mesmo com percentual ou valor: "pedidos lançados pelo site levam 10% de
desconto geral", pedido mínimo, condição de pagamento. A Dri diz a regra como
ela está escrita. Com prazo ("10% até sexta"), o trecho vai para **Volátil**. Num
documento **Coletado** a leitura é mais rigorosa, e todo desconto vai para
**Volátil**.

Use **Curado** só no que foi de fato escrito para a Dri. Se tudo for curado,
todos os pesos se igualam e nenhuma contradição se resolve sozinha. Ver [Conflitos da base: quando dois documentos discordam](/ajuda/conflitos-da-base).

## Como escrever um documento para a Dri responder bem

1. **Um assunto por seção, com título.** Use os títulos do Word (Título 1,
   Título 2) ou `#` num arquivo .md. O título acima de cada trecho é o que diz à
   leitura do que ele fala: o mesmo endereço sob "Showroom" e sob "Filial Rio"
   são coisas diferentes.
2. **Frases completas, com o sujeito.** "O frete é grátis para pedidos acima de
   R$ 800 nas capitais do Sudeste" responde sozinho; "acima de 800, grátis" não.
3. **Condição e exceção juntas.** "Entregamos em 3 dias úteis, exceto em
   feriados regionais". Separar as duas em páginas diferentes faz a Dri
   responder só a metade.
4. **Um valor por assunto.** Se o prazo mudou, atualize o documento e remova o
   antigo; dois documentos com prazos diferentes viram conflito.
5. **Em ficha técnica, escreva o código do produto exatamente como no
   catálogo.** Quando o código bate com um produto de alguma loja da
   organização, a especificação passa a enriquecer aquele produto; código
   diferente ou aproximado fica só como conhecimento geral.
6. **Em planilha, a primeira linha de cada aba é o cabeçalho.** O nome da aba
   vira o título do bloco, e cada tabela é lida inteira: sem cabeçalho, uma
   linha como "Salvador | BA | 3 dias" não significa nada.

## Perguntas comuns

**Posso mandar o mesmo PDF para várias lojas?** Não precisa: a base é da
organização inteira, e a Dri usa o mesmo documento para todas as lojas.

**Mandei um documento com preços. Ele vai atrapalhar?** Não. Os trechos de preço
vão para **Volátil** e ficam de fora; o resto do documento entra normalmente.

**Corrigi o arquivo. Como atualizo?** Suba a versão nova e remova a antiga. O
botão de reprocessar relê o arquivo **original** guardado, não um arquivo novo.
Ver [Depois do envio: o processamento e o detalhe de um documento](/ajuda/depois-do-envio-processamento-de-um-documento).