User Guide

0 mins to read

Apr 13, 2022

Guía de usuario

Historial de revisiones

Versión

Fecha

Modificación

1.0

5 de agosto de 2021

Primera versión.

1.1

28 de octubre de 2021

Se han añadido más formatos de fecha.

1.2

5 de noviembre de 2021

Se ha añadido la sección "Cómo importar una tarjeta de combustible con el Add-In".

1.3

10 de noviembre de 2021

Se ha añadido una nueva propiedad, currencyCodeMapped, en la plantilla JSON.

1.4

25 de enero de 2022

Se ha añadido una nueva propiedad, isCellDateType, en la plantilla JSON. Se han añadido más formatos de fecha.


Índice



Idiomas

[EN] If you want to see the latest version of this document in english, it’s available here.

[ES-LATAM] Si quieres leer la última versión de este documento en español, está disponible aquí.

[FR] Si vous voulez voir la dernière version de ce document en anglais, elle est disponible ici.

[IT] Se desideri vedere l’ultima versione di questo documento in italiano, è disponibile qui.

Introducción

El Add-In Fuel Transaction Import (Importación de transacciones de combustible) permite a los usuarios importar a MyGeotab transacciones de repostaje extraídas por la aplicación o el servicio del proveedor de combustible. Esta herramienta es una versión revisada del Add-In original.

Hay disponibles tres opciones para importar transacciones:

  1. WEX
  2. Estándar general
  3. Import Fuel Provider (Importación del proveedor de combustible) (NOVEDAD)

Este documento hace referencia a la versión 3.0.0 del Add-In.

! IMPORTANTE: El Add-In Fuel Transaction Import (Importación de transacciones de combustible) se encuentra en fase de desarrollo beta.

Instalación del Add-In

Para instalar el Add-In, siga los siguientes pasos:

  1. En el menú izquierdo de MyGeotab, haga clic en Administración > Sistema… > Configuración del sistema.
  2. Abra la pestaña Add-Ins.
  3. Haga clic en Nuevo Add-In.
  4. Introduzca la información que aparece a continuación en la pestaña Configuración.
  5. {

    "name": "Fuel Transaction Import (by Fabio)",

    "supportEmail": "fabiopolini@geotab.com",

    "version": "3.0.0",

    "items": [

    {

    "icon": "https://cdn.jsdelivr.net/gh/genobean11m/add-in-fuel-transaction-import@master/dist/images/icon.svg",

    "path": "EngineMaintenanceLink/",

    "menuName": {

    "en": "Fuel Transaction Import (by Fabio)"

    },

    "url": "https://cdn.jsdelivr.net/gh/genobean11m/add-in-fuel-transaction-import@master/dist/importFuelTransactions.html"

    }

    ]

    }

  6. Haga clic en Aceptar.

De esta forma podrá abrir el Add-In haciendo clic en Motor y mantenimiento > Fuel Transaction Import (Importación de transacciones de combustible) en el menú principal de MyGeotab.

Crear un archivo JSON

Para utilizar el Add-In Import Fuel Provider (Importación del proveedor de combustible), necesita un archivo JSON para que el Add-In reconozca de qué parte del archivo de la transacción debe recopilar los datos necesarios para la transacción de repostaje.

Plantilla del archivo de mapeo del proveedor de combustible (archivo JSON)

Plantilla Master 1.3

{ "providers": [ { "Name": "Provider Name", "unitVolumeLiters": "Y", "unitOdoKm": "Y",

"isCellDateType": "Y", "dateFormat": "YYYYMMDD", "timeFormat": "HHmm", "currencyCodeMapped": "", "data": { "cardNumber": "", "comments": "", "description": "", "device": "", "driver": "", "driverName": "", "externalReference": "", "licencePlate": "", "provider": "", "serialNumber": "", "siteName": "", "sourceData": "", "vehicleIdentificationNumber": "", "cost": "", "currencyCode": "", "dateTime": "", "location": "", "odometer": "", "productType": "", "volume": "", "version": "", "id": "" } } ] }

Introducir información en el archivo de mapeo del proveedor de combustible (archivo JSON)

El archivo JSON debe estar en formato JSON. El archivo JSON contiene una propiedad principal denominada "providers". Dentro de la propiedad "providers", el mapeo del proveedor de combustible se representa con una o más entidades. El archivo JSON debe estar en formato JSON.

El archivo JSON contiene una propiedad principal denominada "providers". Dentro de esta, hay una o más entidades que representan el mapeo del proveedor de combustible.

Ejemplo

{ "Name": "Provider Name", "unitVolumeLiters": "Y", "unitOdoKm": "Y",

"isCellDateType": "Y", "dateFormat": "YYYYMMDD", "timeFormat": "HHmm", "currencyCodeMapped": "", "data": { "cardNumber": "", "comments": "", "description": "", "device": "", "driver": "", "driverName": "", "externalReference": "", "licencePlate": "", "provider": "", "serialNumber": "", "siteName": "", "sourceData": "", "vehicleIdentificationNumber": "", "cost": "", "currencyCode": "", "dateTime": "", "location": "", "odometer": "", "productType": "", "volume": "", "version": "", "id": "" } }

Name: Representa el nombre del proveedor de combustible. El nombre aparecerá en un menú desplegable del Add-In.

unitVolumeLiters: Valor booleano que especifica si el combustible se expresa en litros o galones en el archivo de la transacción. Acepta únicamente "Y" o "N". Este campo es obligatorio y no puede dejarse vacío.

unitOdoKm: Valor booleano que especifica si la distancia que refleja el odómetro en el archivo de la transacción se expresa en km o millas. Acepta únicamente "Y" o "N". Este campo es obligatorio y no puede dejarse vacío.

isCellDateType: Valor booleano que especifica si la celda de fecha del archivo Excel presenta un formato de fecha o no. Por defecto, el valor es "Y" e indica que el formato de la celda en el archivo Excel es un formato de fecha. Si se trata de una fecha, el software no comprueba cómo se introduce la información en el campo dateFormat. Si se trata de una fecha y hora compuestas por varias celdas (por ejemplo, columna C + columna B), es obligatorio rellenar tanto el campo dateFormat como el timeFormat.

dateFormat: Especifica el formato de fecha encontrado en el archivo de la transacción. Consulte la siguiente tabla para comprobar los formatos permitidos. El Add-In cambiará automáticamente la fecha a formato UTC. Si la fecha se expresa en formato de horas, minutos y segundos, y en una sola celda en el archivo XLSX, el campo "timeFormat" puede dejarse vacío ["timeFormat" :""].

Tabla de formato de fecha:

YYYY-MM-DD

YYYY-MM-DDTHH:mm:ss

YYYY-MM-DDTh:m:s

YYYY-MM-DD HH:mm

YYYY-MM-DD HH:mm:ss

YYYY-MM-DD h:m:s

YYYY-MM-DDTHH:mm:ssZ

YYYY-MM-DDTh:m:sZ

YYYY-MM-DD HHmm

YYYY-MM-DD HHmmss

YYYY-MM-DDTHH:mm:ss.SSSZ

YYYY-MM-DD HH.mm

YYYY-MM-DD HH.mm:ss

YYYY-MM-DD h.m.s

YY-MM-DD

YY-MM-DDTHH:mm:ss

YY-MM-DDTh:m:s

YY-MM-DD HH:mm

YY-MM-DD HH:mm:ss

YY-MM-DD h:m:s

YY-MM-DDTHH:mm:ssZ

YY-MM-DDTh:m:sZ

YY-MM-DD HHmm

YY-MM-DD HHmmss

YY-MM-DDTHH:mm:ss.SSSZ

YY-MM-DD HH.mm

YY-MM-DD HH.mm:ss

YY-MM-DD h.m.s

YY-MM-DD H.mm

YY-MM-DD H.m

YYYY/MM/DD

YYYY/MM/DDTHH:mm:ss

YYYY/MM/DDTh:m:s

YYYY/MM/DD HH:mm

YYYY/MM/DD HH:mm:ss

YYYY/MM/DD h:m:s

YYYY/MM/DDTHH:mm:ssZ

YYYY/MM/DDTh:m:sZ

