Se usó la API de Cloud Translation para traducir esta página.

Registra a tus clientes

En esta página, se te guiará a través de los siguientes pasos para registrar y cancelar el registro de partes a fin de crear resultados de predicción:

Asegúrate de estar listo para registrar grupos
Prepara las tablas de registro de las partes
Usa el método projects.locations.instances.importRegisteredParties para registrar o cancelar el registro de partes.
Valida la respuesta del método
(Opcional) Exporta una tabla de grupos registrados

Antes de comenzar

Antes de comenzar, necesitas una instancia de IA contra el lavado de dinero.

Para permitir que un modelo cree predicciones de puntuación de riesgo, primero debes registrar partes. Te recomendamos que registres grupos cuando ya tengas lo siguiente:

Uno o más conjuntos de datos
Un modelo ajustado, entrenado y probado previamente

Cuándo registrar grupos

Antes de que puedas crear predicciones para un grupo en uno de los conjuntos de datos, debes registrarlo. No se requiere registro para el entrenamiento, el ajuste o el backtesting.

Los resultados de la predicción se usan para investigar a los clientes por lavado de dinero en una fase de producción o de prueba/paralela.

El registro de las partes genera costos mensuales adicionales por cada parte registrada (consulta la página de Precios para obtener más información).

Cómo preparar las tablas de registro de grupos

Consulte la página de Precios para obtener información sobre el registro de grupos.

Prepara una tabla para la línea de negocio para la que quieras registrar partes. Esta tabla de registro de partes puede ser un subconjunto de la tabla Party.

Esquema de partes de venta minorista

Columna	Tipo	Descripción
`party_id`	`STRING`	Identificador único de la parte en los conjuntos de datos de la instancia
`party_size`	`STRING`	NULL; el contenido se ignora para los registros de partes de venta minorista

Esquema de partes comerciales

Columna Tipo Descripción

party_id STRING Identificador único de la parte en los conjuntos de datos de la instancia

party_size

STRING

Cantidad de personas solicitadas. El nivel se basa en la cantidad promedio de transacciones mensuales de la parte durante los 365 días anteriores:

SMALL para fiestas comerciales pequeñas con menos de 500 transacciones mensuales en promedio
LARGE para grandes grupos comerciales con un promedio mayor o igual al de 500 transacciones mensuales

Todos los valores distinguen mayúsculas de minúsculas.

Cómo registrar partidos

Las partes se registran por separado para cada instancia de IA contra el lavado de dinero. Ten en cuenta lo siguiente:

Las partes minoristas y comerciales se deben registrar por separado. Usa llamadas a la API y tablas de registro de terceros independientes. Si una parte está en ambas listas, se consideran registros separados.
Las predicciones requieren que todas las partes estén registradas en la línea de negocio asociada con la versión del motor que se usó. No puedes crear resultados de predicción si se usa un conjunto de datos que contiene a alguien que no esté registrado en la misma línea de negocios.
La tabla de registro de partes proporcionada se utiliza para anexar a la lista existente de grupos registrados en la instancia o reemplazar todas las partes registradas para la línea de negocios proporcionada en la instancia.
Una vez que se registra, no se puede anular el registro de una parte durante un tiempo (consulta la Página de precios). Por este motivo, puedes establecer el campo validateOnly en TRUE. Este campo te permite ver el efecto neto y la respuesta del método sin cambiar los grupos registrados. Una vez validado, puedes volver a ejecutar la operación y establecer el parámetro validateOnly en FALSE.
Siempre verifica la respuesta de una solicitud de registro para asegurarte de que todas las partes se hayan registrado de forma correcta, incluso si una solicitud validateOnly anterior tuvo éxito.
En el caso de los registros de partes comerciales, un valor distinto de SMALL o LARGE en el campo party_size de la tabla de registro de partes activa un error (Invalid party_size present in table). Las partes registradas no se actualizan.
Para los registros de partes minoristas, se ignora el campo party_size y se registran todas las partes en la tabla de registro de terceros proporcionada.

Para importar grupos registrados, usa el método projects.locations.instances.importRegisteredParties.

La siguiente información también está disponible en Crea y administra instancias.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
LOCATION: La ubicación de la instancia; usa una de las regiones compatibles:
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: El identificador definido por el usuario para la instancia
BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: Un conjunto de datos de BigQuery que contiene una tabla en la que se describen los grupos registrados
REGISTERED_PARTIES_TABLE: Es la tabla en la que se enumeran los grupos registrados.
Nota: Puedes proporcionar varias tablas que enumeren los grupos registrados. Usa el formato "bq://{project}.{bqDatasetID}.{bqTableID}" para cada tabla del arreglo partyTables.
UPDATE_MODE: Usa REPLACE para reemplazar los grupos que se pueden quitar de la tabla de grupos registrados por grupos nuevos, o bien usa APPEND para agregar grupos nuevos a la tabla de grupos registrados.
LINE_OF_BUSINESS: Este campo debe coincidir con el valor lineOfBusiness en la versión del motor que usa la configuración del motor. Usa COMMERCIAL para clientes de banca comercial (entidades legales y naturales) o usa RETAIL para clientes de banca minorista

