|   Integración

Soporte

Integración albaranes

|   Integración

Integración albaranes

Soporte

Integra tus albaranes

La integración de albaranes 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: albarans.json

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

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

En un mismo fichero tienen que venir toda la información de todos los albaranes.

Si un cliente tiene más de un albarán, se tiene que añadir como nuevo registro en el array "deliveryNotes". Si por ejemplo, se entregan 5 albaranes en un mismo destino, se tiene que añadir un único registro de ese cliente cliente con 5 albaranes.

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.

deliveryNotes.deliveryNoteCode string – obligatorio
Número o código del albarán.

deliveryNotes.deliveryNoteObservation string
Observaciones del albarán.

deliveryNotes.deliveryNoteOrderCode string
Número del pedido referente al albarán.

deliveryNotes.showDeliveryNotePrice boolean
Si aparecerá el albarán con precios o sin precios.

deliveryNotes.deliveryPayDiscuntPercent float
Porcentaje de descuento a aplicar en el precio total del albarán.

deliveryNotes.companyAssociated.code string – obligatorio si factura compañía asociada
Código de la compañía asociada.

deliveryNotes.companyAssociated.name string – obligatorio si factura compañía asociada
Nombre de la compañía asociada.

deliveryNotes.companyAssociated.nif string – obligatorio si factura compañía asociada
NIF de la compañía asociada.

deliveryNotes.companyAssociated.streetAddress string – obligatorio si factura compañía asociada
Dirección de la compañía asociada.

deliveryNotes.companyAssociated.city string – obligatorio si factura compañía asociada
Ciudad de la compañía asociada.

deliveryNotes.companyAssociated.province string – obligatorio si factura compañía asociada
Provincia de la compañía asociada.

deliveryNotes.companyAssociated.zipCode string – obligatorio si factura compañía asociada
Código postal de la compañía asociada.

deliveryNotes.companyAssociated.phone string – obligatorio si factura compañía asociada
Número de teléfono de la compañía asociada.

deliveryNotes.companyAssociated.billingAddress string – obligatorio si factura compañía asociada
Correo de facturación de la compañía asociada.

deliveryNotes.products.code string obligatorio
Identificador del producto.

deliveryNotes.products.name string obligatorio
Nombre del producto.

deliveryNotes.products.quantity float obligatorio
Cantidad del producto.

deliveryNotes.products.price float obligatorio
Precio del producto por medida.

deliveryNotes.products.measureQuantity float
Cantidad del producto referente a la medida.

deliveryNotes.products.taxPercent integer obligatorio
Impuesto sobre el Valor Añadido (IVA) del producto.

deliveryNotes.products.equivalencePercent float
Porcentaje del recargo de equivalencia del producto.

deliveryNotes.products.measure string obligatorio
Formato del producto.

deliveryNotes.products.grossMass float
Peso bruto del producto.

deliveryNotes.products.tare float
Tara del producto.

deliveryNotes.products.netMass float
Peso neto del producto.

deliveryNotes.products.lotCode string
Identificador del lote al que pertenece el producto.

deliveryNotes.products.observation string
Observaciones del producto.

3. Ejemplos y descargables

{
    "deliveryPoints": [{
        "id": "119029",
        ”deliveryNotes”: [
        {
            "deliveryNoteCode": "45466770",
            "deliveryNoteObservation": "Observaciones",
            "deliveryNoteOrderCode": "2013",
            "showDeliveryNotePrice": true,
            "deliveryPayDiscountPercent": 21,

            "companyAssociated":{
                "code": "0023",
                "name": "Empresa Asociada SL",
                "nif": "B78902232",
                "streetAddress": "Pg. Sant Joan 21, 08009, Barcelona",
                "city": "Barcelona",
                "province": "Barcelona",
                "zipCode": "08009",
                "phone": "+346162666112",
                "billingEmail": "asociada@empr.com"
            },

            "products": [{
                "code": "PX-34",
                "name": "Manzana Pink Pearl",
                "quantity": 23,
                "price": 0.67,
                "measureQuantity": 2,
                "taxPercent": 21,
                "equivalencePercent": 5.2,
                "measure": "KGS",
                "grossMass": 0.67,
                "tare": 0.16,
                "netMass": 0.51,
                "lotCode": "11297090",
                "observation": "Observaciones"
            }]
        }
        ]
    }
    ]
}

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