YYYY/MM/DD HHmm

YYYY/MM/DD HHmmss

YYYY/MM/DDTHH:mm:ss.SSSZ

YYYY/MM/DD HH.mm

YYYY/MM/DD HH.mm:ss

YYYY/MM/DD h.m.s

YY/MM/DD

YY/MM/DDTHH:mm:ss

YY/MM/DDTh:m:s

YY/MM/DD HH:mm

YY/MM/DD HH:mm:ss

YY/MM/DD h:m:s

YY/MM/DDTHH:mm:ssZ

YY/MM/DDTh:m:sZ

YY/MM/DD HHmm

YY/MM/DD HHmmss

YY/MM/DDTHH:mm:ss.SSSZ

YY/MM/DD HH.mm

YY/MM/DD HH.mm:ss

YY/MM/DD h.m.s

YY/MM/DD H.mm

YY/MM/DD H.m

YYYYMMDD

YYYYMMDDTHH:mm:ss

YYYYMMDDTh:m:s

YYYYMMDD HH:mm

YYYYMMDD HH:mm:ss

YYYYMMDD h:m:s

YYYYMMDDTHH:mm:ssZ

YYYYMMDDTh:m:sZ

YYYYMMDD HHmm

YYYYMMDD HHmmss

YYYYMMDDTHH:mm:ss.SSSZ

YYYYMMDD HH.mm

YYYYMMDD HH.mm.ss

YYYYMMDD h.m.s

YYMMDD

YYMMDDTHH:mm:ss

YYMMDDTh:m:s

YYMMDD HH:mm

YYMMDD HH:mm:ss

YYMMDD h:m:s

YYMMDDTHH:mm:ssZ

YYMMDDTh:m:sZ

YYMMDD HHmm

YYMMDD HHmmss

YYMMDDTHH:mm:ss.SSSZ

YYMMDD HH.mm

YYMMDD HH.mm.ss

YYMMDD h.m.s

YYMMDD H.mm

YYMMDD H.m

MM-DD-YYYY

MM-DD-YYYYTHH:mm:ss

MM-DD-YYYYTh:m:s

MM-DD-YYYY HH:mm

MM-DD-YYYY HH:mm:ss

MM-DD-YYYY h:m:s

MM-DD-YYYYTHH:mm:ssZ

MM-DD-YYYYTh:m:sZ

MM-DD-YYYY HHmm

MM-DD-YYYY HHmmss

MM-DD-YYYYTHH:mm:ss.SSSZ

MM-DD-YYYY HH.mm

MM-DD-YYYY HH.mm.ss

MM-DD-YYYY h.m.s

MM-DD-YY

MM-DD-YYTHH:mm:ss

MM-DD-YYTh:m:s

MM-DD-YY HH:mm

MM-DD-YY HH:mm:ss

MM-DD-YY h:m:s

MM-DD-YYTHH:mm:ssZ

MM-DD-YYTh:m:sZ

MM-DD-YY HHmm

MM-DD-YY HHmmss

MM-DD-YYTHH:mm:ss.SSSZ

MM-DD-YY HH.mm

MM-DD-YY HH.mm.ss

MM-DD-YY h.m.s

MM-DD-YY H.mm

MM-DD-YY H.m

MM/DD/YYYY

MM/DD/YYYYTHH:mm:ss

MM/DD/YYYYTh:m:s

MM/DD/YYYY HH:mm

MM/DD/YYYY HH:mm:ss

MM/DD/YYYY h:m:s

MM/DD/YYYYTHH:mm:ssZ

MM/DD/YYYYTh:m:sZ

MM/DD/YYYY HHmm

MM/DD/YYYY HHmmss

MM/DD/YYYYTHH:mm:ss.SSSZ

MM/DD/YYYY HH.mm

MM/DD/YYYY HH.mm.ss

MM/DD/YYYY h.m.s

MM/DD/YY

MM/DD/YYTHH:mm:ss

MM/DD/YYTh:m:s

MM/DD/YY HH:mm

MM/DD/YY HH:mm:ss

MM/DD/YY h:m:s

MM/DD/YYTHH:mm:ssZ

