ANPD SEI Integrations
    Preparing search index...

    Operações somente leitura do SEI (listagens e consultas).

    Esta classe não altera estado no SEI. Ela é deliberadamente fina: recebe config, chama SOAP e devolve tipos TypeScript.

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

    Index
    • Consulta um bloco (assinatura, reunião ou interno) e, opcionalmente, seus protocolos.

      Parameters

      Returns Promise<
          | Readonly<
              {
                  descricao: string;
                  estado: string;
                  idBloco: string;
                  protocolos: Readonly<
                      {
                          assinaturas: Readonly<
                              {
                                  cargoFuncao: string;
                                  dataHora: string;
                                  idOrgao: string;
                                  idOrigem: string;
                                  idUsuario: string;
                                  nome: string;
                                  sigla: string;
                              },
                          >[];
                          identificacao: string;
                          protocoloFormatado: string;
                      },
                  >[];
                  sinPrioridade: boolean;
                  sinRevisao: boolean;
                  tipo: string;
                  unidade: | Readonly<
                      {
                          descricao: string;
                          idUnidade: string;
                          sigla: string;
                          sinArquivamento: boolean;
                          sinOuvidoria: boolean;
                          sinProtocolo: boolean;
                      },
                  >
                  | null;
                  unidadesDisponibilizacao: Readonly<
                      {
                          descricao: string;
                          idUnidade: string;
                          sigla: string;
                          sinArquivamento: boolean;
                          sinOuvidoria: boolean;
                          sinProtocolo: boolean;
                      },
                  >[];
                  usuario: | Readonly<{ idUsuario: string; nome: string; sigla: string }>
                  | null;
                  usuarioAtribuicao:
                      | Readonly<{ idUsuario: string; nome: string; sigla: string }>
                      | null;
              },
          >
          | null,
      >

      Dados do bloco, ou null quando o SEI não retorna corpo.

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

    • Consulta os dados completos de um documento pelo protocolo.

      Parameters

      Returns Promise<
          | Readonly<
              {
                  andamentoGeracao: | 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;
                  assinaturas: Readonly<
                      {
                          cargoFuncao: string;
                          dataHora: string;
                          idOrgao: string;
                          idOrigem: string;
                          idUsuario: string;
                          nome: string;
                          sigla: string;
                      },
                  >[];
                  blocos: Readonly<
                      {
                          descricao: string;
                          estado: string;
                          idBloco: string;
                          sinPrioridade: boolean;
                          sinRevisao: boolean;
                          tipo: string;
                          unidade: SeiUnidade;
                          unidadesDisponibilizacao: Readonly<
                              {
                                  descricao: string;
                                  idUnidade: string;
                                  sigla: string;
                                  sinArquivamento: boolean;
                                  sinOuvidoria: boolean;
                                  sinProtocolo: boolean;
                              },
                          >[];
                          usuario: SeiUsuario;
                          usuarioAtribuicao: SeiUsuario;
                      },
                  >[];
                  campos: Readonly<{ nome: string; valor: string }>[];
                  data: string;
                  descricao: string;
                  dinValor: string | null;
                  documentoFormatado: string;
                  idDocumento: string;
                  idProcedimento: string;
                  linkAcesso: string;
                  nivelAcessoGlobal: string | null;
                  nivelAcessoLocal: string | null;
                  nomeArvore: string;
                  numero: string;
                  procedimentoFormatado: string;
                  publicacao:
                      | Readonly<
                          {
                              dataDisponibilizacao: string;
                              dataPublicacao: string;
                              estado: string;
                              idDocumento: string
                              | null;
                              idPublicacao: string | null;
                              idVeiculoPublicacao: string | null;
                              imprensaNacional: SeiPublicacaoImprensaNacional;
                              nomeVeiculo: string;
                              numero: string;
                              resumo: string | null;
                              staMotivo: string | null;
                              staTipoVeiculo: string | null;
                          },
                      >
                      | null;
                  serie: | Readonly<
                      { aplicabilidade: string
                      | null; idSerie: string; nome: string },
                  >
                  | null;
                  unidadeElaboradora:
                      | Readonly<
                          {
                              descricao: string;
                              idUnidade: string;
                              sigla: string;
                              sinArquivamento: boolean;
                              sinOuvidoria: boolean;
                              sinProtocolo: boolean;
                          },
                      >
                      | null;
              },
          >
          | null,
      >

      Dados do documento, ou null quando o SEI não retorna corpo.

      Os sinalizadores sinRetornar* seguem o padrão "S", exceto sinRetornarBlocos, que por padrão é "N" por ser a consulta mais custosa no SEI.

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

    • Consulta os dados completos de um processo pelo protocolo.

      Parameters

      Returns Promise<
          | Readonly<
              {
                  andamentoConclusao: | 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;
                  andamentoGeracao: | 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;
                  assuntos: Readonly<
                      { codigoEstruturado: string; descricao: string
                      | null },
                  >[];
                  dataAutuacao: string;
                  especificacao: string;
                  idProcedimento: string;
                  interessados: Readonly<
                      {
                          cnpj: string
                          | null;
                          cpf: string | null;
                          idContato: string | null;
                          nome: string | null;
                          sigla: string | null;
                      },
                  >[];
                  linkAcesso: string;
                  nivelAcessoGlobal: string
                  | null;
                  nivelAcessoLocal: string | null;
                  observacoes: Readonly<{ descricao: string; unidade: SeiUnidade }>[];
                  procedimentoFormatado: string;
                  procedimentosAnexados: Readonly<
                      {
                          idProcedimento: string;
                          procedimentoFormatado: string;
                          tipoProcedimento: SeiTipoProcedimento;
                      },
                  >[];
                  procedimentosRelacionados: Readonly<
                      {
                          idProcedimento: string;
                          procedimentoFormatado: string;
                          tipoProcedimento: SeiTipoProcedimento;
                      },
                  >[];
                  tipoPrioridade: | Readonly<{ idTipoPrioridade: string; nome: string }>
                  | null;
                  tipoProcedimento: SeiTipoProcedimento;
                  ultimoAndamento:
                      | 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;
                  unidadesProcedimentoAberto: Readonly<
                      { unidade: SeiUnidade; usuarioAtribuicao: SeiUsuario },
                  >[];
              },
          >
          | null,
      >

      Dados do processo, ou null quando o SEI não retorna corpo.

      Por padrão todos os sinalizadores sinRetornar* são enviados como "S", retornando assuntos, interessados, observações, andamentos, unidades abertas e processos relacionados/anexados. Desligue os blocos que não precisa ("N") para reduzir o custo da consulta no SEI.

      SeiSoapError em caso de falha de comunicação ou SOAP Fault (ex.: processo inexistente ou sem acesso pela unidade).

      const proc = await sei.consultas.consultarProcedimento({
      idUnidade: "110000001",
      protocoloProcedimento: "00000.000001/2026-01",
      sinRetornarAndamentoConclusao: "N",
      })
    • Consulta o procedimento individual de um usuário (tipos de processo com autuação individual, ex.: dossiê funcional).

      Parameters

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

      Referência resumida ao processo, ou null se não encontrado.

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

    • Consulta uma publicação oficial associada a um documento.

      Parameters

      • params: SeiConsultarPublicacaoParams

        Unidade e identificação da publicação (idPublicacao, idDocumento ou protocoloDocumento), com sinalizadores de retorno.

      Returns Promise<
          | Readonly<
              {
                  andamento: | 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;
                  assinaturas: Readonly<
                      {
                          cargoFuncao: string;
                          dataHora: string;
                          idOrgao: string;
                          idOrigem: string;
                          idUsuario: string;
                          nome: string;
                          sigla: string;
                      },
                  >[];
                  publicacao: | Readonly<
                      {
                          dataDisponibilizacao: string;
                          dataPublicacao: string;
                          estado: string;
                          idDocumento: string
                          | null;
                          idPublicacao: string | null;
                          idVeiculoPublicacao: string | null;
                          imprensaNacional: SeiPublicacaoImprensaNacional;
                          nomeVeiculo: string;
                          numero: string;
                          resumo: string | null;
                          staMotivo: string | null;
                          staTipoVeiculo: string | null;
                      },
                  >
                  | null;
              },
          >
          | null,
      >

      Dados da publicação, ou null quando o SEI não retorna corpo.

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

    • Lista o histórico de andamentos de um processo.

      Parameters

      • params: SeiListarAndamentosParams

        Unidade, protocolo do processo e filtros opcionais por andamentos, tarefas e tarefas de módulos.

      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;
              },
          >[],
      >

      Lista de andamentos do processo.

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

    • Lista os cargos cadastrados no SEI.

      Parameters

      Returns Promise<
          Readonly<
              {
                  expressaoCargo: string;
                  expressaoTratamento: string;
                  expressaoVocativo: string;
                  idCargo: string;
              },
          >[],
      >

      Lista de cargos com expressões de tratamento e vocativo.

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

    • Lista os municípios cadastrados no SEI.

      Parameters

      Returns Promise<
          Readonly<
              {
                  codigoIbge: string;
                  idCidade: string;
                  idEstado: string;
                  idPais: string;
                  latitude: string;
                  longitude: string;
                  nome: string;
                  sinCapital: boolean;
              },
          >[],
      >

      Lista de municípios.

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

    • Lista contatos cadastrados no SEI com filtros combinativos e paginação.

      Parameters

      • params: SeiListarContatosParams

        Unidade, filtros (tipo, sigla, nome, CPF, CNPJ, matrícula, IDs) e controle de paginação (paginaRegistros/paginaAtual).

      Returns Promise<
          Readonly<
              {
                  abreviaturaTitulo: string
                  | null;
                  bairro: string;
                  cep: string;
                  cnpj: string;
                  cnpjAssociado: string | null;
                  complemento: string;
                  conjuge: string | null;
                  cpf: string;
                  dataNascimento: string;
                  email: string;
                  endereco: string;
                  expressaoCargo: string | null;
                  expressaoTitulo: string | null;
                  expressaoTratamento: string | null;
                  expressaoVocativo: string | null;
                  funcao: string | null;
                  idCargo: string | null;
                  idCategoria: string | null;
                  idCidade: string | null;
                  idContato: string;
                  idContatoAssociado: string | null;
                  idEstado: string | null;
                  idNomeCategoria: string | null;
                  idPais: string | null;
                  idPaisPassaporte: string | null;
                  idTipoContato: string;
                  idTitulo: string | null;
                  matricula: string;
                  matriculaOab: string;
                  nome: string;
                  nomeCidade: string | null;
                  nomeContatoAssociado: string | null;
                  nomePais: string | null;
                  nomePaisPassaporte: string | null;
                  nomeSocial: string | null;
                  nomeTipoContato: string | null;
                  numeroPassaporte: string | null;
                  observacao: string;
                  orgaoExpedidor: string;
                  rg: string;
                  sigla: string;
                  siglaEstado: string | null;
                  sinAtivo: boolean;
                  sinEnderecoAssociado: boolean;
                  sitioInternet: string;
                  staGenero: string;
                  staNatureza: string;
                  staOperacao: string | null;
                  telefoneCelular: string;
                  telefoneComercial: string;
                  telefoneResidencial: string;
              },
          >[],
      >

      Lista de contatos que atendem aos filtros.

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

    • Lista os estados/UF cadastrados no SEI.

      Parameters

      Returns Promise<
          Readonly<
              {
                  codigoIbge: string;
                  idEstado: string;
                  idPais: string;
                  nome: string;
                  sigla: string;
              },
          >[],
      >

      Lista de estados.

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

    • Lista as hipóteses legais de restrição de acesso configuradas no SEI.

      Parameters

      Returns Promise<
          Readonly<
              {
                  baseLegal: string;
                  idHipoteseLegal: string;
                  nivelAcesso: string;
                  nome: string;
              },
          >[],
      >

      Lista de hipóteses legais.

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

    • Lista as séries (tipos de documento) disponíveis na unidade.

      Parameters

      Returns Promise<
          Readonly<
              { aplicabilidade: string
              | null; idSerie: string; nome: string },
          >[],
      >

      Lista de séries documentais.

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

    • Lista os tipos de procedimento (tipos de processo) disponíveis na unidade.

      Parameters

      Returns Promise<
          Readonly<
              {
                  idTipoProcedimento: string;
                  nome: string;
                  sinOuvidoriaAnonimo: boolean;
              },
          >[],
      >

      Lista de tipos de procedimento.

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

    • Lista os tipos de procedimento habilitados para manifestações de ouvidoria.

      Returns Promise<
          Readonly<
              {
                  idTipoProcedimento: string;
                  nome: string;
                  sinOuvidoriaAnonimo: boolean;
              },
          >[],
      >

      Lista de tipos de procedimento de ouvidoria.

      Diferente das demais consultas, esta operação não exige unidade: o SEI a resolve apenas com as credenciais do sistema integrador.

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

    • Lista as unidades liberadas para o sistema integrador no SEI.

      Parameters

      Returns Promise<
          Readonly<
              {
                  descricao: string;
                  idUnidade: string;
                  sigla: string;
                  sinArquivamento: boolean;
                  sinOuvidoria: boolean;
                  sinProtocolo: boolean;
              },
          >[],
      >

      Lista de unidades habilitadas para a integração.

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

      const unidades = await sei.consultas.listarUnidades()