TL;DR: Los contactos admiten identificadores externos, además del identificador de Adversus (interno).
Durante la integración de Adversus con sistemas externos, es esencial mantener el seguimiento de los sistemas de entidades de contacto entre ellos. Para ello, utilizamos un identificador que puede proceder de Adversus o del servicio externo.
Al enviar nuevos contactos a Adversus, se puede añadir un identificador externo a la solicitud.
curl --location --request POST 'https://api.adversus.io/contacts' \--header 'Authorization: Basic XX' \--header 'Content-Type: application/json' \--data-raw ' { "poolId": 25518, "externalId": "ABCD1234", "data": { "1": "John Doe", "2": "+1 (337) 385 5102" }}'
Tanto el identificador interno (Adversus) como el externo son visibles desde el almacén y están disponibles en las solicitudes PATCH (utilizando el identificador interno o el externo).
¿Qué pasa si los contactos se cargan sin el identificador externo?
En los casos en los que queremos mantener actualizados los contactos cargados manualmente desde la API -pero no se añade ningún identificador externo durante la importación- es posible buscar contactos por pares clave/valor, por ejemplo, por un número de registro de empresa o similar. Incluso es posible buscar contactos basados en múltiples campos utilizando valores de campo concatenados.
Estas solicitudes son realizadas mediante los contactos findByData-endpoint.
curl --location --request POST 'https://api.adversus.io/contacts/findByData' \--header 'Authorization: Basic XX' \--header 'Content-Type: application/json' \--data-raw '{ "1": "John Doe", "2": "+1 (337) 385 5102"}'
El punto final devolverá el identificador interno, que puede ser utilizado para el procesamiento posterior.
Por favor, tenga en cuenta que generalmente se considera la mejor práctica utilizar el identificador interno o el externo, lo que igualmente provocará tiempos de respuesta más rápidos.