Guía de usuario

Historial de revisiones

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

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.

{

"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"

}

]

}

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

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: 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:

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:

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

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.

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.