# Retorno Customizado

## CONFIGURAÇÃO

Para utilizar esse objeto, é necessário escolher um código, uma mensagem, os dados apresentados e se as informações retornadas devem ou não ser convertidas para um [JSON](https://docs.roboteasy.tech/studio/geral/objetos/blocos-de-comando/json).

![Layout geral do objeto](https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FG0SSvuoQD05fu6HfcKUa%2FCaptura%20de%20tela_20230113_142114.png?alt=media\&token=75020961-21e1-4dfd-b314-80bd666065c3)

**Preenchendo o objeto:**

<table><thead><tr><th width="261">Campo</th><th>Descritivo</th></tr></thead><tbody><tr><td>Título</td><td>É o nome do objeto e <strong>não precisa ser alterado</strong>, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Retorno Customizado - Execução Sucesso".</td></tr><tr><td>Código</td><td><p>Código de retorno padrão utilizado pelos robôs. As opções que podem ser utilizadas são:</p><ul><li>RPA001: É utilizada para casos que o robô conseguiu executar com <strong>sucesso</strong></li><li>RPA002: Em casos de <strong>erro</strong> na execução do robô</li><li>RPA003: Para <strong>alertar</strong> sobre possível erro no ambiente/processo.</li></ul></td></tr><tr><td>Mensagem</td><td><p>Mensagem de validação. </p><p>Exemplo: Executado com Sucesso.</p></td></tr><tr><td>Dados</td><td>Dados que o usuário quiser retornar. Exemplo: Variável com dados específicos</td></tr><tr><td>Converter para JSON</td><td>Ao selecionar esta opção, a variável inserida no campo Dados será convertida para um JSON.</td></tr></tbody></table>

{% hint style="info" %}
**INTERPOLAÇÃO**

Trata-se de um conceito técnico utilizado em programação e você não precisa se preocupar em alterá-lo neste momento.
{% endhint %}

## CASOS DE USO

* Quando é necessário verificar o retorno de uma informação no LOG do robô.
* &#x20;Rastreio de CEP via correios, verificando o retorno com sucesso da operação em mensagem LOG do robô.

## EXEMPLO

**Verificar o retorno com sucesso das informações da busca do CEP da Roboteasy.**

Neste exemplo, utilizaremos o robô pronto de consulta aos Correios.&#x20;

Para saber mais, acesse: [**Robôs prontos Correios**](https://docs.roboteasy.tech/studio/geral/objetos/robos-prontos/correios)**.**

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FxtJ0ahSf7ImAt6jjIuk3%2FRob%C3%B4%20Exemplo%20Retorno%20Customizado.PNG?alt=media&#x26;token=e9f14f09-3b5e-4ce1-a36a-aa2705b05f72" alt=""><figcaption><p>Robô Exemplo Retorno Customizado</p></figcaption></figure>

**PASSO 1:** Selecionar o Nome Identificador Único do Objeto Correios e os seus dados de retorno.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fa1m8IhvbJff8NjmjASLL%2FRetorno%20Customizado%20Rob%C3%B4%20selecionando%20Variaveis.gif?alt=media&#x26;token=17db113c-3c33-41c9-a8a4-2ebe343f8a40" alt=""><figcaption><p>Configurando Objeto Retorno Customizado com dados de retorno dos Correios</p></figcaption></figure>

**PASSO 2:** Executar o robô e verificar no Console/LOG o seu retorno com sucesso.

{% hint style="warning" %}
Aperte CTRL + SHIFT + T **ou** painel do Studio nas opções IDE e depois EXIBIR CONSOLE.
{% endhint %}

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fgt1jAur336w82LisogQ4%2FRetorno%20Customizado%20Rob%C3%B4%20Exemplo%20Execu%C3%A7%C3%A3o%20Sucesso.gif?alt=media&#x26;token=2f9709e9-4034-4bd5-b690-e0553bd57c8b" alt=""><figcaption><p>Execução com Sucesso do Robô Exemplo Retorno Customizado</p></figcaption></figure>

## Baixar o Robô

{% file src="<https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FyNts7LdUmHE5ijlIX7jX%2FRetorno%20Customizado%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=19ef549f-f064-4ffe-89e1-ccacfbe07805>" %}