Pular para o conteúdo principal

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​

TelaOnde ficaPara que serve
Canal de IngestãoSistema › Configurações › Canal de IngestãoCriar e configurar os canais por onde os documentos entram
ProtocoloFerramentas › ProtocoloAcompanhar 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:

OrigemComo funciona
Portal do canalCada canal tem uma página pública (.../protocol/<slug-do-canal>) onde quem tem o link envia os arquivos.
E-mailUma 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​

  1. Em Sistema › Configurações › Canal de Ingestão, clique em Novo.
  2. Preencha as seções do formulário. Use Preview do Portal para ver como a página pública vai aparecer.
  3. Salve.
  4. No menu ⋮ do canal, cadastre os Tipos de Documentos aceitos.
  5. Se quiser restringir quem envia, use Vincular Pessoas.
  6. Envie o link do portal do canal para quem vai mandar documentos.
SeçãoCampos
Informações BásicasNome (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 ArquivosTipos 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õesPermitir 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 PortalCor Primária, Mensagem de Boas-Vindas, Mensagem de Sucesso e URL do Logo (vazio usa o logo da empresa).
Usuários Responsáveis pelo CanalUsuá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çãoLigadaDesligada
Habilitar OCRO 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áticaO sistema identifica o tipo de cada documento (nota fiscal, boleto, contrato…).O tipo é escolhido por quem envia ou por um administrador.
Vinculação AutomáticaO 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ônimoQualquer 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çãoPara que serve
Tipos de DocumentosCadastra os tipos aceitos no canal e como cada um é tratado (veja abaixo).
Gerenciar ResponsáveisAdiciona ou remove usuários avisados sobre o canal. Só entram usuários com permissão de leitura e escrita nesta funcionalidade.
Vincular PessoasDefine 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.
ExcluirInativa o canal.

Tipos de documentos​

Para cada tipo (ex.: "Nota fiscal de serviço", "Boleto"):

CampoPara que serve
Nome, Descrição, Ícone, OrdemComo o tipo aparece no portal.
Modo de entradaExige anexo (arquivo, com OCR e extração) ou só campos preenchidos, sem arquivo (ex.: link do LinkedIn, link de uma pasta).
Campos CustomizadosCampos extras do formulário de envio no portal (texto, número, data, arquivo), obrigatórios ou não. Opcionais.
Template de ExtraçãoModelo 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áticoO 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​

  1. 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).
  2. Recebe um código de 6 dígitos no e-mail, válido por 10 minutos, e confirma.
  3. Escolhe o tipo de documento, anexa os arquivos e envia.
  4. 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​

StatusO que significa
RecebidoO documento entrou e aguarda processamento
AnalisandoOs arquivos passam por verificação de segurança (antivírus)
ProcessandoLeitura do texto, identificação do tipo e extração dos dados
Aguardando revisãoPrecisa de conferência ou de vínculo feito por uma pessoa
ConcluídoProcessamento terminado
FalhouHouve 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çãoQuando aparecePermissão
Editar dadosDepois 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 RegistroProtocolo 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
DesvincularProtocolo concluído e vinculado.Gerenciar vínculo de protocolo
Descartar e pedir reenvioProtocolo 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
ReenfileirarProtocolo Recebido que não começou a ser processado.Gerenciar processos de protocolo
ReprocessarProtocolo que falhou, concluído sem vínculo ou parado há mais de 30 minutos. Os documentos voltam à extração.Gerenciar processos de protocolo
ExcluirQualquer 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​

RegraDetalhe
Nome e slug únicosNã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 arquivoPelo menos um tipo precisa estar marcado
LimitesTamanho por arquivo, arquivos por envio e requisições por minuto têm mínimo de 1
Canal inativoNão aceita envios e não pode ser editado

Envios​

SituaçãoO 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 queOnde se define
Ver, editar e excluir protocolosPermissões da tela Protocolo no perfil de acesso
Vincular, desvincular, descartar e pedir reenvioPermissão especial Gerenciar vínculo de protocolo
Reprocessar e reenfileirarPermissão especial Gerenciar processos de protocolo
Criar, editar e excluir canaisPermissõ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.

Ainda com dúvida?

A nossa equipe ajuda você a configurar e usar esse recurso.