API - Documentación
API Endpoint
https://apistore.pcnt.ioIntroduction ¶
Autenticación
La forma de autenticación es mediante username y password, al invocar al endpoint de /login/jwt se obtiene un token (JWT).
Cuando el JWT expira por inactividad las apis retornan un HTTP 401.
Headers
- Authorization: se envia el token que se obtuvo en el endpoint login, antes del token hay que concatenar la palabra JWT Ejemplo: Authorization: JWT FDASFFAFDSF#$23423DSADSDAS=
Auth ¶
Login ¶
Headers
Content-Type: application/json
Body
{
"username": "username_generado",
"password": "password_generado",
}
Headers
Content-Type: application/json
Body
{
"token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A"
}
Headers
Content-Type: application/json
Body
{
"code": "INVALID_LOGIN",
"process": "948595173290356736",
}
Headers
Content-Type: application/json
Body
{
"code": "GENERAL_ERROR",
"process": "948595173290356736",
}
Autenticarse en apistorePOST/v1/login/jwt
Mediante este servicio se autentica con username / password, y se obtiene un JWT que deberá ser usado en los posteriores requests.
Campo | Tipo | Descripción |
---|---|---|
username | String (required) | Es el 'username' proporcionado |
password | String (required) | Es el 'password' proporcionado |
Campo | Tipo | Descripción |
---|---|---|
token | String | JWT token de autenticación |
expires_in | Number | Tiempo de validez del token en segundos |
Código | Descripción |
---|---|
GENERAL_ERROR | Error genérico. |
INVALID_LOGIN | Acceso inválido. |
Información de la persona ¶
Consulta CUIT de un DNI ¶
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Headers
Content-Type: application/json
Body
[
"23330162449"
]
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cF
Headers
Content-Type: application/json
Body
[
"23330162449",
"20422609084"
]
Headers
Content-Type: application/json
Body
{
"code": "GENERAL_ERROR",
"message": "Error generico",
"process": "948595173290356736",
}
Consulta CUIT de un DNIGET/v1/information/persons/{identification}
Se obtiene el CUIT a partir del DNI de una persona. Se devuelve un listado porque hay casos en los que existen más de un CUIT para un mismo DNI. Por ejemplo se da cuando hay DNI duplicados.
Campo | Tipo | Descripción |
---|---|---|
Content-Type | String | application/json |
Authorization | String | Contiene el JWT de autenticación Valores permitidos: "JWT :token" |
DNI de la persona
Campo | Tipo | Descripción |
---|---|---|
identification | String | DNI de la persona |
Array[String] |
---|
Se devuelve una lista de CUITs |
Código | Descripción |
---|---|
GENERAL_ERROR | Error genérico. |
INVALID_LOGIN | Acceso inválido. |
- identification
string
(required)dni de la persona.
Información de la persona - AFIP ¶
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Headers
Content-Type: application/json
Body
{
"tax_identification_number": "23142765799",
"person_type": "natural_person",
"tax_identification_type": "CUIT",
"status": "ACTIVO",
"name": "MARADONA DIEGO ARMANDO",
"first_name": "DIEGO ARMANDO",
"last_name": "MARADONA",
"identification_type": "DNI",
"identification": "14276579",
"address": {
"address": "CANTILO JOSE LUIS 4575",
"zip_code": "1419",
"state_code": 0,
"state": "CIUDAD AUTONOMA BUENOS AIRES"
},
"closing_month": 12,
"business_activity": [
"931042"
],
"business_activity_description": [
{
"id": "931042",
"description": "SERVICIOS PRESTADOS POR PROFESIONALES Y TÉCNICOS PARA LA REALIZACIÓN DE PRÁCTICAS DEPORTIVAS",
"order": "1",
"period": "201311"
}
],
"birth_date": "1960-10-30",
"date_of_death": "2020-11-25"
}
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Headers
Content-Type: application/json
Body
{
"tax_identification_number": "23330162449",
"person_type": "natural_person",
"tax_identification_type": "CUIT",
"status": "ACTIVE",
"name": "MESSI LIONEL ANDRES",
"first_name": "LIONEL ANDRES",
"last_name": "MESSI",
"identification_type": "DNI",
"identification": "33016244",
"closing_month": 12,
"address": {
"address": "PJE. LAVALLEJA 525",
"zip_code": "2000",
"state_code": 12,
"state": "ROSARIO SUD"
},
"business_activity": [
"931042"
],
"business_activity_description": [
{
"id": "931042",
"description": "SERVICIOS PRESTADOS POR PROFESIONALES Y TÉCNICOS PARA LA REALIZACIÓN DE PRÁCTICAS DEPORTIVAS",
"order": "1",
"period": "201311"
}
],
"monotributo_categories": [
{
"registration_date": "2022-01-01T00:00:00.000Z",
"category_description": "G LOCACIONES DE SERVICIO",
"tax_id": "20",
"category_id": "41"
}
],
"birth_date": "1987-06-24"
}
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Headers
Content-Type: application/json
Body
{
"tax_identification_number": "30714423033",
"person_type": "legal_person",
"tax_identification_type": "CUIT",
"status": "ACTIVO",
"name": "POINCENOT TECHNOLOGY STUDIO S.A",
"identification_type": "CUIT",
"identification": "30714423033",
"legal_form": "SOC. ANONIMA",
"address": {
"address": "RECONQUISTA 1088 Piso:12",
"zip_code": "1003",
"state_code": 0,
"state": "CIUDAD AUTONOMA BUENOS AIRES"
},
"closing_month": 12,
"start_date": "2013-10-17",
"business_activity": [
"620100",
"649290"
],
"business_activity_description": [
{
"id": "620100",
"description": "SERVICIOS DE CONSULTORES EN INFORMÁTICA Y SUMINISTROS DE PROGRAMAS DE INFORMÁTICA",
"order": "1",
"period": "201404"
},
{
"id": "649290",
"description": "SERVICIOS DE CRÉDITO N.C.P.",
"order": "2",
"period": "201804"
}
],
"taxes_description": [
{
"id": "103",
"description": "REGIMENES DE INFORMACIÓN",
"registration_date": "2014-04-01T00:00:00Z"
},
{
"id": "10",
"description": "GANANCIAS SOCIEDADES",
"registration_date": "2014-04-01T00:00:00Z"
},
{
"id": "30",
"description": "IVA",
"registration_date": "2014-04-01T00:00:00Z"
},
{
"id": "301",
"description": "EMPLEADOR-APORTES SEG. SOCIAL",
"registration_date": "2014-05-01T00:00:00Z"
},
{
"id": "217",
"description": "SICORE-IMPTO.A LAS GANANCIAS",
"registration_date": "2014-06-01T00:00:00Z"
},
{
"id": "353",
"description": "RETENCIONES CONTRIB.SEG.SOCIAL",
"registration_date": "2014-10-01T00:00:00Z"
}
],
"taxes": [
"103",
"10",
"30",
"301",
"217",
"353"
]
}
Headers
Content-Type: application/json
Body
{
"code": "GENERAL_ERROR",
"message": "Error generico",
"process": "948595173290356736",
}
Información de la persona - AFIPGET/v1/information/person/{tax_identification_number}
Se obtiene inrofmación a partir del CUIT
Campo | Tipo | Descripción |
---|---|---|
Content-Type | String | application/json |
Authorization | String | Contiene el JWT de autenticación Valores permitidos: "JWT :token" |
cuit
Campo | Tipo | Descripción |
---|---|---|
tax_identification_number | String | CUIT de la persona física o jurídica |
Campo | Tipo | Descripción |
---|---|---|
tax_identification_number | String | CUIT de la persona |
person_type | String | Tipo de persona. Posibles valores:
|
tax_identification_type | String | Tipo de clave - documento. Posibles valores:
|
status | String | Estado Posibles valores:
|
name | String | Nombre completo o Razón social |
first_name | String | Solo nombre en caso de persona física |
last_name | String | Solo apellido en caso de persona física |
identification_type | String | Tipo de documento ver valores |
identification | String | Número de documento |
legal_form | String | Forma Juridica. Solo para persona jurídica. |
address | Object [address] | Domicilio Fiscal ver Domicilio Fiscal |
closing_month | Number | Mes de cierre |
birth_date | String | Fecha nacimiento. Solo para persona física. formato yyyy-MM-dd |
date_of_death | String | Fecha Fallecimiento. Solo para persona física. formato yyyy-MM-dd |
start_date | String | Fecha contrato social. Solo para persona jurídica. formato yyyy-MM-dd |
business_activity | Array [Number] | Lista de código de actividades |
business_activity_description | Array [Object [BusinessActivityDescription]] | Lista de actividades ver Lista de actividades |
taxes | Array [Number] | Lista de impuestos |
taxes_description | Array [Object [TaxesDescription]] | Lista de impuestos con descripción ver Lista de impuestos con descripción |
categorias_monotributo | Array [Object [Monotributo]] | Lista de categorías de monotributo ver Lista de categorías de monotributo |
Domicilio Fiscal | ||
---|---|---|
Campo | Tipo | Descripción |
state_code | Number | Id de provincia |
state | String | Descripción de la provincia |
address | String | Dirección del domicilio |
zip_code | number | Código postal |
Lista de actividades | ||
---|---|---|
Campo | Tipo | Descripción |
id | Number | Código de actividad |
description | String | Descripción de la actividad |
order | Number | Orden |
period | Number | Período |
Lista de impuestos con descripción | ||
---|---|---|
Campo | Tipo | Descripción |
id | Number | Código de actividad |
description | String | Descripción de la actividad |
registration_date | Number | Fecha inscripción |
Lista de categorías de monotributo | ||
---|---|---|
Campo | Tipo | Descripción |
idImpuesto | Number | Código de impuesto |
idCategoria | String | Código de la categoría |
descripcionCategoria | String | Descripción Categoría |
fechaInscripcion | String | Fecha inscripción. formato: ISO |
Código | Descripción |
---|---|
GENERAL_ERROR | Error genérico. |
INVALID_LOGIN | Acceso inválido. |
- tax_identification_number
string
(required)cuit de la persona física o jurídica.
Información de la persona - ReNaPer ¶
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Headers
Content-Type: application/json
Body
{
"id_tramite_principal": "162853884",
"id_tramite_tarjeta_reimpresa": 0,
"ejemplar": "B",
"vencimiento": "22/01/2028",
"emision": "22/01/2013",
"apellido": "MESSI",
"nombres": "Lionel Andrés",
"fecha_nacimiento": "24/06/1987",
"cuil": "23330162449",
"calle": "REINA ELISENDA DE MONTCADA",
"numero": "26",
"piso": "",
"departamento": "1",
"codigo_postal": "8034",
"barrio": "0",
"monoblock": "",
"ciudad": "SIN INFORMAR",
"municipio": "BARCELONA",
"provincia": "BARCELONA",
"pais": "ESPAÑA",
"nacionalidad": "ARGENTINA",
"codigo_fallecido": 0,
"mensaje_fallecido": "SIN AVISO DE FALLECIMIENTO",
"fecha_fallecimiento": "",
"id_ciudadano": "24291560"
}
Headers
Content-Type: application/json
Body
{
"code": "GENERAL_ERROR",
"message": "Error generico",
"process": "948595173290356736",
}
Información de la persona - ReNaPerGET/v1/information/person-renaper/{identification}/gender/{gender}
A partir del DNI y el género devuelve datos del Registro Nacional de las Personas (ReNaPer)
Campo | Tipo | Descripción |
---|---|---|
Content-Type | String | application/json |
Authorization | String | Contiene el JWT de autenticación Valores permitidos: "JWT :token" |
DNI de la persona
Campo | Tipo | Descripción |
---|---|---|
identification | String | DNI de la persona |
gender | String | Género de la persona que figura en el DNI Posibles valores:
|
Campo | Tipo | Descripción |
---|---|---|
id_tramite_principal | String | id trámite principal |
id_tramite_tarjeta_reimpresa | String | id trámite tarjeta reimpresa |
ejemplar | String | Tipo de ejemplar. ejemplo: B |
vencimiento | String | Fecha de vencimiento del DNI |
emision | String | Fecha de emisión del DNI |
apellido | String | Apellido de la persona |
nombres | String | Nombre de la persona |
fecha_nacimiento | String | Fecha de nacimiento |
cuil | String | CUIL de la persona |
calle | String | Domicilio: calle |
numero | String | Domicilio: número |
piso | String | Domicilio: piso |
departamento | String | Domicilio: departamento |
codigo_postal | String | Domicilio: código postal |
barrio | String | Domicilio: barrio |
monoblock | String | Domicilio: monoblock |
ciudad | String | Domicilio: ciudad |
municipio | String | Domicilio: municipio |
provincia | String | Domicilio: provincia |
pais | String | Domicilio: pais |
nacionalidad | String | Nacionalidad |
codigo_fallecido | Number | Código de fallecido |
mensaje_fallecido | String | Mensaje fallecido |
fecha_fallecimiento | String | Fecha de fallecimiento |
id_ciudadano | String | id ciudadano |
Código | Descripción |
---|---|
GENERAL_ERROR | Error genérico. |
INVALID_LOGIN | Acceso inválido. |
- identification
string
(required)dni de la persona.
- gender
string
(required)género de la persona que figura en el DNI. (F/M)
Chequeo en listas ¶
Chequeo en listas de terrorismo ¶
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Headers
Content-Type: application/json
Body
[
{
"threshold": 0.9,
"hits": [
{
"target_value": "AAMIR ALI CHAUDHRY ",
"result": 1,
"blacklist_attrs": {
"dataid": "2999482",
"versionnum": "1",
"un_list_type": "Al-Qaida",
"reference_number": "QDi.312",
"listed_on": "18/10/2012",
"comments": "Electronics and explosives expert for Tehrik-e Taliban Pakistan (TTP)\n(QDe.132). Involved in attack planning for TTP. Provided financial and logistical\nsupport for TTP and participated in TTP-sponsored militant training. Review pursuant to Security Council resolution 2253 (2015) was concluded on 21 Feb. 2019. INTERPOL-UN Security Council Special Notice web link: https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals",
"gender": "",
"nationality": [
"Pakistan"
],
"full_name": "AAMIR ALI CHAUDHRY "
}
}
]
}
]
Headers
Content-Type: application/json
Body
{
"code": "GENERAL_ERROR",
"message": "Error generico",
"process": "948595173290356736",
}
Chequeo en lista de terrorismoGET/v1/blacklists/terrorist?tax_identification_number={tax_identification_number}&person_type=&name={name}&threshold={threshold}&limit={limit}
Chequeo en registros de actos de Terrorismo y su Financiamiento
Campo | Tipo | Descripción |
---|---|---|
Content-Type | String | application/json |
Authorization | String | Contiene el JWT de autenticación Valores permitidos: "JWT :token" |
Campo | Tipo | Descripción |
---|---|---|
tax_identification_number | String | CUIT de la persona. La busqueda se hace por CUIT o por nombre. |
person_type | String | Tipo de persona relacionada con el parámetro tax_identification_number. Posibles valores:
|
name | String | Nombre de la persona. La busqueda se hace por CUIT o por nombre. |
threshold | String | Porcentaje para el límite de confianza. Ej. 0.90 |
limit | String | Cantidad limite de resultados. |
Tipo | Descripción |
---|---|
Array [Object [TerroristCheck]] | Lista de aciertos ver Lista de aciertos |
Campo | Tipo | Descripción |
---|---|---|
threshold | number | Porcentaje de confianza |
hits | Array [Object [Hits]] | hits ver Aciertos |
Detalle de acierto | ||
---|---|---|
Campo | Tipo | Descripción |
target_value | String | Valor objetivo acertado |
result | number | Porcentaje de acierto |
blacklist_attrs | Object [BlacklistAttrs] | Detalle en la lista de terrorismo. ver Detalle en la lista de terrorismo |
Detalle de lista de terrorismo | ||
---|---|---|
Campo | Tipo | Descripción |
dataid | String | Id |
versionnum | number | Número de versión |
un_list_type | String | tipo de lista |
reference_number | String | Número de referencia |
listed_on | String | Fecha de ingreso. formato yyyy-MM-dd |
comments | String | Comentario |
full_name | String | Nombre completo |
nationality | Array | Nacionaliad |
gender | String | Género |
Código | Descripción |
---|---|
GENERAL_ERROR | Error genérico. |
INVALID_LOGIN | Acceso inválido. |
- tax_identification_number
string
(optional)CUIT de la persona. Alguno de los dos campos tax_identification_number o nombre son requerido.
- person_type (string, optional) - Tipo de persona relacionada con el parámetro tax_identification_number. natural_person | legal_person
string
(required)- name
string
(optional)nombre de la persona. Alguno de los dos campos tax_identification_number o nombre son requerido.
- threshold
number
(optional)Porcentaje para el límite de confianza. Ej. 0.90
- limit
number
(optional)Cantidad limite de resultados.
Errores ¶
Formato
Todos los errores controlados retornan con HTTP 409 y el siguiente formato de respuesta:
{
"code": "GENERAL_ERROR",
"process": "948595173290356736",
"message": "Debe introducir una fecha válida"
}
Anexo Códigos ¶
Tipo de documento
Código | Descripción |
---|---|
LC | LIBRETA CIVICA |
LE | LIBRETA DE ENROLAMIENTO |
CI | CEDULA DE IDENTIDAD |
TRAM | EN TRAMITE |
ACTA | ACTA DE NACIMIENTO |
PAS | PASAPORTE |
DNI | DOC.NACIONAL DE IDENTIDAD |
INDET | INDETERMINADO |
CERT | CERTIFICADO DE MIGRACIÓN |
DIEXT | DOCUMENTO IDENTIDAD EXTRANJERO |
DNI M | D.N.I. (N° MÚLTIPLE) |
INDOC | ANSES INDOCUMENTADO |
Generated by aglio on 22 Jan 2024