# Espaider Spal



# espaider-spal-andamentos-inserir

> **<span class="align-center">1 Introdução  
> </span>**<span class="align-center">O robô **espaider-spal-andamentos-inserir** foi desenvolvido para automatizar o processo de inclusão de andamentos, documentos e imagens no sistema SPAL, garantindo a correta vinculação das informações aos processos cadastrados, reduzindo atividades manuais e assegurando a aplicação das regras de negócio e parametrizações definidas pelo cliente</span>**<span class="align-center">  
> </span>**

#### <span class="align-center">**1.1 **Escopo****</span>

> Esta documentação abrange todas as funcionalidades e configurações do **espaider-spal-andamentos-inserir**, incluindo:
> 
> - Pesquisa de processos por número de Pasta/Integração;
> - Acesso à interface do processo;
> - Inclusão de novos andamentos;
> - Identificação e preenchimento do Desdobramento correspondente ao Evento, conforme equivalência parametrizada;
> - Validação dos campos obrigatórios para cadastro de andamentos;
> - Inclusão de documentos vinculados aos andamentos;
> - Inclusão de documentos e imagens diretamente na aba "Documentos e Imagens";
> - Preenchimento dos campos Nome e Documento conforme tabela de equivalências parametrizadas;
> - Validação dos campos obrigatórios para cadastro de documentos;
> - Registro e tratamento de exceções durante a execução do processo;
> - Finalização e salvamento das informações inseridas.

