---
title: Zip
slug: zip
docTags: 
createdAt: 2025-10-06T19:18:15.606Z
---

## Objetivo

O conector **Zip** permite descompactar arquivos `.zip` localizados na pasta temporária (`tmp`) do servidor Fluid. Este conector é interno e não requer conexão com serviços externos.

### Criando conexão

Este conector não requer conexão. Ele opera diretamente sobre arquivos temporários no ambiente da plataforma Fluid.
**Pré-requisitos**

- O arquivo `.zip` precisa estar previamente enviado e disponível no diretório tmp do servidor da Fluid. 
- A extensão do arquivo deve obrigatoriamente ser .zip. 
- Nome do arquivo deve conter a extensão no final, por exemplo: documentos.zip. 

### Campos de entrada

### operation (objeto, obrigatório)

Define a operação que será executada.

Opções disponíveis:
**Descompactar arquivo**

- `fileName` (string, obrigatório)
   Nome do arquivo `.zip` que será descompactado.
   **Exemplo:** `documentos.zip`
   **Observação:** o arquivo deve estar previamente na pasta `tmp `do servidor. 

**Compactar arquivo**

- Compactar um arquivo base64
  - Nome do arquivo
  - Arquivo em base64
- Compactar arquivo em memória
  - Nome do arquivo

### Campos de saída

Nenhum retorno é gerado diretamente pelo conector. Caso necessário, utilize conectores complementares para leitura dos arquivos extraídos.

### Configurando fluxo

Crie um fluxo (passo a passo [Criar Fluxo](#)) e arraste o conector Zip para o canvas.

![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/QZKFzWkqyaQh7B4QYiSdE_image.png)

### Operações

**Operação**: Descompactar arquivo

- Descompacta um arquivo .zip localizado na pasta temporária do servidor (tmp).

## Na prática

Use este conector quando precisar extrair arquivos .zip enviados previamente para o servidor via outro conector (como FTP, SFTP, etc.). Certifique-se de que o nome do arquivo esteja correto e que ele esteja na pasta tmp.

### Exemplo de uso

```json
{
  "operation": {
    "value": "unzip_tmp",
    "fileName": "documentos.zip"
  }
}
```

### Possíveis erros

|  Código  |  Mensagem                |  Causa possível                                          |
| -------- | ------------------------ | -------------------------------------------------------- |
|  400     |  File not found          |  O arquivo informado não está presente na pasta \`tmp\`  |
|  400     |  Invalid file extension  |  A extensão do arquivo não é \`.zip\`                    |
|  500     |  Internal server error   |  Erro inesperado no processo de descompactação           |
|          |                          |                                                          |

### Disparando o fluxo

O conector Zip pode ser acionado por qualquer gatilho disponível na Fluid. É comum ser utilizado após etapas que fazem upload de arquivos para o servidor.