> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/feature-references/feature-references-lac-es/referencias-de-funciones-y-productos/tarjetas-de-flota-commander-fleet/soporte-para-flotas-comerciales-de-quikq.md).

# Soporte para flotas comerciales de QuikQ

El soporte para flotas comerciales de QuikQ permite que los establecimientos con Verifone Commander acepten directamente las tarjetas para flotas comerciales de QuikQ como parte de Commander Fleet.

## Descripción general

QuikQ es un programa de tarjetas comerciales para flotas que usan las empresas de transporte por carretera. Esta función conecta el Commander directamente al host de QuikQ, para que las tarjetas de flota de QuikQ puedan presentarse y autorizarse en la estación de servicio de la misma manera que las tarjetas de flota comerciales de Comdata, WEX-OTR y otros proveedores: mediante la oferta Commander Fleet, con la configuración correspondiente en Commander Central, así como la certificación y los informes.

Una transacción de QuikQ es un intercambio de varios pasos con el host de QuikQ. Se captura el código de inicio del conductor (al deslizar la tarjeta o ingresarlo manualmente) y se envía a QuikQ; el conductor responde a las solicitudes que exija el host; QuikQ devuelve una política de transacción (qué productos están permitidos, los límites en dólares y si se permite un adelanto de efectivo); el Commander habilita la bomba dentro de esos límites; y, cuando se completa la venta, el Commander envía la compra a QuikQ, que devuelve el monto financiado.

### Valor para el negocio

* Incorpora otra importante red comercial para flotas directamente al Commander y amplía la oferta de Commander Fleet.
* Configuración e informes uniformes junto con los de los demás proveedores de flota de la estación, mediante Commander Central.

### Comportamiento de la función

