> ## 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. # Importar verificacions d'un altre proveïdor > Escull la via d'importació de Didit per a sessions de verificació, usuaris, rostres, llistes de bloqueig, empreses, transaccions i estats de flux. Fes servir aquesta guia per triar el camí d'importació adequat quan migris dades d'un altre proveïdor a Didit. Els clients sovint anomenen "importació" dues feines diferents:- **Importar treball de verificació històric**: recrear registres completats de KYC, KYB, monitoratge de transaccions o regles de flux de treball perquè Didit mostri l'historial de l'antic proveïdor. Utilitza `POST /v3/session/imports/`. - **Importar dades operatives**: crear Users, Businesses, rostres de perfil, entrades de la llista de bloqueig o de la llista de permesos perquè Didit les pugui utilitzar en futures comprovacions. Utilitza les APIs d'entitats, de rostres i de llistes.Les importacions de verificació creen registres històrics amb `session_type: "MIGRATED"` per a KYC i KYB. No envien correus electrònics als usuaris finals, no redirigeixen els usuaris al flux allotjat i no tornen a executar la verificació original. Els registres importats apareixen a les llistes de sessions, als perfils d'entitats, a les vistes de transaccions i a `GET /v3/session/{session_id}/decision/` quan sigui aplicable.## Quina importació has d'utilitzar?| Objectiu | Camí d'importació | Què crea | Ideal per a | | - | - | - | - | | Recrear sessions KYC històriques | `POST /v3/session/imports/` amb `import_type=user_verification` | `Session`, dades de Verificació d'identitat, imatges opcionals de document o selfie, vídeos de document i de prova de vida, etiquetes, metadades | Migrar sol·licitants que ja han completat el procés des de Sumsub, MetaMap, Veriff, Onfido, Persona, Jumio, Incode, iDenfy, Trulioo o un altre proveïdor de KYC | | Recrear sessions KYB històriques | `POST /v3/session/imports/` amb `import_type=business_verification` | `BusinessSession`, dades del registre mercantil, administradors, titulars reals, etiquetes, metadades | Migrar comprovacions d'empresa completades des de proveïdors de KYB, proveïdors de registres mercantils o eines internes de KYB | | Recrear registres històrics de monitoratge de transaccions | `POST /v3/session/imports/` amb `import_type=transactions` | `Transaction`, parts subjectes i contraparts, resultats del proveïdor, dades de Travel Rule, instantània de la xarxa, metadades | Migrar l'historial de motors de regles, de KYT, de cribratge de carteres o de monitoratge de transaccions fiat | | Importar regles d'estat de flux de treball personalitzades | `POST /v3/session/imports/` amb `import_type=status_rules` | `VerificationSettings.feature_status_rules` | Migrar la lògica de política d'un altre proveïdor o d'un full de càlcul al motor de flux de treball de Didit | | Crear Users sense sessions històriques | `POST /v3/users/create/` o importació CSV des de la Console | Files de perfil `VendorUser` | Carregar el teu registre d'usuaris abans d'iniciar noves comprovacions de Didit | | Associar rostres de perfil de confiança als usuaris | `POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/` | Evidència de rostre de perfil indexada per a la detecció de duplicats i la cerca facial | Migrar imatges de rostre de perfil d'un altre proveïdor de KYC sense recrear sessions completes | | Afegir rostres a la llista de bloqueig o a la llista de permesos | `POST /v3/lists/{list_uuid}/entries/face-upload/` o `POST /v3/lists/{list_uuid}/entries/` amb `reference_session_id` | Entrada de llista de rostres i embedding biomètric | Migrar rostres de frau coneguts, rostres de confiança de la llista de permesos o afegir un rostre d'una sessió existent de Didit a la llista de bloqueig | | Crear Businesses sense sessions KYB històriques | `POST /v3/businesses/create/` o importació CSV des de la Console | Files de perfil `VendorBusiness` | Carregar el registre de clients empresarials abans d'executar KYB |> [!NOTE] > > Si només necessites un perfil d'usuari o d'empresa per a futures comprovacions, no importis una sessió de verificació històrica. Utilitza les APIs d'entitats User o Business. Si necessites que la decisió, els camps del document, les advertències o les evidències de l'antic proveïdor apareguin com a historial de compliment a Didit, utilitza `POST /v3/session/imports/`.## Quins elements es poden migrar de cada proveïdor?Didit accepta un fitxer CSV o NDJSON canònic, de manera que pots migrar des de qualsevol proveïdor després d'exportar i transformar les dades. El contracte d'importació és sempre l'esquema canònic de Didit.| Família de proveïdors | Fonts habituals | Normalment migrable | Notes | | - | - | - | - | | Proveïdors de KYC | Sumsub, MetaMap, Veriff, Onfido, Persona, Jumio, Incode, iDenfy, Trulioo, HyperVerge, AU10TIX, Mitek, Ondato | Id de sol·licitant, id d'usuari del proveïdor, estat de la decisió, camps del document, imatges del document, imatge de selfie o de prova de vida, etiquetes de rebuig, etiquetes, metadades en brut del proveïdor | Utilitza `import_type=user_verification`. Si el proveïdor no pot exportar imatges, importa els camps estructurats i deixa buits els URL de les imatges. | | Proveïdors de KYB | Proveïdors de registres mercantils, Sumsub KYB, Trulioo KYB, exportacions de registres de tipus Creditsafe, eines internes de KYB | Nom de l'empresa, número de registre, país, estat al registre, administradors, titulars reals, nivell de risc, payload en brut del registre | Utilitza `import_type=business_verification`. Els administradors i els titulars reals es passen com a matrius JSON. | | Proveïdors de monitoratge de transaccions i KYT | Sumsub Transaction Monitoring, exportacions de tipus KYT de Chainalysis, Crystal, Merkle Science, Sardine, Unit21, Alloy, motors de regles interns | Id de la transacció, import, moneda, direcció, subjecte o contrapart, coincidències de regles, resultats del proveïdor, estat de la Travel Rule, instantània del graf de xarxa | Utilitza `import_type=transactions`. Les transaccions importades són registres històrics; no es tornen a cribrar per defecte. | | Fulls de càlcul de flux de treball i de política | Exportacions de polítiques de compliment, taules de regles del proveïdor, fulls de risc interns | Regles d'estat per funcionalitat, com ara «si el país emissor és X, estableix la Verificació d'identitat en revisió» | Utilitza `import_type=status_rules`. Les regles es validen amb el catàleg de camps de flux de treball de Didit abans de desar-se. | | Magatzems d'usuaris i perfils | CRM, base de dades de clients, exportació d'usuaris del proveïdor, magatzem de dades | `vendor_data`, nom visible, metadades, etiquetes, imatges facials de confiança | Utilitza les API d'usuaris i la pujada de cares de perfil. Això no és el mateix que una sessió de verificació completada. | | Dades de llistes de bloqueig i de permís | Llistes de frau del proveïdor, fulls interns d'operacions de frau, llistes de contracarrecs, llistes internes relacionades amb sancions | Correus electrònics, telèfons, documents, carteres, IP, empremtes de dispositiu, cares, països, usuaris, empreses | Utilitza les API de llistes. Per a imatges facials, utilitza el endpoint de càrrega de cares específic perquè Didit pugui extreure l'embedding biomètric. |## Flux de treball de migració1) Decideix si vols importar historial, perfils, cares, llistes, transaccions o regles. 2) Exporta tu mateix les dades del proveïdor antic. No enviïs a Didit les claus d'API del proveïdor antic. 3) Transforma l'exportació del proveïdor a la plantilla CSV o NDJSON canònica de Didit que correspongui. 4) Per a migracions grans, prefereix NDJSON i divideix-les en fitxers que puguis reintentar de manera independent. 5) Crea la tasca d'importació i consulta'n el progrés. 6) Obtén els errors de fila, corregeix només les files que han fallat i reintenta-les. Totes les tasques d'importació són idempotents respecte del seu identificador extern natural.## Crea una tasca d'importacióCrea una tasca d'importació amb una única sol·licitud multipart:```bash theme={null} curl -X POST https://verification.didit.me/v3/session/imports/ \ -H "x-api-key: YOUR_API_KEY" \ -F "import_type=user_verification" \ -F "workflow_id=YOUR_KYC_WORKFLOW_ID" \ -F "file=@didit-import.ndjson" ```Utilitza CSV per a migracions més petites basades en fulls de càlcul i NDJSON per a migracions grans. Per a 100k+ files, NDJSON és més fàcil de transmetre en flux, dividir, validar i reintentar.Una aplicació pot executar fins a 4 tasques d'importació alhora, de manera que has de dividir una migració gran en diversos fitxers i iniciar una tasca per a cadascun. Cada tasca descarrega en paral·lel els fitxers multimèdia d'una fila. Una tasca interrompuda per un desplegament o per un reinici del treballador continua des de l'última fila importada sense intervenció, de manera que no cal reiniciar-la.Per a les importacions de transaccions, omet `workflow_id`:```bash theme={null} curl -X POST https://verification.didit.me/v3/session/imports/ \ -H "x-api-key: YOUR_API_KEY" \ -F "import_type=transactions" \ -F "file=@didit-transactions.ndjson" ```### Camps de la sol·licitud| Camp | Obligatori | Descripció | | - | - | - | | `import_type` | No, el valor per defecte és `user_verification` | Un de `user_verification`, `business_verification`, `status_rules` o `transactions`. | | `workflow_id` | Sí, excepte per a `transactions` | UUID del flux de treball al qual s'associen els registres importats. `user_verification` i `status_rules` necessiten un flux de treball de Verificació d'usuaris; `business_verification` necessita un flux de treball de Verificació d'empreses. | | `file` | `file` o `source_file_url` | El fitxer CSV o NDJSON canònic, pujat en línia. | | `source_file_url` | `file` o `source_file_url` | URL HTTPS des de la qual Didit descarrega el fitxer. Les URL de xarxes privades són rebutjades. | | `source_format` | No | `csv` o `ndjson`. Es dedueix de l'extensió del fitxer si s'omet. |### Com es fan el seguiment i la deduplicació dels registresNo hi ha cap camp de sol·licitud per a l'origen de les dades: totes les importacions utilitzen l'esquema canònic de Didit. Cada registre importat desa `metadata.imported_from = "generic"` per a la traçabilitat.Les importacions de `user_verification` i `business_verification` deduplicen les files segons `external_id` dins de l'aplicació, de manera que reintentar el mateix fitxer no crea duplicats. Les importacions de `transactions` deduplicen segons `transaction_id`.Una migració de proveïdor (`source=provider`) desa cada registre com a `:`, per exemple `sumsub:5f8c0e2a9b1d4c3e2f1a0b9c`. Una importació de fitxer de Verificació d'usuaris que hagi enviat l'id nu del proveïdor (`5f8c0e2a9b1d4c3e2f1a0b9c`) es reconeix com el mateix registre en les dues direccions. Per tant, pots començar una migració amb fitxers i acabar-la amb una migració de proveïdor, o a la inversa, sense importar cap registre dues vegades.## Importar fotos de documents, vídeos i evidències de selfiePer a `import_type=user_verification`, pots importar les fotos originals dels documents, els vídeos de captura de document i prova de vida, i la imatge de selfie del proveïdor anterior.Fes servir aquestes columnes canòniques:| Evidència | Columna preferida | Alternativa per a importacions petites | Emmagatzemada a Didit com a | | - | - | - | - | | Imatge frontal del document | `document_front_url` | `document_front_base64` | Imatge frontal de l'OCR de Verificació d'identitat | | Imatge posterior del document | `document_back_url` | `document_back_base64` | Imatge posterior de l'OCR de Verificació d'identitat | | Imatge de selfie / prova de vida | `selfie_url` | `selfie_base64` | Imatge de referència de Face/Liveness | | Vídeo frontal del document | `document_front_video_url` | Només URL | Vídeo frontal de l'OCR de Verificació d'identitat | | Vídeo posterior del document | `document_back_video_url` | Només URL | Vídeo posterior de l'OCR de Verificació d'identitat | | Vídeo de prova de vida | `liveness_video_url` | Només URL | Vídeo de captura de Face/Liveness |Per a migracions grans, fes servir **URL HTTPS**. Didit descarrega cada fitxer, valida que la URL sigui segura, emmagatzema una còpia pròpia de Didit i l'enllaça a la sessió importada. Les imatges es comprimeixen; els vídeos s'emmagatzemen tal com són. El base64 en línia és acceptat per a imatges en importacions petites, però **els vídeos s'han de proporcionar sempre com a URL**, ja que el base64 augmentaria cada vídeo en un \~33 % i superaria ràpidament el límit d'importació per fitxer.Exemple de fila NDJSON amb URL de contingut allotjat pel proveïdor:```json theme={null} { "external_id": "applicant-123", "vendor_data": "user-42", "created_at": "2025-01-12T10:30:00Z", "status": "Approved", "email": "user@example.com", "phone": "+34687020083", "first_name": "Jane", "last_name": "Doe", "date_of_birth": "1990-05-15", "document_type": "P", "issuing_state": "USA", "document_number": "123456789", "expiration_date": "2030-01-15", "document_front_url": "https://provider-export.example.com/files/applicant-123-front.jpg", "document_back_url": "https://provider-export.example.com/files/applicant-123-back.jpg", "selfie_url": "https://provider-export.example.com/files/applicant-123-selfie.jpg", "document_front_video_url": "https://provider-export.example.com/files/applicant-123-front.webm", "document_back_video_url": "https://provider-export.example.com/files/applicant-123-back.webm", "liveness_video_url": "https://provider-export.example.com/files/applicant-123-liveness.mp4", "reject_reasons_json": "[]", "provider_metadata_json": "{\"source\":\"sumsub-export\"}" } ```Regles importants sobre el contingut multimèdia:- Les URL han de fer servir `https`. - Les URL no poden resoldre's a IP privades, localhost, rangs d'enllaç local ni servidors de metadades internes. - Les imatges accepten una columna d'URL o la seva alternativa `*_base64`; si s'informen les dues, es fa servir base64. Els vídeos només són URL: no hi ha cap columna `*_video_base64`. - Els vídeos han de ser `mp4`, `webm` o `mov`, i cada vídeo pot tenir com a màxim **10 MB**. Els fitxers més grans o que no siguin vídeos es rebutgen com a errors de fila. - Didit aplica temps d'espera de connexió i de lectura, una mida màxima de fitxer i no fa reintents infinits. - Les errades de descàrrega de contingut multimèdia s'emmagatzemen com a errors de fila perquè la resta de la importació pugui continuar. - Si no tens contingut multimèdia del proveïdor, deixa buides aquestes columnes. Didit igualment importa la decisió estructurada i els camps del document. - Les imatges i els vídeos importats són evidència per a la revisió històrica. Per defecte, Didit no torna a executar l'anàlisi d'OCR, de prova de vida ni de frau documental sobre el contingut històric importat. Prompt d'importació de verificació d'usuaris Copia el prompt al porta-retalls \

