# SFTP

## Proceso

Este método consiste en subir un archivo con la información de los pedidos a un servidor de SFTP, nosotros estaremos leyendo constantemente este servidor en busqueda de archivos nuevos para posteriormente crear las entregas en Shippify.

<figure><img src="https://4161681308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5jRdo0cXdFHp6c7ZKdof%2Fuploads%2FOqOimsYuwtSY0rvOTw8R%2Fimage.png?alt=media&#x26;token=92acfa0b-d7be-4c96-a2db-09eaf64b801d" alt=""><figcaption><p>Creación por sftp</p></figcaption></figure>

## Servidor

Tu puedes utilizar tu propio servidor SFTP para guardar los archivos y darnos acceso para leerlo constantemente, o en caso que no cuentes con uno te podemos dar acceso al nuestro.&#x20;

## Archivos

Soportamos una amplia variedad de formatos para los archivos que desees subir al servidor:

* JSON
* EXCEL
* CSV
* XML
* EDIFILE

En estos archivos es importante que se incluya toda la información requerida para crear una entrega en nuestro sistema, puedes revisar los campos requeridos en [este link](https://docs.shippify.co/developers/shippify-api/entregas/creacion-de-entregas).&#x20;

## Requerimiento

Para poder activar esta integración es necesario que nos envies un requerimiento por email a `integrations@shippify.co` con toda la información para la configuración. En este espacio te dejo los datos que debes enviar y ejemplos:

* **Email de mi compañia en shippify**: Aqui deberas escribirnos el email de tu cuenta en shippify
* **Servidor SFTP:**  Shippify o Propio. Si es propio adjuntar los siguientes datos:
  * Host
  * Puerto
  * Usuario&#x20;
  * Contraseña
* **Tipo de archivo:** formato del archivo que subirás al sftp, puede ser JSON, EXCEL, CSV, XML o EDIFILE.
* **Tiempo:** Indica cada cuanto tiempo subirás un archivo
* **Pedidos por archivo:** Indica cuantos pedidos vienen en cada archivo.
* **Archivo de ejemplo:** Aqui puedes adjuntar un archivo de ejemplo que subirás al sftp o dejar una url al archivo.
* **Descripción del archivo:** Aqui podrás dejar un excel, adjunto o por url, con el significado de cada campo que contiene el archivo y si necesitas que se registre en la plataforma o no.

<details>

<summary>Request usando el sftp de shippify</summary>

```
Buenas días,

Deseo crear las entregas en shippify por medio de un sftp.
Adjunto los datos necesarios:

* Email de mi compañia en shippify: example@shippify.co
* Servidor SFTP: Shippify
* Tipo de archivo: JSON
* Archivo de Ejemplo: Documento adjunto
* Descripción del archivo: Documento adjunto

De antemano gracias,

Att.
Nombre
```

</details>

<details>

<summary>Request usando un sftp propio</summary>

```
Buenas días,

Deseo crear los entregas en shippify por medio de un sftp.
Adjunto los datos necesarios:

* Email de mi compañia en shippify: example@shippify.co
* Servidor SFTP: Propio
    * Host: sftp-test.millunas.co
    * Puerto: 43
    * Usuario: test
    * Contraseña: *******
* Tipo de archivo: JSON
* Tiempo: Se subirá un archivo a las 12pm todos los día.
* Pedidos por archivo: Cada archivo tendrá entre 100 y 200 pedidos
* Archivo de Ejemplo: Documento adjunto
* Descripción del archivo: Documento adjunto

De antemano gracias,

Att.
Nombre
```

</details>


---

# 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.shippify.co/developers/guia-de-integracion/procesos-basicos/creacion-de-entregas/sftp.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.