MM/DD/YYTh:m:sZ

MM/DD/YY HHmm

MM/DD/YY HHmmss

MM/DD/YYTHH:mm:ss.SSSZ

MM/DD/YY HH.mm

MM/DD/YY HH.mm.ss

MM/DD/YY h.m.s

MM/DD/YY H.mm

MM/DD/YY H.m

MMDDYYYY

MMDDYYYYTHH:mm:ss

MMDDYYYYTh:m:s

MMDDYYYY HH:mm

MMDDYYYY HH:mm:ss

MMDDYYYY h:m:s

MMDDYYYYTHH:mm:ssZ

MMDDYYYYTh:m:sZ

MMDDYYYY HHmm

MMDDYYYY HHmmss

MMDDYYYYTHH:mm:ss.SSSZ

MMDDYYYY HH.mm

MMDDYYYY HH.mm.ss

MMDDYYYY h.m.s

MMDDYY

MMDDYYTHH:mm:ss

MMDDYYTh:m:s

MMDDYY HH:mm

MMDDYY HH:mm:ss

MMDDYY h:m:s

MMDDYYTHH:mm:ssZ

MMDDYYTh:m:sZ

MMDDYY HHmm

MMDDYY HHmmss

MMDDYYTHH:mm:ss.SSSZ

MMDDYY HH.mm

MMDDYY HH.mm.ss

MMDDYY h.m.s

MMDDYY H.mm

MMDDYY H.m

DD-MM-YYYY

DD-MM-YYYYTHH:mm:ss

DD-MM-YYYYTh:m:s

DD-MM-YYYY HH:mm

DD-MM-YYYY HH:mm:ss

DD-MM-YYYY h:m:s

DD-MM-YYYYTHH:mm:ssZ

DD-MM-YYYYTh:m:sZ

DD-MM-YYYY HHmm

DD-MM-YYYY HHmmss

DD-MM-YYYYTHH:mm:ss.SSSZ

DD-MM-YYYY HH.mm

DD-MM-YYYY HH.mm.ss

DD-MM-YYYY h.m.s

DD-MM-YY

DD-MM-YYTHH:mm:ss

DD-MM-YYTh:m:s

DD-MM-YY HH:mm

DD-MM-YY HH:mm:ss

DD-MM-YY h:m:s

DD-MM-YYTHH:mm:ssZ

DD-MM-YYTh:m:sZ

DD-MM-YY HHmm

DD-MM-YY HHmmss

DD-MM-YYTHH:mm:ss.SSSZ

DD-MM-YY HH.mm

DD-MM-YY HH.mm.ss

DD-MM-YY h.m.s

DD-MM-YY H.mm

DD-MM-YY H.m

DD/MM/YYYY

DD/MM/YYYYTHH:mm:ss

DD/MM/YYYYTh:m:s

DD/MM/YYYY HH:mm

DD/MM/YYYY HH:mm:ss

DD/MM/YYYY h:m:s

DD/MM/YYYYTHH:mm:ssZ

DD/MM/YYYYTh:m:sZ

DD/MM/YYYY HHmm

DD/MM/YYYY HHmmss

DD/MM/YYYYTHH:mm:ss.SSSZ

DD/MM/YYYY HH.mm

DD/MM/YYYY HH.mm.ss

DD/MM/YYYY h.m.s

DD/MM/YY

DD/MM/YYTHH:mm:ss

DD/MM/YYTh:m:s

DD/MM/YY HH:mm

DD/MM/YY HH:mm:ss

DD/MM/YY h:m:s

DD/MM/YYTHH:mm:ssZ

DD/MM/YYTh:m:sZ

DD/MM/YY HHmm

DD/MM/YY HHmmss

DD/MM/YYTHH:mm:ss.SSSZ

DD/MM/YY HH.mm

DD/MM/YY HH.mm.ss

DD/MM/YY h.m.s

DD/MM/YY H.mm

DD/MM/YY H.m

DDMMYYYY

DDMMYYYYTHH:mm:ss

DDMMYYYYTh:m:s

DDMMYYYY HH:mm

DDMMYYYY HH:mm:ss

