Comprende la facturación

Como parte de las condiciones de la Last Mile Fleet Solution (LMFS) de Google Maps Platform, se realiza una transacción facturable con la finalización exitosa de las tareas asociadas con un envío.

El objeto Task es un tipo de objeto fundamental que desempeña un papel clave en el seguimiento y la generación de informes de transacciones facturables en la API de LMFS Deliveries. Según nuestras condiciones, debes modelar correctamente las tareas del conductor y registrar el TaskOutcome de forma adecuada. Esto garantiza que todas las transacciones facturables se registren de manera correcta. Para los clientes contratados, consulta los requisitos de informes aplicables a tu producto:

¿Qué es una tarea facturable?

Una tarea facturable es cualquier tarea que complete un envío de forma correcta: el transporte de uno o más artículos desde un remitente único hasta un destinatario único. Las tareas de envío fallidas no son facturables.

En la siguiente tabla, se proporcionan algunas situaciones del mundo real para las tareas facturables y no facturables.

Situación ¿Es facturable?
Un conductor intentó entregar un paquete, pero el intento fue exitoso. Por ejemplo, el destinatario lo recibió directamente o el conductor dejó el paquete con un vecino. Sí
Un conductor entregó un paquete fuera del plazo previsto para ese paquete. Sí
Un conductor informó que un envío se realizó correctamente, pero el destinatario posteriormente impugnó su recepción. Sí
Un conductor intentó entregar un paquete, pero hubo un error. Por ejemplo, el destinatario no era el hogar de una firma obligatoria o la dirección era incorrecta. No
Un conductor toma un descanso o una parada programados. No

¿Cómo se realiza la facturación en la API de Deliveries?

Una tarea se factura en las siguientes condiciones:

  • La tarea tiene un tipo establecido en delivery. Las tareas de retiro no activan la facturación, y los descansos o paradas programados no califican. Cada transacción facturable debe tener asociada una tarea de entrega. Para los retiros en el primer kilómetro, que se entregan en un depósito, se puede modelar la tarea de retiro en el lugar de retiro y la tarea de entrega en el depósito.

  • TaskOutcome tiene el valor SUCCEEDED.

La API de Last Mile Fleet Solution Deliveries crea un evento facturable la primera vez que se actualiza un TaskOutcome con un valor de SUCCEEDED. Cuando esto sucede, aumenta la métrica de facturación para ese SKU. Cualquier actualización posterior de esa tarea no afectará esta métrica de facturación, que no puede aumentarse ni disminuir después de que se establece el resultado por primera vez.

¿Cómo deberías modelar tus tareas?

En esta sección, se proporcionan recomendaciones básicas para ayudarte a verificar si configuraste correctamente tus tareas según nuestros Términos y Condiciones.

  • Establece los campos correctos para las tareas de envíos. Establece el tipo de tarea en delivery, asigna un ID de tarea único y especifica la ubicación correcta para que se complete cada tarea. Asegúrate de que todos los envíos tengan una tarea de entrega.
  • Crea tareas independientes para cada combinación de remitente y destinatario. Por ejemplo, usa dos tareas de varios transportistas para un solo destinatario. O bien, para una sola ubicación de entrega en la que se entregarán varios paquetes a varios destinatarios, crea varias tareas.
  • Define correctamente las tareas que no son de envío. Para las paradas programadas, establece la tarea Type en SCHEDULED_STOP. En el caso de los descansos para conductores, establece Type en UNAVAILABLE.
  • Establece el campo TaskOutcome de forma correcta. Cuando se complete la tarea, asegúrate de que la implementación establezca TaskOutcome en SUCCEEDED o FAILED. La mera actualización de una tarea completada a un estado CLOSED no cumple con nuestras condiciones. Puedes establecer el resultado de la tarea mediante el SDK del controlador, gRPC o REST.

Para obtener más información, consulta los siguientes temas de la guía del usuario de Fleet Engine: