ANPD SEI Integrations
    Preparing search index...

    Operações que alteram estado no SEI.

    Inclui criação de processos e documentos, movimentação, envio de e-mail, publicação, marcadores, controle de prazo e ouvidoria.

    Em aplicações que usam SeiClient, acesse via seiClient.operacoes.

    Index
    • Experimental

      Atribui um processo a um usuário da unidade.

      Parameters

      Returns Promise<string>

      Retorno textual do SEI (normalmente "1" em caso de sucesso).

      Esta operação ainda não foi validada de ponta a ponta contra um ambiente SEI real. Valide em homologação antes de usar em produção.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

    • Experimental

      Bloqueia um documento contra edição.

      Parameters

      Returns Promise<string>

      Retorno textual do SEI (normalmente "1" em caso de sucesso).

      O Web Service do SEI não expõe, nesta lib, operação simétrica de desbloqueio de documento — valide o fluxo com documento de teste.

      Esta operação ainda não foi validada de ponta a ponta contra um ambiente SEI real. Valide em homologação antes de usar em produção.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

    • Experimental

      Cancela um documento no processo, registrando o motivo.

      Parameters

      Returns Promise<string>

      Retorno textual do SEI (normalmente "1" em caso de sucesso).

      Operação sensível e sem reversão simples pelo Web Service — o documento permanece na árvore do processo com a tarja de cancelado.

      Esta operação ainda não foi validada de ponta a ponta contra um ambiente SEI real. Valide em homologação antes de usar em produção.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

    • Experimental

      Confirma a disponibilização/publicação de documentos em um veículo.

      Parameters

      Returns Promise<string>

      Retorno textual do SEI (normalmente "1" em caso de sucesso).

      Operação finalística e sem par simples de reversão no Web Service. Execute apenas com roteiro explícito de confirmação de publicação.

      Esta operação ainda não foi validada de ponta a ponta contra um ambiente SEI real. Valide em homologação antes de usar em produção.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

    • Envia um e-mail pelo SEI e gera o documento de e-mail correspondente no processo.

      Parameters

      • params: SeiEnviarEmailParams

        Unidade, protocolo do processo, remetente/destinatários, assunto, mensagem e documentos anexos.

      Returns Promise<
          | Readonly<
              { documentoFormatado: string; idDocumento: string; linkAcesso: string },
          >
          | null,
      >

      Protocolo do documento de e-mail gerado, ou null quando o SEI não retorna corpo.

      A operação dispara e-mail real pelo servidor do SEI. Em ambientes de teste, use apenas destinatários controlados.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

    • Experimental

      Tramita um processo para uma ou mais unidades.

      Parameters

      Returns Promise<string>

      Retorno textual do SEI (normalmente "1" em caso de sucesso).

      Por padrão o processo é fechado na unidade de origem; use sinManterAbertoUnidade: "S" para mantê-lo aberto. Também suporta retorno programado por data ou prazo em dias.

      Esta operação ainda não foi validada de ponta a ponta contra um ambiente SEI real (apenas a serialização/desserialização foi verificada). Valide em homologação antes de usar em produção.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

      await sei.operacoes.enviarProcesso({
      idUnidade: "110000001",
      protocoloProcedimento: "00000.000001/2026-01",
      unidadesDestino: ["110000002"],
      sinManterAbertoUnidade: "S",
      })
    • Experimental

      Exclui um documento.

      Parameters

      Returns Promise<string>

      Retorno textual do SEI (normalmente "1" em caso de sucesso).

      Operação destrutiva, sujeita às regras de exclusão do SEI (documento sem assinatura/tramitação, gerado pela própria unidade).

      Esta operação ainda não foi validada de ponta a ponta contra um ambiente SEI real. Valide em homologação antes de usar em produção.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

    • Experimental

      Exclui um processo.

      Parameters

      Returns Promise<string>

      Retorno textual do SEI (normalmente "1" em caso de sucesso).

      Operação destrutiva. O SEI só permite excluir processo sem andamentos relevantes, gerado pela própria unidade — pensada para limpeza de massa de teste/rascunho, não para descarte de processos reais.

      Esta operação ainda não foi validada de ponta a ponta contra um ambiente SEI real. Valide em homologação antes de usar em produção.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

    • Cria um processo no SEI, opcionalmente já com documentos, relacionamentos, envio para unidades, marcador e controle de prazo.

      Parameters

      Returns Promise<
          | Readonly<
              {
                  idProcedimento: string;
                  linkAcesso: string;
                  procedimentoFormatado: string;
                  retornoInclusaoDocumentos: Readonly<
                      {
                          documentoFormatado: string;
                          idDocumento: string;
                          linkAcesso: string;
                      },
                  >[];
              },
          >
          | null,
      >

      Protocolo gerado com link de acesso e retorno da inclusão de cada documento, ou null quando o SEI não retorna corpo.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault (ex.: tipo de procedimento inválido ou assunto não permitido).

      const retorno = await sei.operacoes.gerarProcedimento({
      idUnidade: "110000001",
      procedimento: {
      idTipoProcedimento: "100000101",
      especificacao: "Integração via sei-client",
      assuntos: [{ codigoEstruturado: "06.01.01" }],
      interessados: [{ nome: "Fulano de Tal", cpf: "00000000000" }],
      nivelAcesso: "0",
      },
      })
      console.log(retorno?.procedimentoFormatado)
    • Inclui um documento (gerado ou recebido) em um processo existente.

      Parameters

      Returns Promise<
          | Readonly<
              { documentoFormatado: string; idDocumento: string; linkAcesso: string },
          >
          | null,
      >

      Protocolo do documento gerado com link de acesso, ou null quando o SEI não retorna corpo.

      O conteúdo deve ser informado em Base64 via conteudo, conteudoSecoes ou idArquivo (upload prévio com SeiConsultasClient.adicionarArquivo). Use encodeSeiBase64 para codificar HTML/texto.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault (ex.: série inválida ou extensão de arquivo não permitida).

      const doc = await sei.operacoes.incluirDocumento({
      idUnidade: "110000001",
      documento: {
      tipo: "G",
      protocoloProcedimento: "00000.000001/2026-01",
      idSerie: "5",
      nivelAcesso: "0",
      conteudo: encodeSeiBase64("<p>Conteúdo</p>"),
      },
      })
    • Registra um andamento (histórico) em um processo.

      Parameters

      Returns Promise<
          | Readonly<
              {
                  atributos: Readonly<{ idOrigem: string; nome: string; valor: string }>[];
                  dataHora: string;
                  descricao: string;
                  idAndamento: string | null;
                  idTarefa: string | null;
                  idTarefaModulo: string | null;
                  unidade: SeiUnidade;
                  usuario: SeiUsuario;
              },
          >
          | null,
      >

      O andamento registrado, ou null quando o SEI não retorna corpo.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.

    • Experimental

      Registra manifestação de ouvidoria no SEI.

      Parameters

      Returns Promise<
          | Readonly<
              {
                  idProcedimento: string;
                  procedimentoFormatado: string;
                  tipoProcedimento: SeiTipoProcedimento;
              },
          >
          | null,
      >

      Referência resumida ao processo criado, ou null quando o SEI não retorna corpo.

      A chamada serializa dados do manifestante, tipo de procedimento, mensagem, atributos adicionais e anexos. Requer que o parâmetro ID_TIPO_CONTATO_OUVIDORIA esteja configurado na instalação do SEI; caso contrário, a operação pode falhar com um erro indicando tipo de contato não informado.

      Esta operação ainda não foi validada com sucesso de ponta a ponta contra um ambiente SEI real (a serialização chega ao serviço, mas a confirmação completa depende da configuração de ouvidoria da instalação). Valide em homologação antes de usar em produção.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault.