¿Preguntas?

Más información en nuestro Centro de Ayuda.

Centro de Ayuda
Contacto

Envíanos un mail con tu duda o sugerencia.

Contacto

API DIAN

Todas las requests deben incluir el API Key, ya sea usando el header X-API-Key o el parametro api_key en la url.

Para todos los ejemplos utilizaremos los mismos datos de prueba:

  • Usuario personal - Document: 10000000 - Password: sandbox_password

  • Usuario empresa - NIT: 900000000 - Document: 20000000 - Password: sandbox_password


Login

Endpoint: POST /login/

Parámetros Descripción
nit

Numero de nit, sin guiones (Solo requerido para empresas).

document

Identificador del usuario

password

Contraseña de acceso.

Respuesta:

Status Descripción
status
  • wrong_credentials usuario o password inválidos.

  • missing_credentials falta un campo de credenciales.

  • logged_in sesión iniciada correctamente.

  • interaction_required se requiere algún tipo de inicio de sesión interactiva, podría ser un captcha o una pregunta de seguridad.

session_key

Clave de autenticación que deberá ser usada en todas las requests siguientes (no estará presente si el status es un error).

message

Mensaje obtenido en caso de que las credenciales sean erróneas.

missing_fields

Campos faltantes para la consulta (no estará presente ante un inicio de sesión exitoso).

El login puede demorar hasta 20s en generar una respuesta dependiendo de la carga que tenga la página de la Hacienda.

Login

POST /login/ HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

nit=900000000&document=20000000&password=sandbox_password

Respuesta:

{
    "status" : "logged_in",
    "session_key" : "4d16be85-554e-4d26-a74d-cd1a3c0f93b8"
}

Respuesta errónea:

{
    "status" : "wrong_credentials",
    "message" : ":40035: Se presento un error al autenticar el usuario. El nombre de usuario, la clave o la organizacion son err?neos  "
}

Respuesta errónea por falta de parámetros:

{
    "status" : "missing_credentials",
    "missing_fields" : [
        "password"
    ]
}

Respuesta errónea por falta de API KEY:

{
    "data": null,
    "error": "Missing API key"
}
curl -X POST "https://fiscal.sandbox.prometeoapi.com/login/" -d "nit=900000000&document=20000000&password=sandbox_password" -H "X-API-Key: <API KEY>"

Respuesta:

{
    "status" : "logged_in",
    "session_key" : "4d16be85-554e-4d26-a74d-cd1a3c0f93b8"
}

Respuesta errónea:

{
    "status" : "wrong_credentials",
    "message" : ":40035: Se presento un error al autenticar el usuario. El nombre de usuario, la clave o la organizacion son err?neos  "
}

Respuesta errónea por falta de parámetros:

{
    "status" : "missing_credentials",
    "missing_fields" : [
        "password"
    ]
}

Respuesta errónea por falta de API KEY:

{
    "data": null,
    "error": "Missing API key"
}
import requests

requests.post('https://fiscal.sandbox.prometeoapi.com/login/', data={
    'nit': '900000000',
    'document': '20000000',
    'password': 'sandbox_password',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
    "status" : "logged_in",
    "session_key" : "4d16be85-554e-4d26-a74d-cd1a3c0f93b8"
}

Respuesta errónea:

{
    "status" : "wrong_credentials",
    "message" : ":40035: Se presento un error al autenticar el usuario. El nombre de usuario, la clave o la organizacion son err?neos  "
}

Respuesta errónea por falta de parámetros:

{
    "status" : "missing_credentials",
    "missing_fields" : [
        "password"
    ]
}

Respuesta errónea por falta de API KEY:

{
    "data": null,
    "error": "Missing API key"
}
var request = require('request');

request.post({
  "url": "https://fiscal.sandbox.prometeoapi.com/login/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "nit": "900000000",
    "document": "20000000",
    "password": "sandbox_password"
  }
});

Respuesta:

{
    "status" : "logged_in",
    "session_key" : "4d16be85-554e-4d26-a74d-cd1a3c0f93b8"
}

Respuesta errónea:

{
    "status" : "wrong_credentials",
    "message" : ":40035: Se presento un error al autenticar el usuario. El nombre de usuario, la clave o la organizacion son err?neos  "
}

Respuesta errónea por falta de parámetros:

{
    "status" : "missing_credentials",
    "missing_fields" : [
        "password"
    ]
}

Respuesta errónea por falta de API KEY:

{
    "data": null,
    "error": "Missing API key"
}

Información de la empresa

Endpoint: GET /company-info/

Parámetros Descripción
session_key

Clave de autenticación que deberá ser usada en todas las requests siguientes.

Respuesta:

Status Descripción
status
  • success la informacion ha sido accedida correctamente.

  • error la sesión o la key es inválida.

acccountant

Información sobre el contador.

capital_composition

Composición la empresa (campos 82 a 87).

reason

Razón Social (campo 35).

pdf_url

URI para extraer el PDF original.

location

Datos de como ubicar a la empresa (campos 38 a 45).

name

Nombre de la empresa (campo 36).

constitution_date

Fecha de constitución (campo 73).

representation
  • document número de identificación (campo 101)

  • document_type código numérico del tipo de documento (campo 100)

  • name nombre del representante (campo 104 a 107)

  • representation_type código numérico del tipo de representación (campo 98)

  • start_date fecha de inicio del ejercicio de representación

members
  • document número de identificación (campo 112)

  • document_type código numérico del tipo de identificación (campo 111)

  • name nombre del miembro (campos 115 a 118)

  • nationality nacionalidad (campo 114)

  • start_date fecha de ingreso (campo 122)

Información de la empresa

GET /company-info/ HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75

Respuesta:

{
    "status" : "success",
    "info" : {
    "accountant" : {
        "document" : "123456",
        "start_date" : "01/05/2017",
        "name" : "ARMANDO BARREDA",
        "professional_card" : "42972Z"
    },
    "capital_composition" : {
        "foreign_private" : "0%",
        "foreign_public" : "0%",
        "national" : "100%",
        "national_private" : "100%",
        "foreign" : "0%",
        "national_public" : "0%"
    },
    "reason" : "Qualia Fintech SRL",
    "pdf_url" : "/pdf/9a001f5239673420c3f5335a96cfef4f.pdf",
    "location" : {
        "country" : "Uruguay",
        "city" : "Montevideo",
        "phone1" : "099030345",
        "phone2" : "0303456",
        "department" : "Montevideo",
        "address" : "Calle falsa 12345",
        "email" : "info@qualia.uy"
    },
    "name" : "Qualia Fintech SRL",
    "constitution_date" : "15/08/2016",
    "representation" : [
        {
                "document": "1015399852",
                "document_type": "13",
                "name": {
                    "first_name": "Paquita",
                    "first_surname": "Navajas",
                    "other_names": "",
                    "second_surname": ""
                },
                "representation_type": "18",
                "start_date": "10/04/2014"
            }
    ],
    "members": [
            {
                "document": "479380",
                "document_type": "13",
                "name": {
                    "first_name": "John",
                    "first_surname": "Doe",
                    "other_names": "",
                    "second_surname": ""
                },
                "nationality": "COLOMBIA",
                "start_date": "10/04/2014"
            },
            {
                "document": "16226853",
                "document_type": "13",
                "name": {
                    "first_name": "Jane",
                    "first_surname": "Doe",
                    "other_names": "",
                    "second_surname": ""
                },
                "nationality": "COLOMBIA",
                "start_date": "10/04/2014"
            }
        ]
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
curl -X GET "https://fiscal.sandbox.prometeoapi.com/company-info/" -d "session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75" -H "X-API-Key: <API KEY>"

Respuesta:

{
    "status" : "success",
    "info" : {
    "accountant" : {
        "document" : "123456",
        "start_date" : "01/05/2017",
        "name" : "ARMANDO BARREDA",
        "professional_card" : "42972Z"
    },
    "capital_composition" : {
        "foreign_private" : "0%",
        "foreign_public" : "0%",
        "national" : "100%",
        "national_private" : "100%",
        "foreign" : "0%",
        "national_public" : "0%"
    },
    "reason" : "Qualia Fintech SRL",
    "pdf_url" : "/pdf/9a001f5239673420c3f5335a96cfef4f.pdf",
    "location" : {
        "country" : "Uruguay",
        "city" : "Montevideo",
        "phone1" : "099030345",
        "phone2" : "0303456",
        "department" : "Montevideo",
        "address" : "Calle falsa 12345",
        "email" : "info@qualia.uy"
    },
    "name" : "Qualia Fintech SRL",
    "constitution_date" : "15/08/2016",
    "representation" : [
        {
                "document": "1015399852",
                "document_type": "13",
                "name": {
                    "first_name": "Paquita",
                    "first_surname": "Navajas",
                    "other_names": "",
                    "second_surname": ""
                },
                "representation_type": "18",
                "start_date": "10/04/2014"
            }
    ],
    "members": [
            {
                "document": "479380",
                "document_type": "13",
                "name": {
                    "first_name": "John",
                    "first_surname": "Doe",
                    "other_names": "",
                    "second_surname": ""
                },
                "nationality": "COLOMBIA",
                "start_date": "10/04/2014"
            },
            {
                "document": "16226853",
                "document_type": "13",
                "name": {
                    "first_name": "Jane",
                    "first_surname": "Doe",
                    "other_names": "",
                    "second_surname": ""
                },
                "nationality": "COLOMBIA",
                "start_date": "10/04/2014"
            }
        ]
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
import requests

requests.get('https://fiscal.sandbox.prometeoapi.com/company-info/', data={
    'session_key': 'ce11f66e-ed28-4a4c-acc7-bb28bb899c75',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
    "status" : "success",
    "info" : {
    "accountant" : {
        "document" : "123456",
        "start_date" : "01/05/2017",
        "name" : "ARMANDO BARREDA",
        "professional_card" : "42972Z"
    },
    "capital_composition" : {
        "foreign_private" : "0%",
        "foreign_public" : "0%",
        "national" : "100%",
        "national_private" : "100%",
        "foreign" : "0%",
        "national_public" : "0%"
    },
    "reason" : "Qualia Fintech SRL",
    "pdf_url" : "/pdf/9a001f5239673420c3f5335a96cfef4f.pdf",
    "location" : {
        "country" : "Uruguay",
        "city" : "Montevideo",
        "phone1" : "099030345",
        "phone2" : "0303456",
        "department" : "Montevideo",
        "address" : "Calle falsa 12345",
        "email" : "info@qualia.uy"
    },
    "name" : "Qualia Fintech SRL",
    "constitution_date" : "15/08/2016",
    "representation" : [
        {
                "document": "1015399852",
                "document_type": "13",
                "name": {
                    "first_name": "Paquita",
                    "first_surname": "Navajas",
                    "other_names": "",
                    "second_surname": ""
                },
                "representation_type": "18",
                "start_date": "10/04/2014"
            }
    ],
    "members": [
            {
                "document": "479380",
                "document_type": "13",
                "name": {
                    "first_name": "John",
                    "first_surname": "Doe",
                    "other_names": "",
                    "second_surname": ""
                },
                "nationality": "COLOMBIA",
                "start_date": "10/04/2014"
            },
            {
                "document": "16226853",
                "document_type": "13",
                "name": {
                    "first_name": "Jane",
                    "first_surname": "Doe",
                    "other_names": "",
                    "second_surname": ""
                },
                "nationality": "COLOMBIA",
                "start_date": "10/04/2014"
            }
        ]
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
var request = require('request');

request.get({
  "url": "https://fiscal.sandbox.prometeoapi.com/company-info/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "session_key": "ce11f66e-ed28-4a4c-acc7-bb28bb899c75"
  }
});

Respuesta:

{
    "status" : "success",
    "info" : {
    "accountant" : {
        "document" : "123456",
        "start_date" : "01/05/2017",
        "name" : "ARMANDO BARREDA",
        "professional_card" : "42972Z"
    },
    "capital_composition" : {
        "foreign_private" : "0%",
        "foreign_public" : "0%",
        "national" : "100%",
        "national_private" : "100%",
        "foreign" : "0%",
        "national_public" : "0%"
    },
    "reason" : "Qualia Fintech SRL",
    "pdf_url" : "/pdf/9a001f5239673420c3f5335a96cfef4f.pdf",
    "location" : {
        "country" : "Uruguay",
        "city" : "Montevideo",
        "phone1" : "099030345",
        "phone2" : "0303456",
        "department" : "Montevideo",
        "address" : "Calle falsa 12345",
        "email" : "info@qualia.uy"
    },
    "name" : "Qualia Fintech SRL",
    "constitution_date" : "15/08/2016",
    "representation" : [
        {
                "document": "1015399852",
                "document_type": "13",
                "name": {
                    "first_name": "Paquita",
                    "first_surname": "Navajas",
                    "other_names": "",
                    "second_surname": ""
                },
                "representation_type": "18",
                "start_date": "10/04/2014"
            }
    ],
    "members": [
            {
                "document": "479380",
                "document_type": "13",
                "name": {
                    "first_name": "John",
                    "first_surname": "Doe",
                    "other_names": "",
                    "second_surname": ""
                },
                "nationality": "COLOMBIA",
                "start_date": "10/04/2014"
            },
            {
                "document": "16226853",
                "document_type": "13",
                "name": {
                    "first_name": "Jane",
                    "first_surname": "Doe",
                    "other_names": "",
                    "second_surname": ""
                },
                "nationality": "COLOMBIA",
                "start_date": "10/04/2014"
            }
        ]
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}

Listar Balances

Endpoint: GET /balances/

Parámetros Descripción
session_key

Clave de autenticación que deberá ser usada en todas las requests siguientes.

Respuesta:

Status Descripción
status
  • success la informacion ha sido accedida correctamente.

  • error la sesión o la key es inválida.

balances

Los balances de la empresa.

Corresponde al detalle de las obligaciones al día o en mora de la entidad.

Listar Balances

GET /balances/ HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75

Respuesta:

{
    "status" : "success",
    "balances" : [
        {
            "value" : 0,
            "amount" : 26,
            "type" : "al dia"
        },
        {
            "value" : 47280000,
            "amount" : 3,
            "type" : "saldo a favor"
        }
    ]
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
curl -X GET "https://fiscal.sandbox.prometeoapi.com/balances/" -d "session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75" -H "X-API-Key: <API KEY>"

Respuesta:

{
    "status" : "success",
    "balances" : [
        {
            "value" : 0,
            "amount" : 26,
            "type" : "al dia"
        },
        {
            "value" : 47280000,
            "amount" : 3,
            "type" : "saldo a favor"
        }
    ]
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
import requests

requests.get('https://fiscal.sandbox.prometeoapi.com/balances/', data={
    'session_key': 'ce11f66e-ed28-4a4c-acc7-bb28bb899c75',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
    "status" : "success",
    "balances" : [
        {
            "value" : 0,
            "amount" : 26,
            "type" : "al dia"
        },
        {
            "value" : 47280000,
            "amount" : 3,
            "type" : "saldo a favor"
        }
    ]
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
var request = require('request');

request.get({
  "url": "https://fiscal.sandbox.prometeoapi.com/balances/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "session_key": "ce11f66e-ed28-4a4c-acc7-bb28bb899c75"
  }
});

Respuesta:

{
    "status" : "success",
    "balances" : [
        {
            "value" : 0,
            "amount" : 26,
            "type" : "al dia"
        },
        {
            "value" : 47280000,
            "amount" : 3,
            "type" : "saldo a favor"
        }
    ]
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}

Renta

Endpoint: GET /rent/

Parámetros Descripción
session_key

Clave de autenticación que deberá ser usada en todas las requests siguientes.

year

Año.

Respuesta:

Status Descripción
status
  • success la informacion ha sido accedida correctamente.

  • error la sesión o la key es inválida.

declaration

Contiene los datos del formulario 110.

Renta

GET /rent/ HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&year=2016

Respuesta:

{
    "status" : "success",
    "declaration" : {
        "previous_form" : "",
        "pdf_url" : "/pdf/6368901ff39e2a5ec239823343c575923.pdf",
        "reason" : "Qualia Fintech SRL",
        "correction_code" : "",
        "year" : 2016,
        "form_number" : "1112600018226",
        "fields" : {
            "80" : {
                "name" : "Anticipo renta por el a?o gravable 2017",
                "number" : "80",
                "value" : 0
            },
            "79" : {
                "name" : "Total retenciones a?o gravable",
                "number" : "79",
                "value" : 0
            },
            "50" : {
                "name" : "Otros costos",
                "value" : 0,
                "number" : "50"
            },
            "88" : {
                "value" : 0,
                "number" : "88",
                "name" : "o Total saldo a favor"
            },
            "31" : {
                "name" : "Aportes al sistema de seguridad social",
                "number" : "31",
                "value" : 2278000
            },
            "85" : {
                "value" : 0,
                "number" : "85",
                "name" : "Saldo a pagar por impuesto"
            }
        },
        "name" : {
            "first_surname" : "",
            "first_name" : "",
            "second_surname" : "",
            "other_names" : ""
        },
        "economic_activity" : "2499",
        "nit" : "333222251",
        "dv" : "0",
        "direction_code" : "1 3"
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
curl -X GET "https://fiscal.sandbox.prometeoapi.com/rent/" -d "session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&year=2016" -H "X-API-Key: <API KEY>"

Respuesta:

{
    "status" : "success",
    "declaration" : {
        "previous_form" : "",
        "pdf_url" : "/pdf/6368901ff39e2a5ec239823343c575923.pdf",
        "reason" : "Qualia Fintech SRL",
        "correction_code" : "",
        "year" : 2016,
        "form_number" : "1112600018226",
        "fields" : {
            "80" : {
                "name" : "Anticipo renta por el a?o gravable 2017",
                "number" : "80",
                "value" : 0
            },
            "79" : {
                "name" : "Total retenciones a?o gravable",
                "number" : "79",
                "value" : 0
            },
            "50" : {
                "name" : "Otros costos",
                "value" : 0,
                "number" : "50"
            },
            "88" : {
                "value" : 0,
                "number" : "88",
                "name" : "o Total saldo a favor"
            },
            "31" : {
                "name" : "Aportes al sistema de seguridad social",
                "number" : "31",
                "value" : 2278000
            },
            "85" : {
                "value" : 0,
                "number" : "85",
                "name" : "Saldo a pagar por impuesto"
            }
        },
        "name" : {
            "first_surname" : "",
            "first_name" : "",
            "second_surname" : "",
            "other_names" : ""
        },
        "economic_activity" : "2499",
        "nit" : "333222251",
        "dv" : "0",
        "direction_code" : "1 3"
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
import requests

requests.get('https://fiscal.sandbox.prometeoapi.com/rent/', data={
    'session_key': 'ce11f66e-ed28-4a4c-acc7-bb28bb899c75',
    'year': '2016',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
    "status" : "success",
    "declaration" : {
        "previous_form" : "",
        "pdf_url" : "/pdf/6368901ff39e2a5ec239823343c575923.pdf",
        "reason" : "Qualia Fintech SRL",
        "correction_code" : "",
        "year" : 2016,
        "form_number" : "1112600018226",
        "fields" : {
            "80" : {
                "name" : "Anticipo renta por el a?o gravable 2017",
                "number" : "80",
                "value" : 0
            },
            "79" : {
                "name" : "Total retenciones a?o gravable",
                "number" : "79",
                "value" : 0
            },
            "50" : {
                "name" : "Otros costos",
                "value" : 0,
                "number" : "50"
            },
            "88" : {
                "value" : 0,
                "number" : "88",
                "name" : "o Total saldo a favor"
            },
            "31" : {
                "name" : "Aportes al sistema de seguridad social",
                "number" : "31",
                "value" : 2278000
            },
            "85" : {
                "value" : 0,
                "number" : "85",
                "name" : "Saldo a pagar por impuesto"
            }
        },
        "name" : {
            "first_surname" : "",
            "first_name" : "",
            "second_surname" : "",
            "other_names" : ""
        },
        "economic_activity" : "2499",
        "nit" : "333222251",
        "dv" : "0",
        "direction_code" : "1 3"
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
var request = require('request');

request.get({
  "url": "https://fiscal.sandbox.prometeoapi.com/rent/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "session_key": "ce11f66e-ed28-4a4c-acc7-bb28bb899c75",
    "year": "2016"
  }
});

Respuesta:

{
    "status" : "success",
    "declaration" : {
        "previous_form" : "",
        "pdf_url" : "/pdf/6368901ff39e2a5ec239823343c575923.pdf",
        "reason" : "Qualia Fintech SRL",
        "correction_code" : "",
        "year" : 2016,
        "form_number" : "1112600018226",
        "fields" : {
            "80" : {
                "name" : "Anticipo renta por el a?o gravable 2017",
                "number" : "80",
                "value" : 0
            },
            "79" : {
                "name" : "Total retenciones a?o gravable",
                "number" : "79",
                "value" : 0
            },
            "50" : {
                "name" : "Otros costos",
                "value" : 0,
                "number" : "50"
            },
            "88" : {
                "value" : 0,
                "number" : "88",
                "name" : "o Total saldo a favor"
            },
            "31" : {
                "name" : "Aportes al sistema de seguridad social",
                "number" : "31",
                "value" : 2278000
            },
            "85" : {
                "value" : 0,
                "number" : "85",
                "name" : "Saldo a pagar por impuesto"
            }
        },
        "name" : {
            "first_surname" : "",
            "first_name" : "",
            "second_surname" : "",
            "other_names" : ""
        },
        "economic_activity" : "2499",
        "nit" : "333222251",
        "dv" : "0",
        "direction_code" : "1 3"
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}

VAT

Endpoint: GET /vat/

Parámetros Descripción
session_key

Clave de autenticación que deberá ser usada en todas las requests siguientes.

year

Año.

periodicity
  • q cuatrimestral.

  • b bimestral.

period
  • Cuatrimestral:
    • 1: Enero - Abril

    • 2: Mayo - Agosto

    • 3: Septiembre - Diciembre

  • Bimestral:
    • 1: Enero - Febrero

    • 2: Marzo - Abril

    • 3: Mayo - Junio

    • 4: Julio - Agosto

    • 5: Septiembre - Octubre

    • 6: Noviembre - Diciembre

Respuesta:

Status Descripción
status
  • success la informacion ha sido accedida correctamente.

  • error la sesión o la key es inválida.

VAT

GET /vat/ HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&year=2017&periodicity=q&period=2

Respuesta:

{
    "status" : "success",
    "declaration" : {
        "pdf_url" : "/pdf/8ff21e603a523l0a98c9cc8b0e9b3db1.pdf",
        "previous_form" : "",
        "form_number" : "3013623041391",
        "year" : "2017",
        "correction_code" : "",
        "direction_code" : "1 1",
        "dv" : "0",
        "reason" : "Qualia Fintech SRL",
        "nit" : "123332211",
        "fields" : {
            "56" : {
                "name" : "Total compras netas realizadas durante el",
                "value" : 21530000,
                "number" : "56"
            },
            "83" : {
                "value" : 0,
                "number" : "83",
                "name" : "Retenciones por IVA que le practicaron"
            },
            "32" : {
                "name" : "iPntoer rvneanctiaosn aal sociedades de comercializaci?n",
                "value" : 0,
                "number" : "32"
            },
            "31" : {
                "name" : "Por exportaci?n de servicios",
                "number" : "31",
                "value" : 0
            },
            "66" : {
                "number" : "66",
                "value" : 0,
                "name" : "Por importaciones gravadas a tarifa del 5%"
            },
            "88" : {
                "name" : "Saldo a favor susceptible de devoluci?n y/ocompensaci?n por el presente per?odo",
                "value" : 0,
                "number" : "88"
            }
        }
    },
    "period" : "3",
    "name" : {
        "other_names" : "",
        "first_surname" : "",
        "second_surname" : "",
        "first_name" : ""
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
curl -X GET "https://fiscal.sandbox.prometeoapi.com/vat/" -d "session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&year=2017&periodicity=q&period=2" -H "X-API-Key: <API KEY>"

Respuesta:

{
    "status" : "success",
    "declaration" : {
        "pdf_url" : "/pdf/8ff21e603a523l0a98c9cc8b0e9b3db1.pdf",
        "previous_form" : "",
        "form_number" : "3013623041391",
        "year" : "2017",
        "correction_code" : "",
        "direction_code" : "1 1",
        "dv" : "0",
        "reason" : "Qualia Fintech SRL",
        "nit" : "123332211",
        "fields" : {
            "56" : {
                "name" : "Total compras netas realizadas durante el",
                "value" : 21530000,
                "number" : "56"
            },
            "83" : {
                "value" : 0,
                "number" : "83",
                "name" : "Retenciones por IVA que le practicaron"
            },
            "32" : {
                "name" : "iPntoer rvneanctiaosn aal sociedades de comercializaci?n",
                "value" : 0,
                "number" : "32"
            },
            "31" : {
                "name" : "Por exportaci?n de servicios",
                "number" : "31",
                "value" : 0
            },
            "66" : {
                "number" : "66",
                "value" : 0,
                "name" : "Por importaciones gravadas a tarifa del 5%"
            },
            "88" : {
                "name" : "Saldo a favor susceptible de devoluci?n y/ocompensaci?n por el presente per?odo",
                "value" : 0,
                "number" : "88"
            }
        }
    },
    "period" : "3",
    "name" : {
        "other_names" : "",
        "first_surname" : "",
        "second_surname" : "",
        "first_name" : ""
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
import requests

requests.get('https://fiscal.sandbox.prometeoapi.com/vat/', data={
    'session_key': 'ce11f66e-ed28-4a4c-acc7-bb28bb899c75',
    'year': '2017',
    'periodicity': 'q',
    'period': '2',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
    "status" : "success",
    "declaration" : {
        "pdf_url" : "/pdf/8ff21e603a523l0a98c9cc8b0e9b3db1.pdf",
        "previous_form" : "",
        "form_number" : "3013623041391",
        "year" : "2017",
        "correction_code" : "",
        "direction_code" : "1 1",
        "dv" : "0",
        "reason" : "Qualia Fintech SRL",
        "nit" : "123332211",
        "fields" : {
            "56" : {
                "name" : "Total compras netas realizadas durante el",
                "value" : 21530000,
                "number" : "56"
            },
            "83" : {
                "value" : 0,
                "number" : "83",
                "name" : "Retenciones por IVA que le practicaron"
            },
            "32" : {
                "name" : "iPntoer rvneanctiaosn aal sociedades de comercializaci?n",
                "value" : 0,
                "number" : "32"
            },
            "31" : {
                "name" : "Por exportaci?n de servicios",
                "number" : "31",
                "value" : 0
            },
            "66" : {
                "number" : "66",
                "value" : 0,
                "name" : "Por importaciones gravadas a tarifa del 5%"
            },
            "88" : {
                "name" : "Saldo a favor susceptible de devoluci?n y/ocompensaci?n por el presente per?odo",
                "value" : 0,
                "number" : "88"
            }
        }
    },
    "period" : "3",
    "name" : {
        "other_names" : "",
        "first_surname" : "",
        "second_surname" : "",
        "first_name" : ""
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
var request = require('request');

request.get({
  "url": "https://fiscal.sandbox.prometeoapi.com/vat/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "session_key": "ce11f66e-ed28-4a4c-acc7-bb28bb899c75",
    "year": "2017",
    "periodicity": "q",
    "period": "2"
  }
});

Respuesta:

{
    "status" : "success",
    "declaration" : {
        "pdf_url" : "/pdf/8ff21e603a523l0a98c9cc8b0e9b3db1.pdf",
        "previous_form" : "",
        "form_number" : "3013623041391",
        "year" : "2017",
        "correction_code" : "",
        "direction_code" : "1 1",
        "dv" : "0",
        "reason" : "Qualia Fintech SRL",
        "nit" : "123332211",
        "fields" : {
            "56" : {
                "name" : "Total compras netas realizadas durante el",
                "value" : 21530000,
                "number" : "56"
            },
            "83" : {
                "value" : 0,
                "number" : "83",
                "name" : "Retenciones por IVA que le practicaron"
            },
            "32" : {
                "name" : "iPntoer rvneanctiaosn aal sociedades de comercializaci?n",
                "value" : 0,
                "number" : "32"
            },
            "31" : {
                "name" : "Por exportaci?n de servicios",
                "number" : "31",
                "value" : 0
            },
            "66" : {
                "number" : "66",
                "value" : 0,
                "name" : "Por importaciones gravadas a tarifa del 5%"
            },
            "88" : {
                "name" : "Saldo a favor susceptible de devoluci?n y/ocompensaci?n por el presente per?odo",
                "value" : 0,
                "number" : "88"
            }
        }
    },
    "period" : "3",
    "name" : {
        "other_names" : "",
        "first_surname" : "",
        "second_surname" : "",
        "first_name" : ""
    }
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}

Numeración

Endpoint: GET /numeration/

Parámetros Descripción
session_key

Clave de autenticación que deberá ser usada en todas las requests siguientes.

type
  • authorization autorización.

  • habilitation habilitación.

  • inhabilitation inhabilitación.

date_start

Fecha de inicio del rango (formato DD/MM/YYYY)

date_end

Fecha del fin del rango (formato DD/MM/YYYY)

Respuesta:

Status Descripción
status
  • success la informacion ha sido accedida correctamente.

  • error la sesión o la key es inválida.

Ésta opción permite consultar del NIT, las autorizaciones, habilitaciones e inhabilitaciones de facturación de rangos de facturación de la DIAN, en períodos de tiempo específicos.

Numeración

GET /numeration/ HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&type=authorization&date_start=01%2F01%2F2016&date_end=01%2F01%2F2017

Respuesta:

{
    "numeration": [
        {
            "address": "CR 12 A 65",
            "country": "Colombia",
            "department": "Antioquia",
            "dv": "0",
            "municipality": "Medellín",
            "name": {
                "first_name": "",
                "first_surname": "",
                "other_names": "",
                "second_surname": ""
            },
            "nit": "902202672",
            "pdf_url": "/pdf/25ebc593c917786864b9753cffa68b8f.pdf",
            "ranges": [
                {
                    "establishment": "Qualia SRL",
                    "from": 1,
                    "mode": "COMPUTADOR",
                    "prefix": "",
                    "to": 2000,
                    "type": "AUTORIZACIÓN"
                }
            ],
            "reason": "Qualia SRL"
        }
    ],
    "status": "success"
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
curl -X GET "https://fiscal.sandbox.prometeoapi.com/numeration/" -d "session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&type=authorization&date_start=01%2F01%2F2016&date_end=01%2F01%2F2017" -H "X-API-Key: <API KEY>"

Respuesta:

{
    "numeration": [
        {
            "address": "CR 12 A 65",
            "country": "Colombia",
            "department": "Antioquia",
            "dv": "0",
            "municipality": "Medellín",
            "name": {
                "first_name": "",
                "first_surname": "",
                "other_names": "",
                "second_surname": ""
            },
            "nit": "902202672",
            "pdf_url": "/pdf/25ebc593c917786864b9753cffa68b8f.pdf",
            "ranges": [
                {
                    "establishment": "Qualia SRL",
                    "from": 1,
                    "mode": "COMPUTADOR",
                    "prefix": "",
                    "to": 2000,
                    "type": "AUTORIZACIÓN"
                }
            ],
            "reason": "Qualia SRL"
        }
    ],
    "status": "success"
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
import requests

requests.get('https://fiscal.sandbox.prometeoapi.com/numeration/', data={
    'session_key': 'ce11f66e-ed28-4a4c-acc7-bb28bb899c75',
    'type': 'authorization',
    'date_start': '01/01/2016',
    'date_end': '01/01/2017',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
    "numeration": [
        {
            "address": "CR 12 A 65",
            "country": "Colombia",
            "department": "Antioquia",
            "dv": "0",
            "municipality": "Medellín",
            "name": {
                "first_name": "",
                "first_surname": "",
                "other_names": "",
                "second_surname": ""
            },
            "nit": "902202672",
            "pdf_url": "/pdf/25ebc593c917786864b9753cffa68b8f.pdf",
            "ranges": [
                {
                    "establishment": "Qualia SRL",
                    "from": 1,
                    "mode": "COMPUTADOR",
                    "prefix": "",
                    "to": 2000,
                    "type": "AUTORIZACIÓN"
                }
            ],
            "reason": "Qualia SRL"
        }
    ],
    "status": "success"
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
var request = require('request');

request.get({
  "url": "https://fiscal.sandbox.prometeoapi.com/numeration/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "session_key": "ce11f66e-ed28-4a4c-acc7-bb28bb899c75",
    "type": "authorization",
    "date_start": "01/01/2016",
    "date_end": "01/01/2017"
  }
});

Respuesta:

{
    "numeration": [
        {
            "address": "CR 12 A 65",
            "country": "Colombia",
            "department": "Antioquia",
            "dv": "0",
            "municipality": "Medellín",
            "name": {
                "first_name": "",
                "first_surname": "",
                "other_names": "",
                "second_surname": ""
            },
            "nit": "902202672",
            "pdf_url": "/pdf/25ebc593c917786864b9753cffa68b8f.pdf",
            "ranges": [
                {
                    "establishment": "Qualia SRL",
                    "from": 1,
                    "mode": "COMPUTADOR",
                    "prefix": "",
                    "to": 2000,
                    "type": "AUTORIZACIÓN"
                }
            ],
            "reason": "Qualia SRL"
        }
    ],
    "status": "success"
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}

Retenciones en la Fuente

Endpoint: GET /retentions/

Parámetros Descripción
session_key

Clave de autenticación que deberá ser usada en todas las requests siguientes.

year

Año.

period
  • 1: Enero - Enero

  • 2: Febrero - Febrero

  • 3: Marzo - Marzo

  • 4: Abril - Abril

  • 5: Mayo - Mayo

  • 6: Junio - Junio

  • 7: Julio - Julio

  • 8: Agosto - Agosto

  • 9: Septiembre - Septiembre

  • 10: Octubre - Octubre

  • 11: Noviembre - Noviembre

  • 12: Diciembre - Diciembre

Respuesta:

Status Descripción
status
  • success la informacion ha sido accedida correctamente.

  • error la sesión o la key es inválida.

Retenciones en la Fuente

GET /retentions/ HTTP/1.1
Host: fiscal.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&year=2017&period=1

Respuesta:

{
    "retentions": {
        "direction_code": "3 2",
        "fields": {
            "27": {
                "name": "Rentas de trabajo",
                "number": 27,
                "value": 15972000
            },
            "28": {
                "name": "Rentas de pensiones",
                "number": 28,
                "value": 0
            },
            "29": {
                "name": "Honorarios",
                "number": 29,
                "value": 4200000
            },
            "30": {
                "name": "Comisiones",
                "number": 30,
                "value": 0
            },
            "83": {
                "name": "Más: Sanciones",
                "number": 83,
                "value": 0
            },
            "84": {
                "name": "Total retenciones más sanciones",
                "number": 84,
                "value": 1668000
            }
        },
        "form_number": "3501661737131",
        "nit": "80172487",
        "pdf_url": "/pdf/f9ac62308e8595b1cd2a5756c1c8ce75.pdf",
        "period": 0,
        "reason": "Qualia Fintech SRL",
        "year": 2017
    },
    "status": "success"
}

No existe el documento en el periodo seleccionado:

{
    "message": "El sistema no ha encontrado documentos a su nombre o a nombre de la Organización que representa, correspondientes al año gravable, período y periodicidad diligenciados, regrese e intente nuevos parámetros de consulta.",
    "status": "error"
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
curl -X GET "https://fiscal.sandbox.prometeoapi.com/retentions/" -d "session_key=ce11f66e-ed28-4a4c-acc7-bb28bb899c75&year=2017&period=1" -H "X-API-Key: <API KEY>"

Respuesta:

{
    "retentions": {
        "direction_code": "3 2",
        "fields": {
            "27": {
                "name": "Rentas de trabajo",
                "number": 27,
                "value": 15972000
            },
            "28": {
                "name": "Rentas de pensiones",
                "number": 28,
                "value": 0
            },
            "29": {
                "name": "Honorarios",
                "number": 29,
                "value": 4200000
            },
            "30": {
                "name": "Comisiones",
                "number": 30,
                "value": 0
            },
            "83": {
                "name": "Más: Sanciones",
                "number": 83,
                "value": 0
            },
            "84": {
                "name": "Total retenciones más sanciones",
                "number": 84,
                "value": 1668000
            }
        },
        "form_number": "3501661737131",
        "nit": "80172487",
        "pdf_url": "/pdf/f9ac62308e8595b1cd2a5756c1c8ce75.pdf",
        "period": 0,
        "reason": "Qualia Fintech SRL",
        "year": 2017
    },
    "status": "success"
}

No existe el documento en el periodo seleccionado:

{
    "message": "El sistema no ha encontrado documentos a su nombre o a nombre de la Organización que representa, correspondientes al año gravable, período y periodicidad diligenciados, regrese e intente nuevos parámetros de consulta.",
    "status": "error"
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
import requests

requests.get('https://fiscal.sandbox.prometeoapi.com/retentions/', data={
    'session_key': 'ce11f66e-ed28-4a4c-acc7-bb28bb899c75',
    'year': '2017',
    'period': '1',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
    "retentions": {
        "direction_code": "3 2",
        "fields": {
            "27": {
                "name": "Rentas de trabajo",
                "number": 27,
                "value": 15972000
            },
            "28": {
                "name": "Rentas de pensiones",
                "number": 28,
                "value": 0
            },
            "29": {
                "name": "Honorarios",
                "number": 29,
                "value": 4200000
            },
            "30": {
                "name": "Comisiones",
                "number": 30,
                "value": 0
            },
            "83": {
                "name": "Más: Sanciones",
                "number": 83,
                "value": 0
            },
            "84": {
                "name": "Total retenciones más sanciones",
                "number": 84,
                "value": 1668000
            }
        },
        "form_number": "3501661737131",
        "nit": "80172487",
        "pdf_url": "/pdf/f9ac62308e8595b1cd2a5756c1c8ce75.pdf",
        "period": 0,
        "reason": "Qualia Fintech SRL",
        "year": 2017
    },
    "status": "success"
}

No existe el documento en el periodo seleccionado:

{
    "message": "El sistema no ha encontrado documentos a su nombre o a nombre de la Organización que representa, correspondientes al año gravable, período y periodicidad diligenciados, regrese e intente nuevos parámetros de consulta.",
    "status": "error"
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}
var request = require('request');

request.get({
  "url": "https://fiscal.sandbox.prometeoapi.com/retentions/",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "session_key": "ce11f66e-ed28-4a4c-acc7-bb28bb899c75",
    "year": "2017",
    "period": "1"
  }
});

Respuesta:

{
    "retentions": {
        "direction_code": "3 2",
        "fields": {
            "27": {
                "name": "Rentas de trabajo",
                "number": 27,
                "value": 15972000
            },
            "28": {
                "name": "Rentas de pensiones",
                "number": 28,
                "value": 0
            },
            "29": {
                "name": "Honorarios",
                "number": 29,
                "value": 4200000
            },
            "30": {
                "name": "Comisiones",
                "number": 30,
                "value": 0
            },
            "83": {
                "name": "Más: Sanciones",
                "number": 83,
                "value": 0
            },
            "84": {
                "name": "Total retenciones más sanciones",
                "number": 84,
                "value": 1668000
            }
        },
        "form_number": "3501661737131",
        "nit": "80172487",
        "pdf_url": "/pdf/f9ac62308e8595b1cd2a5756c1c8ce75.pdf",
        "period": 0,
        "reason": "Qualia Fintech SRL",
        "year": 2017
    },
    "status": "success"
}

No existe el documento en el periodo seleccionado:

{
    "message": "El sistema no ha encontrado documentos a su nombre o a nombre de la Organización que representa, correspondientes al año gravable, período y periodicidad diligenciados, regrese e intente nuevos parámetros de consulta.",
    "status": "error"
}

Respuesta errónea o session_key expirada:

{
    "message" : "Invalid session key",
    "status" : "error"
}

Especificación OpenAPI