| Situación                                                                  | Comportamiento                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| El conductor presenta una tarjeta QuikQ (la desliza) o un código de inicio | El Commander extrae el código de inicio al deslizar la tarjeta o lo acepta mediante ingreso manual si el conductor no tiene una tarjeta legible, y lo envía a QuikQ para su autorización.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| QuikQ solicita información adicional del conductor                         | El Commander muestra cada solicitud de información de QuikQ (por ejemplo, el número de pedido o el número del remolque). Si QuikQ devuelve un error para una respuesta, se muestra el mensaje y el conductor puede volver a intentarlo; después de 3 intentos fallidos para la misma solicitud, se rechaza la transacción. Los números de orden de compra y de remolque ingresados se conservan para la venta completada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Política de transacción y habilitación de la bomba                         | QuikQ devuelve los productos permitidos para la transacción, junto con los límites en dólares y el monto permitido para adelantos de efectivo. El Commander los aplica: solo se pueden vender los productos permitidos, la bomba se habilita dentro de los límites y el límite del adelanto de efectivo se hace cumplir en la caja.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Límites de productos (en dólares y cantidad)                               | Un límite en dólares para un producto establece el monto máximo que puede dispensar la bomba. Un límite de cantidad se convierte a dólares según el precio del grado de combustible y se redondea hacia abajo, para que la bomba nunca dispense más de la cantidad permitida. Si se establecen límites tanto en dólares como de cantidad, se aplica el más restrictivo. La mercancía que exceda su límite en dólares o de cantidad se rechaza, aunque no exceda el otro límite. No se permite un producto que no esté contemplado en ninguna categoría de la política.                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Límites grupales para varios grados de combustible                         | Cuando QuikQ establece un límite en dólares o de cantidad para un grupo de grados de combustible, el límite se comparte entre todos los grados del grupo, en lugar de aplicarse por separado a cada uno. El primer grado queda sujeto al límite grupal y cada grado posterior solo puede usar lo que quede disponible. Por ejemplo, con un límite grupal de $30, si el primer grado consume $18, el siguiente puede consumir hasta $12. Con un límite grupal de 3 galones, si el primer grado consume 2 galones, el siguiente puede consumir 1 galón, de modo que el total no supere los 3 galones. La cantidad restante para cada grado se convierte a dólares según el precio de ese grado y se redondea hacia abajo. Si un grupo tiene límites tanto en dólares como de cantidad, el Commander lleva el control de ambos y aplica el más restrictivo. Cuando se agota el límite grupal, los grados restantes dejan de ofrecerse en la bomba y la transacción se completa con el combustible ya dispensado. |
| Productos incluidos en más de una categoría                                | Un producto puede pertenecer a más de una categoría a la vez; por ejemplo, puede tener su propio límite y estar sujeto a un límite grupal compartido con otros productos. El Commander conserva y hace cumplir todos los límites, y el producto se contabiliza en el total de cada categoría a la que pertenece. Esto se aplica tanto al combustible como a la mercancía.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Límite de la transacción                                                   | Cada grado se habilita con el menor de estos valores: el saldo restante de la transacción, el límite del producto, el límite grupal y, cuando se aplica un descuento de lealtad, el límite de lealtad. Si se rechaza una preautorización y la mercancía permanece en el ticket, el límite anterior no se transfiere a la siguiente preautorización.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Descuento de lealtad en el ticket                                          | El límite grupal sigue aplicándose después del descuento de lealtad en el ticket. No se reduce al monto del descuento ni se contabiliza el descuento dos veces.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Solicitud de adelanto de efectivo                                          | En la caja, la solicitud ofrece solo el monto que queda disponible dentro del límite de la transacción después del prepago de combustible y de la mercancía. Por ejemplo, con un límite de $100 y productos por $37.20, la solicitud muestra “HASTA $62.80”. Si no queda saldo disponible, no se muestra la solicitud. Para el suministro de combustible desde el exterior, el efectivo se solicita primero y la bomba se habilita por el saldo restante del límite de la transacción.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Se completa la compra                                                      | El Commander envía la compra a QuikQ. El monto financiado por QuikQ y su código de aprobación se registran en la venta y se muestran en el recibo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Reembolso de una compra completada                                         | Se admiten reembolsos de toda la transacción y de artículos individuales el mismo día calendario de la venta original (según la zona horaria de la estación). Después de ese plazo, el reembolso se rechaza en la caja con el mensaje “Void Window Expired – Process via AR Invoice” y debe procesarse mediante una factura de cuentas por cobrar. No se permiten reembolsos de la parte de combustible de una transacción que incluya una venta de combustible. Si falla un reembolso, se rechaza con el motivo indicado por QuikQ.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Cancelación antes de la compra                                             | La cancelación se envía a QuikQ. Si no se puede conectar con QuikQ, la cancelación queda en cola y se intenta una vez; la caja la considera completada y el crédito de la preautorización vence por sí solo después de 3 horas.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| No hay conexión disponible con QuikQ                                       | El Commander intenta conectarse primero al host principal de QuikQ y luego al secundario. Si no se puede conectar con ninguno cuando se envía una compra, esta se pone en cola en Store-and-Forward y se vuelve a intentar cada 60 segundos durante un máximo de 7 días.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Se rechaza la transacción o se produce un error                            | En la caja o en la bomba se muestra un mensaje de rechazo específico de QuikQ, asignado a partir del código de error del host.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Cierre del día                                                             | El Commander cierra localmente el lote de QuikQ. No se envía ninguna solicitud de liquidación a QuikQ.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

### Plataformas compatibles y requisitos previos

| Requisito             | Detalles                                                                                                                                                      |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Software de Commander | Commander Release 57.02, PCS v1.28.0                                                                                                                          |
| Licencia              | Licencia de conexión directa al host para flotas comerciales, de la misma familia de licencias que se usa para habilitar otros proveedores de Commander Fleet |
| Configuración         | Commander Central: configuración FEP específica de QuikQ                                                                                                      |
| Inscripción           | La estación debe estar inscrita en QuikQ y tener disponibles las credenciales del host para la configuración                                                  |

### Restricciones de la función

* Al igual que con otros proveedores de Commander Fleet, la disponibilidad depende de que la estación tenga una licencia de conexión directa al host para flotas comerciales.
* Los reembolsos de compras completadas se limitan al mismo día calendario de la venta. Las cancelaciones enviadas mientras QuikQ no está disponible se intentan una sola vez; no se reintentan indefinidamente.
* El ingreso manual del código de inicio para prepago comercial en interiores no está incluido en esta versión.

### Interacción con otras funciones