\`You are helping migrate historical User Verification (KYC) sessions into Didit.

Goal:
Transform the customer's Sumsub, MetaMap, or provider export into Didit's canonical verification import file, then call Didit's import API.

Didit API:
\- Create import job: POST https://verification.didit.me/v3/session/imports/
\- Poll job: GET https://verification.didit.me/v3/session/imports/{import_id}/
\- Read row errors: GET https://verification.didit.me/v3/session/imports/{import_id}/errors/
\- Download template: GET https://verification.didit.me/v3/session/imports/template/?import_type=user_verification
\- Authenticate with x-api-key: 

Inputs you need:
\- DIDIT_API_KEY
\- DIDIT_WORKFLOW_ID for a User Verification workflow
\- Provider export file or API output

Canonical columns:
external_id, vendor_data, created_at, status, email, phone, first_name, last_name, date_of_birth, gender, nationality, document_type, issuing_state, document_number, personal_number, expiration_date, document_front_url, document_back_url, selfie_url, document_front_base64, document_back_base64, selfie_base64, document_front_video_url, document_back_video_url, liveness_video_url, is_blocklisted, reject_reasons_json, tags, provider_metadata_json

Rules:
\- phone is optional and accepts international format (for example +34687020083); it is stored on the imported session.
\- external_id must be the provider's unique verification/applicant id.
\- vendor_data must be the customer's stable user id. If absent, use the provider identity/user id.
\- status must be Approved, Declined, In Review, or Expired.
\- date_of_birth and expiration_date must use YYYY-MM-DD.
\- created_at must be ISO 8601.
\- nationality and issuing_state must be ISO-3166 alpha-3, for example USA, ESP, BRA.
\- document_type must use Didit codes: P, ID, DL, RP, SSC, HIC, WP, TC, VISA, PSC, BC, OTHER.
\- reject_reasons_json must be a JSON array. provider_metadata_json must be a JSON object.
\- Use document_front_url, document_back_url, and selfie_url when the provider can export evidence images. Use HTTPS media URLs for large imports. Avoid inline base64 unless the import is small.
\- Use document_front_video_url, document_back_video_url, and liveness_video_url to import capture videos. Videos must be mp4, webm, or mov and at most 10 MB each; otherwise the row is rejected.
\- If only one document side exists, fill document_front_url and leave document_back_url empty.
\- Never call the import API with provider credentials. The customer downloads provider data themselves.
\- The import is idempotent by external_id inside one Didit application, so retries are safe.

Steps:
1\. Inspect the provider export schema.
2\. Map each provider row to the canonical fields.
3\. Write NDJSON for large files; one JSON object per line.
4\. Validate the first 10 rows locally before uploading.
5\. Create an import job:
curl -X POST https://verification.didit.me/v3/session/imports/ \
-H "x-api-key: $DIDIT_API_KEY" \
-F "import_type=user_verification" \
-F "workflow_id=$DIDIT_WORKFLOW_ID" \
-F "file=@didit-import.ndjson"
6\. Poll until status is COMPLETED or FAILED.
7\. If failed_count is greater than 0, fetch /errors/ and produce a corrected file containing only failed rows.

Output:
\- A canonical CSV or NDJSON file ready for Didit.
\- The curl command used to create the import job.
\- The import_id and polling command.
\- A short summary of created, skipped, and failed rows.`

\
Enganxa a Prompt d'importació de verificació d'empreses Copia el prompt al porta-retalls \

\`You are helping migrate historical Business Verification (KYB) sessions into Didit.

Goal:
Transform the customer's KYB provider export into Didit's canonical business verification import file, then call Didit's import API.

Didit API:
\- Create import job: POST https://verification.didit.me/v3/session/imports/
\- Poll job: GET https://verification.didit.me/v3/session/imports/{import_id}/
\- Read row errors: GET https://verification.didit.me/v3/session/imports/{import_id}/errors/
\- Download template: GET https://verification.didit.me/v3/session/imports/template/?import_type=business_verification
\- Authenticate with x-api-key: 

Inputs you need:
\- DIDIT_API_KEY
\- DIDIT_WORKFLOW_ID for a Business Verification workflow
\- Provider export file or API output

Canonical business columns:
external_id, vendor_data, created_at, status, company_name, registration_number, country_code, registry_status, verification_status, company_type, tax_number, risk_level, incorporation_date, registered_address, is_from_registry, officers_json, beneficial_owners_json, provider_metadata_json, tags

Rules:
\- external_id must be the provider's unique business verification id.
\- vendor_data must be the customer's stable business id.
\- status must be Approved, Declined, In Review, or Expired.
\- country_code must be ISO-3166 alpha-3.
\- officers_json and beneficial_owners_json must be JSON arrays of objects.
\- provider_metadata_json must be a JSON object.
\- The import is idempotent by external_id inside one Didit application.

Create an import job:
curl -X POST https://verification.didit.me/v3/session/imports/ \
-H "x-api-key: $DIDIT_API_KEY" \
-F "import_type=business_verification" \
-F "workflow_id=$DIDIT_WORKFLOW_ID" \
-F "file=@didit-business-import.ndjson"

Output:
\- A canonical CSV or NDJSON file ready for Didit.
\- The curl command used to create the import job.
\- The import_id and polling command.
\- A short summary of created, skipped, and failed rows.`

\
Enganxa a Prompt d'importació de regles d'estat personalitzades Copia el prompt al porta-retalls \

\`You are helping import custom status rules into a Didit workflow.

Goal:
Transform the customer's policy spreadsheet into Didit's feature_status_rules format, then call Didit's import API.

Didit API:
\- Create import job: POST https://verification.didit.me/v3/session/imports/
\- Poll job: GET https://verification.didit.me/v3/session/imports/{import_id}/
\- Read row errors: GET https://verification.didit.me/v3/session/imports/{import_id}/errors/
\- Download template: GET https://verification.didit.me/v3/session/imports/template/?import_type=status_rules
\- Authenticate with x-api-key: 

Inputs you need:
\- DIDIT_API_KEY
\- DIDIT_WORKFLOW_ID for the workflow to update
\- A policy spreadsheet or JSON policy definition

Canonical status-rule columns:
feature, rules_json, mode

Rules:
\- feature must be a Didit feature key such as OCR, LIVENESS, FACE_MATCH, AML, KYB_REGISTRY, KYB_DOCUMENTS, or KYB_KEY_PEOPLE.
\- rules_json must be a JSON array of rule objects.
\- Each rule needs field, operator, status, and usually value.
\- mode is replace or append. Default is replace.
\- Do not reference status fields such as kyc.status; status rules compute status and must use other report fields.

Example rules_json:
\[{"field":"kyc.issuing_state","operator":"in","value":["VEN","IRN"],"status":"In Review"}]

Create an import job:
curl -X POST https://verification.didit.me/v3/session/imports/ \
-H "x-api-key: $DIDIT_API_KEY" \
-F "import_type=status_rules" \
-F "workflow_id=$DIDIT_WORKFLOW_ID" \
-F "file=@didit-status-rules.csv"

Output:
\- A canonical CSV or NDJSON file ready for Didit.
\- The curl command used to create the import job.
\- The import_id and polling command.
\- A summary of updated and failed rule rows.`

