API - Documentación

Introduction

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

POST https://apistore.pcnt.io/v1/login/jwt
RequestsEjemplo
Headers
Content-Type: application/json
Body
{
    "username": "username_generado",
    "password": "password_generado",
}
Responses200401409
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 apistore
POST/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.
Error de authenticacion por credenciales devolveran código HTTP 401. En el anexo de errores se detalla el formato de los mismos.

Información de la persona

Consulta CUIT de un DNI

GET https://apistore.pcnt.io/v1/information/persons/identification
RequestsEjemplo con un cuitEjemplo con dos cuits
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Responses200
Headers
Content-Type: application/json
Body
[
  "23330162449"
]
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cF
Responses200409
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 DNI
GET/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.
Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.
URI Parameters
HideShow
identification
string (required) 

dni de la persona.


Información de la persona - AFIP

GET https://apistore.pcnt.io/v1/information/person/tax_identification_number
RequestsEjemplo Persona físicaEjemplo Persona física MonotributoEjemplo Persona jurídica
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Responses200
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
Responses200
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
Responses200409
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 - AFIP
GET/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:
  • natural_person (FISICA)
  • legal_person (JURIDICA)
tax_identification_type String Tipo de clave - documento.
Posibles valores:
  • CUIT
  • CUIL
  • CDI
status String Estado
Posibles valores:
  • ACTIVO
  • INACTIVO
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.
Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.
URI Parameters
HideShow
tax_identification_number
string (required) 

cuit de la persona física o jurídica.


Información de la persona - ReNaPer

GET https://apistore.pcnt.io/v1/information/person-renaper/identification/gender/gender
RequestsEjemplo con un cuit
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Responses200409
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 - ReNaPer
GET/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:
  • F
  • M
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.
Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.
URI Parameters
HideShow
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

GET https://apistore.pcnt.io/v1/blacklists/terrorist?tax_identification_number=tax_identification_number&person_type=&name=name&threshold=threshold&limit=limit
Requestsexample 1
Headers
Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJBREFSL2pvZWxwY250QG1haWxpbmF0b3IuY29tIiwib3MiOiJVTktOT1dOIiwib3JnIjoiQURBUiIsImNyZWF0ZWQiOjE2NDM4MzQyNDE3MzEsImJybyI6IlVOS05PV04ifQ.dk4JkEe0c5Ed7NbweA7tHfgSADO4av8_v0cFnmBzj_8IUA094eZ8GgPBVaKwngmmpU6avX98yQepShgaK9p20A
Responses200409
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 terrorismo
GET/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:
  • natural_person
  • legal_person
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.
Todos los errores devuelven HTTP 409. En el anexo de errores se detalla el formato de los mismos.
URI Parameters
HideShow
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
LCLIBRETA CIVICA
LELIBRETA DE ENROLAMIENTO
CICEDULA DE IDENTIDAD
TRAMEN TRAMITE
ACTAACTA DE NACIMIENTO
PASPASAPORTE
DNIDOC.NACIONAL DE IDENTIDAD
INDETINDETERMINADO
CERTCERTIFICADO DE MIGRACIÓN
DIEXTDOCUMENTO IDENTIDAD EXTRANJERO
DNI M D.N.I. (N° MÚLTIPLE)
INDOCANSES INDOCUMENTADO

Generated by aglio on 22 Jan 2024