Agrupa varias tarjetas de embarque

Cómo usar un ID de agrupación

De forma predeterminada, agregar varios pases a un solo vínculo de Agregar a la Billetera de Google no agrupará esos pases en la app de la Billetera de Google del usuario. Sin embargo, puedes agrupar los pases asegurándote de que todos tengan el mismo ID de agrupación. Los pases agrupados aparecerán juntos en la app de la Billetera de Google. Cuando se seleccione un grupo de pases, cada uno se mostrará en un carrusel.

Los pases se pueden agrupar de la siguiente manera:

  • Durante el aprovisionamiento inicial
  • Mediante los métodos update o patch

Para agregar un pase a un grupo, se debe establecer la propiedad groupingInfo.groupingId del objeto de pase. Todos los objetos de pase con el mismo valor groupingId se agruparán automáticamente, incluso si se agregaron por separado.

En el siguiente ejemplo, se muestra cómo se agrupan una tarjeta de lealtad y una oferta para motivar al usuario a usar ambas en su próxima compra. 

loyaltyObject = {
  "classId": "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX",
  "id": "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX",
  "state": "ACTIVE",
  "groupingInfo": {
    # Note the same groupingId value
    "groupingId": "combinedGiftCardAndOfferId",
    "sortIndex": 1
  },
  "barcode": {
    "type": "QR_CODE",
    "value": "QR code"
  },
  "accountId": "Account id",
  "accountName": "Account name",
  "loyaltyPoints": {
  "label": "Points",
    "balance": {
      "int": 800
    }
  }
}

offerObject = {
  "classId": "ISSUER_ID.OFFER_CLASS_SUFFIX",
  "id": "ISSUER_ID.OFFER_OBJECT_SUFFIX",
  "state": "ACTIVE",
  "groupingInfo": {
    # Note the same groupingId value
    "groupingId": "combinedGiftCardAndOfferId",
    "sortIndex": 2
  },
  "barcode": {
      "type": "QR_CODE",
      "value": "QR code",
  },
}

Agrupación automática de tarjetas de embarque

A veces, las tarjetas de embarque se usan en grupo y no de manera individual. Una situación común para esto es agrupar boletos para vuelos con escalas o varias paradas.

Las tarjetas de embarque tienen una lógica adicional que los agrupará automáticamente si tienen los mismos valores para las siguientes propiedades:

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • La parte del ID de la entidad emisora de FlightObject.id

Si alguna de las propiedades anteriores es diferente para dos tarjetas de embarque, no se agrupará (a menos que lo hagas con groupingInfo). Como puedes ver, las propiedades de clase y objeto afectan la agrupación automática. Esto permite agrupar las tarjetas de embarque de diferentes clases (por ejemplo, cuando diferentes vuelos de un mismo viaje tienen empresas de transporte distintas).