(DIAN - Empresas) Extracción de declaraciónes de renta e impuestos de archivo PDF (Formato 210) - Colombia
Para integrar el servicio de (DIAN - Empresas) Extracción de declaraciónes de renta e impuestos de archivo PDF (Formato 210) - Colombia en su sistema. Primero, obtenga su API key de Apitude, luego envíe una solicitud POST a Aptitude ... ¡Y eso es todo!.
Esa solicitud POST debe devolver lo siguiente
{
"message": "Request processed successfully",
"url": "/api/v1.0/requests/dian-business-tax-files-co/e0606c19-a32d-410f-b2eb-d57a665677bc/",
"request_id": "e0606c19-a32d-410f-b2eb-d57a665677bc"
}
Esta respuesta contendrá un ID de solicitud único que debe utilizar enviando un GET de la siguiente manera
¿Cómo se ve la respuesta?
{
"result": {
"data": {
"records": [
{
"costos": {
"code": 63,
"value": 0.0,
"section": "esal"
},
"message": "ok",
"pasivos": {
"code": 42,
"value": 197630000.0,
"section": "patrimonio"
},
"inventarios": {
"code": 36,
"value": 0.0,
"section": "patrimonio"
},
"renta_exenta": {
"code": 78,
"value": 0.0,
"section": "ganancias_ocasionales"
},
"otros_activos": {
"code": 40,
"value": 0.0,
"section": "patrimonio"
},
"renta_liquida": {
"code": 76,
"value": 0.0,
"section": "ganancias_ocasionales"
},
"compensaciones": {
"code": 75,
"value": 0.0,
"section": "ganancias_ocasionales"
},
"otros_ingresos": {
"code": 52,
"value": 26213000.0,
"section": "ingresos"
},
"document_number": "908888881",
"autorretenciones": {
"code": 99,
"value": 0.0,
"section": "sobretasa_instituciones_financieras"
},
"renta_presuntiva": {
"code": 77,
"value": 0.0,
"section": "ganancias_ocasionales"
},
"rentas_gravables": {
"code": 79,
"value": 4053000.0,
"section": "impuesto_sobre_las_rentas_l\u00edquidas_gravables"
},
"tax_records_year": 2019,
"otras_retenciones": {
"code": 100,
"value": 3034000.0,
"section": "liquidacion_privada"
},
"activos_biologicos": {
"code": 38,
"value": 0.0,
"section": "patrimonio"
},
"gastos_financieros": {
"code": 66,
"value": 0.0,
"section": "renta"
},
"activos_intangibles": {
"code": 37,
"value": 0.0,
"section": "patrimonio"
},
"dian_signature_date": "2020-04-15 15:37:26",
"ingresos_financieros": {
"code": 45,
"value": 9052000.0,
"section": "ingresos"
},
"total_ingresos_netos": {
"code": 62,
"value": 173894000.0,
"section": "costos_y_deducciones"
},
"total_ingresos_brutos": {
"code": 53,
"value": 172786000.0,
"section": "ingresos"
},
"descuentos_tributarios": {
"code": 90,
"value": 0.0,
"section": "liquidacion_privada"
},
"impuesto_neto_de_renta": {
"code": 91,
"value": 0.0,
"section": "liquidacion_privada"
},
"renta_liquida_gravable": {
"code": 80,
"value": 0.0,
"section": "impuesto_sobre_las_rentas_l\u00edquidas_gravables"
},
"total_impuesto_a_cargo": {
"code": 94,
"value": 435000.0,
"section": "retenciones"
},
"total_patrimonio_bruto": {
"code": 41,
"value": 322153000.0,
"section": "patrimonio"
},
"gastos_de_administracion": {
"code": 64,
"value": 0.0,
"section": "esal"
},
"total_patrimonio_liquido": {
"code": 43,
"value": 124523000.0,
"section": "patrimonio"
},
"otros_gastos_y_deducciones": {
"code": 67,
"value": 0.0,
"section": "renta"
},
"perdida_liquida_del_ejercicio": {
"code": 74,
"value": 12283000.0,
"section": "renta"
},
"ganancias_ocasionales_gravables": {
"code": 84,
"value": 0.0,
"section": "liquidacion_privada"
},
"gastos_de_distribucion_y_ventas": {
"code": 65,
"value": 0.0,
"section": "renta"
},
"costos_por_ganancias_ocasionales": {
"code": 82,
"value": 0.0,
"section": "impuesto_sobre_las_rentas_l\u00edquidas_gravables"
},
"inversiones_efectuadas_en_el_ano": {
"code": 69,
"value": 0.0,
"section": "renta"
},
"total_costos_y_gastos_deducibles": {
"code": 68,
"value": 76872000.0,
"section": "renta"
},
"impuesto_de_ganancias_ocasionales": {
"code": 92,
"value": 0.0,
"section": "liquidacion_privada"
},
"ingresos_por_ganancias_ocasionales": {
"code": 81,
"value": 0.0,
"section": "impuesto_sobre_las_rentas_l\u00edquidas_gravables"
},
"efectivo_y_equivalentes_al_efectivo": {
"code": 33,
"value": 119175000.0,
"section": "patrimonio"
},
"sobretasa_instituciones_financieras": {
"code": 104,
"value": 0.0,
"section": "liquidacion_privada"
},
"renta_liquida_ordinaria_del_ejercicio": {
"code": 73,
"value": 0.0,
"section": "renta"
},
"renta_por_recuperacion_de_deducciones": {
"code": 71,
"value": 12283000.0,
"section": "renta"
},
"impuesto_sobre_la_renta_liquida_gravable": {
"code": 85,
"value": 4053000.0,
"section": "liquidacion_privada"
},
"ingresos_brutos_de_actividades_ordinarias": {
"code": 44,
"value": 137521000.0,
"section": "ingresos"
},
"total_retenciones_ano_gravable_a_declarar": {
"code": 101,
"value": 0.0,
"section": "liquidacion_privada"
},
"devoluciones_rebajas_y_descuentos_en_ventas": {
"code": 54,
"value": 75764000.0,
"section": "ingresos"
},
"ganancias_ocasionales_no_gravadas_y_exentas": {
"code": 83,
"value": 4053000.0,
"section": "liquidacion_privada"
},
"anticipo_renta_para_el_ano_gravable_siguiente": {
"code": 102,
"value": 3034000.0,
"section": "liquidacion_privada"
},
"anticipo_renta_liquidado_ano_gravable_anterior": {
"code": 97,
"value": 0.0,
"section": "sobretasa_instituciones_financieras"
},
"descuento_efectivo_inversion_obras_por_impuestos": {
"code": 96,
"value": 504000.0,
"section": "liquidacion_privada"
},
"inversiones_e_instrumentos_financieros_derivados": {
"code": 34,
"value": 0.0,
"section": "patrimonio"
},
"total_impuesto_sobre_las_rentas_liquidas_gravables": {
"code": 89,
"value": 0.0,
"section": "liquidacion_privada"
},
"renta_pasiva_-_ece_sin_residencia_fiscal_en_colombia": {
"code": 72,
"value": 0.0,
"section": "renta"
},
"dividendos_yo_participaciones_gravadas_al_75_porciento": {
"code": 50,
"value": 0.0,
"section": "ingresos"
},
"inversiones_liquidadas_de_periodos_gravables_anteriores": {
"code": 70,
"value": 0.0,
"section": "renta"
},
"dividendos_y_o_participaciones_gravadas_a_tarifa_general": {
"code": 51,
"value": 0.0,
"section": "ingresos"
},
"ingresos_no_constitutivos_de_renta_ni_ganancia_ocasional": {
"code": 61,
"value": 0.0,
"section": "costos_y_deducciones"
},
"cuentas_documentos_y_arrendamientos_financieros_por_cobrar": {
"code": 35,
"value": 202978000.0,
"section": "patrimonio"
},
"propiedades_planta_y_equipo_propiedades_de_inversion_y_ancmv": {
"code": 39,
"value": 0.0,
"section": "patrimonio"
},
"anticipo_sobretasa_instituciones_financieras_ano_gravable_anterior": {
"code": 103,
"value": 0.0,
"section": "liquidacion_privada"
},
"anticipo_sobretasa_instituciones_financieras_ano_gravable_siguiente": {
"code": 105,
"value": 0.0,
"section": "liquidacion_privada"
},
"descuento_por_impuestos_pagados_en_el_exterior_por_ganancias_ocasionales": {
"code": 93,
"value": 1088000.0,
"section": "retenciones"
},
"dividendos_y_o_participaciones_gravadas_recibidas_por_sociedades_extrangeras": {
"code": 48,
"value": 0.0,
"section": "ingresos"
},
"dividendos_y_o_participaciones_no_constitutivos_de_renta_ni_ganancia_ocasional": {
"code": 46,
"value": 0.0,
"section": "ingresos"
},
"impuesto_de_dividendos_yo_participaciones_gravadas_a_la_tarifa_del_33_porciento": {
"code": 88,
"value": 4053000.0,
"section": "liquidacion_privada"
},
"impuesto_de_dividendos_yo_participaciones_gravadas_a_la_tarifa_del_75_porciento": {
"code": 86,
"value": 0.0,
"section": "liquidacion_privada"
},
"impuesto_de_dividendos_yo_participaciones_gravadas_a_la_tarifa_del_articulo_240": {
"code": 87,
"value": 0.0,
"section": "liquidacion_privada"
},
"saldo_a_favor_ano_gravable_anterior_sin_solicitud_de_devolucion_yo_compensacion": {
"code": 98,
"value": 0.0,
"section": "sobretasa_instituciones_financieras"
},
"valor_inversion_obras_por_impuestos_hasta_del_50_porciento_del_valor_de_la_casilla_89": {
"code": 95,
"value": 1523000.0,
"section": "retenciones"
},
"dividendos_y_o_participaciones_recibidas_por_chc_de_una_entidad_no_residente_en_colombia": {
"code": 47,
"value": 0.0,
"section": "ingresos"
},
"dividendos_y_o_participaciones_gravadas_recibidas_por_personas_naturales_sin_residencia_fiscal": {
"code": 49,
"value": 0.0,
"section": "ingresos"
}
}
]
},
"error": "",
"end_at": "2021-03-14 19:13:02.001039",
"status": 200,
"message": "successful",
"queried_by": "testUser",
"service_name": "dian-business-tax-records-co"
},
"message": "Request completed"
}
Ok, pero ¿qué significa cada campo en ese JSON?
Las partes generales:
message:El mensaje es unstringgenerado por Aptitude con un texto informativo sobre la solicitud..result:El resultado contiene la parte principal de la solicitud..result.error:El error es unstringgenerado por Aptitude para la solicitud. Si todo funcionó, estará en blanco.result.message:El mensaje es unstringcon dos opcionessuccessfulounsuccessfuldependiendo de cómo terminó su solicitud.result.queried_by:El campo queried_by es unstringque indica que usuario creo la solicitud.result.end_at:El campo end_at es unstring formatted dateque indica en qué momento la solicitud terminó en Apitude.result.service_name:El campo service_name es unstringque retorna el servicio llamado. Para este servicio siempre serádian-business-tax-files-co.result.status:El campo estado, es unenterocuyo valor representa si el servicio retorno informacion para la solicitud enviada. Puede tomar alguno de los siguientes valores:200: El servicio devolvió datos con la respuesta para la información que se envió en la solicitud.404: El servicio no devolvió datos con la respuesta para la información que se envió en la solicitud.400: El servicio no se inició porque su entrada no era válida.500: Apitude intentó ejecutar tu solicitud, sin embargo, el servicio que utiliza Apitude para ejecutar su solicitud no funciona. Espera un poco y vuelve a intentarlo, Apitude no te cobrará solicitudes con este código.
Dependiendo del servicio, quieres que devuelva diferente códigos. Por ejemplo, si está pasando al usuario por un proceso de vinculación y desea que este quede en su lista blanca, debe buscar un
404, porque un200significaría que el usuario está de hecho en la lista. Otros casossin embargo, como crear objetos con el nombre de un usuario, desea que el código sea200, ya que implicará que la creación fue un éxito.
Los datos en la respuesta:
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 110 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.
Sobre este servicio
Este servicio permite procesar por medio de API el PDF (Formato 110) 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.
¿A quién puede consultar utilizando este servicio?:
Este servicio (dian-business-tax-files-co) está disponible para consultar unicamente empresas / negocios.
Get API Access
Servicios