* Funciona junto con Comdata, WEX-OTR, [Mudflap](https://docs.verifone.com/feature-references/feature-references-lac-es/referencias-de-funciones-y-productos/tarjetas-de-flota-compatibilidad-con-mudflap.md) y otros proveedores de Commander Fleet que ya son compatibles; QuikQ se configura y licencia de la misma manera.
* Se eliminaron de Config Client las entradas redundantes del menú FEP heredado para QuikQ (y MultiService), ya que la configuración de estos proveedores de flota más recientes se realiza en Commander Central.

## Configuración de la compatibilidad con flotas comerciales de QuikQ

QuikQ se habilita mediante la licencia de comunicación directa con el host para flotas comerciales del sitio, el mismo mecanismo que se usa para otros proveedores de Commander Fleet. Las direcciones del host de QuikQ (principal y secundaria) y otros ajustes de QuikQ se envían al Commander desde Commander Central.

La contraseña del comercio para el host de QuikQ se almacena en el Commander y no se envía desde la nube. Un técnico del sitio la actualiza con el `ufepcfg quikq merchant.password` comando y puede consultar los ajustes de QuikQ con `vfepcfg quikq` (la contraseña aparece enmascarada). La nueva contraseña se usa en la siguiente transacción; no es necesario reiniciar.

## Uso de la compatibilidad con flotas comerciales de QuikQ

El conductor presenta una tarjeta QuikQ o ingresa manualmente un código de inicio, y responde a las indicaciones que soliciten información del conductor o del viaje requerida por el host. El Commander autoriza la transacción con QuikQ y, en el caso del suministro de combustible en el exterior, habilita la bomba según los límites que QuikQ devuelve para esa transacción. Si no hay conexión con QuikQ, la transacción se procesa mediante Store-and-Forward en lugar de rechazarse directamente.

## Comportamientos conocidos y casos especiales

| Escenario                                                           | Comportamiento esperado                                                                                                                                                                                                        |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Reembolso después del día de la venta original                      | Se rechaza en la caja con el mensaje “Void Window Expired – Process via AR Invoice”. No se establece conexión con QuikQ. Procese el reembolso mediante una factura de cuentas por cobrar (AR).                                 |
| El reembolso falla en QuikQ                                         | El reembolso se rechaza de inmediato con el motivo indicado por QuikQ. No se pone en cola, ya que un reintento retrasado podría quedar fuera del plazo del mismo día.                                                          |
| El conductor cancela o no responde a una indicación                 | Si cancela: la transacción termina sin cargos. Si no responde: la indicación vence y la transacción se rechaza.                                                                                                                |
| La política de QuikQ no permite el producto                         | La venta de ese producto se rechaza en la caja.                                                                                                                                                                                |
| Límite de cero o menos para un producto                             | El producto se bloquea. En la bomba no se ofrece; en la caja se rechaza al agregarlo a un prepago o a la venta.                                                                                                                |
| Límite de cero o menos para un grupo                                | Se bloquean todos los productos del grupo. Si el grupo incluye todo el combustible, se cancela la transacción.                                                                                                                 |
| Límite de transacción de cero o menos                               | No se permite nada y no se muestra la indicación de adelanto de efectivo.                                                                                                                                                      |
| Límite ilegible o negativo                                          | Se trata como cero (bloqueado), nunca como ilimitado.                                                                                                                                                                          |
| Límite de cantidad y redondeo                                       | Como el límite de cantidad se convierte a un importe en dólares que se redondea hacia abajo al centavo, la bomba puede detenerse un poco antes del límite de cantidad (por ejemplo, 2.998 de 3 galones), pero nunca lo supera. |
| El combustible ya despachado supera el límite                       | El importe se envía a QuikQ para que lo determine, en lugar de rechazarse en la caja. La mercancía que supere el límite sí se rechaza en la caja.                                                                              |
| La transacción ya se anuló o el importe de la anulación no coincide | Se rechaza. Si el importe debe coincidir con el original, use una anulación total en lugar de una anulación de una partida.                                                                                                    |
| No se puede acceder al host de QuikQ al realizar la compra          | La compra se pone en cola en Store-and-Forward y se reintenta automáticamente hasta que QuikQ vuelva a estar disponible o hayan transcurrido 7 días.                                                                           |
| QuikQ informa un error interno del sistema                          | La transacción se rechaza; si el problema persiste, comuníquese con el soporte de QuikQ.                                                                                                                                       |
| Actualización de software (actualización automática)                | Los datos de las tablas de QuikQ y la configuración del sitio están diseñados para conservarse durante la actualización.                                                                                                       |

## Informes

Además de los informes de flota estándar del sitio, hay informes específicos de QuikQ: Exception, Terminal Day Detail y Terminal Day Summary.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verifone.com/feature-references/feature-references-lac-es/referencias-de-funciones-y-productos/tarjetas-de-flota-commander-fleet/soporte-para-flotas-comerciales-de-quikq.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
