> For the complete documentation index, see [llms.txt](https://guia.fenicio.help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia.fenicio.help/panel-de-gestion/accesos-y-usuarios/usuarios-y-acceso-sftp.md).

# Usuarios y acceso SFTP

<figure><picture><source srcset="/files/XubvRTZST4Gb3vqJ1GlZ" media="(prefers-color-scheme: dark)"><img src="/files/ilKuB2CMO1YyndoTw7Sp" alt=""></picture><figcaption></figcaption></figure>

El acceso SFTP permite cargar y administrar archivos asociados a los productos, como imágenes JPG y documentos PDF, mediante una conexión segura con el servidor de Fenicio.

Desde el panel de gestión, los usuarios con rol Administrador pueden crear y administrar las credenciales necesarias para conectarse al servicio.

Para acceder, ingresa a:

**Administración** ➡ **Usuarios SFTP**

{% hint style="info" %}
Esta funcionalidad se encuentra disponible únicamente para tiendas que tengan habilitada una integración que gestione imágenes mediante SFTP.
{% endhint %}

### ¿Qué es SFTP?

SFTP significa **Secure File Transfer Protocol**.

Es un protocolo que permite transferir archivos entre un equipo o sistema externo y el servidor de Fenicio mediante una conexión cifrada.

A través de SFTP es posible:

* Subir imágenes y documentos.
* Descargar archivos.
* Visualizar carpetas.
* Renombrar archivos.
* Eliminar archivos.
* Gestionar contenido de forma remota.

A diferencia del FTP tradicional, SFTP protege tanto los archivos como las credenciales utilizadas para conectarse.

### ¿Cuándo se utiliza?

La gestión mediante SFTP puede utilizarse en tiendas con los siguientes tipos de integración:

* **Parcial con precio, stock e imágenes externas:** el precio, el stock y las imágenes provienen de un sistema externo.
* **Completa con imágenes mediante SFTP:** toda la información de los productos se gestiona desde un sistema externo.

En estas configuraciones, las imágenes no se administran directamente desde el Catálogo del panel.

### Estado del servicio SFTP

El servicio puede encontrarse activo o deshabilitado.

#### Servicio activo

Cuando el servicio está activo:

* Las conexiones SFTP pueden realizarse correctamente.
* La pantalla muestra el servidor y el puerto de conexión.
* Se visualiza el listado de usuarios creados.
* Los usuarios habilitados pueden acceder a los archivos.

#### Servicio deshabilitado

Cuando el servicio está deshabilitado:

* Se rechazan todos los intentos de conexión.
* No es posible acceder a los archivos.
* La pantalla muestra el siguiente mensaje:

> El módulo está deshabilitado. Por favor, contacte a soporte para más información.

{% hint style="warning" %}
Si el servicio SFTP se deshabilita y luego vuelve a activarse, los usuarios creados anteriormente se eliminan y deben generarse nuevamente.
{% endhint %}

### Archivos compartidos entre tiendas

Varias tiendas pueden compartir los mismos archivos y credenciales si pertenecen al mismo grupo SFTP.

Esta configuración es útil para empresas o grupos económicos que administran varias tiendas y desean cargar sus imágenes en un único lugar.

Cuando las tiendas pertenecen al mismo grupo SFTP:

* Comparten los archivos cargados.
* Comparten los usuarios de acceso.
* Comparten las contraseñas.
* Los cambios realizados sobre un usuario se reflejan en todas las tiendas.
* Las imágenes cargadas pueden utilizarse en todas las tiendas del grupo.

{% hint style="warning" %}
Cualquier creación, modificación o eliminación de usuarios afectará a todas las tiendas que pertenezcan al mismo grupo SFTP.
{% endhint %}

### Gestión de usuarios SFTP

Desde **Administración** ➡ **Usuarios SFTP** puedes:

* Consultar los usuarios existentes.
* Crear usuarios.
* Habilitar o deshabilitar usuarios.
* Copiar el nombre de usuario.
* Cambiar una contraseña.
* Eliminar usuarios.

Los usuarios SFTP no necesariamente representan a una persona. También pueden utilizarse para conectar un ERP u otro sistema encargado de gestionar los archivos.

### Límite de usuarios

Cada grupo SFTP puede tener un máximo de **cinco usuarios**.

La pantalla muestra:

* Cantidad de usuarios creados.
* Cantidad de usuarios disponibles.
* Límite total permitido.

Al alcanzar los cinco usuarios, el botón **Agregar usuario SFTP** queda deshabilitado.

Para crear uno nuevo, primero debes eliminar un usuario existente.

### Crear un usuario SFTP

1. Ingresa a **Administración → Usuarios SFTP**.
2. Selecciona **Agregar usuario SFTP**.
3. Ingresa un nombre de usuario válido.
4. Crea una contraseña.
5. Repite la contraseña.
6. Selecciona **Aceptar**.

El nuevo usuario aparecerá inmediatamente en el listado.

{% hint style="warning" %}
El sistema no envía la contraseña por email. El Administrador debe guardarla y compartirla manualmente con la persona o sistema que realizará la conexión.
{% endhint %}

### Habilitar o deshabilitar un usuario

Para habilitar o deshabilitar un usuario:

1. Busca el usuario en el listado.
2. Utiliza el interruptor **On**.

Cuando un usuario se encuentra deshabilitado, no puede conectarse al servidor SFTP.

Esta acción no elimina al usuario y puede revertirse utilizando nuevamente el interruptor.

### Copiar el nombre de usuario

Para copiar el nombre de un usuario:

1. Busca el usuario en el listado.
2. Selecciona el botón de copiar ubicado junto al nombre.

El nombre quedará disponible para pegarlo en FileZilla o en el sistema que realizará la conexión.

### Cambiar la contraseña

Para crear una nueva contraseña:

1. Busca el usuario.
2. Selecciona el botón con el ícono de llave.
3. Ingresa la nueva contraseña.
4. Repite la contraseña.
5. Selecciona **Aceptar**.

La contraseña anterior dejará de funcionar inmediatamente.

{% hint style="warning" %}
Si el usuario es compartido por varias tiendas del mismo grupo, el cambio de contraseña afectará a todas ellas.
{% endhint %}

### Eliminar un usuario

Para eliminar un usuario:

1. Busca el usuario en el listado.
2. Selecciona el botón **Eliminar**.
3. Confirma la acción.

Una vez eliminado:

* El usuario deja de poder conectarse.
* Pierde inmediatamente el acceso a los archivos.
* La eliminación se refleja en todas las tiendas del grupo SFTP.

Antes de eliminarlo, verifica que ningún sistema o proveedor continúe utilizando esas credenciales.

## Conectarse mediante FileZilla

Para cargar archivos mediante SFTP puedes utilizar FileZilla Client.

### ¿Qué es FileZilla?

FileZilla es una aplicación que permite conectarse a servidores FTP, FTPS y SFTP.

Desde FileZilla puedes:

* Subir archivos.
* Descargar archivos.
* Crear carpetas.
* Renombrar archivos.
* Eliminar archivos.
* Gestionar el contenido almacenado en el servidor.

### Instalar FileZilla

1. Ingresa al sitio oficial de FileZilla.
2. Descarga la opción **FileZilla Client**.
3. Instala el programa en tu equipo.

{% hint style="info" %}
Descarga FileZilla únicamente desde su sitio oficial.
{% endhint %}

### Configurar la conexión

Antes de comenzar, crea un usuario desde:

**Administración → Usuarios SFTP**

Luego, en FileZilla:

1. Ingresa a **Archivo**.
2. Selecciona **Gestor de sitios** o **Site Manager**.
3. Selecciona **Nuevo sitio**.
4. En Protocolo, elige **SFTP - SSH File Transfer Protocol**.
5. Completa los datos de conexión.
6. Selecciona **Conectar**.

Utiliza la siguiente información:

| Campo          | Información                                         |
| -------------- | --------------------------------------------------- |
| Protocolo      | SFTP - SSH File Transfer Protocol                   |
| Servidor       | El servidor informado en la pantalla Usuarios SFTP  |
| Puerto         | El puerto informado en la pantalla Usuarios SFTP    |
| Modo de acceso | Normal                                              |
| Usuario        | El usuario creado en el panel                       |
| Contraseña     | La contraseña definida al crear o editar el usuario |

### Cargar archivos

Una vez establecida la conexión:

1. Ubica en el sector izquierdo los archivos guardados en tu equipo.
2. Ubica en el sector derecho la carpeta del servidor SFTP.
3. Arrastra los archivos desde tu equipo hacia el servidor.
4. Espera a que la transferencia finalice correctamente.

Si varias tiendas pertenecen al mismo grupo SFTP, los archivos cargados estarán disponibles para todas ellas.

### Recomendaciones de seguridad

* Crea un usuario diferente para cada sistema o proveedor.
* No compartas credenciales mediante canales públicos.
* Cambia la contraseña si sospechas que fue expuesta.
* Deshabilita los usuarios que no se estén utilizando temporalmente.
* Elimina los accesos que ya no sean necesarios.
* Verifica el impacto en las demás tiendas antes de modificar usuarios compartidos.
* No publiques capturas que muestren contraseñas o datos de conexión.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://guia.fenicio.help/panel-de-gestion/accesos-y-usuarios/usuarios-y-acceso-sftp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
