> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Advertències de verificació d'ubicació i codis LOCATION_

> Advertències LOCATION_ de Didit en controls d'ubicació: geotanques, precisió, suplantació, VPN, distància i permisos, amb activador i acció.

## Visió general

Les advertències de l'informe d'ubicació assenyalen cada condició que Didit ha detectat en un pas de verificació d'ubicació.
Apareixen a la matriu `warnings[]` de cada element de `geolocation_checks[]` (consulta l'[informe d'ubicació](https://docs.didit.me/ca/core-technology/location-verification/report-location-verification.md)).

Cada advertència té tres capes:

1. **El codi `risk`**: un identificador estable amb què pots fer la correspondència; tots comencen per `LOCATION_`.
2. **El `log_type`**: `information`, `warning` o `error`. Per als riscos configurables, segueix l'acció configurada: `NO_ACTION` dona `information`, `REVIEW` dona `warning` i `DECLINE` dona `error`.
3. **L'impacte en la decisió**: l'acció més estricta d'entre les advertències estableix el `status` del pas. `REVIEW` dona `In Review`, `DECLINE` dona `Declined` i `NO_ACTION` el deixa intacte.

La incertesa i el rebuig tenen per defecte el valor `REVIEW`, mai `DECLINE`: un permís denegat, una posició en interiors o un radi ampli no són proves de frau.
Les advertències sobre precisió, actualitat, àrees, distància i anonimitzadors només es generen en l'últim intent, de manera que una persona que se'n surt satisfactòriament al segon intent no arrossega cap advertència.
Les regles de `status_rules` personalitzades al node poden mantenir o augmentar l'estat, però mai reduir-lo.

## Condicions de rebuig automàtic

Aquestes condicions sempre rebutgen el pas, amb `log_type: "error"`, i no tenen clau d'acció.

| Risk | Activador |
| - | - |
| `LOCATION_REPLAY_DETECTED` | L'enviament contenia un desafiament que pertany a una altra sessió. Cada intent rep un desafiament d'un sol ús vinculat a la seva sessió, de manera que presentar-lo en un altre lloc constitueix una repetició. |
| `LOCATION_INTEGRITY_FAILED` | Una atestació del dispositiu acompanyava la posició i no ha superat la verificació. |

## Advertències generades

Els valors per defecte són les accions d'un pas sense `geolocation_preset`.
Sota `licensing`, `LOCATION_VPN_DETECTED`, `LOCATION_TOR_DETECTED` i `LOCATION_EMULATOR_DETECTED` tenen per defecte `DECLINE`, i `LOCATION_PROXY_DETECTED` té `REVIEW`.
Sota `fraud_screening`, cada valor per defecte que és `DECLINE` passa a ser `REVIEW`, i aquestes quatre troballes d'anonimitzadors passen a ser `REVIEW`.
Una acció que defineixis explícitament sempre preval.

### Permisos i disponibilitat

| Risc | Activador | Clau de configuració | Per defecte |
| - | - | - | - |
| `LOCATION_PERMISSION_DENIED` | La persona ha rebutjat o descartat l'avís d'ubicació en tots els intents permesos. És una elecció, no una prova de frau. | `geolocation_permission_denied_action` | `REVIEW` |
| `LOCATION_RESTRICTED` | El sistema operatiu ha refusat abans que la persona pogués respondre: els serveis d'ubicació estan desactivats a tot el dispositiu, o bé una política de gestió de dispositius o de control parental els bloqueja. | `geolocation_unavailable_action` | `REVIEW` |
| `LOCATION_UNAVAILABLE` | El dispositiu ha acceptat la sol·licitud, però el seu sistema de posicionament no ha retornat cap posició en cap intent permès. Habitual en interiors i sota terra. | `geolocation_unavailable_action` | `REVIEW` |
| `LOCATION_TIMEOUT` | No s'ha rebut cap posició dins de `geolocation_timeout_seconds` en cap intent permès. | `geolocation_unavailable_action` | `REVIEW` |
| `LOCATION_SKIPPED` | El flux de treball permet ometre el pas i la persona ha continuat sense compartir la ubicació. | `geolocation_unavailable_action` | `REVIEW` |
| `LOCATION_UNSUPPORTED_CLIENT` | La sessió ha arribat a una versió de l'aplicació o de l'SDK que no implementa el pas. Didit ha tancat el pas en lloc de deixar la sessió aturada. Actualitza l'SDK. | `geolocation_unavailable_action` | `REVIEW` |

### Precisió i actualitat

| Risc | Activador | Clau de configuració | Per defecte |
| - | - | - | - |
| `LOCATION_LOW_ACCURACY` | La millor posició tenia un radi més ampli que `geolocation_max_accuracy_radius_m`. Una mesura de confiança, no d'honestedat. | `geolocation_low_accuracy_action` | `REVIEW` |
| `LOCATION_ACCURACY_UNDETERMINED` | La posició no contenia cap radi en cap intent permès, de manera que res indica que compleixi el límit. Mai no es considera que compleixi el límit. | `geolocation_low_accuracy_action` | `REVIEW` |
| `LOCATION_STALE_FIX` | Feia més de `geolocation_max_age_seconds` que s'havia mesurat la posició quan Didit la va rebre. | `geolocation_stale_fix_action` | `REVIEW` |
| `LOCATION_APPROXIMATE_ONLY` | Es requeria una ubicació precisa i la persona n'ha concedit una d'aproximada (precisió reduïda a iOS, «Aproximada» a Android). Mai no es genera al web, que no ho pot distingir. | `geolocation_approximate_action` | `REVIEW` |
| `LOCATION_CLOCK_SKEW` | El dispositiu indicava que havia mesurat la posició en el futur en comparació amb el rellotge de Didit. Només informatiu: l'antiguitat es calcula a partir de l'hora de recepció de Didit. | cap | informació |

### Suplantació i integritat

| Risc | Activador | Clau de configuració | Per defecte |
| - | - | - | - |
| `LOCATION_MOCK_PROVIDER_DETECTED` | Android ha informat que la posició provenia d'un proveïdor d'ubicacions simulades. Les eines de prova i d'accessibilitat també ho defineixen, per la qual cosa l'acció és configurable. | `geolocation_mock_location_action` | `REVIEW` |
| `LOCATION_SIMULATED_BY_SOFTWARE` | iOS ha informat que la posició s'havia simulat per programari. | `geolocation_mock_location_action` | `REVIEW` |
| `LOCATION_INTEGRITY_MISSING` | Una aplicació nativa ha enviat una posició sense atestació del dispositiu. El web es registra com a no compatible, no com a absent. | `geolocation_integrity_missing_action` | `NO_ACTION` |
| `LOCATION_EMULATOR_DETECTED` | L'aplicació ha informat que s'executa en un emulador o màquina virtual. Els navegadors no ho poden informar. Llevat que l'acció sigui `NO_ACTION`, finalitza el pas en aquest intent. | `geolocation_emulator_action` | `NO_ACTION` |
| `LOCATION_VPN_DETECTED` | La connexió que ha compartit la ubicació surt a través d'una VPN comercial. Llevat que l'acció sigui `NO_ACTION`, es demana a la persona que la desactivi i torni a comprovar-ho. | `geolocation_vpn_action` | `NO_ACTION` |
| `LOCATION_PROXY_DETECTED` | La connexió passa a través d'un proxy obert, anònim o de retransmissió privada. | `geolocation_proxy_action` | `NO_ACTION` |
| `LOCATION_TOR_DETECTED` | La connexió és un node de sortida de Tor. | `geolocation_tor_action` | `NO_ACTION` |

### Àrees

| Risc | Activador | Clau de configuració | Per defecte |
| - | - | - | - |
| `LOCATION_OUTSIDE_GEOFENCE` | La posició i tot el seu cercle de precisió es troben fora de qualsevol àrea permesa. | `geolocation_geofencing_action` | `DECLINE` |
| `LOCATION_GEOFENCE_UNDETERMINED` | El cercle de precisió arriba a un límit que determina la resposta, o la posició no es resol en cap país. La incertesa mai no s'informa com a fora. | `geolocation_geofence_undetermined_action` | `REVIEW` |
| `LOCATION_IN_BLOCKED_AREA` | La posició i tot el seu cercle de precisió es troben dins d'una àrea bloquejada. S'afegeix al veredicte d'àrea permesa, mai en lloc d'aquest, i l'acció més estricta decideix. | `geolocation_blocked_area_action` | `DECLINE` |

### Distància i historial

| Risc | Activador | Clau de configuració | Per defecte |
| - | - | - | - |
| `LOCATION_IP_DISTANCE_MISMATCH` | La posició del dispositiu i la ubicació de la IP estan més separades que `geolocation_ip_distance_km`, després de restar ambdós radis. Una VPN, un proxy corporatiu o la sortida central d'un operador ho poden provocar legítimament. | `geolocation_ip_distance_action` | `REVIEW` |
| `LOCATION_DOCUMENT_DISTANCE_MISMATCH` | La posició es troba a una distància superior a `geolocation_document_distance_km` de l'adreça del document. Un senyal feble, perquè les adreces es geocodifiquen de manera aproximada i les persones viatgen. | `geolocation_document_distance_action` | `REVIEW` |
| `LOCATION_CONSECUTIVE_MISMATCHES` | Aquesta comprovació i les comprovacions anteriors de la mateixa persona (mateix `vendor_data`) han quedat fora d'una àrea permesa, dins d'una àrea bloquejada o massa lluny de l'adreça almenys `geolocation_consecutive_mismatch_count` vegades consecutives. | `geolocation_consecutive_mismatch_action` | `REVIEW` |

## Què veu la persona

Algunes troballes no s'expliquen mai a la persona, perquè donar el nom del senyal indica a un defraudador què ha de canviar.
`LOCATION_EMULATOR_DETECTED`, `LOCATION_MOCK_PROVIDER_DETECTED`, `LOCATION_SIMULATED_BY_SOFTWARE`, `LOCATION_REPLAY_DETECTED`, `LOCATION_INTEGRITY_FAILED` i `LOCATION_IP_DISTANCE_MISMATCH` formen part d'aquest grup: si un revisor retorna la verificació, la persona veu un motiu genèric, mentre que el payload de decisió i els teus webhooks conserven l'advertència completa.
Una VPN només es mostra a la persona com una sol·licitud per desactivar qualsevol VPN i tornar-ho a provar, i una zona bloquejada només es mostra com la llista de llocs on el servei està disponible.

## Exemple

```json theme={null}
{
  "risk": "LOCATION_LOW_ACCURACY",
  "log_type": "warning",
  "short_description": "Device location accuracy below the configured limit",
  "additional_data": {
    "accuracy_m": 1200.0,
    "accuracy_confidence": "p95",
    "max_accuracy_radius_m": 250
  },
  "node_id": "geolocation_1"
}
```

## Tipus d'advertència

A cada risc se li assigna una gravetat basada en la configuració de la teva aplicació. Les tres gravetats són:

## Relacionat

* [Informe de verificació d'ubicació](https://docs.didit.me/ca/core-technology/location-verification/report-location-verification.md) - els camps al costat de `warnings[]`.
* [Verificació d'ubicació](https://docs.didit.me/ca/core-technology/location-verification/overview.md) - com funciona el pas.
* [Configuracions de funcionalitats del flux de treball](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#verificació-de-la-ubicació) - cada clau d'acció.
* [Models de dades - Objecte d'advertència](https://docs.didit.me/ca/reference/data-models.md#objecte-d’advertència) - l'estructura de cada entrada a `warnings[]`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.