Detalle de la API

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

• Endpoint: https://cont1-virtual1.certisend.com/web/container/api/v1/validations/identity/ar/dni/validate_dni_complete

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.
• document: Número de documento sin puntos. (Obligatorio)
• docfront: Imagen del DNI del lado del frente. 
• docback: Imagen del DNI del lado del dorso.
• 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://cont1-virtual1.certisend.com/web/container/api/v1/validations/identity/ar/dni/validate_dni_complete?token-susc=TOKENSUSC&token-api=TOKENAPI&document=35375478&docfront=35375478&docback=DOCBACK&internalid=82

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.
• valid_doc: Determina la validez del documento en donde "true" indica la validez del mismo y "false" una diferencia entre los datos obtenidos de la lectura del OCR y el código PDF147.
• valid_ocr: Determina si la lectura de la información contenida en las imágenes es legible y correcta.
• img_front: Ruta temporal de la imagen del frente del DNI.
• img_back: Ruta temporal de la imagen del dorso del DNI.
• ocr: Contiene un conjunto de datos con las validaciones realizadas sobre los textos encontrados en las imágenes.
• front: Contiene un conjunto de datos con las validaciones realizadas sobre el frente del documento.
• language: Idioma del texto encontrado en el frente del DNI.
• textAngle: Ángulo de lectura del texto encontrado en el frente del DNI.
• orientation: Orientación del texto encontrado en el frente del DNI.
• regions: Colección de datos conteniendo los cuadrantes de la imagen leída, sus líneas y las palabras encontradas en el frente del DNI.
• boundingBox: Información de las coordenadas en las que se encontró información. El primer valor refiere al eje X del extremo izquierdo en donde se encontró texto; el segundo al eje Y contando desde el extremo superior de la imagen; mientras que el tercer y cuarto valor hacen referencia al ancho y alto del cuadrante leído en el frente del DNI.
• lines: Colección de objetos donde cada uno de ellos representa una línea de texto encontrada en el frente del DNI.
• words: Colección de objetos donde cada uno de ellos contiene información sobre las palabras encontradas en el frente del DNI.
• text: Indica la palabra encontrada en la lectura del OCR en el frente del DNI.
• back: Contiene un conjunto de datos con las validaciones realizadas sobre el dorso del documento.
• language: Idioma del texto encontrado en el dorso del documento.
• textAngle: Ángulo de lectura del texto encontrado en el dorso del documento.
• orientation: Orientación del texto encontrado en el dorso del documento.
• regions: Colección de datos conteniendo los cuadrantes de la imagen leída, sus líneas y las palabras encontradas en el dorso del documento.
• boundingBox: Información de las coordenadas en las que se encontró información. El primer valor refiere al eje X del extremo izquierdo en donde se encontró texto; el segundo al eje Y contando desde el extremo superior de la imagen; mientras que el tercer y cuarto valor hacen referencia al ancho y alto del cuadrante leído en el dorso del documento.
• lines: Colección de objetos donde cada uno de ellos representa una línea de texto encontrada en el dorso del documento.
• words: Colección de objetos donde cada uno de ellos contiene información sobre las palabras encontradas en el dorso del documento.
• text: Indica la palabra encontrada en la lectura del OCR en el dorso del documento.
• address_ocr: Colección de datos de lectura de OCR específicos del domicilio.
• language: Idioma del texto encontrado.
• textAngle: Ángulo de lectura del texto encontrado.
• orientation: Orientación del texto encontrado.
• regions: Colección de datos conteniendo los cuadrantes de la imagen leída, sus líneas y las palabras encontradas.
• boundingBox: Información de las coordenadas en las que se encontró información. El primer valor refiere al eje X del extremo izquierdo en donde se encontró texto; el segundo al eje Y contando desde el extremo superior de la imagen; mientras que el tercer y cuarto valor hacen referencia al ancho y alto del cuadrante leído.
• words: Colección de objetos donde cada uno de ellos contiene información sobre las palabras encontradas.
• text: Indica la palabra encontrada en la lectura del OCR.
• valid_pdf147: Indica un valor "true" si la lectura del código de  barras del DNI es correcta, un valor "false" si la misma falló.
• pdf147: Colección de datos referidos al contenido del código de barras leído.
• url: URL temporal del código de barras leído.
• barcodetype: Tipo de código de barras leído.
• text: Información contenida dentro del código de barras leído.
• address: Colección de datos conteniendo el domicilio normalizado encontrado en el DNI.
• street_number: Número del domicilio normalizado.
• street_name: Nombre de la calle normalizada.
• locality: Localidad normalizada.
• department: Departamento normalizado.
• province: Provincia normalizada.
  
