Client for the 'SEI' Electronic Information System Web Services

Toolkit to interact with the 'SOAP' web services of the 'SEI' (Sistema Eletronico de Informacoes), the electronic system for document and process management widely used by Brazilian public administration bodies. Provides functions to build the 'SOAP' envelopes, perform the requests, handle 'SOAP' faults, and parse the 'XML' responses into data frames. Covers process and document queries, listing services, write operations (creating processes and documents, sending and signing off processes, blocks, deadlines and markers) and the permission services of the companion 'SIP' system. Note that access to the web services is restricted by the server to previously authorized network addresses. For more information about the 'SEI' system and its web services see < https://www.gov.br/gestao/pt-br/assuntos/processo-eletronico-nacional>.

rsei (R + SEI)

rsei é um toolkit em R para os Web Services SOAP do SEI (Sistema Eletrônico de Informações). Ele monta os envelopes SOAP no formato esperado pelo SEI, executa as chamadas com httr2, trata erros HTTP e SOAP Fault, e devolve os resultados como tibble. Cobre consultas (consultar_*), listagens (listar_*), operações de escrita (gerar_procedimento, incluir_documento, enviar_processo, …) e os serviços do SIP (listar_permissao, replicar_permissao, replicar_usuario).

⚠️ Acesso restrito por IP. Os Web Services do SEI são protegidos por firewall: só respondem a requisições vindas de IPs/servidores previamente autorizados no cadastro do serviço no SEI. As funções deste pacote só retornarão dados quando executadas a partir de um host autorizado (por exemplo, o servidor institucional). A partir de um IP não autorizado as chamadas falham por timeout ou conexão recusada. A autenticação adicional é feita por SiglaSistema + chave de acesso (IdentificacaoServico).

Arquitetura

Todas as operações são wrappers finos sobre um único motor SOAP (sei_build_envelope() + sei_call()), com configuração centralizada (sei_config()) e parsers que devolvem tibble.

O fluxo de uma chamada — da função ao tibble, com tratamento de erro:

Instalação

# install.packages("remotes")
remotes::install_github("StrategicProjects/rsei")

Configuração

library(rsei)

# Configuração reutilizada por todas as funções
# Funciona com qualquer instalação do SEI: aponte `sei_url` para o
# endpoint do Web Service do seu servidor.
cfg <- sei_config(
  sei_url               = "https://sei.<seu-orgao>.gov.br/sei/ws/SeiWS.php",
  sigla_sistema         = "MEU_SISTEMA",
  identificacao_servico = Sys.getenv("RSEI_IDENTIFICACAO_SERVICO")  # chave de acesso
)

# Opcional: definir como padrão da sessão (dispensa passar `config`)
sei_set_default_config(
  sei_url               = "https://sei.<seu-orgao>.gov.br/sei/ws/SeiWS.php",
  sigla_sistema         = "MEU_SISTEMA",
  identificacao_servico = Sys.getenv("RSEI_IDENTIFICACAO_SERVICO")
)

Exemplo

# Consultar um processo (retorna um tibble)
proc <- consultar_procedimento("0000000000.000001/2020-11", config = cfg)
proc$Especificacao
proc$Assuntos[[1]]          # coluna-lista com os assuntos

# Listar unidades, séries, tipos de processo, ...
unidades <- listar_unidades(cfg)
series   <- listar_series(cfg)

As operações de escrita alteram dados no SEI e devem ser validadas em ambiente de homologação/treino antes de uso em produção.

rsei faz parte de um ecossistema de pacotes R desenvolvido na Secretaria Executiva de Monitoramento Estratégico. ```