(DIAN - Persona natural) Extracción de declaraciónes de renta e impuestos (Formato 210) - Colombia
Lets integrate (DIAN - Persona natural) Extracción de declaraciónes de renta e impuestos (Formato 210) - Colombia in your system. First, get your Apitude API key, then send a POST request to Apitude... And that's it!.
That POST request should return the following
{
"message": "Request processed successfully",
"url": "/api/v1.0/requests/dian-personal-tax-files-co/e0606c19-a32d-410f-b2eb-d57a665677bc/",
"request_id": "e0606c19-a32d-410f-b2eb-d57a665677bc"
}
This response will contains a unique request ID that you should poll using a GET as follows
How does the response looks like?
{
"result": {
"data": {
"records": [
{
"otros": {
"code": 93,
"value": 0.0,
"section": "descuentos"
},
"deudas": {
"code": 29,
"value": 4424000.0,
"section": "patrimonio"
},
"sanciones": {
"code": 104,
"value": 0.0,
"section": "liquidacion_privada"
},
"donaciones": {
"code": 92,
"value": 0.0,
"section": "descuentos"
},
"renta_presuntiva": {
"code": 68,
"value": 0.0,
"section": "renta_presuntiva"
},
"rentas_gravables": {
"code": 66,
"value": 0.0,
"section": "cedula_general"
},
"tax_records_year": 2019,
"dian_signature_date": "2020-09-22 11:54:38",
"total_saldo_a_favor": {
"code": 106,
"value": 0.0,
"section": "liquidacion_privada"
},
"total_saldo_a_pagar": {
"code": 105,
"value": 0.0,
"section": "liquidacion_privada"
},
"general_y_de_pensiones": {
"code": 85,
"value": 46540000.0,
"section": "impuesto_sobre_las_rentas_liquidas_gravables"
},
"impuesto_neto_de_renta": {
"code": 95,
"value": 46540000.0,
"section": "liquidacion_privada"
},
"total_impuesto_a_cargo": {
"code": 98,
"value": 46540000.0,
"section": "liquidacion_privada"
},
"total_patrimonio_bruto": {
"code": 28,
"value": 340051000.0,
"section": "patrimonio"
},
"renta_liquida_de_capital": {
"code": 48,
"value": 9977000.0,
"section": "rentas_de_capital"
},
"renta_liquida_de_trabajo": {
"code": 37,
"value": 189728000.0,
"section": "rentas_de_trabajo"
},
"renta_liquida_no_laboral": {
"code": 60,
"value": 0.0,
"section": "rentas_no_laborales"
},
"total_patrimonio_liquido": {
"code": 30,
"value": 335627000.0,
"section": "patrimonio"
},
"saldo_a_pagar_por_impuesto": {
"code": 103,
"value": 0.0,
"section": "liquidacion_privada"
},
"costos_y_gastos_procedentes": {
"code": 52,
"value": 0.0,
"section": "rentas_no_laborales"
},
"rentas_exentas_de_pensiones": {
"code": 72,
"value": 0.0,
"section": "cedula_de_pensiones"
},
"renta_liquida_cedula_general": {
"code": 61,
"value": 319848000.0,
"section": "cedula_general"
},
"total_descuentos_tributarios": {
"code": 94,
"value": 0.0,
"section": "descuentos"
},
"ganancias_ocasionales_gravables": {
"code": 84,
"value": 0.0,
"section": "ganancias_ocasionales"
},
"renta_liquida_rentas_de_capital": {
"code": 41,
"value": 9977000.0,
"section": "rentas_de_capital"
},
"renta_liquida_rentas_de_trabajo": {
"code": 34,
"value": 309871000.0,
"section": "rentas_de_trabajo"
},
"renta_presuntiva_y_de_pensiones": {
"code": 86,
"value": 0.0,
"section": "impuesto_sobre_las_rentas_liquidas_gravables"
},
"rentas_exentas_de_la_casilla_79": {
"code": 80,
"value": 0.0,
"section": "cedula_de_dividendos_y_participaciones"
},
"costos_por_ganancias_ocasionales": {
"code": 82,
"value": 0.0,
"section": "ganancias_ocasionales"
},
"costos_y_deducciones_procedentes": {
"code": 40,
"value": 898000.0,
"section": "rentas_de_capital"
},
"impuestos_pagados_en_el_exterior": {
"code": 91,
"value": 0.0,
"section": "descuentos"
},
"devoluciones_rebajas_y_descuentos": {
"code": 50,
"value": 0.0,
"section": "rentas_no_laborales"
},
"impuesto_de_ganancias_ocasionales": {
"code": 96,
"value": 0.0,
"section": "liquidacion_privada"
},
"renta_liquida_cedula_de_pensiones": {
"code": 71,
"value": 0.0,
"section": "cedula_de_pensiones"
},
"renta_liquida_rentas_no_laborales": {
"code": 53,
"value": 0.0,
"section": "rentas_no_laborales"
},
"ingresos_no_constitutivos_de_renta": {
"code": 51,
"value": 0.0,
"section": "rentas_no_laborales"
},
"rentas_liquidas_pasivas_de_capital": {
"code": 42,
"value": 0.0,
"section": "rentas_de_capital"
},
"ingresos_brutos_rentas_no_laborales": {
"code": 49,
"value": 0.0,
"section": "rentas_no_laborales"
},
"rentas_liquidas_pasivas_no_laborales": {
"code": 54,
"value": 0.0,
"section": "rentas_no_laborales"
},
"retenciones_anio_gravable_a_declarar": {
"code": 101,
"value": 46062000.0,
"section": "liquidacion_privada"
},
"ingresos_brutos_por_rentas_de_capital": {
"code": 38,
"value": 10875000.0,
"section": "rentas_de_capital"
},
"ingresos_brutos_por_rentas_de_trabajo": {
"code": 31,
"value": 327116000.0,
"section": "rentas_de_trabajo"
},
"renta_liquida_gravable_cedula_general": {
"code": 67,
"value": 199705000.0,
"section": "cedula_general"
},
"renta_liquida_ordinaria_cedula_general": {
"code": 63,
"value": 199705000.0,
"section": "cedula_general"
},
"rentas_exentas_y_deducciones_imputables": {
"code": 36,
"value": 120143000.0,
"section": "rentas_de_trabajo"
},
"por_dividendos_y_participaciones_anio_2016": {
"code": 87,
"value": 0.0,
"section": "impuesto_sobre_las_rentas_liquidas_gravables"
},
"renta_liquida_gravable_cedula_de_pensiones": {
"code": 73,
"value": 0.0,
"section": "cedula_de_pensiones"
},
"ganancias_ocasionales_no_gravadas_y_exentas": {
"code": 83,
"value": 0.0,
"section": "ganancias_ocasionales"
},
"compensaciones_por_exceso_de_renta_presuntiva": {
"code": 65,
"value": 0.0,
"section": "cedula_general"
},
"compensaciones_por_perdidas_rentas_de_capital": {
"code": 47,
"value": 0.0,
"section": "rentas_de_capital"
},
"anticipo_renta_para_el_anio_gravable_siguiente": {
"code": 102,
"value": 7631000.0,
"section": "liquidacion_privada"
},
"renta_liquida_ordinaria_anio_2016_y_anteriores": {
"code": 76,
"value": 0.0,
"section": "cedula_de_dividendos_y_participaciones"
},
"anticipo_renta_liquidado_anio_gravable_anterior": {
"code": 99,
"value": 8109000.0,
"section": "liquidacion_privada"
},
"compensaciones_por_perdidas_rentas_no_laborales": {
"code": 59,
"value": 0.0,
"section": "rentas_no_laborales"
},
"perdida_liquida_del_ejercicio_rentas_de_capital": {
"code": 46,
"value": 0.0,
"section": "rentas_de_capital"
},
"perdida_liquida_del_ejercicio_rentas_no_laborales": {
"code": 58,
"value": 0.0,
"section": "rentas_no_laborales"
},
"rentas_exentas_y_deducciones_imputables_limitadas": {
"code": 62,
"value": 120143000.0,
"section": "cedula_general"
},
"subcedula_anio_2017_y_siguientes_numeral_3_art_49": {
"code": 77,
"value": 0.0,
"section": "cedula_de_dividendos_y_participaciones"
},
"subcedula_anio_2017_y_siguientes_parrafo_2_art_49": {
"code": 78,
"value": 0.0,
"section": "cedula_de_dividendos_y_participaciones"
},
"total_impuesto_sobre_las_rentas_liquidas_gravables": {
"code": 90,
"value": 46540000.0,
"section": "impuesto_sobre_las_rentas_liquidas_gravables"
},
"ingresos_no_constitutivos_de_renta_rentas_de_capital": {
"code": 39,
"value": 0.0,
"section": "rentas_de_capital"
},
"ingresos_no_constitutivos_de_renta_rentas_de_trabajo": {
"code": 32,
"value": 17245000.0,
"section": "rentas_de_trabajo"
},
"dividendos_y_participaciones_2016_y_anteriores_y_otros": {
"code": 74,
"value": 0.0,
"section": "cedula_de_dividendos_y_participaciones"
},
"ingresos_no_constitutivos_de_renta_cedula_de_pensiones": {
"code": 70,
"value": 0.0,
"section": "cedula_de_pensiones"
},
"renta_liquida_ordinaria_del_ejercicio_rentas_de_capital": {
"code": 45,
"value": 9977000.0,
"section": "rentas_de_capital"
},
"renta_liquida_ordinaria_del_ejercicio_rentas_no_laborales": {
"code": 57,
"value": 0.0,
"section": "rentas_no_laborales"
},
"rentas_exentas_y_deducciones_imputables_rentas_de_capital": {
"code": 44,
"value": 0.0,
"section": "rentas_de_capital"
},
"renta_liquida_pasiva_dividendos_y_o_recibidos_del_exterior": {
"code": 79,
"value": 0.0,
"section": "cedula_de_dividendos_y_participaciones"
},
"compensaciones_por_perdidas_anio_gravable_2016_y_anteriores": {
"code": 64,
"value": 0.0,
"section": "cedula_general"
},
"rentas_exentas_y_deducciones_imputables_rentas_no_laborales": {
"code": 56,
"value": 0.0,
"section": "rentas_no_laborales"
},
"costos_y_deducciones_procedentes_trabajadores_independientes": {
"code": 33,
"value": 0.0,
"section": "rentas_de_trabajo"
},
"ingresos_por_ganancias_ocasionales_en_el_pais_y_del_exterior": {
"code": 81,
"value": 0.0,
"section": "ganancias_ocasionales"
},
"ingresos_brutos_por_rentas_de_pensiones_del_pais_y_del_exterior": {
"code": 69,
"value": 0.0,
"section": "cedula_de_pensiones"
},
"rentas_exentas_y_deducciones_imputables_a_las_rentas_de_capital": {
"code": 43,
"value": 0.0,
"section": "rentas_de_capital"
},
"rentas_exentas_y_deducciones_imputables_a_las_rentas_de_trabajo": {
"code": 35,
"value": 120143000.0,
"section": "rentas_de_trabajo"
},
"rentas_exentas_y_deducciones_imputables_a_las_rentas_no_laborales": {
"code": 55,
"value": 0.0,
"section": "rentas_no_laborales"
},
"por_dividendos_y_participaciones_anio_2017_y_siguientes_1a_subcedula": {
"code": 88,
"value": 0.0,
"section": "impuesto_sobre_las_rentas_liquidas_gravables"
},
"descuento_por_impuestos_pagados_en_el_exterior_por_ganancias_ocasionales": {
"code": 97,
"value": 0.0,
"section": "liquidacion_privada"
},
"ingresos_no_constitutivos_de_renta_cedula_de_dividendos_y_participaciones": {
"code": 75,
"value": 0.0,
"section": "cedula_de_dividendos_y_participaciones"
},
"por_dividendos_y_participaciones_anio_2017_y_siguientes_2a_subcedula_y_otros": {
"code": 89,
"value": 0.0,
"section": "impuesto_sobre_las_rentas_liquidas_gravables"
},
"saldo_a_favor_del_anio_gravable_anterior_sin_solicitud_de_devolucion_y_o_compensacion": {
"code": 100,
"value": 0.0,
"section": "liquidacion_privada"
}
}
]
},
"error": "",
"end_at": "2023-01-07 05:23:01.110942",
"status": 200,
"message": "successful",
"queried_by": "testUser",
"service_name": "dian-personal-tax-files-co"
}
}
Ok, but what does each field in that JSON means?
The general parts:
message:The message is an Apitude generatedstringwith an informational text about the request.result:The result is contains the main part of the request.result.error:The error is astringgenerated by apitude for the request if everything worked it will be blank.result.message:The message is astringwith two optionssuccessfulorunsuccessfuldepending of how your request finished.result.queried_by:The queried_by field is astringthat lets you know what user started the request.result.end_at:The end_at field is astring formatted datethat lets you know at what time the request ended in Apitude.result.service_name:The service_name field is astringthat echos the service called. For this service it will always bedian-personal-tax-files-co.result.status:The status field is aintegerthat represents whether the service returned data from the input sent in the request. It could be one of the following values:200: The service returned response data for the payload that was sent in the creation of the request.404: The service did not returned data for the payload that was sent in the creation of the request.400: The service did not started because your input was invalid.500: Apitude tried to execute your request, however the service Apitude uses to execute your request was down. Please wait some time and try again, Apitude will not charged you for requests with this code.
Depending on the service, you want it to return different codes. For example, if you are checking the user against a security list to whitelist the user you should look for a
404, because a200would mean the user is in fact in the list. Other cases however, like creating objects in the name of a user you want the code to be200, since it will imply the creation was a success.
The data in the response:
Pasos del proceso
- Se recibe el pdf de la Declaración de Renta en cualquiera de los formatos por parte del Cliente.
- El cliente debe haber solicitado este documento a su cliente que debe cumplir las siguientes especificaciones:
- Documento en formato 210, 110 o 260 descargado directamente de la plataforma Muisca del cliente
- No se aceptan documentos escaneados o fotos de documentos.
- El Cliente carga documento de Declaración de Renta en el API de Apitude
- La API de Apitude valida que el documento cargado sea original y no esté adulterado en ninguna de las partes. Si el documento cumple con los requisitos de originalidad, continúa el proceso. De lo contrario, el proceso termina allí.
- La API extrae todos los valores de cada uno de los campos de la Declaracién de Renta y retorna en un JSON cada uno de los nombres y los valores de cada campo a el Cliente.
About this service
Este servicio permite procesar por medio de API el PDF (Formato 210) de una declaración de renta del sistema de la DIAN en Colombia (Muisca) y obtener todos los datos que en este se encuentran almacenados, al mismo tiempo que valida la autenticidad del PDF contra la DIAN. El proceso es 100% automático y seguro, no hay intervención humana. Si se envia el campo (Opcional) de email en la solicitud del API, los resultados seran entragados tanto en la respuesta REST como via archivo CSV al email enviado.
Who can you query using this service?:
This service (dian-personal-tax-files-co) is available for you to query individuals only.
Get API Access
Services