• country: País normalizado.
• formatted_address: Dirección normalizada completa.
• geometry: Colección de datos geométricos correspondientes al domicilio normalizado.
• location: Latitud y longitud del domicilio normalizado.
• lat: Latitud del domicilio normalizado.
• lng: Longitud del domicilio normalizado.
• id_internal: ID interno ingresado por el cliente.

Respuestas de Ejemplo:

Negativa:

{ "state": "0", "desc": "invalid doc image back.",  "id_internal": "" }

Positiva:

{"state":"1","valid_doc":"true","valid_ocr":"true","img_front":"https://cont1-desa1.certisend.com/web/container/api/v1/validations/identity/ar/dni/tmp/33923493_143930dd7c2ac980cbb2bd18db793e745.jpeg","img_back":"https://cont1-desa1.certisend.com/web/container/api/v1/validations/identity/ar/dni/tmp/33923493_275b71c3ef486884587f9274edc9ae2c3.jpeg","ocr":{"front":{"language":"es","textAngle":0.0,"orientation":"Up","regions":[{"boundingBox":"232,212,460,60","lines":[{"boundingBox":"234,212,303,21","words":[{"boundingBox":"234,212,94,15","text":"REPUBLICA"},{"boundingBox":"334,216,94,14","text":"ARGENTINA"},{"boundingBox":"434,225,5,3","text":"-"},{"boundingBox":"445,219,92,14","text":"MERCOSUR"}]},{"boundingBox":"233,231,332,21","words":[{"boundingBox":"233,231,86,14","text":"REGISTRO"},{"boundingBox":"325,234,83,15","text":"NACIONAL"},{"boundingBox":"415,237,21,12","text":"DE"},{"boundingBox":"442,238,30,12","text":"LAS"},{"boundingBox":"478,238,87,14","text":"PERSONAS"}]},{"boundingBox":"232,250,460,22","words":[{"boundingBox":"232,250,95,15","text":"MINISTERIO"},{"boundingBox":"333,253,32,13","text":"DEL"},{"boundingBox":"370,254,82,16","text":"INTERIOR,"},{"boundingBox":"458,256,56,13","text":"OBRAS"},{"boundingBox":"520,258,78,12","text":"PUBLICAS"},{"boundingBox":"603,259,10,12","text":"Y"},{"boundingBox":"619,259,73,13","text":"VIVIENDA"}]}]},{"boundingBox":"156,697,230,81","lines":[{"boundingBox":"157,697,216,19","words":[{"boundingBox":"157,697,99,19","text":"Docunerto"},{"boundingBox":"263,697,7,19","text":"/"},{"boundingBox":"278,697,95,19","text":"Document"}]},{"boundingBox":"156,737,230,41","words":[{"boundingBox":"156,737,230,41","text":"42.588.783"}]}]},{"boundingBox":"479,279,596,498","lines":[{"boundingBox":"486,279,158,20","words":[{"boundingBox":"486,279,62,20","text":"Ape%o"},{"boundingBox":"554,280,7,16","text":"I"},{"boundingBox":"566,280,78,18","text":"Surname"}]},{"boundingBox":"485,305,109,23","words":[{"boundingBox":"485,305,109,23","text":"PEREZ"}]},{"boundingBox":"555,365,60,16","words":[{"boundingBox":"555,365,7,16","text":"I"},{"boundingBox":"566,365,49,16","text":"Name"}]},{"boundingBox":"484,386,225,28","words":[{"boundingBox":"484,390,85,22","text":"NOELIA"},{"boundingBox":"581,386,128,28","text":"ESTEFANÍA"}]},{"boundingBox":"484,453,451,25","words":[{"boundingBox":"484,453,42,18","text":"Sexo"},{"boundingBox":"531,454,7,17","text":"I"},{"boundingBox":"542,454,34,18","text":"Sex"},{"boundingBox":"610,455,103,17","text":"Nacmahdad"},{"boundingBox":"720,456,6,16","text":"I"},{"boundingBox":"732,456,96,22","text":"Nationality"},{"boundingBox":"863,456,72,22","text":"Ejemplar"}]},{"boundingBox":"611,477,135,22","words":[{"boundingBox":"611,477,135,22","text":"ARGENTINA"}]},{"boundingBox":"864,478,15,22","words":[{"boundingBox":"864,478,15,22","text":"c"}]},{"boundingBox":"482,511,309,21","words":[{"boundingBox":"482,511,52,19","text":"Fecha"},{"boundingBox":"541,513,21,17","text":"de"},{"boundingBox":"663,514,6,17","text":"I"},{"boundingBox":"674,514,41,18","text":"Date"},{"boundingBox":"723,514,18,18","text":"of"},{"boundingBox":"749,515,42,17","text":"birth"}]},{"boundingBox":"483,534,219,24","words":[{"boundingBox":"483,534,25,23","text":"04"},{"boundingBox":"520,535,58,22","text":"JUL/"},{"boundingBox":"590,536,49,21","text":"JUL"},{"boundingBox":"654,536,48,22","text":"1999"}]},{"boundingBox":"568,573,203,19","words":[{"boundingBox":"568,573,75,19","text":"errisón/"},{"boundingBox":"649,573,42,18","text":"Date"},{"boundingBox":"699,574,17,18","text":"of"},{"boundingBox":"724,574,47,18","text":"issue"}]},{"boundingBox":"481,595,212,23","words":[{"boundingBox":"481,595,26,22","text":"03"},{"boundingBox":"518,595,51,23","text":"01C/"},{"boundingBox":"581,595,50,23","text":"DEC"},{"boundingBox":"644,596,49,22","text":"2019"}]},{"boundingBox":"819,612,256,15","words":[{"boundingBox":"819,612,44,14","text":"FIRMA"},{"boundingBox":"870,613,3,12","text":"I"},{"boundingBox":"893,613,82,14","text":"NTIFICADO/"},{"boundingBox":"984,613,91,14","text":"SIGNATURE"}]},{"boundingBox":"481,633,340,26","words":[{"boundingBox":"481,633,52,19","text":"Fecha"},{"boundingBox":"568,633,98,19","text":"\"Mt\"nto"},{"boundingBox":"673,635,7,17","text":"I"},{"boundingBox":"687,634,42,19","text":"Date"},{"boundingBox":"737,635,18,18","text":"of"},{"boundingBox":"763,636,58,23","text":"expiry"}]},{"boundingBox":"481,657,218,26","words":[{"boundingBox":"481,657,26,23","text":"03"},{"boundingBox":"520,657,49,23","text":"DIC/"},{"boundingBox":"581,657,50,26","text":"PEC"},{"boundingBox":"644,658,55,22","text":"2034"}]},{"boundingBox":"480,695,189,20","words":[{"boundingBox":"480,695,65,19","text":"TrárMe"},{"boundingBox":"579,696,7,18","text":"I"},{"boundingBox":"593,696,24,18","text":"Of."},{"boundingBox":"625,696,44,19","text":"k%nt."}]},{"boundingBox":"480,724,153,23","words":[{"boundingBox":"480,724,153,23","text":"00620608783"}]},{"boundingBox":"479,755,52,22","words":[{"boundingBox":"479,755,52,22","text":"7561"}]}]}]}, "back":{"language":"es","textAngle":0.0,"orientation":"Up","regions":[{"boundingBox":"146,217,597,498","lines":[{"boundingBox":"275,217,468,35","words":[{"boundingBox":"275,217,80,23","text":"COLON"},{"boundingBox":"368,221,47,21","text":"1549"},{"boundingBox":"441,222,99,24","text":"CALCHIN"},{"boundingBox":"550,237,7,4","text":"-"},{"boundingBox":"568,224,39,24","text":"RIO"},{"boundingBox":"618,229,108,23","text":"SEGUNDO"},{"boundingBox":"736,243,7,4","text":"-"}]},{"boundingBox":"164,238,115,22","words":[{"boundingBox":"164,238,115,22","text":"CORDOBA"}]},{"boundingBox":"163,266,342,37","words":[{"boundingBox":"163,266,61,18","text":"LUGAR"},{"boundingBox":"231,267,24,18","text":"DE"},{"boundingBox":"263,267,121,36","text":"NACIMIEYJP%"},{"boundingBox":"390,266,115,24","text":"CORDOBA"}]},{"boundingBox":"153,525,250,22","words":[{"boundingBox":"153,527,53,19","text":"CUIL:"},{"boundingBox":"216,525,187,22","text":"27-33923493-6"}]},{"boundingBox":"146,675,444,40","words":[{"boundingBox":"146,675,205,39","text":"8904045"},{"boundingBox":"363,679,227,36","text":"0412031"}]}]}]}, "domicilio":{"language":"es","textAngle":0.0,"orientation":"Up","regions":[{"boundingBox":"163,217,580,86","lines":[{"boundingBox":"275,217,468,35","words":[{"boundingBox":"275,217,80,23","text":"COLON"},{"boundingBox":"368,221,47,21","text":"1549"},{"boundingBox":"441,222,99,24","text":"CALCHIN"},{"boundingBox":"550,237,7,4","text":"-"},{"boundingBox":"568,224,39,24","text":"RIO"},{"boundingBox":"618,229,108,23","text":"SEGUNDO"},{"boundingBox":"736,243,7,4","text":"-"}]},{"boundingBox":"164,238,115,22","words":[{"boundingBox":"164,238,115,22","text":"CORDOBA"}]},{"boundingBox":"163,266,342,37","words":[{"boundingBox":"163,266,61,18","text":"LUGAR"},{"boundingBox":"231,267,24,18","text":"DE"},{"boundingBox":"263,267,121,36","text":"NACIMIEYJP%"},{"boundingBox":"390,266,115,24","text":"CORDOBA"}]}]}]}},"valid_pdf147":"true","pdf147":[{"url":"https://cont1-desa1.certisend.com/web/container/api/v1/validations/identity/ar/dni/tmp/33923493_C143930dd7c2ac980cbb2bd18db793e745.png","valid_pdf147":"1","barcodetype":"PDF_417","text":"00985476787@AREVALO@NOELIA ESTEFANIA@F@8595965@C@07/07/1999@03/12/2019@276"}],"address": {"street_number":"1549","street_name":"Colon","locality":"Calch\u00edn","department":"R\u00edo Segundo","province":"C\u00f3rdoba","country":"Argentina","formatted_address":"Colon 1549, Calch\u00edn, C\u00f3rdoba, Argentina","geometry":{"location":{"lat":-31.6702629,"lng":-63.1962492},"location_type":"RANGE_INTERPOLATED","viewport":{"northeast":{"lat":-31.6689139197085,"lng":-63.19490021970849},"southwest":{"lat":-31.6716118802915,"lng":-63.19759818029151}}}},"id_internal":""}

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: