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

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:

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.
• 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:

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.

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.