|   Integración

Soporte

Integración clientes

|   Integración

Integración clientes

Soporte

Integra tus clientes

La integración de clientes requiere de una conexión particular de cada cliente a nuestro servidor SFTP.

Esta conexión se la creará uno de nuestros propios técnicos y se enviará a la cuenta de correo electrónico que se introdujo en el momento del registro de la empresa en Polpoo. Como ERP, deberéis pedir a la empresa que os otorgue las siguientes credenciales:

Usuario: Nombre de usuario.

Contraseña: Contraseña del usuario.

Servidor: Dirección a la que conectarse.

Puerto: Puerto por el cual se conectará el cliente a nuestro servidor.

También recibiréis la información del directorio de la empresa donde deberéis realizar las integraciones correspondientes.

En cuanto a la configuración, la empresa deberá introducir un correo electrónico de soporte para las integraciones para que, en caso de haber algún tipo de error en alguno de los procesos, el ERP pueda observar cuál ha sido la incidencia. Esto es configurable desde la Configuración de la empresa, en el apartado Integraciones.

1. Tipo de documento: clients.json

Un cliente se define como una localización en la que se puede realizar la entrega o recogida de un pedido.

El fichero para la integración de clientes debe llamarse clients.json y debe estar codificado en UTF-8. Se dejará en el directorio raíz (./).

En caso de cargar un fichero en el SFTP con el mismo nombre que un fichero ya existente, este se sobrescribirá.

La plataforma cargará los nuevos clientes y podrás encontrarlos en el menú Gestión -> Clientes.

Es importante que la información de los campos no contenga comillas dobles (p.e: "Frutería "El sol""), ya que los ficheros .json trabajan con comillas dobles para delimitar los campos y la información. En caso de tener algún dato de este estilo, la integración no se realizará correctamente. Cualquier otro símbolo especial es aceptado.

Se definen los campos que pertenecen a este fichero de la siguiente manera:

* La información obligatoria está marcada en rojo. En caso de que no se tenga la información de un campo opcional, no se tiene que añadir la etiqueta en el fichero .json.

2. Especificaciones de los campos

id string - obligatorio
Identificador único del cliente.

nif string
NIF del cliente.

name string - obligatorio
Nombre del cliente.

address string obligatorio
Dirección principal de envío del cliente.

deliveryWindow.start integer
Hora en la que se puede empezar a repartir en un cliente (segundos).

deliveryWindow.end integer
Hora en la que ya no se puede repartir en un cliente (segundos).

serviceTime integer obligatorio
Tiempo estimado para realizar la descarga en el cliente (segundos).

demand integer obligatorio
Espacio que ocupa el pedido de un cliente (se manda 0).

email string
Correo electrónico del cliente.

sendDeliveryNoteMail boolean
Si el cliente recibirá o no un email cuando se le haya entregado el pedido.

population string
Población del cliente.

addresses.address string
Dirección secundaria del cliente.

addresses.postalCode string
Código postal de la dirección secundaria del cliente.

addresses.province string
Provincia de la dirección secundaria del cliente.

addresses.coordiantes.longitude number
Coordenada de longitud de la dirección secundaria del cliente.

addresses.coordiantes.latitude number
Coordenada de latitud de la dirección secundaria del cliente.

service.code string obligatorio si se envía un servicio
Código de la especificación de servicio.

service.name string obligatorio si se envía un servicio
Nombre de la especificación de servicio.

phones.name string
Nombre del contacto del teléfono secundario.

phones.phone string
Número de teléfono secundario.

showDeliveryNotePrice boolean
Si sus albaranes aparecerán con precios o sin precios.

3. Ejemplos y descargables

{
    "deliveryPoints": [
    {
        "id": "119029",
        "nif": "12345678A",
        "name": "Empresa Prueba SL",
        "address": "Pg. Sant Joan 6, 08009, Barcelona",
        "deliveryWindow": {
            "start": 14400,
            "end": 39600
        }
        "serviceTime": 600,
        "demand": 0,
        "email": "prueba@empr.com",
        "sendDeliveryNoteEmail": true,
        "population": "Barcelona",
        "addresses": [
        {
            "address": "Calle del Montevideo 3, 08009, Barcelona",
            "postalCode": "08009",
            "province": "Barcelona",
            "coordinates": {
                "longitude": 41.394149,
                "latitude": 2.1087109
            }
        }
        ],
        "service": {
            "code": "00002",
            "name": "Frío"
        },
        "phones": [
        {
            "name": "Administración",
            "phone": "+34666555777"
        }
        ],
        "showDeliveryNotePrice": true
    }
    ]
}

4. ¿Cómo recibo la información en Polpoo?

Una vez cargado satisfactoriamente el fichero clients.json en el SFTP, nuestra plataforma lo absorbe automáticamente añadiendo los nuevos clientes en nuestra base de datos y/o modificando los clientes ya existentes con la nueva información.

Para comprobar la carga correcta del contenido, nos dirigimos al menú Gestión -> Clientes. Una vez ahí, deberán aparecer en la tabla los clientes importados.

* El botón llamado Importar dentro de Gestión -> Clientes, únicamente sirve para la carga de clientes mediante fichero Excel. Podéis encontrar información referente a este tipo de importación en el siguiente enlace:

