Detalle de la API

Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:

• Endpoint: https://cont.certisend.com/web/container/api/v1/validations/identity/ar/validate_multiplechoice

Parámetros:

• token-susc: Token obtenido al momento de la suscripción a nivel empresa.
• token-api: Token obtenido al momento de la suscripción a nivel API.
• cuit: Número de CUIT o CUIL que se quiere validar.
• internalid: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.

La llamada quedaría de la siguiente manera:
https://cont.certisend.com/web/container/api/v1/validations/identity/ar/validate_multiplechoice?token-susc=TOKENSUSC&token-api=TOKENAPI&cuit=30710348347&internalid=22

Una vez realizada la llamada van a recibir los siguientes parámetros:

• state: Tendrá el valor 0 para un parámetro faltante y un 1 en el caso de que se encuentre información.
• desc: Descripción del parámetro "state" recibido.
• data: Conjunto de información recibida.
• financial_data: Array de información relativa a una entidad financiera en las que el individuo tiene o tuvo relación.
  • bank: Nombre del banco encontrado.
  • isValid: Indica si el CUIT consultado no está relacionado con el banco encontrado, con el valor 0; o si esa relación existe (o existió) con el valor “1”.
• addresses: Lista los posibles domicilios de la persona.
  • address: Domicilio en el que reside o pudo residir la persona.
  • isValid: Indica si el CUIT consultado no está relacionado con el domicilio encontrado, con el valor 0; o si esa relación existe (o existió) con el valor “1”.
• business_data: Array de información relativo a una empresa en la que se pudo haber desempeñado la persona.
  • company: Nombre de la empresa encontrada.
  • isValid: Indica si el CUIT consultado no está relacionado con la empresa encontrada, con el valor 0; o si esa relación existe (o existió) con el valor “1”.
• personal_data: Personas con las que el individuo tiene o tuvo una relación.
  • name: Nombre de la persona encontrada.
  • isValid: Indica si el CUIT consultado no está relacionado con la persona encontrada, con el valor 0; o si esa relación existe (o existió) con el valor “1”.
• related_data: Información adicional correspondiente a si el individuo tiene o tuvo una relación de sociedad.
  • company: Lista posibles sociedades en las que se encuentra la persona.
  • isValid: Indica si el CUIT consultado no está relacionado con el banco, con el valor 0; o si esa relación existe (o existió) con el valor “1”.
• id_internal: ID que se ingresó en el parámetro de entrada.

Cada uno de los parámetros devueltos habilitan a nuestro cliente poder realizar un pequeño múltiple choice en su página web, donde por cada uno de ellos se habilita las cinco opciones que se entregan y luego se compara lo que respondió contra la información que nuestra API entrega.

Cabe destacar que puede suceder que algunas de las secciones pueden venir en todas sus opciones con el valor "isValid = 0", en donde la inteligencia radica en que quien complete la encuesta no marque ninguna de las opciones para que se encuentre correcta.

Si el puntaje de la persona es positivo queda validada y puede avanzar en el proceso que ha sido integrado.

Respuestas de Ejemplo:

Negativa: 

{"state":"0","desc":"Longitud Invalida del CUIT","id_internal":"0"}

Positiva:

{"state":"1","data":[{"financial_data":[{"bank":"BANCO BICA S.A.","isValid":"0"},{"bank":"BANCO BRADESCO ARGENTINA S.A.","isValid":"0"},{"bank":"BANCO PIANO S.A.","isValid":"0"},{"bank":"FIDEICOMISO NUES","isValid":"0"},{"bank":"NUEVO BANCO DEL CHACO S. A.","isValid":"0"}],"addresses":[{"address":"AV. BELGRANO 624  PISO 8  CIUDAD DE BUENOS AIRES","isValid":"1"},{"address":"BENEGAS 8367 ROSARIO NORTE SANTA FE","isValid":"0"},{"address":"BENEGAS 8367 ROSARIO SANTA FE","isValid":"0"},{"address":"CALLE 17 N 712 712 COLON BUENOS AIRES","isValid":"0"},{"address":"CPO DE PEDRETTI CTEL SUIPACHA BUENOS AIRES","isValid":"0"},{"address":"CPO DE PEDRETTI SUIPACHA BUENOS AIRES","isValid":"0"}],"business_data":[{"company":"19 DE NOVIEMBRE S R L","isValid":"0"},{"company":"ACA 868 S.A.","isValid":"0"},{"company":"ALEFA VENTAS S A C I I A G F Y MANDATARIA","isValid":"0"},{"company":"ALFE S R L","isValid":"0"},{"company":"DECONO SA","isValid":"0"}],"personal_data":[{"name":"NIEVA NERI DANTE","isValid":"0"},{"name":"RAMA CARLOS GUSTAVO","isValid":"0"},{"name":"ABREGO ROXANA VANINA","isValid":"0"},{"name":"AIZENSTAT NICOLAS ALEJANDRO","isValid":"0"},{"name":"ALANIZ JUAN CARLOS","isValid":"0"}],"related_data":[{"company":"36 S R L","isValid":"0"},{"company":"A M DIECI SRL","isValid":"0"},{"company":"AGROEMPRESA SAN FRANCISCO S A","isValid":"0"},{"company":"KRALICEK FERNANDO LUIS Y RODRIGUEZ CARLOS ALBERTO","isValid":"0"},{"company":"SUCESORES DE ALFREDO WILLINER S A","isValid":"0"}]}],"id_internal":"0"}

Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test

Definición Técnica de la API: