# 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](https://bookstack.iguazoft.com/uploads/images/gallery/2025-06/scaled-1680-/menu-admin-proyectos.png)](https://bookstack.iguazoft.com/uploads/images/gallery/2025-06/menu-admin-proyectos.png)

Ve a **Administrador › Proyectos**.

[![lista_proyectos.png](https://bookstack.iguazoft.com/uploads/images/gallery/2025-06/scaled-1680-/lista-proyectos.png)](https://bookstack.iguazoft.com/uploads/images/gallery/2025-06/lista-proyectos.png)

Haz clic en **Crear Proyecto**.

[![mensaje_exito.png](https://bookstack.iguazoft.com/uploads/images/gallery/2025-06/scaled-1680-/mensaje-exito.png)](https://bookstack.iguazoft.com/uploads/images/gallery/2025-06/mensaje-exito.png)

Introduce el nombre y pulsa **Guardar**.

[![form_crear_proyecto.png](https://bookstack.iguazoft.com/uploads/images/gallery/2025-06/scaled-1680-/form-crear-proyecto.png)](https://bookstack.iguazoft.com/uploads/images/gallery/2025-06/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](#login)
- [Generar Firma Usuario Ejemplo Empresa](#generar-firma-usuario-ejemplo-empresa)
- [Generar Firma Usuario Ejemplo Persona Natural](#generar-firma-usuario-ejemplo-persona-natural)
- [Consultar informacion DIAN](#consultar-informacion-dian)

### Login

- **Método:** `POST`
- **URL:** `http://192.168.0.97:8081/api/v1/oauth/login`
- **Autenticación:** No

#### Encabezados

<table id="bkmrk-header-valor-authkey"><thead><tr><th>Header</th><th>Valor</th></tr></thead><tbody><tr><td>authkey</td><td>`<TU_AUTHKEY>`</td></tr></tbody></table>

#### Form-data

<table id="bkmrk-campo-valor-ejemplo-"><thead><tr><th>Campo</th><th>Valor ejemplo</th><th>Tipo</th></tr></thead><tbody><tr><td>username</td><td>SVI</td><td>text</td></tr><tr><td>password</td><td>\*\*\*</td><td>text</td></tr></tbody></table>

#### Respuesta ejemplo

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

```

#### Ejemplo cURL

```bash
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

<table id="bkmrk-header-valor-authkey-1"><thead><tr><th>Header</th><th>Valor</th></tr></thead><tbody><tr><td>authkey</td><td>`<TU_AUTHKEY>`</td></tr><tr><td>Authorization</td><td>`Bearer <TU_TOKEN>`</td></tr></tbody></table>

#### Cuerpo JSON

```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

```json
{
    "datosValidos": true
}

```

#### Ejemplo cURL

```bash
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

<table id="bkmrk-header-valor-authkey-2"><thead><tr><th>Header</th><th>Valor</th></tr></thead><tbody><tr><td>authkey</td><td>`<TU_AUTHKEY>`</td></tr></tbody></table>

| Authorization | `Bearer <TU_TOKEN>` |

#### Cuerpo JSON

```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

```json
{
    "datosValidos": true
}

```

#### Ejemplo cURL

```bash
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

<table id="bkmrk-header-valor-authkey-3"><thead><tr><th>Header</th><th>Valor</th></tr></thead><tbody><tr><td>authkey</td><td>`<TU_AUTHKEY>`</td></tr></tbody></table>

| Authorization | `Bearer <TU_TOKEN>` |

#### Cuerpo JSON

```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

```json
{
    "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

```bash
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":""
    
  }
}'

```