DDMMYYYY h:m:s

DDMMYYYYTHH:mm:ssZ

DDMMYYYYTh:m:sZ

DDMMYYYY HHmm

DDMMYYYY HHmmss

DDMMYYYYTHH:mm:ss.SSSZ

DDMMYYYY HH.mm

DDMMYYYY HH.mm.ss

DDMMYYYY h.m.s

DDMMYY

DDMMYYTHH:mm:ss

DDMMYYTh:m:s

DDMMYY HH:mm

DDMMYY HH:mm:ss

DDMMYY h:m:s

DDMMYYTHH:mm:ssZ

DDMMYYTh:m:sZ

DDMMYY HHmm

DDMMYY HHmmss

DDMMYYTHH:mm:ss.SSSZ

DDMMYY HH.mm

DDMMYY HH.mm.ss

DDMMYY h.m.s

DDMMYY H.mm

DDMMYY H.m

timeFormat: Campo que debe rellenarse si la hora se expresa en un formato de horas, minutos y segundos en el archivo de la transacción, y no ocupa una única celda de fecha. Si la hora ocupa varias celdas, utilice únicamente el formato de horas, minutos y segundos, y compruebe la tabla de formato de fecha para verificar si los formatos de dateFormat y timeFormat son válidos.

Ejemplos:

VÁLIDO

NO VÁLIDO

"dateFormat" :"YYYYMMDD",

"timeFormat" :"HHmm",

"dateFormat" :"YYYYMMDD",

"timeFormat" :"HH",

Resultado: "YYYYMMDD HHmm"

Resultado: "YYYYMMDD HH"

currencyCodeMapped: Campo en el que añadir directamente el código de divisa ISO 4217 de tres dígitos (es decir, "EUR" o "USD") en el archivo JSON. Valor de clave única; no acepta el mapeo de columnas del archivo XLSX. Campo opcional. Aparece como [""] por defecto.

data: Representa los datos que coincidirán con los datos del archivo XLSX. Todos los valores de la clave de esta sección deben seguir el siguiente formato, dependiendo del tipo de clave:

"Key": "ColumnA" (si la clave debe tener un único valor).

"Key": ["ColumnA", "ColumnB"] (si la clave puede tener varios valores encontrados en el documento XLSX).

La primera letra de ColumnA debe ser mayúscula ("C") y debe terminar con la letra de la columna identificada en el archivo XLSX.

Los siguientes campos también están documentados en la documentación del SDK de MyGeotab.

cardNumber: Número de tarjeta de compra parcial u oculto. Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Campo opcional. Aparece como [""] por defecto.

Comments: Campo de texto libre en el que se puede registrar y consultar cualquier información de usuario para esta entidad. Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Campo opcional. Aparece como [""] por defecto. Longitud máxima: 1.024 caracteres.

Description: Descripción del activo. Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Campo opcional. Aparece como [""] por defecto. Longitud máxima: 255 caracteres.

Device: No complete esta clave. Déjela vacía como se muestra a continuación: "device":""

Driver: No complete esta clave. Déjela vacía como se muestra a continuación: "driver":""

driverName: Nombre del titular de la tarjeta de combustible. Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Campo opcional. Aparece como [""] por defecto.

externalReference: Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Referencia externa a la transacción. Normalmente, se trata de un identificador externo. Campo opcional. Aparece como [""] por defecto. Longitud máxima [255].

licencePlate: Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Matrícula del vehículo. Se puede utilizar para asociar la transacción a un dispositivo. Campo obligatorio. Aparece como [""] por defecto [deben aparecer LicencePlate, serialNumber o vehicleIdentificationNumber]. Longitud máxima: 255 caracteres.

provider: Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Se trata del FuelTransactionProvider de la transacción. Campo opcional. Si se deja el campo por defecto [""], el proveedor será desconocido.

serialNumber: Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Se trata del número de serie del dispositivo. Se puede utilizar para asociar la transacción a un dispositivo. Campo opcional. Aparece como [""] por defecto [deben aparecer LicencePlate, serialNumber O vehicleIdentificationNumber]. Longitud máxima: 255 caracteres.

