Envío de albaranes

Otros

Envía tus albaranes

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: 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 de vuestra compañía (./company_X/).

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 recibos.

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 recibos en un mismo destino, se tiene que añadir un único registro de ese cliente cliente con 5 recibos.

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.kg float

Carga en kilos del albarán.


deliveryNotes.volumen float

Carga en metros cúbicos del albarán.


deliveryNotes.palets integer

Número de palets del albarán.


deliveryNotes.package integer

Número de bultos del albarán.


deliveryNotes.sendDeliveryNoteCompanyId integer
Id de la compañía donde irá la información de los albaranes. *Sólo para multialmacé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.promptPayDiscountPercent float
Porcentaje de descuento a aplicar en el precio total del albarán.


deliveryNotes.managementCost float
Coste de gestión del albarán.


deliveryNotes.scannedCode string – sólo con el módulo Paquetería
Código de escaneo del albarán.


deliveryNotes.isBill boolean 
Si es true, esta información pasará a ser de factura. Si es false o no se envío este campo, será un albarán.


deliveryNotes.date date
Fecha que aparecerá en el albarán.


deliveryNotes.barCode string
Imagen en base64 del código de barras que aparecerá en el albarán.


deliveryNotes.deliveryIdentifier string
Identificador de la entrega para asignación correcta del albarán. Vinculación con el mismo campo en rutas.


deliveryNotes.isDevolution boolean 
Marca si el albarán es de entrega o recogida. En caso de ser «True» será de recogida y en caso de ser «False» o no mandar la información, será de entrega.


deliveryNotes.documentStore string 
Almacén del documento (sólo informativo).


deliveryNotes.documentType string 
Tipo de documento (sólo informativo).


deliveryNotes.documentSeries string 
Serie del documento (sólo informativo).


deliveryNotes.documentExercise string 
Ejercicio del documento (sólo informativo).


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


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


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


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


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


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


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


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


deliveryNotes.companyAssociated.billingAddress string – obligatorio si factura a 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.


deliveryNotes.products.scannedCode string – sólo con el módulo Paquetería
Código de escaneo del bulto.


deliveryNotes.products.discountPercent float
Descuento en porcentaje del producto.


deliveryNotes.products.supplierReference string
Proveedor del producto.

3. Ejemplos y descargables

{
    «deliveryPoints»: [{
        «id»: «119029»,
        ”deliveryNotes”: [
        {

            «kg»:1450.5,

    «volumen»:300.6,

    «palets»:4,

    «packages»:2,

            «deliveryNoteCode»: «45466770»,
            «deliveryNoteObservation»: «Observaciones»,
            «sendDeliveryNoteCompanyId»: 231,
            «deliveryNoteOrderCode»: «2013»,
            «showDeliveryNotePrice»: true,
            «promptPayDiscountPercent»: 33,
            «managementCost»: 3.27,
            «scannedCode»: «626763132»,
            «isBill»: false,
            «date»: «2022-11-28»,
            «barCode»: «data:image/png;base64,iVBORw0KGgoAAAA….»,
            «deliveryIdentifier»: «2»,
            «isDevolution»: False,
            «documentStore»: «12»,
            «documentType»: «A»,
            «documentSeries»: «7»,
            «documentExercise»: «2023»,

            «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»,

                «scannedCode»: «32143242»,

                «discountPercent»: 20,
                «supplierReference»: «Proveedor de manzanas»
            }]
        }
        ]
    }
    ]
}

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ú Seguimiento -> Seguimiento de viajes.

Dentro del apartado Seguimiento de viajes, se encontrarán las rutas asignadas previamente desde el Planificador. Para cargar los recibos desde el ftp, clicaremos en el botón Cargar albarán 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.