Partimos de la base que, para que el fichero de albaranes pueda ser absorbido y cargado correctamente por Polpoo, debe haber la/s ruta/s de los clientes que forman parte de ese albarán asignada/s.

En caso de tener dudas acerca de la integración de rutas podéis ver la guía en el siguiente enlace:

Una vez cargado satisfactoriamente el fichero albarans.json en el SFTP y las rutas correctamente asignadas, debemos importar esto albaranes en la plataforma Polpoo.

Para ello, nos dirigimos al menú Rutas -> Rutas asignadas.

Dentro del apartado Rutas asignadas, se encontrarán las rutas asignadas previamente desde el planificador. Para cargar los albaranes desde el ftp, clicaremos en el botón Cargar albaranes y seleccionaremos la opción Importar desde nube.

Automáticamente, podremos visualizar el albarán de cada uno de los clientes desde los detalles de la entrega.

5. ¿Cómo devuelvo los albaranes a Polpoo?

Una vez finalizadas las rutas del día, las podrás encontrar en el menú Histórico de rutas. n este punto podrás buscar por día las rutas terminadas con la información de los albaranes.

Para mandar los albaranes al SFTP, clicamos en el botón derecho Descargar albaranes y en el siguiente submenú, Enviar a nube.

6. Tipo de documento

El fichero se llamará route_NombreDeLaRuta_YYYYMMDD.json, donde YYYY es el año, MM es el mes y DD es le día en que se manda el fichero de vuelta. Está codificado en UTF-8. Este tipo de fichero se recogerá de la carpeta routes (./routes) dentro del SFTP. Esta carpeta no estará disponible hasta que se mande un fichero de albaranes de vuelta por primera vez.

7. Especificaciones de los campos

id string
Identificador único del cliente.

signature string
Imagen en base64 de la firma del albarán.

deliveredBoxes integer
Número de cajas recogidas.

devolutionDeliveryNote string
Observaciones de la devolución.

observation string
Observaciones generales.

deliveryNoteObservation string
Observaciones del albarán.

dniDeliveryNote string
DNI de la persona que firma el albarán.

nameDeliveryNote string
Nombre de la persona que firma el albarán.

8. Ejemplos y descargables

[
    {
        "id": "119029",
        "signature": "data:image/jpeg;base64,/9j/4AAQSkZJRg",
        "deliveredBoxes": 3,
        "devolutionDeliveryNote": "Judías en mal estado",
        "observation": "null",
        "deliveryNoteObservation": "5% de descuento en albarán",
        "dniDeliveryNote": "12345678P",
        "nameDeliveryNote": "Javier Iglesias"
    }
]

Integra tus albaranes

La integración de albaranes 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: albarans.json

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

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

En un mismo fichero tienen que venir toda la información de todos los albaranes.

Si un cliente tiene más de un albarán, se tiene que añadir como nuevo registro en el array "deliveryNotes". Si por ejemplo, se entregan 5 albaranes en un mismo destino, se tiene que añadir un único registro de ese cliente cliente con 5 albaranes.

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.

deliveryNotes.deliveryNoteCode 

string – obligatorio
Número o código del albarán.

deliveryNotes.deliveryNoteObservation 

string
Observaciones del albarán.

deliveryNotes.deliveryNoteOrderCode

 string
Número del pedido referente al albarán.

deliveryNotes.showDeliveryNotePrice 

boolean
Si aparecerá el albarán con precios o sin precios.

deliveryNotes.deliveryPayDiscuntPercent float
Porcentaje de descuento a aplicar en el precio total del albarán.

deliveryNotes.companyAssociated.code 

string – obligatorio si factura compañía asociada
Código de la compañía asociada.

deliveryNotes.companyAssociated.name 

string – obligatorio si factura compañía asociada
Nombre de la compañía asociada.