Integra tus clientes

La integración de clientes requiere de una conexión particular de cada cliente a nuestro servidor SFTP.

Esta conexión se la creará uno de nuestros propios técnicos y se enviará a la cuenta de correo electrónico que se introdujo en el momento del registro de la empresa en Polpoo. Como ERP, deberéis pedir a la empresa que os otorgue las siguientes credenciales:

Usuario: Nombre de usuario.

Contraseña: Contraseña del usuario.

Servidor: Dirección a la que conectarse.

Puerto: Puerto por el cual se conectará el cliente a nuestro servidor.

También recibiréis la información del directorio de la empresa donde deberéis realizar las integraciones correspondientes.

En cuanto a la configuración, la empresa deberá introducir un correo electrónico de soporte para las integraciones para que, en caso de haber algún tipo de error en alguno de los procesos, el ERP pueda observar cuál ha sido la incidencia. Esto es configurable desde la Configuración de la empresa, en el apartado Integraciones.

1. Tipo de documento: clients.json

Un cliente se define como una localización en la que se puede realizar la entrega o recogida de un pedido.

El fichero para la integración de clientes debe llamarse clients.json y debe estar codificado en UTF-8. Se dejará en el directorio raíz (./).

En caso de cargar un fichero en el SFTP con el mismo nombre que un fichero ya existente, este se sobrescribirá.

La plataforma cargará los nuevos clientes y podrás encontrarlos en el menú Gestión -> Clientes.

Es importante que la información de los campos no contenga comillas dobles (p.e: "Frutería "El sol""), ya que los ficheros .json trabajan con comillas dobles para delimitar los campos y la información. En caso de tener algún dato de este estilo, la integración no se realizará correctamente. Cualquier otro símbolo especial es aceptado.

Se definen los campos que pertenecen a este fichero de la siguiente manera:

* La información obligatoria está marcada en rojo. En caso de que no se tenga la información de un campo opcional, no se tiene que añadir la etiqueta en el fichero .json.

2. Especificaciones de los campos

id string - obligatorio
Identificador único del cliente.

nif string 
NIF del cliente.

name string - obligatorio
Nombre del cliente.

address string obligatorio
Dirección principal de envío del cliente.

deliveryWindow.start integer
Hora en la que se puede empezar a repartir en un cliente (segundos).

deliveryWindow.end integer
Hora en la que ya no se puede repartir en un cliente (segundos).

serviceTime integer obligatorio
Tiempo estimado para realizar la descarga en el cliente (segundos).

demand integer obligatorio
Espacio que ocupa el pedido de un cliente (se manda 0).

email string
Correo electrónico del cliente.

sendDeliveryNoteMail boolean
Si el cliente recibirá o no un email cuando se le haya entregado el pedido.

population string
Población del cliente.

addresses.address string
Dirección secundaria del cliente.

addresses.postalCode string
Código postal de la dirección secundaria del cliente.

addresses.province string
Provincia de la dirección secundaria del cliente.

addresses.coordiantes.longitude number
Coordenada de longitud de la dirección secundaria del cliente.

addresses.coordiantes.latitude number
Coordenada de latitud de la dirección secundaria del cliente.

services.code integer
Identificador del servicio.

services.name string
Nombre del servicio.

phones.name string
Nombre del contacto del teléfono secundario.

phones.phone string
Número de teléfono secundario.

showDeliveryNotePrice boolean
Si sus albaranes aparecerán con precios o sin precios.

3. Ejemplos y descargables

{
    "deliveryPoints": [
    {
        "id": "119029",
        "nif": "12345678A",
        "name": "Empresa Prueba SL",
        "address": "Pg. Sant Joan 6, 08009, Barcelona",
        "deliveryWindow": {
            "start": 14400,
            "end": 39600
        }
        "serviceTime": 600,
        "demand": 0,
        "email": "prueba@empr.com",
        "sendDeliveryNoteEmail": true,
        "population": "Barcelona",
        "addresses": [
        {
            "address": "Calle del Montevideo 3, 08009, Barcelona",
            "postalCode": "08009",
            "province": "Barcelona",
            "coordinates": {
                "longitude": 41.394149,
                "latitude": 2.1087109
            }
        }
        ],
        "services": [
        {
            "code": "00002",
            "name": "Frío"
        },
        {
            "code": "00003",
            "name": "Plataforma"
        }
        ],
        "phones": [
        {
            "name": "Administracion",
            "phone": "+34666555777"
        }
        ],
        "showDeliveryNotePrice": true
    }
    ]
}

4. ¿Cómo recibo la información en Polpoo?

Una vez cargado satisfactoriamente el fichero clients.json en el SFTP, nuestra plataforma lo absorbe automáticamente añadiendo los nuevos clientes en nuestra base de datos y/o modificando los clientes ya existentes con la nueva información.

Para comprobar la carga correcta del contenido, nos dirigimos al menú Gestión -> Clientes. Una vez ahí, deberán aparecer en la tabla los clientes importados.

* El botón llamado Importar dentro de Gestión -> Clientes, únicamente sirve para la carga de clientes mediante fichero Excel. Podéis encontrar información referente a este tipo de importación en el siguiente enlace: