Obtener información de un DNI via API
Usando el padrón alcance 13 de ARCA
Requisitos previos
Para poder seguir esta guía, primero necesitarás:
Obtener la autorización
Lo primero que tenemos hacer es obtener el “Token authorization”, que sería la autorización en ARCA.
Para usar los web services de ARCA, se requiere un certificado digital, con Afip SDK puedes integrarte en modo desarrollo usando el CUIT 20409378472 sin necesidad de obtener un certificado, para poder integrarte lo más rápido posible.
Te dejo este enlace por si luego quieres usar tu propio certificado para desarrollo.
Debemos ejecutar una solicitud POST al endpoint
https://app.afipsdk.com/api/v1/afip/auth
Incluí el header con tu token:
Authorization: Bearer TU_ACCESS_TOKEN_AQUI
{
"environment": "dev",
"tax_id": "20409378472",
"wsid": "ws_sr_padron_a13"
}
Como respuesta nos devolverá
{
"expiration": "2024-03-13T00:42:59.845Z",
"token": "PD94bWwgd...",
"sign": "kEaCwSs36hpe..."
}
Aquí tenemos el token y sign que nos dio ARCA para usar el web service. No es necesario que lo guardemos, Afip SDK se encarga de esto por nosotros, debemos solicitarlo antes de cada llamada a los métodos del web service.
Paso 1: Obtener el CUIT a partir del DNI
Con token y sign, consultamos getIdPersonaListByDocumento.
POST https://app.afipsdk.com/api/v1/afip/requests
Authorization: Bearer TU_ACCESS_TOKEN_AQUI
{
"environment": "dev",
"method": "getIdPersonaListByDocumento",
"wsid": "ws_sr_padron_a13",
"params": {
"token": "{{token}}",
"sign": "{{sign}}",
"cuitRepresentada": "20409378472",
"documento": 30111222
}
}
De la respuesta debemos tomar el primer CUIT devuelto en idPersonaListReturn.idPersona.
Paso 2: Obtener la información usando ese CUIT
Con ese CUIT, consultamos getPersona.
POST https://app.afipsdk.com/api/v1/afip/requests
Authorization: Bearer TU_ACCESS_TOKEN_AQUI
{
"environment": "dev",
"method": "getPersona",
"wsid": "ws_sr_padron_a13",
"params": {
"token": "{{token}}",
"sign": "{{sign}}",
"cuitRepresentada": "20409378472",
"idPersona": 20111111111
}
}
La respuesta devuelve los datos de la persona asociada al CUIT.
Problemas comunes
Si recibís una respuesta vacía o el error “No existe persona con ese ID”, te recomiendo este artículo:
No existe persona con ese Id
Pasos para resolver este error
También podés revisar la guía oficial del servicio: Padrón alcance 13.
Lo único que queda es pasar a modo producción para consultar información real con tus propias credenciales.
Ante cualquier duda o pregunta, podés resolverla rápidamente en la Comunidad Afip SDK.