Skip to main content

Servicio de Validación de Información (SVI) – Manual de la API

Introducción

Este manual explica cómo generar credenciales y consumir la API de SVI. Incluye ejemplos reales de respuesta.

Obtención de authkey y credenciales del proyecto

Sigue estos pasos en la interfaz web:

Inicia sesión con rol Administrador.

menu_admin_proyectos.png

Ve a Administrador › Proyectos.

lista_proyectos.png

Haz clic en Crear Proyecto.

mensaje_exito.png

Introduce el nombre y pulsa Guardar.

form_crear_proyecto.png

Copia authkey, usuario y contraseña mostrados.

Añade estos encabezados en cada llamada protegida:

  • authkey: <TU_AUTHKEY>
  • Authorization: Bearer <TU_TOKEN>

Endpoints

Login

  • Método: POST

  • URL: http://192.168.0.97:8081/api/v1/oauth/login

  • Autenticación: No

Encabezados

Header Valor
authkey <TU_AUTHKEY>

Form-data

Campo Valor ejemplo Tipo
username SVI text
password *** text

Respuesta ejemplo

{
    "token": "Pln_Kk7khiw2JOqD3eNd6aqR335hPRK6",
    "expiry": "2025-06-24 01:02:49"
}

Ejemplo cURL

curl -X POST "http://192.168.0.97:8081/api/v1/oauth/login" \
  -H "authkey: <TU_AUTHKEY>" \
  -F "username=SVI" \
  -F "password=***"

Generar Firma Usuario Ejemplo Empresa

  • Método: POST

  • URL: http://192.168.0.97:8081/api/v1/validar

  • Autenticación: Sí

Encabezados

Header Valor
authkey <TU_AUTHKEY>
Authorization Bearer <TU_TOKEN>

Cuerpo JSON

{
  "authkey": "QfRlRqJZqIQouNXu41HSFHkgrlMWZnM8", 
  "thirdPart": {
    "tipoDocumento":"NIT",
    "numeroDocumento":"830037946",
    "primerNombre":"PANAMERICANA LIBRERIA Y PAPELERIA SA",
    "segundoNombre":"",
    "primerApellido":"",
    "segundoApellido":"",
    "idUser":0
  },
  "user": {
    "idUser":0,
    "netUser":"danny.rios",
    "email":"danny.rios@ica.gov.co",
    "primerNombre":"Danny",
    "segundoNombre":"",
    "primerApellido":"Rios",
    "segundoApellido":"Tolosa"
  }
}

Respuesta ejemplo

{
    "datosValidos": true
}

Ejemplo cURL

curl -X POST "http://192.168.0.97:8081/api/v1/validar" \
  -H "authkey: <TU_AUTHKEY>" \
  -H "Authorization: Bearer <TU_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "authkey": "QfRlRqJZqIQouNXu41HSFHkgrlMWZnM8", 
  "thirdPart": {
    "tipoDocumento":"NIT",
    "numeroDocumento":"830037946",
    "primerNombre":"PANAMERICANA LIBRERIA Y PAPELERIA SA",
    "segundoNombre":"",
    "primerApellido":"",
    "segundoApellido":"",
    "idUser":0
  },
  "user": {
    "idUser":0,
    "netUser":"danny.rios",
    "email":"danny.rios@ica.gov.co",
    "primerNombre":"Danny",
    "segundoNombre":"",
    "primerApellido":"Rios",
    "segundoApellido":"Tolosa"
  }
}'

Generar Firma Usuario Ejemplo Persona Natural

  • Método: POST

  • URL: http://192.168.0.97:8081/api/v1/validar

  • Autenticación: Sí

Encabezados

Header Valor
authkey <TU_AUTHKEY>

| Authorization | Bearer <TU_TOKEN> |

Cuerpo JSON

{
  "authkey": "QfRlRqJZqIQouNXu41HSFHkgrlMWZnM8",
  "thirdPart": {
    "tipoDocumento":"CC",
    "numeroDocumento":"80181157",
    "primerNombre": "DANNY",
    "segundoNombre": "",
    "primerApellido": "RIOS",
    "segundoApellido": "TOLOSA",
    "idUser":0
  },
  "user": {
    "idUser":0,
    "netUser":"danny.rios",
    "email":"danny.rios@ica.gov.co",
    "primerNombre":"Danny",
    "segundoNombre":"",
    "primerApellido":"Rios",
    "segundoApellido":"Tolosa"
  }
}

Respuesta ejemplo

{
    "datosValidos": true
}

Ejemplo cURL

