Protocolo e canais de ingestão
Para que serve
O módulo de Protocolos (processamento inteligente de documentos) organiza a entrada de documentos na sua empresa. Fornecedores, clientes ou a sua própria equipe enviam arquivos (notas, boletos, contratos, currículos); cada envio recebe um número de protocolo, os arquivos são lidos, o tipo de documento é identificado, os dados são extraídos e o protocolo pode ser vinculado a um registro do Tesselys, como um lançamento financeiro ou uma pessoa.
Onde fica
| Tela | Onde fica | Para que serve |
|---|---|---|
| Canal de Ingestão | Sistema › Configurações › Canal de Ingestão | Criar e configurar os canais por onde os documentos entram |
| Protocolo | Ferramentas › Protocolo | Acompanhar cada documento recebido, revisar dados e vincular a registros |
A seção Ferramentas mostra só 5 itens: se Protocolo não aparecer, procure em Ferramentas › Ver todos.
Antes de começar
- O plano da empresa precisa incluir Protocolos.
- O seu perfil precisa das permissões da tela Canal de Ingestão (para configurar) e da tela Protocolo (para acompanhar). Vincular e reprocessar exigem permissões especiais (veja Regras importantes).
- Para restringir quem envia, cadastre antes as empresas ou pessoas autorizadas em Cadastros › Pessoa.
Por onde os documentos chegam
Todo protocolo nasce em um canal. Um mesmo canal pode receber documentos de mais de uma origem:
| Origem | Como funciona |
|---|---|
| Portal do canal | Cada canal tem uma página pública (.../protocol/<slug-do-canal>) onde quem tem o link envia os arquivos. |
| Uma caixa do e-mail inbound pode criar protocolos no canal escolhido, automaticamente ou quando o e-mail não traz marcador de ação. |
Passo a passo: configurar um canal
- Em Sistema › Configurações › Canal de Ingestão, clique em Novo.
- Preencha as seções do formulário. Use Preview do Portal para ver como a página pública vai aparecer.
- Salve.
- No menu ⋮ do canal, cadastre os Tipos de Documentos aceitos.
- Se quiser restringir quem envia, use Vincular Pessoas.
- Envie o link do portal do canal para quem vai mandar documentos.
| Seção | Campos |
|---|---|
| Informações Básicas | Nome (aparece no portal; ex.: "Portal Fornecedores"), Slug (endereço do portal, gerado a partir do nome; só letras minúsculas, números e hífens, e não pode repetir) e Descrição. |
| Configurações de Arquivos | Tipos de Arquivo Permitidos (PDF, PNG, JPEG, TIFF, Word, Excel, XML, CSV, TXT; ao menos um), Tamanho Máximo por Arquivo (MB) (padrão 10), Máximo de Arquivos por Upload (padrão 10). |
| Configurações e Permissões | Permitir Acesso Anônimo, Habilitar OCR, Classificação Automática, Vinculação Automática e Limite de Requisições por Minuto (padrão 60). |
| Configurações Visuais do Portal | Cor Primária, Mensagem de Boas-Vindas, Mensagem de Sucesso e URL do Logo (vazio usa o logo da empresa). |
| Usuários Responsáveis pelo Canal | Usuários avisados de tudo o que acontece no canal: documentos novos, falhas e protocolos aguardando revisão. |
O que cada opção de processamento faz:
| Opção | Ligada | Desligada |
|---|---|---|
| Habilitar OCR | O sistema lê o texto dos arquivos (PDFs, fotos, documentos escaneados). É necessária para a classificação e a extração de dados funcionarem. | Os arquivos são guardados sem leitura. |
| Classificação Automática | O sistema identifica o tipo de cada documento (nota fiscal, boleto, contrato…). | O tipo é escolhido por quem envia ou por um administrador. |
| Vinculação Automática | O sistema procura o registro correspondente (ex.: o pedido de compra ou o lançamento da nota). | O vínculo é feito à mão pelo responsável. |
| Permitir Acesso Anônimo | Qualquer pessoa com o link envia, sem se identificar com CNPJ (útil para "Envie seu currículo" ou "Ouvidoria"). | Só quem está autorizado envia. |
Na edição aparecem também o campo Ativo (canal inativo não aceita envios) e a API Key do canal, só para consulta.
Ações de cada canal
No menu ⋮ da linha do canal:
| Ação | Para que serve |
|---|---|
| Tipos de Documentos | Cadastra os tipos aceitos no canal e como cada um é tratado (veja abaixo). |
| Gerenciar Responsáveis | Adiciona ou remove usuários avisados sobre o canal. Só entram usuários com permissão de leitura e escrita nesta funcionalidade. |
| Vincular Pessoas | Define as Pessoas Autorizadas: empresas ou pessoas, já cadastradas em Cadastros, que podem enviar pelo canal. No portal, o sistema confere o CNPJ informado. Se a lista ficar vazia, qualquer pessoa acessa o canal identificando-se só pelo e-mail. |
| Excluir | Inativa o canal. |
Tipos de documentos
Para cada tipo (ex.: "Nota fiscal de serviço", "Boleto"):
| Campo | Para que serve |
|---|---|
| Nome, Descrição, Ícone, Ordem | Como o tipo aparece no portal. |
| Modo de entrada | Exige anexo (arquivo, com OCR e extração) ou só campos preenchidos, sem arquivo (ex.: link do LinkedIn, link de uma pasta). |
| Campos Customizados | Campos extras do formulário de envio no portal (texto, número, data, arquivo), obrigatórios ou não. Opcionais. |
| Template de Extração | Modelo de campos que o sistema extrai do documento. Há modelos em vários idiomas; se nenhum servir, escolha "personalizado" e defina os campos. |
| Habilitar Vínculo Automático | O que fazer quando chega um documento desse tipo: vincular a um registro existente ou criar um novo (pessoa, lançamento financeiro, negócio, serviço, pedido de compra, assinatura, contrato ou proposta), como procurar o registro (por campo extraído, campo customizado, pessoa remetente ou registro fixo), o que fazer se não achar (Deixar Pendente ou Revisão Manual), se cria a pessoa quando ela não existe e se exige CNPJ/CPF do remetente. Com Modo Estrito, o protocolo fica bloqueado se o vínculo automático não for possível. |
Como o remetente envia pelo portal
- Abre o link do canal e informa o e-mail. Quando o canal não é anônimo, informa também o CPF ou CNPJ da pessoa ou empresa autorizada a enviar (não necessariamente o próprio documento).
- Recebe um código de 6 dígitos no e-mail, válido por 10 minutos, e confirma.
- Escolhe o tipo de documento, anexa os arquivos e envia.
- Recebe o número do protocolo, no formato
PROT-AAAA-NNNNNN, e um e-mail "Protocolo recebido com sucesso". Quando o processamento termina, ele é avisado por e-mail de novo.
Depois, o remetente pode consultar a situação do envio na página do canal, informando o número do protocolo, o mesmo e-mail do envio e, se o canal exigir, o CPF/CNPJ autorizado.
Acompanhando protocolos
A tela Protocolo lista os documentos recebidos com número, remetente, status e data. Por padrão mostra os últimos 7 dias; você pode trocar para 30 ou 60 dias ou um período personalizado. Os filtros rápidos separam Processando, Validados, Falhas, Vinculados e Aguardando revisão, e a busca procura por protocolo, canal e tipo.
Status do protocolo
| Status | O que significa |
|---|---|
| Recebido | O documento entrou e aguarda processamento |
| Analisando | Os arquivos passam por verificação de segurança (antivírus) |
| Processando | Leitura do texto, identificação do tipo e extração dos dados |
| Aguardando revisão | Precisa de conferência ou de vínculo feito por uma pessoa |
| Concluído | Processamento terminado |
| Falhou | Houve erro e o documento precisa de atenção |
Se o processamento não avança por mais de 10 minutos, a tela avisa Processamento demorando. Se ficar 30 minutos parado, o sistema interrompe o processamento e libera Reprocessar.
Detalhe do protocolo
Ao abrir um protocolo, você vê as informações do envio (número, tipo de documento, canal, remetente, e-mail, datas e registro vinculado), os Dados Extraídos com o grau de confiança, os Documentos Enviados (com Visualizar, Baixar e Ver OCR) e a Timeline de Eventos com cada passo do processamento.
Arquivos bloqueados pela verificação antivírus não podem ser baixados.
Ações sobre o protocolo
| Ação | Quando aparece | Permissão |
|---|---|---|
| Editar dados | Depois da extração, com o protocolo Concluído, Aguardando revisão ou Falhou e ainda não vinculado. Se o protocolo já estiver vinculado, a edição não altera o registro vinculado. | Editar protocolo |
| Vincular Registro | Protocolo Concluído ou Aguardando revisão, sem vínculo. Você escolhe vincular a um registro existente ou criar um novo com os dados extraídos; a tela só mostra as combinações permitidas para o tipo de documento. | Gerenciar vínculo de protocolo |
| Desvincular | Protocolo concluído e vinculado. | Gerenciar vínculo de protocolo |
| Descartar e pedir reenvio | Protocolo vinculado a um lançamento financeiro, quando o documento estava errado. Se o protocolo criou o lançamento, ele é inativado (não é possível se já houver baixa); se o lançamento já existia, só o anexo é removido. Opcionalmente envia um e-mail ao remetente pedindo o arquivo correto. | Gerenciar vínculo de protocolo |
| Reenfileirar | Protocolo Recebido que não começou a ser processado. | Gerenciar processos de protocolo |
| Reprocessar | Protocolo que falhou, concluído sem vínculo ou parado há mais de 30 minutos. Os documentos voltam à extração. | Gerenciar processos de protocolo |
| Excluir | Qualquer protocolo que não esteja concluído e vinculado. O protocolo fica inativo e só pode ser consultado. | Excluir protocolo |
Protocolos que vieram do Smart Email têm ações próprias, como Revisar simulação, Completar manualmente e Cancelar Smart Email. Veja E-mail inbound (Smart Email).
Regras importantes
Canais
| Regra | Detalhe |
|---|---|
| Nome e slug únicos | Não pode haver dois canais com o mesmo slug, nem dois canais ativos com o mesmo nome, na empresa. A tela avisa "Já existe … com este slug cadastrado para esta empresa" ou "Registro duplicado" |
| Tipos de arquivo | Pelo menos um tipo precisa estar marcado |
| Limites | Tamanho por arquivo, arquivos por envio e requisições por minuto têm mínimo de 1 |
| Canal inativo | Não aceita envios e não pode ser editado |
Envios
| Situação | O que o remetente vê |
|---|---|
| Nenhum arquivo | "Nenhum arquivo enviado. É necessário enviar pelo menos um arquivo." (exceto em tipos de documento só com campos) |
| Arquivos demais | "Quantidade máxima de arquivos excedida. O limite é de N arquivo(s) por envio." |
| Arquivo grande demais | "Arquivo excede o tamanho máximo permitido." |
| Tipo de arquivo não aceito | "Tipo de arquivo não permitido." |
| Código errado ou vencido | "Código de verificação inválido ou expirado. Tente novamente." |
| CPF/CNPJ fora da lista | "O documento informado não está vinculado a nenhuma empresa autorizada neste canal." |
Permissões
| O que | Onde se define |
|---|---|
| Ver, editar e excluir protocolos | Permissões da tela Protocolo no perfil de acesso |
| Vincular, desvincular, descartar e pedir reenvio | Permissão especial Gerenciar vínculo de protocolo |
| Reprocessar e reenfileirar | Permissão especial Gerenciar processos de protocolo |
| Criar, editar e excluir canais | Permissões da tela Canal de Ingestão no perfil de acesso |
As permissões são configuradas em Permissões e papéis.
Avisos para outros sistemas
Os eventos de protocolo (recebido, mudança de status, processamento concluído ou com falha, vinculado e desvinculado) podem ser enviados a sistemas externos por Webhooks.
Perguntas frequentes
Posso mudar o formato do número de protocolo?
Não. O número é gerado pelo sistema no formato PROT-AAAA-NNNNNN.
Protocolos podem ser apagados?
O Excluir deixa o protocolo inativo: ele sai da lista padrão (o filtro Somente ativos vem ligado), mas continua consultável com a linha do tempo preservada. Protocolos concluídos e vinculados não podem ser excluídos; desvincule antes.
Posso registrar na mão um documento que recebi em papel?
A tela de Protocolo não tem cadastro manual. Digitalize o documento e envie pelo portal do canal ou por uma caixa do e-mail inbound.
O vínculo automático não encontrou o registro. E agora?
Depende do tipo de documento: com Deixar Pendente ou Revisão Manual, o protocolo aguarda alguém usar Vincular Registro. Com Modo Estrito, o protocolo fica bloqueado até a situação ser resolvida.
Tentei vincular e apareceu que o protocolo já tem um registro vinculado.
Cada protocolo tem um vínculo só. Use Desvincular e depois Vincular Registro de novo.
O botão Reprocessar não aparece.
Ele só aparece quando o protocolo falhou, foi concluído sem vínculo ou está parado há mais de 30 minutos, e para quem tem a permissão Gerenciar processos de protocolo.
Não consigo descartar e pedir reenvio.
Essa ação só vale para protocolos vinculados a lançamento financeiro e precisa de um e-mail de remetente registrado no protocolo. Se o lançamento criado já tiver baixa, ele não pode ser inativado.
A nossa equipe ajuda você a configurar e usar esse recurso.