Cuerpo JSON de la solicitud:

{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.REGISTERED_PARTIES_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien con Cloud Shell, que te permite acceder automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.REGISTERED_PARTIES_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties"

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

@'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.REGISTERED_PARTIES_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "importRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Si quieres obtener información para obtener el resultado de la operación de larga duración (LRO), consulta Administra operaciones de larga duración.

Respuesta del registro

Cuando se completa la LRO, la respuesta indica la cantidad de partes que la operación agregó, quitó o actualizó.

Campo de respuesta	Tipo	Descripción
`partiesAdded`	`integer`	Cantidad de partes agregadas por esta operación
`partiesRemoved`	`integer`	Cantidad de partes quitadas por esta operación
`partiesTotal`	`integer`	Cantidad total de partes registradas en esta instancia, después de que se haya completado la operación de actualización
`partiesUptiered`	`integer`	Cantidad total de grupos comerciales que se mejoran de pequeños a grandes
`partiesDowntiered`	`integer`	Cantidad total de grupos comerciales cuya escala se reduce de grande a pequeño
`partiesFailedToDowntier`	`integer`	Cantidad total de grupos comerciales que no se pudieron reducir de grande a pequeño
`partiesFailedToRemove`	`integer`	Cantidad de partes que no se pudieron quitar con esta operación

Cómo anular el registro de grupos

Las partes se anulan por cada instancia de IA contra el lavado de dinero mediante el mismo método projects.locations.instances.importRegisteredParties y reemplazando la lista existente de partes. Establece el campo mode en REPLACE. Esta configuración anula el registro de los grupos registrados actualmente (para la línea de negocio proporcionada) que no forman parte de la tabla de registro de partes proporcionada.

Respuestas para anular el registro

Una vez que se complete la operación, verifica la respuesta de la API para comprobar si la operación generó el resultado deseado en términos de cantidad de partes agregadas o quitadas, y la cantidad total de grupos registrados.

La respuesta de la API también muestra la cantidad de partes que no se pudieron quitar debido a restricciones (por ejemplo, debido a la cantidad mínima de días antes de que se pueda anular el registro de una parte).

Exportar grupos registrados

Para exportar grupos registrados, usa el método projects.locations.instances.exportRegisteredParties.

La siguiente información también está disponible en Crea y administra instancias.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
LOCATION: La ubicación de la instancia; usa una de las regiones compatibles:
- us-central1
- us-east1
- asia-south1
- europe-west1
- europe-west2
- europe-west4
- northamerica-northeast1
- southamerica-east1
INSTANCE_ID: El identificador definido por el usuario para la instancia
BQ_OUTPUT_DATASET_NAME: Un conjunto de datos de BigQuery en el que se exporta una tabla que describe los grupos registrados
REGISTERED_PARTIES_TABLE: Es la tabla en la que se escribirán los grupos registrados.
WRITE_DISPOSITION: Es la acción que se produce si la tabla de destino ya existe. Usa uno de los siguientes valores:
- WRITE_EMPTY: Solo exportar datos si la tabla de destino está vacía.
- WRITE_TRUNCATE: Borra todos los datos existentes en la tabla de BigQuery antes de escribir en ella.
LINE_OF_BUSINESS: Usa COMMERCIAL para clientes de banca comercial (entidades legales y naturales) o RETAIL para clientes de banca minorista

Cuerpo JSON de la solicitud:

{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.REGISTERED_PARTIES_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.REGISTERED_PARTIES_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

@'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.REGISTERED_PARTIES_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "exportRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Si quieres obtener información para obtener el resultado de la operación de larga duración (LRO), consulta Administra operaciones de larga duración.

Este método genera una tabla de BigQuery con el siguiente esquema:

Columna	Tipo	Descripción
`party_id`	`STRING`	Identificador único de la parte en los conjuntos de datos de la instancia
`party_size`	`STRING`	Especifica el nivel para los clientes comerciales (grandes y pequeñas). Este campo no se aplica a los clientes de venta minorista. `NULL` para todos los clientes minoristas `SMALL` para fiestas comerciales pequeñas con menos de 500 transacciones mensuales en promedio `LARGE` para grandes grupos comerciales con un promedio mayor o igual al de 500 transacciones mensuales Todos los valores distinguen mayúsculas de minúsculas.
`earliest_remove_time`	`STRING`	El momento en que se puede quitar a la parte involucrada
`party_with_prediction_intent`	`STRING`	Indicador que sugiere si se predijo una parte desde el registro
`registration_or_uptier_time`	`STRING`	El momento en que el partido se registró o se elevó