<span class="align-center">**1.2 Url de acesso** Ambiente: SPAL FEMSA  
</span>[<span class="align-center">https://espaider.com.br/femsa/login/</span>](https://espaider.com.br/femsa/login/)

### **2.Fluxo de Trabalho**

#### <span class="align-center">**2.1 **Autenticação****</span>

<table border="1" id="bkmrk-1---valide-os-campos" style="border-collapse: collapse; width: 101.728%; height: 7589px;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr style="height: 935.719px;"><td style="height: 935.719px;">##### 1 - Preencher o campo **"Usuário"** com a credencial parametrizada.  
2 - Preencher o campo **"Senha"** com a credencial parametrizada.  
3 - Clicar em "Entrar".  
  


[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/image.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/image.png)

[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/qKjimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/qKjimage.png)

  
</td></tr><tr style="height: 648.531px;"><td style="height: 648.531px;">##### **2.2. Acesso ao Módulo de Processos** Tela exibida após autenticação, posicionada no módulo **Contencioso/Processos** para realização da pesquisa do processo por meio do número da **Pasta/Integração**.  
  


[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/xhMimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/xhMimage.png)

####   


</td></tr><tr style="height: 518.891px;"><td style="height: 518.891px;">**2.3. Fluxo de Inserção de Andamentos**   
4.1. Pesquisar o número da **Pasta/Integração** informado e abrir o processo correspondente para dar continuidade ao fluxo.

[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/EMYimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/EMYimage.png)

</td></tr><tr style="height: 527.875px;"><td style="height: 527.875px;">##### 4.2. Acessar o processo e localizar a aba **Andamentos**.  
  


[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/jMYimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/jMYimage.png)

</td></tr><tr style="height: 502.469px;"><td style="height: 502.469px;">##### 4.3. Acessar a aba **Andamentos** e selecionar a opção **Novo.**

[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/54Gimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/54Gimage.png)

</td></tr><tr style="height: 639.203px;"><td style="height: 639.203px;">##### <span style="background-color: rgb(255, 255, 255);">4.4. <span style="background-color: rgb(0, 0, 0);"><span style="background-color: rgb(255, 255, 255);">Preencher os campos **Data, Desdobramento** e **Evento** conforme as informações recebidas, utilizando as equivalências parametrizadas definidas para o processamento.</span></span></span>

![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/nAMimage.png)</td></tr><tr style="height: 677.578px;"><td style="height: 677.578px;">##### 4.5. Após preencher os campos do andamento, o robô deverá **SALVAR** o registro e acessar a aba **Documentos e Imagens** disponibilizada após a gravação do andamento.

  
[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/7WUimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/7WUimage.png)

</td></tr><tr style="height: 484.062px;"><td style="height: 484.062px;">
##### 4.6. Na aba **Documentos e Imagens**, o robô deverá selecionar a opção **Novo** para inclusão de um novo documento.  


[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/tptimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/tptimage.png)

</td></tr><tr style="height: 493.266px;"><td style="height: 493.266px;">##### 4.7. Ao abrir a tela de inclusão, o robô deverá preencher os campos **Nome** e **Documento** utilizando a equivalência parametrizada para o evento processado e, em seguida, salvar o registro.

##### Após salvar o documento, o robô deverá finalizar o cadastro e prosseguir para o próximo processo da fila.

  
[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/zMZimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/zMZimage.png)

</td></tr><tr style="height: 584.641px;"><td style="height: 584.641px;">##### **2.4. Fluxo de Inserção de Documentos e Imagens**5.1. O robô deverá localizar o processo por meio do número da **Pasta/Integração** informado e acessar seu cadastro para iniciar a inclusão do documento.

##### [![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/vjzimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/vjzimage.png)

#####   


</td></tr><tr style="height: 524.484px;"><td style="height: 524.484px;">##### 5.2. Após acessar o processo, o robô deverá localizar e acessar a aba **Documentos e Imagens**.  
  


[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/bAFimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/bAFimage.png)

</td></tr><tr style="height: 1043.86px;"><td style="height: 1043.86px;">##### 5.3. Na aba **Documentos e Imagens**, o robô deverá selecionar a opção **Novo** e preencher os campos **Nome** e **Documento** conforme a equivalência parametrizada, garantindo que o nome do documento seja igual ao valor informado no campo **Nome**.  
Após o preenchimento dos campos, o robô deverá **SALVAR** o registro e prosseguir para o próximo processo da fila de processamento.  


[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/w5fimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/w5fimage.png)

[![image.png](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/scaled-1680-/Gxtimage.png)](https://wiki.oystr.com.br/uploads/images/gallery/2026-06/Gxtimage.png)

</td></tr></tbody></table>

#### <span class="align-center"> Bot  
espaider-spal-andamentos-inserir   
</span>

### **3. Dados de entrada**

<p class="callout info"><span class="align-center"> **Tabela XLS/XML**</span></p>

<table border="1" id="bkmrk-se%C3%87%C3%83o-propriedade-co" style="width: 103.457%; height: 413.938px;"><tbody><tr style="height: 63.3906px;"><td style="width: 8.27943%; height: 63.3906px;">SEÇÃO</td><td style="width: 15.912%; height: 63.3906px;">PROPRIEDADE</td><td style="width: 18.4994%; height: 63.3906px;">XLS</td><td style="width: 17.3351%; height: 63.3906px;">XML</td><td style="width: 13.1953%; height: 63.3906px;">CAMPO OBRIGATÓRIO</td><td style="width: 6.72704%; height: 63.3906px;">FORMATAÇÃO</td><td style="width: 19.9224%; height: 63.3906px;">DESCRIÇÃO</td><td style="width: 0%; height: 63.3906px;">  
</td><td style="width: 0%; height: 63.3906px;">  
</td><td style="width: 0%; height: 63.3906px;">  
</td><td style="width: 0%; height: 63.3906px;">  
</td><td style="width: 0.129366%; height: 63.3906px;">  
</td></tr><tr style="height: 80.1875px;"><td style="width: 8.27943%; height: 80.1875px;">  
</td><td style="width: 15.912%; height: 80.1875px;">Integração</td><td style="width: 18.4994%; height: 80.1875px;">INTEGRACAO</td><td style="width: 17.3351%; height: 80.1875px;">integracao</td><td style="width: 13.1953%; height: 80.1875px;">Sim</td><td style="width: 6.72704%; height: 80.1875px;">Texto</td><td style="width: 19.9224%; height: 80.1875px;">Referência da Pasta/Integração utilizada para localizar o processo no SPAL.</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0.129366%; height: 80.1875px;">  
</td></tr><tr style="height: 80.1875px;"><td style="width: 8.27943%; height: 80.1875px;"> </td><td style="width: 15.912%; height: 80.1875px;">Evento</td><td style="width: 18.4994%; height: 80.1875px;">EVENTO</td><td style="width: 17.3351%; height: 80.1875px;">evento</td><td style="width: 13.1953%; height: 80.1875px;">Sim</td><td style="width: 6.72704%; height: 80.1875px;">Texto</td><td style="width: 19.9224%; height: 80.1875px;">Evento que será cadastrado no andamento do processo.</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0.129366%; height: 80.1875px;">  
</td></tr><tr style="height: 63.3906px;"><td style="width: 8.27943%; height: 63.3906px;">  
</td><td style="width: 15.912%; height: 63.3906px;">Data do Evento</td><td style="width: 18.4994%; height: 63.3906px;">DATA\_EVENTO</td><td style="width: 17.3351%; height: 63.3906px;">data\_evento</td><td style="width: 13.1953%; height: 63.3906px;">Sim</td><td style="width: 6.72704%; height: 63.3906px;">DD/MM/AAAA</td><td style="width: 19.9224%; height: 63.3906px;">Data que será informada no cadastro do andamento.</td><td style="width: 0%; height: 63.3906px;">  
</td><td style="width: 0%; height: 63.3906px;">  
</td><td style="width: 0%; height: 63.3906px;">  
</td><td style="width: 0%; height: 63.3906px;">  
</td><td style="width: 0.129366%; height: 63.3906px;">  
</td></tr><tr style="height: 80.1875px;"><td style="width: 8.27943%; height: 80.1875px;">  
</td><td style="width: 15.912%; height: 80.1875px;">Nome do Documento</td><td style="width: 18.4994%; height: 80.1875px;">NOME\_DOCUMENTO</td><td style="width: 17.3351%; height: 80.1875px;">nome\_documento</td><td style="width: 13.1953%; height: 80.1875px;">Sim</td><td style="width: 6.72704%; height: 80.1875px;">Texto</td><td style="width: 19.9224%; height: 80.1875px;">Nome utilizado para cadastro do documento no SPAL.</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0%; height: 80.1875px;">  
</td><td style="width: 0.129366%; height: 80.1875px;">  
</td></tr><tr style="height: 46.5938px;"><td style="width: 8.27943%; height: 46.5938px;">  
</td><td style="width: 15.912%; height: 46.5938px;">Documento</td><td style="width: 18.4994%; height: 46.5938px;">DOCUMENTO</td><td style="width: 17.3351%; height: 46.5938px;">documento</td><td style="width: 13.1953%; height: 46.5938px;">Sim</td><td style="width: 6.72704%; height: 46.5938px;">Arquivo</td><td style="width: 19.9224%; height: 46.5938px;">Documento que será anexado ao processo.</td><td style="width: 0%; height: 46.5938px;">  
</td><td style="width: 0%; height: 46.5938px;">  
</td><td style="width: 0%; height: 46.5938px;">  
</td><td style="width: 0%; height: 46.5938px;">  
</td><td style="width: 0.129366%; height: 46.5938px;">  
</td></tr><tr><td style="width: 8.27943%;">  
</td><td style="width: 15.912%;">Desdobramento</td><td style="width: 18.4994%;">ACAO</td><td style="width: 17.3351%;">acao</td><td style="width: 13.1953%;">Sim</td><td style="width: 6.72704%;">  
</td><td style="width: 19.9224%;"><table><tbody><tr><td data-col-size="sm" data-end="611" data-start="605">Desdobramento do andamento recebido na carga XML e utilizado para preenchimento do campo correspondente no SPAL.</td></tr></tbody></table>

</td><td style="width: 0%;"> </td><td style="width: 0%;"> </td><td style="width: 0%;"> </td><td style="width: 0%;"> </td><td style="width: 0.129366%;"> </td></tr></tbody></table>

<p class="callout info">**Tabela Scheduler**</p>

#### **4. Regras de Negócio** 

**RN001:** O processo será localizado exclusivamente pelo número da Pasta/Integração.

**RN002:** O campo Desdobramento deverá ser preenchido conforme a equivalência parametrizada para o Evento informado.

**RN003:** O campo Nome do Documento deverá utilizar a equivalência parametrizada para o Evento processado.

**RN004:** O nome do documento anexado deverá ser igual ao valor informado no campo Nome.

**4 Restrições e Premissas**


> #### Premissas
> 
> - O usuário utilizado pelo robô possui permissão para consulta de processos, inclusão de andamentos e inclusão de documentos no sistema SPAL.
> - Os processos já estão previamente cadastrados no sistema SPAL.
> - As tabelas de equivalência entre **Evento x Desdobramento** e **Evento x Nome do Documento** estão devidamente configuradas.
> - Os documentos a serem anexados estão disponíveis para consulta e upload durante a execução do robô.
> - O ambiente SPAL está disponível e operacional durante o processamento.
> 
> #### Restrições
> 
> - O robô realiza a busca dos processos exclusivamente pelo número da **Pasta/Integração**.
> - O robô não cria novos processos no sistema SPAL.
> - Eventos sem equivalência parametrizada não poderão ser processados pelo robô.
> - O robô depende da disponibilidade e estabilidade do ambiente SPAL para execução das atividades.
> - Alterações na interface do sistema SPAL poderão impactar o funcionamento do robô e exigir ajustes.