User Guide
0 mins to read
•Add-In Importación de transacciones de combustible
User Guide
0 mins to read
•Obtenga más información sobre el Add-In Importación de transacciones de combustible, que permite a los usuarios importar a MyGeotab transacciones de repostaje extraídas por la aplicación/servicio del proveedor de combustible. Este documento muestra cómo importar transacciones utilizando tres opciones diferentes: WEX, Estándar general e Importar proveedor de combustible.
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
[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.
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:
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.
Para instalar el Add-In, siga los siguientes pasos:
{
"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"
}
]
}
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.
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.
{ "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": "" } } ]}
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.
{ "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:
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":""
Para importar un archivo JSON, siga los siguientes pasos:
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.
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.