deliveryNotes.companyAssociated.nif 

string – obligatorio si factura compañía asociada
NIF de la compañía asociada.

deliveryNotes.companyAssociated.streetAddress 

string – obligatorio si factura compañía asociada
Dirección de la compañía asociada.


deliveryNotes.companyAssociated.city 

string – obligatorio si factura compañía asociada
Ciudad de la compañía asociada.

deliveryNotes.companyAssociated.province 

string – obligatorio si factura compañía asociada
Provincia de la compañía asociada.

deliveryNotes.companyAssociated.zipCode 

string – obligatorio si factura compañía asociada
Código postal de la compañía asociada.


deliveryNotes.companyAssociated.phone 

string – obligatorio si factura compañía asociada
Número de teléfono de la compañía asociada.

deliveryNotes.companyAssociated.billingAddress 

string – obligatorio si factura compañía asociada
Correo de facturación de la compañía asociada.

deliveryNotes.products.code 

string obligatorio
Identificador del producto.

deliveryNotes.products.name 

string obligatorio
Nombre del producto.

deliveryNotes.products.quantity

 float obligatorio
Cantidad del producto.

deliveryNotes.products.price

 float obligatorio
Precio del producto por medida.

deliveryNotes.products.measureQuantity 

float
Cantidad del producto referente a la medida.

deliveryNotes.products.taxPercent 

integer obligatorio
Impuesto sobre el Valor Añadido (IVA) del producto.

deliveryNotes.products.equivalencePercent 

float
Porcentaje del recargo de equivalencia del producto.

deliveryNotes.products.measure

 float
Formato del producto.

deliveryNotes.products.grossMass 

float
Peso bruto del producto.

deliveryNotes.products.tare 

float
Tara del producto.

deliveryNotes.products.netMass 

float
Peso neto del producto.

deliveryNotes.products.lotCode

 string
Identificador del lote al que pertenece el producto.

deliveryNotes.products.observation 

+string
Observaciones del producto.

3. Ejemplos y descargables

{
    "deliveryPoints": [{
        "id": "119029",
        ”deliveryNotes”: [
        {
            "deliveryNoteCode": "45466770",
            "deliveryNoteObservation": "Observaciones",
            "deliveryNoteOrderCode": "2013",
            "showDeliveryNotePrice": true,
            "deliveryPayDiscountPercent": 21,

            "companyAssociated":{
                "code": "0023",
                "name": "Empresa Asociada SL",
                "nif": "B78902232",
                "streetAddress": "Pg. Sant Joan 21, 08009, Barcelona",
                "city": "Barcelona",
                "province": "Barcelona",
                "zipCode": "08009",
                "phone": "+346162666112",
                "billingEmail": "asociada@empr.com"
            },

            "products": [{
                "code": "PX-34",
                "name": "Manzana Pink Pearl",
                "quantity": 23,
                "price": 0.67,
                "measureQuantity": 2,
                "taxPercent": 21,
                "equivalencePercent": 5.2,
                "measure": "KGS",
                "grossMass": 0.67,
                "tare": 0.16,
                "netMass": 0.51,
                "lotCode": "11297090",
                "observation": "Observaciones"
            }]
        }
        ]
    }
    ]
}

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

Partimos de la base que, para que el fichero de albaranes pueda ser absorbido y cargado correctamente por Polpoo, debe haber la/s ruta/s de los clientes que forman parte de ese albarán asignada/s.

En caso de tener dudas acerca de la integración de rutas podéis ver la guía en el siguiente enlace:

Una vez cargado satisfactoriamente el fichero albarans.json en el SFTP y las rutas correctamente asignadas, debemos importar esto albaranes en la plataforma Polpoo.

Para ello, nos dirigimos al menú Rutas -> Rutas asignadas.

Dentro del apartado Rutas asignadas, se encontrarán las rutas asignadas previamente desde el planificador. Para cargar los albaranes desde el ftp, clicaremos en el botón Cargar albaranes y seleccionaremos la opción Importar desde nube.

Automáticamente, podremos visualizar el albarán de cada uno de los clientes desde los detalles de la entrega.