curl -X POST "http://192.168.0.97:8081/api/v1/validar" \
  -H "authkey: <TU_AUTHKEY>" \
  -H "Authorization: Bearer <TU_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "authkey": "QfRlRqJZqIQouNXu41HSFHkgrlMWZnM8",
  "thirdPart": {
    "tipoDocumento":"CC",
    "numeroDocumento":"80181157",
    "primerNombre": "DANNY",
    "segundoNombre": "",
    "primerApellido": "RIOS",
    "segundoApellido": "TOLOSA",
    "idUser":0
  },
  "user": {
    "idUser":0,
    "netUser":"danny.rios",
    "email":"danny.rios@ica.gov.co",
    "primerNombre":"Danny",
    "segundoNombre":"",
    "primerApellido":"Rios",
    "segundoApellido":"Tolosa"
  }
}'

Consultar informacion DIAN

  • Método: POST

  • URL: http://192.168.0.97:8081/api/v1/dian/consultar

  • Autenticación: Sí

Encabezados

Header Valor
authkey <TU_AUTHKEY>

| Authorization | Bearer <TU_TOKEN> |

Cuerpo JSON

{
  "thirdPart": {
    "tipoDocumento":"CC",
    "numeroDocumento":"52392716",
    "primerNombre":"X",
    "segundoNombre":"",
    "primerApellido":"",
    "segundoApellido":"",
    "idUser":0
  },
  "user": {
    "idUser":0,
    "netUser":"danny.rios",
    "email":"danny.rios@ica.gov.co",
    "primerNombre":"PANAMERICANA LIBRERIA Y PAPELERIA SA",
    "segundoNombre":"",
    "primerApellido":"",
    "segundoApellido":""
    
  }
}

Respuesta ejemplo

{
    "data": {
        "concepto": "Actualización",
        "numero_de_formulario": "14943616832",
        "numero_de_identificaciun_tributaria": "700134433",
        "dv": "0",
        "direccion_seccional": "Impuestos y Aduanas de Palmira",
        "buzon_electronico": "46,9007,1461;48,9006,1460;",
        "tipo_de_contribuyente": "Persona natural o sucesión ilíquida",
        "tipo_de_documento": "Cédula de Ciudadanía",
        "numero_de_identificacion": "1113682578",
        "fecha_expedicion": "20141020",
        "lugar_de_expedicion_pais": "COLOMBIA",
        "lugar_de_expedicion_departamento": "Valle del Cauca",
        "lugar_de_expedicion_ciudad_municipio": "Palmira",
        "primer_apellido": "ACOSTA",
        "segundo_apellido": "LOZANO",
        "primer_nombre": "KAREN",
        "otros_nombres": "NICOLE",
        "razon_social": "",
        "nombre_comercial": "",
        "sigla": "",
        "pais": "COLOMBIA",
        "departamento": "Valle del Cauca",
        "ciudad_municipio": "Palmira",
        "direccion_principal": "CL 43 B     13  104",
        "correo_electronico": "karennicoleacosta96@gmail.com",
        "codigo_postal": "",
        "telefono_1": "3163575981",
        "telefono_2": "",
        "actividad_principal_codigo": "Actividades de espectáculos musicales en vivo",
        "actividad_principal_fecha_inicio_actividad": "20140708",
        "actividad_secundaria_codigo": "Actividades teatrales",
        "actividad_secundaria_fecha_inicio_actividad": "20140708",
        "otras_actividades": [
            "Otras actividades profesionales, científicas y técnicas n.c.p."
        ],
        "ocupacion": "",
        "numero_establecimientos": "",
        "responsabilidades_calidades_atributos": [
            "05- Impto. renta y compl.  régimen  ordinario",
            "49 - No responsable de IVA"
        ],
        "obligados_aduaneros": [],
        "exportadores_forma": "",
        "exportadores_tipo": "",
        "exportadores_modo": [],
        "exportadores_cpc": []
    },
    "status": true
}

Ejemplo cURL

curl -X POST "http://192.168.0.97:8081/api/v1/dian/consultar" \
  -H "authkey: <TU_AUTHKEY>" \
  -H "Authorization: Bearer <TU_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "thirdPart": {
    "tipoDocumento":"CC",
    "numeroDocumento":"52392716",
    "primerNombre":"X",
    "segundoNombre":"",
    "primerApellido":"",
    "segundoApellido":"",
    "idUser":0
  },
  "user": {
    "idUser":0,
    "netUser":"danny.rios",
    "email":"danny.rios@ica.gov.co",
    "primerNombre":"PANAMERICANA LIBRERIA Y PAPELERIA SA",
    "segundoNombre":"",
    "primerApellido":"",
    "segundoApellido":""
    
  }
}'
Back to top