\
Enganxa a Prompt d'importació de transaccions Copia el prompt al porta-retalls \

\`You are helping migrate historical transaction monitoring records into Didit.

Goal:
Transform the customer's legacy transaction monitoring export into Didit's canonical transaction import file, then call Didit's import API.

Didit API:
\- Create import job: POST https://verification.didit.me/v3/session/imports/
\- Poll job: GET https://verification.didit.me/v3/session/imports/{import_id}/
\- Read row errors: GET https://verification.didit.me/v3/session/imports/{import_id}/errors/
\- Download template: GET https://verification.didit.me/v3/session/imports/template/?import_type=transactions
\- Authenticate with x-api-key: 

Inputs you need:
\- DIDIT_API_KEY
\- A transaction export file or API output

Canonical transaction columns:
transaction_id, transaction_at, transaction_category, direction, amount, currency, currency_kind, amount_in_default_currency, default_currency, payment_details, payment_reference_id, action_type, status, score, severity, subject_json, counterparty_json, custom_properties_json, provider_results_json, travel_rule_json, network_snapshot_json, metadata_json

Rules:
\- transaction_id is required and is idempotent per Didit application.
\- transaction_category must be one of Didit's transaction categories, for example finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, or auditTrailEvent.
\- direction must be INBOUND or OUTBOUND.
\- status must be APPROVED, IN_REVIEW, DECLINED, or AWAITING_USER.
\- subject_json must include vendor_data and full_name.
\- counterparty_json is optional but should be included when the legacy provider has it.
\- provider_results_json must be a JSON array.
\- travel_rule_json, network_snapshot_json, custom_properties_json, and metadata_json must be JSON objects when present.

Create an import job:
curl -X POST https://verification.didit.me/v3/session/imports/ \
-H "x-api-key: $DIDIT_API_KEY" \
-F "import_type=transactions" \
-F "file=@didit-transactions.ndjson"

Output:
\- A canonical CSV or NDJSON file ready for Didit.
\- The curl command used to create the import job.
\- The import_id and polling command.
\- A summary of created, skipped, and failed transaction rows.`

\
Enganxa a ## Consultar el progrés```bash theme={null} curl https://verification.didit.me/v3/session/imports/IMPORT_ID/ \ -H "x-api-key: YOUR_API_KEY" ```La resposta inclou `status`, `import_type`, `total_rows`, `processed_rows`, `created_count`, `updated_count`, `skipped_count`, `failed_count` i `checkpoint_row`.## Descarregar els errors de fila```bash theme={null} curl https://verification.didit.me/v3/session/imports/IMPORT_ID/errors/ \ -H "x-api-key: YOUR_API_KEY" ```Cada error inclou `row_number`, `external_id`, `error` i `raw_row`, de manera que pots corregir només les files que han fallat i reintentar-les.## Protecció contra abusosLes tasques d'importació històrica mitjançant `POST /v3/session/imports/` estan desactivades per defecte. Didit activa aquesta capacitat per organització després de revisar-la, perquè aquestes tasques poden processar milions de files i descarregar contingut multimèdia. Les importacions de dades operatives habituals d'aquesta guia (crear usuaris, crear empreses, pujar cares de perfil, pujar llistes de bloqueig de cares o afegir entrades a llistes) no requereixen cap habilitació especial de migració més enllà dels permisos normals de la clau d'API, la disponibilitat del producte i els límits de freqüència d'aquests endpoints.Les tasques d'importació històrica també s'executen en processos de treball aïllats amb límits de mida de fitxer, límits de files, URL de contingut que només utilitzen HTTPS, bloqueig d'URL de xarxa privada, un límit de 4 tasques d'importació actives per aplicació i captura d'errors per fila.## Estats canònics| Resultat del proveïdor | Estat a Didit | | - | - | | Aprovat / Verd / Verificat | `Approved` | | Rebutjat / Vermell / Refusat | `Declined` | | Revisió manual / Pendent / Cal revisió | `In Review` | | Incomplet / Init / Fila històrica desconeguda | `Expired` |## IdempotènciaDidit fa servir `external_id` com a clau d'idempotència de les importacions de verificació d'usuaris i de verificació d'empreses, limitada a cada aplicació. Les importacions de transaccions fan servir `transaction_id` per aplicació. Tornar a importar el mateix fitxer omet les files que ja s'han importat i crea les files que encara no s'han processat.## Importa usuaris, cares de perfil i llistes de bloqueigFes servir aquests camins quan no estiguis recreant una sessió de verificació completada.### Importa perfils d'usuariCrea usuaris amb [`POST /v3/users/create/`](https://docs.didit.me/ca/management-api/users/create) o amb la importació CSV del Business Console a [Importar i exportar usuaris](https://docs.didit.me/ca/entities/users/import-export.md). Això crea o actualitza només el perfil `VendorUser`. No crea cap sessió de verificació, decisió KYC, informe de document, advertència ni historial de webhooks.Fes-ho servir quan vulguis que Didit sàpiga que el client existeix abans de les verificacions futures, o quan necessitis omplir retroactivament camps similars a un CRM com `display_name`, etiquetes o metadades.### Puja cares de perfil fiablesQuan existeixi un usuari, puja una cara de perfil fiable amb [`POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/`](https://docs.didit.me/ca/management-api/users/upload-face). Això adjunta l'evidència biomètrica al perfil de l'usuari i la indexa per a la detecció de duplicats i la cerca facial.Això **no** posa la cara a la llista de bloqueig. És útil quan tens una imatge de perfil de confiança d'un proveïdor de KYC anterior i vols que les verificacions futures de Didit la comparin.### Importa llistes de bloqueig i de permesos de caresPer bloquejar o permetre una cara directament, fes servir [`POST /v3/lists/{list_uuid}/entries/face-upload/`](https://docs.didit.me/ca/management-api/lists/upload-face) amb una llista de tipus de cara. Didit extreu l'embedding biomètric i emmagatzema una entrada de la llista.Fes-ho servir per a imatges de defraudadors coneguts, cares de confiança de llistes de permesos o migracions de llistes de frau dels proveïdors. Si la cara prové d'una sessió existent de Didit, és preferible fer servir [`POST /v3/lists/{list_uuid}/entries/`](https://docs.didit.me/ca/management-api/lists/create-entry) amb `reference_session_id`: Didit extreu la cara correcta de la sessió i enllaça l'entrada amb l'origen.### Importa llistes d'usuaris, empreses, documents, carteres, correus electrònics, telèfons, IP o dispositiusFes servir [`POST /v3/lists/{list_uuid}/entries/`](https://docs.didit.me/ca/management-api/lists/create-entry) per als valors de les llistes que no són cares. És el camí adequat per a llistes de bloqueig i de permesos de proveïdors, llistes de contracàrrecs, adreces, adreces de risc conegudes, petjades digitals de dispositius, números de document, correus electrònics, telèfons, usuaris o empreses.## Propers passos> [card] [Importar usuaris](https://docs.didit.me/ca/entities/users/import-export.md) > > Carrega perfils d'usuari i adjunta cares de perfil de confiança.> [card] [Importar empreses](https://docs.didit.me/ca/entities/businesses/import-export.md) > > Carrega perfils d'empresa abans d'executar el KYB.> [card] [Pujar cara de perfil](https://docs.didit.me/ca/management-api/users/upload-face.md) > > Adjunta imatges de cara de confiança als usuaris importats.> [card] [Pujar cara a una llista](https://docs.didit.me/ca/management-api/lists/upload-face.md) > > Afegeix cares a llistes de bloqueig o de permesos.> [card] [Crear entrada de llista](https://docs.didit.me/ca/management-api/lists/create-entry.md) > > Importa telèfons, correus electrònics, carteres, documents, adreces, dispositius, usuaris o empreses a llistes.> [card] [Límits de freqüència](https://docs.didit.me/ca/integration/rate-limiting.md) > > Dissenya bucles de migració segurs i reintents. ## OpenAPI ````yaml ca/openapi-25.json POST /v3/session/imports/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/imports/: post: tags: - Sessions summary: Crea una tasca d'importació de verificacions description: >- Crea una feina d'importació asíncrona per a sessions històriques de Verificació d'usuaris, sessions de Verificació d'empreses, registres de monitoratge de transaccions o regles d'estat personalitzat de fluxos de treball. Estableix `source=provider` per migrar des d'un altre proveïdor: Didit llegeix Sumsub, Onfido, Persona i ComplyCube amb la teva clau de només lectura, llegeix els registres de Veriff, iDenfy i MetaMap mitjançant els ID que pugis a `file`, i importa un fitxer d'exportació en el format de Didit per a la resta de proveïdors. Els ID dels registres s'organitzen en espais de noms per proveïdor (`sumsub:`), de manera que una nova execució omet tot allò que ja es troba a Didit, i els registres importats mitjançant un fitxer amb l'ID simple del proveïdor també es reconeixen en ambdues direccions; així, passar d'una importació per fitxer a una migració des de proveïdor mai no importa un registre dues vegades. Una aplicació pot executar fins a 4 feines d'importació alhora; una feina interrompuda per un desplegament o un reinici d'un procés de treball continua automàticament des de la seva darrera fila importada. Les importacions estan inhabilitades per defecte i Didit les ha d'habilitar per organització. operationId: post_v3_session_imports_create requestBody: required: true content: multipart/form-data: schema: type: object properties: import_type: type: string enum: - user_verification - business_verification - status_rules - transactions default: user_verification description: >- Què importar: sessions històriques de Verificació d'usuaris, sessions històriques de Verificació d'empreses, regles d'estat personalitzades del flux de treball o registres històrics de monitoratge de transaccions. workflow_id: type: string format: uuid description: >- UUID del flux de treball al qual s'han d'adjuntar les sessions o regles d'estat importades. Obligatori per a user_verification, business_verification i status_rules. Omet-ho per a les transaccions. source_format: type: string enum: - csv - ndjson description: >- Opcional. S'infereix de l'extensió del fitxer penjat quan s'omet. file: type: string format: binary description: >- Fitxer canònic en format CSV o NDJSON. Fes servir NDJSON per a importacions grans. Mida màxima de càrrega de 25 MB (fes servir `source_file_url` per a fitxers més grans). Mútuament excloent amb `source_file_url`. source_file_url: type: string format: uri description: >- Alternativa a la càrrega de fitxers. Ha de ser una URL HTTPS que apunti a una adreça pública (es rebutgen les xarxes privades o de loopback). Mútuament excloent amb `file`. source: type: string enum: - file - provider description: >- `provider` fa que això sigui una migració des d'un altre proveïdor de verificació d'identitat. Omet-ho per a una importació de fitxers. provider: type: string enum: - sumsub - jumio - veriff - onfido - persona - metamap - socure - idnow - shufti - idenfy - ondato - trulioo - au10tix - complycube - other description: >- Origen de la migració, de `GET /v3/session/imports/providers/`. Obligatori quan `source` és `provider`. credentials: type: object additionalProperties: type: string description: >- La clau de només lectura del proveïdor, amb els noms de camp que enumera `credential_fields`. Xifrada en repòs, mai no es retorna i s'elimina quan finalitza la importació. Envia-la com una cadena JSON a multipart. options: type: object properties: region: type: string description: >- La regió del proveïdor, una de les seves `regions` (Onfido: `eu`, `us`, `ca`). status_mapping: type: object additionalProperties: type: string enum: - Approved - Declined - In Review - Expired - Not Finished - Abandoned description: >- Modificacions del mapatge d'estats per defecte del proveïdor: de l'estat d'origen a l'estat de Didit. `Not Finished` i `Abandoned` s'ometen i es comptabilitzen, mai s'importen. dry_run: type: boolean default: false description: >- Compta el que importaria la migració (per estat, ja a Didit, mateixa persona, no finalitzat) i no escriu res. La tasca acaba en `READY`; inicia-la amb `POST /v3/session/imports/{importId}/start/`. face_templates: type: boolean default: false description: >- Genera plantilles biomètriques a partir de les selfies importades i cerca-les a les cares i la llista de bloqueig de l'aplicació. Les coincidències només es marquen per a revisió. Requereix `lawful_basis_confirmed`. lawful_basis_confirmed: type: boolean default: false description: >- Confirma que disposes d'una base jurídica per compartir aquestes selfies amb Didit com a encarregat del tractament. application/json: schema: type: object required: - source_file_url properties: import_type: type: string enum: - user_verification - business_verification - status_rules - transactions default: user_verification description: >- Què importar: sessions històriques de Verificació d'usuaris, sessions històriques de Verificació d'empreses, regles d'estat personalitzades del flux de treball o registres històrics de monitoratge de transaccions. workflow_id: type: string format: uuid description: >- UUID del flux de treball al qual s'han d'adjuntar les sessions o regles d'estat importades. Obligatori per a user_verification, business_verification i status_rules. Omet-ho per a les transaccions. source_format: type: string enum: - csv - ndjson description: >- Opcional. S'infereix de l'extensió de fitxer de la URL quan s'omet. source_file_url: type: string format: uri description: >- Alternativa a la càrrega de fitxers. Ha de ser una URL HTTPS que apunti a una adreça pública (es rebutgen les xarxes privades o de loopback). Mútuament excloent amb `file`. source: type: string enum: - file - provider description: >- `provider` fa que això sigui una migració des d'un altre proveïdor de verificació d'identitat. Omet-ho per a una importació de fitxers. provider: type: string enum: - sumsub - jumio - veriff - onfido - persona - metamap - socure - idnow - shufti - idenfy - ondato - trulioo - au10tix - complycube - other description: >- Origen de la migració, de `GET /v3/session/imports/providers/`. Obligatori quan `source` és `provider`. credentials: type: object additionalProperties: type: string description: >- La clau de només lectura del proveïdor, amb els noms de camp que enumera `credential_fields`. Xifrada en repòs, mai no es retorna i s'elimina quan finalitza la importació. Envia-la com una cadena JSON a multipart. options: type: object properties: region: type: string description: >- La regió del proveïdor, una de les seves `regions` (Onfido: `eu`, `us`, `ca`). status_mapping: type: object additionalProperties: type: string enum: - Approved - Declined - In Review - Expired - Not Finished - Abandoned description: >- Modificacions del mapatge d'estats per defecte del proveïdor: de l'estat d'origen a l'estat de Didit. `Not Finished` i `Abandoned` s'ometen i es comptabilitzen, mai s'importen. dry_run: type: boolean default: false description: >- Compta el que importaria la migració (per estat, ja a Didit, mateixa persona, no finalitzat) i no escriu res. La tasca acaba en `READY`; inicia-la amb `POST /v3/session/imports/{importId}/start/`. face_templates: type: boolean default: false description: >- Genera plantilles biomètriques a partir de les selfies importades i cerca-les a les cares i la llista de bloqueig de l'aplicació. Les coincidències només es marquen per a revisió. Requereix `lawful_basis_confirmed`. lawful_basis_confirmed: type: boolean default: false description: >- Confirma que disposes d'una base jurídica per compartir aquestes selfies amb Didit com a encarregat del tractament. examples: URL-based import: value: import_type: user_verification workflow_id: 9f9b1234-aaaa-bbbb-cccc-1234567890ab source_file_url: https://files.example.com/exports/sessions.ndjson responses: '201': description: >- Tasca d'importació acceptada. Consulta periòdicament l'`uuid` retornat fins que `status` sigui `COMPLETED` o `FAILED`. content: application/json: schema: $ref: '#/components/schemas/SessionImportJob' examples: Job accepted: value: uuid: 3f9c1a2b-4d5e-4f60-8a7b-9c0d1e2f3a4b status: PENDING import_type: user_verification source_format: ndjson source_filename: sessions.ndjson total_rows: 0 processed_rows: 0 checkpoint_row: 0 created_count: 0 updated_count: 0 skipped_count: 0 failed_count: 0 total_media_bytes: 0 last_error: null created_at: '2026-05-17T08:42:11Z' updated_at: '2026-05-17T08:42:11Z' started_at: null completed_at: null '400': description: >- Flux de treball, tipus de fitxer, mida de fitxer, URL d'origen o combinació de selectors no vàlids. Una migració la clau de la qual és rebutjada pel proveïdor respon amb `code` (`invalid_credentials`, `missing_permission`, `wrong_region`, `provider_unavailable`, `rate_limited`, `ids_required`, `record_not_found`), `missing_permissions` i `suggested_region`. content: application/json: examples: Invalid workflow: value: workflow_id: - Invalid workflow_id. Workflow required: value: workflow_id: - This field is required for this import type. Wrong file type: value: file: - Only CSV and NDJSON files are supported. File too large: value: file: - Import file exceeds the maximum allowed size. No source: value: file: - Upload a file or provide source_file_url. Both sources: value: file: - Use either file or source_file_url, not both. '403': description: >- Importacions no habilitades, aplicació de sandbox o falta la clau d'API (una clau incorrecta, revocada o caducada rep un `401`). Les importacions de verificacions estan inhabilitades per defecte i Didit les ha d'habilitar per a cada organització. content: application/json: examples: Imports not enabled: value: detail: >- Verification imports are not enabled for this organization. Sandbox: value: detail: >- Verification imports are not enabled for sandbox applications. Bad API key: value: detail: You do not have permission to perform this action. '429': description: >- L'aplicació ja té 4 tasques d'importació actives (PENDING/PROCESSING/PAUSED), el màxim que pot executar alhora. Espera que una finalitzi abans d'iniciar-ne una altra. content: application/json: examples: Active job: value: detail: >- This application already has 4 active import jobs, the most it can run at once. Wait for one to finish before starting another. security: - ApiKeyAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.imports.create( import_type="user_verification", workflow_id="9f9b1234-aaaa-bbbb-cccc-1234567890ab", source_file_url="https://files.example.com/exports/sessions.ndjson", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.imports.create({ import_type: "user_verification", workflow_id: "9f9b1234-aaaa-bbbb-cccc-1234567890ab", source_file_url: "https://files.example.com/exports/sessions.ndjson", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.Imports.Create(ctx, didit.SessionsImportsCreateParams{\n\tImportType: didit.Some(didit.SessionsImportsCreateParamsImportType(\"user_verification\")),\n\tWorkflowID: didit.String(\"9f9b1234-aaaa-bbbb-cccc-1234567890ab\"),\n\tSourceFileURL: didit.String(\"https://files.example.com/exports/sessions.ndjson\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.SessionsImportsCreateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().imports().create(SessionsImportsCreateParams.builder() .importType(SessionsImportsCreateParams.ImportType.of("user_verification")) .workflowId("9f9b1234-aaaa-bbbb-cccc-1234567890ab") .sourceFileUrl("https://files.example.com/exports/sessions.ndjson") .build()); System.out.println(result); - lang: php label: PHP source: |- sessions->imports->create([ 'import_type' => 'user_verification', 'workflow_id' => '9f9b1234-aaaa-bbbb-cccc-1234567890ab', 'source_file_url' => 'https://files.example.com/exports/sessions.ndjson', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.imports.create( import_type: "user_verification", workflow_id: "9f9b1234-aaaa-bbbb-cccc-1234567890ab", source_file_url: "https://files.example.com/exports/sessions.ndjson" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.Imports.CreateAsync(new SessionsImportsCreateParams { ImportType = new SessionsImportsCreateParamsImportType("user_verification"), WorkflowId = "9f9b1234-aaaa-bbbb-cccc-1234567890ab", SourceFileUrl = "https://files.example.com/exports/sessions.ndjson", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: SessionImportJob: type: object required: - uuid - status - import_type - source_format - source_filename - total_rows - processed_rows - created_count - updated_count - skipped_count - failed_count properties: uuid: type: string format: uuid description: >- ID de la tasca d'importació. Utilitza aquest valor per fer el seguiment del progrés i obtenir els errors de les files. status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED - PAUSED - CANCELLED - READY import_type: type: string enum: - user_verification - business_verification - status_rules - transactions source_format: type: string enum: - csv - ndjson source_filename: type: string total_rows: type: integer format: int64 processed_rows: type: integer format: int64 checkpoint_row: type: integer format: int64 created_count: type: integer format: int64 updated_count: type: integer format: int64 skipped_count: type: integer format: int64 failed_count: type: integer format: int64 total_media_bytes: type: integer format: int64 last_error: type: string nullable: true created_at: type: string format: date-time updated_at: type: string format: date-time started_at: type: string format: date-time nullable: true completed_at: type: string format: date-time nullable: true state: type: string enum: - ready - queued - running - paused - completed - errors - failed - cancelled description: >- L'estat de la tasca tal com es mostra a la consola; `errors` és una tasca completada amb files rebutjades. source: type: string enum: - file - api - provider provider: type: string description: Origen de la migració; buit per a una importació per fitxer o API. provider_options: type: object credential_hint: type: string description: >- Els primers caràcters de la clau que manté la migració. La clau en si no es retorna mai. credentials_expires_at: type: string format: date-time nullable: true resumes_at: type: string format: date-time nullable: true description: >- Quan una tasca posada en pausa pel límit de freqüència del proveïdor es reprèn per si mateixa. status_mapping: type: object additionalProperties: type: string is_dry_run: type: boolean dry_run_summary: type: object description: >- El que ha trobat una execució en sec: `total`, `by_status`, `already_in_didit`, `same_person`, `not_finished`, `failed`, `unmapped_statuses`. face_templates_enabled: type: boolean lawful_basis_confirmed_at: type: string format: date-time nullable: true not_finished_count: type: integer format: int64 same_person_count: type: integer format: int64 face_templates_count: type: integer format: int64 face_duplicates_count: type: integer format: int64 face_blocklist_hits_count: type: integer format: int64 created_by_name: type: string nullable: true created_by_email: type: string nullable: true securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.