# Download de FTP

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd_AjbnohVDMMtal5Xj2LXviEZnZKIosaCJAatuFkXTqJKPYpBhEoA-X27kStlnjO0q9NLFNSiJojuAktpOtJUZLy63osZNnlC8gcnsWfVL2i8EH3FpXJ4IniIzr_6wCLpNvsxq-A?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

| Campo                                               | Tipo           | Descrição                                                                                                                                                                     |
| --------------------------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição                                           | Campo de texto | Descrição visual do conector na construção do fluxo.                                                                                                                          |
| Conta de serviço                                    | Seletor        | Permite selecionar contas de serviço para conexão com servidor FTP. A conta de serviço deverá ser do tipo FTP Server para ser exibida na listagem                             |
| Caminho do arquivo no servidor FTP                  | Campo de texto | Define o local de destino onde o arquivo a ser baixado está armazenado no servidor FTP.                                                                                       |
| Caminho do arquivo para download no Workspace Floui | Campo de texto | Define o caminho, no Storage interno do Workspace, onde o arquivo baixado será disponibilizado. O caminho deverá conter a pasta ou diretório, o nome e a extensão do arquivo. |
| Output Path                                         | Campo de texto | Refere-se ao caminho de saída onde o resultado do download será disponibilizado no contexto de execução do conector.                                                          |
| {% endtab %}                                        |                |                                                                                                                                                                               |

{% tab title="Payload" %}

## Sucesso

Ao ser executado com sucesso, o conector irá retornar a carga de dados como o exemplo abaixo. O código 226 refere-se a ação bem sucedida e conexão de transferência fechada.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdjGKopoLuu5EksMRQ3ZlmIPcmjCjZg89oR7BRWuS8-JJ4EZLeT1nMcIFKfM_6P2QcsKy2yhHfdR2vq8COz80hXICTCt-J0W-FrlyZFDaFOXLAtbHhvRoONqAyyJbCodhF0CYz_sA?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Sucesso em download</p></figcaption></figure>

## Erro

Em casos de erro no upload a carga de dados será retornada como a estrutura abaixo.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdad9WIup-0kmRuntpOHzsBivgMm9-HBOf6YMWySM_SI1TL45IehTxmqlqiSdduCBw9id9u-EnBenQv8WbTATDhyAVinOoKGhnZzzE1K3oqOVcCTC0OkqeA-1HmxgMUO-Y64UMfsw?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Erro em download</p></figcaption></figure>

Para evitar erros ao realizar a transferência do arquivo, é importante que na configuração “Caminho do arquivo para download no Workspace Floui” seja passado tanto o caminho do diretório onde o arquivo será salvo, como também o nome do arquivo e extensão. Omitir o nome do arquivo e extensão irá fazer com que o arquivo não seja transferido corretamente.

Adicionalmente, ao informar um diretor não existente, a conexão não irá criar este diretório para armazenar o arquivo. É preciso criar a pasta para que, em seguida, seja possível realizar a transferência com sucesso. No exemplo abaixo foi tentado realizar a transferência de um arquivo floui.txt para a pasta /documentation, como esta pasta não existe, a transferência gerou erro.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdUWBFUjabijoAaUd4qr_xK-jxzptJt07RtgFvW3AFDAG56SStovXEdKr52ugrUH2ATLunh-zDUUTnS41Wn-TBCl7D-Jpn8LPsUOzatgm0k85XPJw4_fneNQcBjhNuiP7Vy1j6JSA?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Download com caminho inexistente</p></figcaption></figure>

Os códigos FTP podem ser consultados por [este artigo](<https://learn.microsoft.com/pt-br/troubleshoot/developer/webapps/iis/ftp-service-svchost-inetinfo/ftp-status-codes-iis-7-and-later-versions >).
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.floui.io/guia/conectores/categorias/manipulacao-de-arquivos/externos/download-de-ftp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