siteName: Valor de clave múltiple; acepta un formato de varias columnas en el archivo XLSX. Se trata del nombre del establecimiento o comercio donde se realizó la transacción. Campo opcional. Aparece como [""] por defecto. Ejemplo de "siteName" de varias columnas: ["ColumnA", "ColumnB"]

sourceData: No complete esta clave. Déjela vacía Debe aparecer de la siguiente forma: "SourceData":""

vehicleIdentificationNumber: Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Se trata del número de identificación del vehículo (VIN). Se utiliza para asociar la transacción a un dispositivo. Campo obligatorio. Aparece como [""] por defecto (deben aparecer LicencePlate, serialNumber o vehicleIdentificationNumber). Longitud máxima: 255 caracteres.

cost: Coste de la transacción de combustible. Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Campo opcional. Aparece como [""] por defecto.

currencyCode: Código de divisa ISO 4217 de tres dígitos (http://www.xe.com/iso4217.php). Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Campo opcional. Aparece como [""] por defecto. El código de divisa se puede especificar de las siguientes dos formas:

  1. Añada el código de divisa (por ejemplo, "EUR" o "USD") directamente en la propiedad "currencyCodeMapped" en el archivo JSON:
  2. Añada el mapeo de columnas en la propiedad "currencyCode" en el archivo JSON:

Primero, el Add-In comprueba la propiedad "currencyCodeMapped". Si está vacío, comprueba "currencyCode". Si esta última está vacía, el valor predeterminado importado será "USD".

dateTime: Valor de clave múltiple; acepta un formato de varias columnas en el archivo XLSX. Fecha y hora de la transacción. Campo opcional. Aparece como [""] por defecto. Ejemplo de "siteName" de varias columnas: ["ColumnA", "ColumnB"]

location: No complete esta clave. Déjela vacía como se muestra a continuación: "location":""

odometer: Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Se trata de la lectura del odómetro que ha registrado el conductor. Campo opcional. Aparece como [""] por defecto.

productType: Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Se trata del FuelTransactionProductType de esta transacción. Campo opcional. Si se deja el campo por defecto [""], el proveedor será desconocido.

volume: Valor de clave única; no acepta un formato de varias columnas en el archivo XLSX. Se trata del volumen de combustible comprado. Campo opcional. Aparece como [""] por defecto.

version: No complete esta clave. Déjela vacía como se muestra a continuación: "version":""

Id: No complete esta clave. Déjela vacía como se muestra a continuación: "id":""

Importar un archivo JSON

Para importar un archivo JSON, siga los siguientes pasos:

  1. Abra el Add-In y haga clic en Motor y mantenimiento > Fuel Transaction Import (Importación de transacciones de combustible) en el menú principal de MyGeotab.
  2. Haga clic en el botón Import Fuel Provider (Importar proveedor de combustible).

3. Haga clic en Select Provider File (Seleccionar archivo del proveedor) para elegir un archivo JSON.

4. Haga clic en Import Json File (Importar archivo JSON). Una vez el Add-In haya analizado el archivo correctamente, seleccione el proveedor en el menú desplegable.

Importar una tarjeta de combustible

Para importar una tarjeta de combustible, siga los siguientes pasos después de importar el archivo JSON.

! IMPORTANTE: El archivo de la tarjeta de combustible debe ser un archivo XLSX.

  1. Seleccione la casilla en Select Transaction File (Seleccionar archivo de transacción) en la sección Provider Selected (Proveedor seleccionado) si la zona horaria de las transacciones es diferente de la que aparece seleccionada automáticamente.
  2. Seleccione la zona horaria correcta para las transacciones de combustible que aparecen en el archivo XLSX.
  3. Haga clic en Browse (Examinar) para seleccionar el archivo XLSX de la tarjeta de combustible.
  4. Haga clic en Open File (Abrir archivo) para obtener una vista previa de las distintas columnas que se van a importar.
  5. Consulte la vista previa y haga clic en Import (Importar) si toda la información es correcta. De lo contrario, haga clic en Cancel (Cancelar).
  6. Haga clic en OK (Aceptar) para cerrar el mensaje de confirmación del identificador de la transacción.

scroll-up