Importar envíos en forma masiva CSV

Owned by Pablo Bossi
Last updated: Jul 23, 2021 by Marcos Detry
7 min read

Esta forma de importar envío CSV es antigua y no se recomienda utilizar.

Por favor ver este artículo para una versión actualizada de importación de CSV y Excel a Moova

Cuando se requiera generar una cantidad grande de shippings, de modo que no sea viable hacerlo manualmente mediante el Dashboard de MOOVA, existe un formato de archivo .CSV para dar de alta envíos en forma masiva.
El CSV ha generar cuenta con los siguientes campos:

  • internalCode: En caso de que los envíos a cargar tengan un código interno de la empresa que lo carga. Si lo ingresan luego podrán verlo en el listado de envíos y podrán buscar un envío por este código,. En caso que estén ingresando un envío del type mercado_flex en este campo deben ingresar el nro de envío (es el que figura en la etiqueta de FLEX como “Envío: XXXXXXXXXXXX”)

  • type: Es el tipo de envío. Los mas utilizados en este caso son: regular o mercado_flex. Entre otros podrían ser: minutes_90, pickup, frio o menos comunmente:( tienda_nube_24_horas_max, magento_2_24_horas_max, woocommerce_24_horas_max, shopify_24_horas_max, magento_1_24_horas_max, vtex_24_horas_max, tienda_nube_48_horas_max, prestashop_24_horas_max. Para un descripción de los mas habituales ver: Tipos de envíos

  • scheduledDate (opcional): En caso de que el envio deba realizarse en una fecha específica a futuro, puede crearse, indicando en este campo dicha fecha. El formato de fecha es: YYYY-mm-dd H:i:s (2020-12-20 18:23:00)

  • description (opcional): Permite agregar una descripción del contenido del envío.

  • items (opcional): Dentro de un envio pueden enviarse mas de un paquete/producto/documento, este campo se setea en varias columnas y permite describir el contenido de un envio. Tiene particular importancia los datos de tamaño de los items, dado que esto determinará que tipos de vehículo pueden retirarlo.Describe los items contenidos en el envio, pueden figurar varios, para ello, debe indicarse un número de item en las configuraciones a continuación (N, debe reemplazarse por números secuenciales, empezando por el 0)

    • conf.items.N.price (opcional): En caso de ventas, aqui puede indicarse el precio del item N, no tiene mayor uso actualmente, a futuro, podría servir para funcionalidades adicionales como contrarto de seguros

    • conf.items.N.width (opcional): Ancho del item N del envío

    • conf.items.N.height (opcional): Alto del item N del envío

    • conf.items.N.length (opcional): Largo del item N del envío

    • conf.items.N.weight (opcional): Peso del item N del envío

  • from (Opcional): Es un campo compuesto, indica el punto de origen desde el cual se realiza el envio, normalmente se usa cuando se quiere crear un envio a recibir, si no se pasa se tomará como default la dirección cargada para su compañia..

    • from.place_id: Si se conoce el id de ubicación interno de MOOVA, se puede enviar en este campo

    • from.coords: Existen casos en los que la dirección no es detectable por MOOVA o por distintas razones no se puede escribir en forma unívoca, para estos casos puede pasarse las coordenadas de esta ubicación.

      • from.coords.lat: Latitud

      • from.coords.lng: Combinado con el campo anterior marcan una ubicación

    • from.addressDescription: En el caso de pasar coordenadas, se utiliza este campo para agregar una descripción legible de la dirección de origen que sirva al mensajero como referencia

    • from.googlePlaceId: En el caso de conocer el id de ubicación en google maps, puede pasarse dicho Id como identificador de la dirección

    • from.address: En el caso que tengamos la dirección toda junta : “Carlos Pellegrini 1760, CABA, Argentina” entonces utilizamos este campo. Si usamos este entonces NO ponemos from.street y from.number dado que los reemplaza

    • from.country: Actualmente no se soportan envíos internacionales con lo que debe coincidir con el país de destino

    • from.state: Nombre del estado/provincia de la dirección

    • from.city: Ciudad de origen del envio

    • from.street: Calle en la cual debe retirarse el envio

    • from.number: Altura de la calle en la cual debe retirarse el envio

    • from.floor (opcional): En caso de corresponder (Ejemplo la dirección de origen es un edificio), el piso

    • from.apartment (opcional): En caso de corresponder, cual es el departamento

    • from.postalCode (opcional): Código postal de la dirección

    • from.instructions (opcional): Indicaciones extras en el origen (Ejemplo: Se puede indicar si el timbre no esta funcionando). Lo que se escriba aquí lo va a leer el mensajero que tiene que hacer la entrega.

    • from.contact: Es un campo compuesto que indica los datos de contacto de quien realiza el envío.

      • from.contact.firstName: Nombre del contacto

      • from.contact.lastName: Apellido del contacto

      • from.contact.email: Email de contacto

      • from.contact.phone: Teléfono del contacto (Este dato y el anterior pueden servir al moover para contactarse en caso de no encontrar a la persona al retirar el envio o incluso para el envio de notificaciones)

Importante: Al importar envíos se requerirá una dirección de origen por defecto, todos los envios que no tengan seteado en el archivo csv el campo from tomarán esta dirección como origen.
También es importante notar que si se configura el campo from, para ese envío todos los campos por defecto serán ignorados. A modo de ejemplo si los datos de contacto son los mismos que el contacto por defecto, el mismo debera volver a incluirse en el campo from si se seteara una dirección de origen distinta por este método.

  • to: Es un campo compuesto, indica el punto de destino al cual se desea realizar el envio.

    • to.place_id: Si se conoce el id de ubicación interno de MOOVA, se puede enviar en este campo

    • to.coords: Existen casos en los que la dirección no es detectable por MOOVA o por distintas razones no se puede escribir en forma unívoca, para estos casos puede pasarse las coordenadas de esta ubicación.

      • to.coords.lat: Latitud

      • to.coords.lng: Combinado con el campo anterior marcan una ubicación

    • to.addressDescription: En el caso de pasar coordenadas, se utiliza este campo para agregar una descripción extra de la dirección de destino

    • to.googlePlaceId: En el caso de conocer el id de ubicación en google maps, puede pasarse dicho Id como identificador de la dirección

    • to.country: Actualmente no se soportan envíos internacionales con lo que debe coincidir con el país de origen

    • to.state: Nombre del estado/provincia de la dirección

    • to.city: Ciudad de destino del envío

    • to.street: Calle en la cual debe entregarse el envío. Si tenemos la dirección junta con el número entonces hay que usar to.address

    • to.number: Altura de la calle en la cual debe entregarse el envío

    • to.floor (opcional): En caso de corresponder (Ejemplo la dirección de destino es un edificio), el piso

    • to.apartment (opcional): En caso de corresponder, cual es el departamento

    • to.postalCode (opcional): Código postal de la dirección

    • to.address: En el caso que tengamos la dirección toda junta : “Carlos Pellegrini 1760, CABA, Argentina” entonces utilizamos este campo. Si usamos este entonces NO ponemos to.street y to.number dado que los reemplaza

    • to.instructions (opcional): Indicaciones extras en el destino (Ejemplo: Se puede indicar si el timbre no esta funcionando). Lo que se escriba aquí lo va a leer el mensajero que tiene que hacer la entrega.

    • to.contact: Es un campo compuesto que indica los datos de contacto del destinatario del envío.

      • to.contact.firstName: Nombre del contacto

      • to.contact.lastName: Apellido del contacto

      • to.contact.email: Email de contacto

      • to.contact.phone: Teléfono del contacto (Este dato y el anterior pueden servir al moover para contactarse en caso de no encontrar a la persona en el destino o incluso para el envio de notificaciones)

    • to.message: Mensaje que se quiera comunicar al moover que realice la entrega

Importante, tanto para los campos from y to, existen distintas formas de indicar una dirección:

Si se ingresa el campo place_id, no son necesarios los datos googlePlaceId, country, state, city, street, number, lat, lng. (Ver 1 en la imagen.)

Si se ingresa el campo googlePlaceId, los campos placeid, country, state, city, street, number, lat y lng son optativos, pero un googlePlaceid puede no identificar una dirección en forma unívoca, lo que produciría que el envio quede en estado DRAFT hasta que se confirme la dirección.(ver 3 en la imagen)

Si se ingresan las coordenadas lat, lng, nuevamente el resto de los campos para indicar una dirección son optativos (Ver 2 en la imagen)

Finalmente pueden ingresarse solo los datos de dirección: country, state, city, street y number, y en este caso se pueden obviar los campos nombrados anteriormente. (Ver 4 en la imagen).

Nota: en el archivo adjunto con ejemplos, encontraran un archivo ‘ejemplo_4.csv’ donde podrán ver un ejemplo de una de las formas de indicar una dirección.

  • settings: Es un campo que permite agregar algunas peculiaridades a un envío. Por ejemplo

    • BackAndForth : Envío de ida y vuelta

    • UpdateDeliveredItems : Se escanea el numero de serie del dispositivo

    • BackAndForth|UpdateDeliveredItems : Las dos anteriores juntas. Se tiene que separar por un pipe | y no hay que dejar espacio.

En el archivo adjunto encontrarán algunos ejemplos de CSV de ejemplo