{"openapi":"3.1.0","info":{"title":"Tusdatos Empresas API","description":"\n# Documentación Técnica\n\nEsta API proporciona acceso a información empresarial colombiana a través de un sistema de facturación por consumo.\n\n## Acceso y Autenticación\n\nPara usar esta API necesitas:\n- **Activación manual**: Un empleado de Tusdatos debe activar tu acceso\n- **API Key**: Podrás generarla luego de la activación de tu acceso al API\n- **Balance prepagado**: Saldo en tu cuenta para cubrir el costo de las consultas\n\n## Modelo de Facturación\n\n### Principio de Cobro\n- **Facturación por uso**: Cada endpoint tiene un costo específico que se deduce de tu balance\n- **Solo consultas exitosas**: Únicamente se cobran las respuestas HTTP 200-299\n- **Consulta única**: Solo se factura la primera llamada con parámetros específicos\n\n### Sistema de Caché\n- **Duración**: 24 horas para todas las respuestas exitosas\n- **Beneficio**: Las consultas repetidas son gratuitas durante el período de caché\n- **Renovación**: El caché se actualiza automáticamente tras expirar\n\n### Reglas de Facturación\n- ✅ **Se cobra**: Primera consulta exitosa (HTTP 200-299)\n- ❌ **No se cobra**: Consultas desde caché\n- ❌ **No se cobra**: Respuestas con error (HTTP 400+)\n- ❌ **No se cobra**: Consultas repetidas dentro de 24 horas\n\n## Headers de Respuesta\n\nTodas las respuestas exitosas incluyen headers informativos sobre el estado del caché:\n- **`X-Cache: HIT`**: Respuesta desde caché (sin costo)\n- **`X-Cache: MISS`**: Respuesta en tiempo real (con costo)\n\n## Ejemplo de Flujo de Facturación\n\n```md\n1. Primera consulta\n   → GET /api/v1/re/informacion-basica?nit=123456789\n   → Respuesta: HTTP 200, X-Cache: MISS\n   → Costo: Se deduce del balance\n\n2. Consulta repetida (dentro de 24h)\n   → GET /api/v1/re/informacion-basica?nit=123456789\n   → Respuesta: HTTP 200, X-Cache: HIT\n   → Costo: $0 (gratuita)\n\n3. Consulta con error\n   → GET /api/v1/re/informacion-basica?nit=99999aaaa\n   → Respuesta: HTTP 422\n   → Costo: $0 (sin cargo por errores)\n```\n\n## Ambiente de Pruebas (Sandbox)\n\nEn el ambiente de pruebas puedes utilizar números de documento de ejemplo para obtener respuestas de prueba. Estos números de documento especiales:\n\n- Solo funcionan en el ambiente de pruebas (sandbox)\n- Retornan respuestas predefinidas para testing\n\n⚠️ **Advertencia**: Los números de documento de prueba solo deben usarse en el ambiente sandbox. Si se utilizan en producción, podrían generar cargos a tu balance o retornar errores.\n\n## Paginación\n\nNo se soporta paginación. Todos los resultados son retornados en una única respuesta.\n\n## Errores\n\nLa API de Tusdatos Empresas retorna códigos de estado coherentes con las convenciones HTTP estándar. Además del código de estado, los errores pueden incluir información adicional en el cuerpo de la respuesta:\n```\n{\n  \"message\": \"Información adicional\"\n}\n```\n\n## Soporte Técnico\n\nCuando necesites contactar a nuestro equipo de soporte, te pedimos que incluyas en tu mensaje el valor del header de respuesta **`X-Request-Id`**. Este identificador único aparece en cada respuesta de la API y nos permite:\n\n- Localizar rápidamente tu consulta específica en nuestros registros\n- Diagnosticar el problema de manera más eficiente\n- Brindarte una solución precisa y oportuna\n\n**¿Cómo encontrar el X-Response-ID?**\n\nRevisa los headers de respuesta de tu llamada a la API. Verás algo como:\n```\nX-Request-Id: 2552c7beb6184472bd46de55aec86bf0\n```\n\nCon esta información, podremos resolver tu consulta mucho más rápido. ¡Gracias por ayudarnos a ayudarte mejor!\n\n## MCP (Model Context Protocol)\n\n🚀 **¡También contamos con un servidor MCP!**\n\nAccede a nuestras capacidades de búsqueda empresarial a través del estándar MCP. Ideal para integrar nuestros servicios en tus herramientas y flujos de trabajo.\n\n```\nhttps://mcp.empresas.tusdatos.co/mcp\n```\n\n**Nota:**\n- Soporte único a Streamable HTTP. SSE no disponible.\n- Usa el mismo token (API Key) de tu acceso REST.\n- Un empleado de Tusdatos debe activar tu acceso a MCP.\n","termsOfService":"https://www.tusdatos.co/terminos-y-condiciones","contact":{"name":"Contacto","url":"https://empresas.tusdatos.co/","email":"info@tusdatos.co"},"version":"1.0"},"paths":{"/meta/precios":{"get":{"tags":["Meta"],"summary":"Precios de endpoints del workspace","description":"Este endpoint proporciona información sobre los precios de cada endpoint\ndisponible en la API para el workspace, permitiendo al usuario conocer el\nprecio antes de realizar las consultas.","operationId":"precios_resolver_meta_precios_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreciosEndpointsSchema"}}}},"404":{"description":"No se encontraron endpoints disponibles para este Workspace","content":{"application/json":{"examples":{"Endpoints no encontrados":{"value":{"message":"No se encontraron endpoints disponibles para este Workspace"}}}}}}},"security":[{"HTTPBearer":[]}]}},"/re/informacion-basica":{"get":{"tags":["Registro Empresarial (RE)"],"summary":"Información básica","description":"Este endpoint proporciona información básica sobre la entidad\nregistrada, incluyendo:\n\n- **Datos de Identificación**: Cámara de comercio, NIT, razón social,\nregistro mercantil, sigla y organización jurídica.\n- **Actividad Económica**: Códigos y descripciones de hasta 4\nactividades económicas principales.\n- **Estado y Ubicación**: Estado de la matrícula, fechas de matrícula,\nrenovación y cancelación, departamentos y municipios comerciales y fiscales.\n- **Caracterización**: Tipo de sociedad y registro único de proponentes.\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_basica_resolver_re_informacion_basica_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformacionBasicaSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/re/informacion-vital":{"get":{"tags":["Registro Empresarial (RE)"],"summary":"Información vital","description":"Este endpoint proporciona información vital sobre la entidad\nregistrada, incluyendo:\n\n- **Información Comercial**: Dirección, departamento, municipio,\ncódigo postal y zona comercial.\n- **Información Financiera**: Ingresos del último año, ingresos en SMLV\ny año financiero.\n- **Estado y Características**: Estado de liquidación, tamaño de la empresa\ny página web.\n- **Actividad Económica**: Fechas de inicio de actividades económicas\nprincipales.\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_vital_resolver_re_informacion_vital_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformacionVitalSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"403":{"description":"Información de contacto de persona natural restringida para este workspace. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Contacto restringido":{"value":{"message":"El acceso a la información de contacto de personas naturales está restringido para este workspace."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/re/informacion-contacto":{"get":{"tags":["Registro Empresarial (RE)"],"summary":"Información de contacto","description":"Este endpoint proporciona información de contacto de la entidad\nregistrada, incluyendo:\n\n- **Información Fiscal**: Dirección, departamento, municipio, código postal\ny zona fiscal.\n- **Teléfonos**: Hasta 3 números de teléfono comerciales y 3 fiscales.\n- **Correos Electrónicos**: Direcciones de correo comercial y fiscal.\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_contacto_resolver_re_informacion_contacto_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformacionContactoSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"403":{"description":"Información de contacto de persona natural restringida para este workspace. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Contacto restringido":{"value":{"message":"El acceso a la información de contacto de personas naturales está restringido para este workspace."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/re/informacion-representantes-legales":{"get":{"tags":["Registro Empresarial (RE)"],"summary":"Información de representantes legales","description":"Este endpoint proporciona información sobre los representantes legales\nde la entidad registrada, incluyendo:\n\n- **Nombre**: Nombre completo del representante legal.\n- **cargo**: Cargo o relación del representante con la entidad\n- **Número y tipo de Identificación**: Documento de identidad del representante.\n(Principal, Suplente, etc.).\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_representantes_legales_resolver_re_informacion_representantes_legales_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RepresentantesLegalesSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/re/informacion-detallada":{"get":{"tags":["Registro Empresarial (RE)"],"summary":"Información detallada","description":"Este endpoint proporciona información detallada sobre la entidad\nregistrada, incluyendo:\n\n- **Información Laboral**: Número de empleados y porcentaje de empleados temporales.\n- **Obligaciones Tributarias**: Indicadores de aportante a seguridad social,\nbeneficiario de leyes 1429 y 1780.\n- **Clasificaciones**: Grupo NIIF y clasificación como importador/exportador.\n- **Establecimientos**: Cantidad de establecimientos registrados.\n- **Actividades Reguladas**: Indicador de vendedor de juegos de suerte y azar.\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_detallada_resolver_re_informacion_detallada_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformacionDetalladaSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/re/informacion-financiera":{"get":{"tags":["Registro Empresarial (RE)"],"summary":"Información financiera","description":"Este endpoint proporciona información financiera sobre la entidad\nregistrada, incluyendo:\n\n- **Capital Social**: Composición del capital por origen (nacional/internacional)\ny naturaleza (público/privado).\n- **Estados Financieros**: Activos, pasivos, patrimonio, ingresos operacionales,\ncostos de ventas, gastos operacionales y resultado del periodo.\n- **Información de Capital**: Capital autorizado, pagado, suscrito y fechas\nde modificación del capital social.\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_financiera_resolver_re_informacion_financiera_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformacionFinancieraSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/re/informacion-proponente":{"get":{"tags":["Registro Empresarial (RE)"],"summary":"Información de proponente","description":"Este endpoint proporciona información financiera y de registro del\nproponente de la entidad registrada, incluyendo:\n\n- **Información Financiera**: Estados financieros con activos corrientes,\nfijos y totales, pasivos, patrimonio, utilidades y pérdidas operacionales.\n- **Indicadores Financieros**: Índices de endeudamiento, liquidez,\nrentabilidad del activo y patrimonio, razón de cobertura de intereses.\n- **Registro y Ubicación**: Cámara de registro único de proponentes,\ndirecciones comerciales y fiscales, municipios de operación.\n- **Estado y Fechas**: Estado del proponente, fechas de inscripción,\nrenovación y cancelación, tamaño de empresa y contacto telefónico.\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_proponentes_resolver_re_informacion_proponente_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformacionProponenteSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"403":{"description":"Información de contacto de persona natural restringida para este workspace. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Contacto restringido":{"value":{"message":"El acceso a la información de contacto de personas naturales está restringido para este workspace."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/re/informacion-establecimientos":{"get":{"tags":["Registro Empresarial (RE)"],"summary":"Información de establecimientos","description":"Este endpoint proporciona información detallada sobre los establecimientos\nde la entidad registrada, incluyendo:\n\n- **Identificación del Establecimiento**: Matrícula, razón social y fechas\nde matrícula, renovación y cancelación.\n- **Actividad Económica**: Códigos de hasta 4 actividades económicas\ndel establecimiento.\n- **Información Comercial**: Dirección comercial, correo electrónico\ny hasta 3 números telefónicos comerciales.\n- **Datos Operativos**: Número de empleados del establecimiento.\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_establecimientos_resolver_re_informacion_establecimientos_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformacionEstablecimientosSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"403":{"description":"Información de contacto de persona natural restringida para este workspace. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Contacto restringido":{"value":{"message":"El acceso a la información de contacto de personas naturales está restringido para este workspace."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/pila/informacion-aportantes":{"get":{"tags":["Planilla Integrada de Liquidación de Aportes (PILA)"],"summary":"Información de aportantes","description":"Este endpoint proporciona información detallada sobre los periodos de\ncotización del aportante en el sistema PILA, incluyendo:\n\n- **Datos del Periodo**: Periodo de cotización, razón social y actividad\neconómica con código y descripción.\n- **Representante Legal**: Tipo y número de documento, nombres completos\ndel representante legal.\n- **Clasificación**: Códigos y descripciones de clase, tipo de aportante\ny tipo de persona.\n- **Información Laboral**: Número de empleados, valor de nómina y\nvalores de aportes parafiscales (con y sin mora).\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- **CC**: 6361846\n- **CC**: 91494045\n- **CC**: 98532601\n- **NI**: 7166826\n- **NI**: 901310572","operationId":"informacion_aportantes_resolver_pila_informacion_aportantes_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"num_documento","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":15,"pattern":"^[A-Za-z0-9]+$","title":"Número de documento","description":"Número de identificación del aportante","examples":["6361846","91494045","98532601","7166826","901310572"]},"description":"Número de identificación del aportante"},{"name":"tipo_documento","in":"query","required":true,"schema":{"$ref":"#/components/schemas/TipoDocumentoEnum","title":"Tipo de documento del aportante","description":"Tipo de documento a consultar: \n- CC: Cédula de Ciudadanía\n- CD: Carné Diplomático\n- CE: Cedula de Extranjería\n- NI: NIT\n- PA: Pasaporte\n- PE: Permiso Especial\n- PT: Permiso por protección temporal en activos y pensionados\n- SC: Salvo conducto de permanencia\n- TI: Tarjeta de Identidad\n","examples":["CC","NI"]},"description":"Tipo de documento a consultar: \n- CC: Cédula de Ciudadanía\n- CD: Carné Diplomático\n- CE: Cedula de Extranjería\n- NI: NIT\n- PA: Pasaporte\n- PE: Permiso Especial\n- PT: Permiso por protección temporal en activos y pensionados\n- SC: Salvo conducto de permanencia\n- TI: Tarjeta de Identidad\n"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PILAAportantesTransformedSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/p/informacion-esencial":{"get":{"tags":["Personalizado"],"summary":"Información Esencial","description":"Este endpoint proporciona información esencial sobre la entidad\nregistrada, incluyendo:\n\n- **Información Básica**: NIT, razón social, actividad económica.\n- **Información de Registro**: Fechas de constitución, matrícula y renovación.\n- **Información de Tamaño**: Tamaño de la empresa y número de empleados.\n- **Información Financiera**: Indicadores financieros del último año disponible.\n- **Representantes Legales**: Nombre, cargo y documento de los representantes legales.\n\n---\n\n**Documentos de prueba:**\n\nPara realizar pruebas en el ambiente sandbox, puedes utilizar los siguientes\ndocumentos de ejemplo:\n\n- 000222222\n- 000666666\n- 000888888\n- 000999999","operationId":"informacion_esencial_resolver_p_informacion_esencial_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"nit","in":"query","required":true,"schema":{"type":"string","minLength":4,"maxLength":10,"pattern":"^[0-9]+$","title":"Número de Identificación Tributaria","description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos).","examples":["000222222","000666666","000888888","000999999"]},"description":"Número de identificación tributaria sin dígito de verificación (máximo 10 dígitos)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InformacionEsencialSchema"}}}},"402":{"description":"Balance insuficiente para completar la transacción.","content":{"application/json":{"examples":{"Balance insuficiente":{"value":{"message":"Balance insuficiente para completar la transacción."}}}}}},"404":{"description":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado.","content":{"application/json":{"examples":{"Empresa no encontrada":{"value":{"message":"No se encontró información disponible de la empresa buscada. Tu saldo no fue afectado."}}}}}},"500":{"description":"Error interno. Si persiste, por favor, contacta con soporte.","content":{"application/json":{"examples":{"Error interno":{"value":{"message":"Error interno. Si persiste, por favor, contacta con soporte."}}}}}},"503":{"description":"Hay indisponibilidad en la fuente, por favor, prueba en un momento.","content":{"application/json":{"examples":{"Fuente no disponible":{"value":{"message":"Hay indisponibilidad en la fuente, por favor, prueba en un momento."}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CapitalSchema":{"properties":{"capital_autorizado":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capital Autorizado","examples":["36540000000000.0"]},"capital_pagado":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capital Pagado","examples":["10279174614049.0"]},"capital_social":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capital Social","examples":[null]},"capital_suscrito":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capital Suscrito","examples":["10279174614049.0"]},"fecha_modificacion_capital":{"type":"string","title":"Fecha Modificacion Capital","examples":["2015"]},"entidad_sin_animo_lucro_patrimonio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entidad Sin Animo Lucro Patrimonio","examples":[null]}},"type":"object","required":["fecha_modificacion_capital"],"title":"CapitalSchema"},"CapitalSocialSchema":{"properties":{"internacional_privado":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Internacional Privado","examples":["0.0"]},"internacional_publico":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Internacional Publico","examples":["0.0"]},"nacional_privado":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nacional Privado","examples":["10.0"]},"nacional_publico":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nacional Publico","examples":["90.0"]}},"type":"object","title":"CapitalSocialSchema"},"ClaseAportanteEnum":{"type":"string","enum":["A","B","C","D","I"],"title":"ClaseAportanteEnum"},"EmptyStrToNone":{"type":"null"},"FinancieraSchema":{"properties":{"activo_corriente":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activo Corriente","examples":["17910101723812.0"]},"activo_total":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activo Total","examples":["100647980203629.0"]},"activos_no_corrientes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activos No Corrientes","examples":["100647980203629.0"]},"ano_informacion_financiera":{"type":"integer","title":"Ano Informacion Financiera","examples":[2013]},"balance_social":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Balance Social","examples":["0.0"]},"costo_ventas":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Costo Ventas","examples":["32494138610405.0"]},"gastos_operacionales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gastos Operacionales","examples":["2850404912072.0"]},"ingresos_actividad_ordinaria":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingresos Actividad Ordinaria","examples":[null]},"margen_bruto":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Margen Bruto","examples":["1.0"]},"margen_neto":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Margen Neto","examples":["0.14429727515388635"]},"margen_operacional":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Margen Operacional","examples":["0.048438545891106834"]},"otros_gastos":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otros Gastos","examples":["6855191612467.0"]},"otros_ingresos":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otros Ingresos","examples":[null]},"pasivo_corriente":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pasivo Corriente","examples":["19496680041990.0"]},"pasivo_total":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pasivo Total","examples":["35389468361790.0"]},"pasivos_no_corrientes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pasivos No Corrientes","examples":["65258511841839.0"]},"patrimonio_neto":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patrimonio Neto","examples":["65258511841839.0"]},"resultado_periodo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resultado Periodo","examples":["14972950298807.0"]},"retencion_de_capital_de_trabajo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retencion De Capital De Trabajo","examples":["14972950298807.0"]},"utilidad_bruta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utilidad Bruta","examples":["22856411163679.0"]},"utilidad_o_perdida_operacional":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utilidad O Perdida Operacional","examples":["22856411163679.0"]}},"type":"object","required":["ano_informacion_financiera"],"title":"FinancieraSchema"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InformacionBasicaSchema":{"properties":{"camara":{"type":"string","title":"Camara","examples":["BOGOTA"]},"codigo_actividad_economica_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 1","examples":["0610"]},"codigo_actividad_economica_2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 2","examples":["0620"]},"codigo_actividad_economica_3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 3","examples":[null]},"codigo_actividad_economica_4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 4","examples":[null]},"departamento_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Departamento Comercial","examples":["BOGOTA"]},"departamento_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Departamento Fiscal","examples":["BOGOTA"]},"descripcion_actividad_economica_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Actividad Economica 1","examples":["Extracción de petróleo crudo"]},"descripcion_actividad_economica_2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Actividad Economica 2","examples":["Extracción de gas natural"]},"descripcion_actividad_economica_3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Actividad Economica 3","examples":[null]},"descripcion_actividad_economica_4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Actividad Economica 4","examples":[null]},"estado_matricula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estado Matricula","examples":["ACTIVA"]},"fecha_cancelacion_matricula":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Cancelacion Matricula","examples":[null]},"fecha_matricula":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Matricula","examples":["2003-07-18"]},"fecha_renovacion":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Renovacion","examples":["2025-03-27"]},"motivo_cancelacion_matricula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Motivo Cancelacion Matricula","examples":[null]},"municipio_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Municipio Comercial","examples":["BOGOTA, D.C."]},"municipio_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Municipio Fiscal","examples":["BOGOTA, D.C."]},"nit":{"type":"string","title":"Nit","examples":["899999068"]},"organizacion_juridica":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organizacion Juridica","examples":["SOCIEDAD ANONIMA"]},"razon_social":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Razon Social","examples":["ECOPETROL S A"]},"registro_mercantil":{"type":"string","title":"Registro Mercantil","examples":["40001291197"]},"registro_unico_proponentes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registro Unico Proponentes","examples":[null]},"sigla":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sigla","examples":[null]},"tipo_sociedad":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tipo Sociedad","examples":["SOCIEDAD COMERCIAL"]}},"type":"object","required":["camara","nit","registro_mercantil"],"title":"InformacionBasicaSchema"},"InformacionContactoSchema":{"properties":{"codigo_postal_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Postal Fiscal","examples":[null]},"correo_electronico_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correo Electronico Comercial","examples":["notificacionesjudicialesecopetrol@ecopetrol.com.co"]},"correo_electronico_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correo Electronico Fiscal","examples":["notificacionesjudicialesecopetrol@ecopetrol.com.co"]},"departamento_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Departamento Fiscal","examples":["BOGOTA"]},"direccion_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direccion Fiscal","examples":["CRA . 13 N.36 - 24 PISO 12"]},"municipio_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Municipio Fiscal","examples":["BOGOTA, D.C."]},"telefono_comercial_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Comercial 1","examples":["2345000"]},"telefono_comercial_2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Comercial 2","examples":["2344112"]},"telefono_comercial_3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Comercial 3","examples":[null]},"telefono_fiscal_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Fiscal 1","examples":["2344112"]},"telefono_fiscal_2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Fiscal 2","examples":["2344741"]},"telefono_fiscal_3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Fiscal 3","examples":[null]},"zona_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zona Fiscal","examples":["URBANA"]}},"type":"object","title":"InformacionContactoSchema"},"InformacionDetalladaSchema":{"properties":{"indicador_aportante_seguridad_social":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Indicador Aportante Seguridad Social","examples":[false]},"indicador_beneficio_ley_1429":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Indicador Beneficio Ley 1429","examples":[false]},"indicador_beneficio_ley_1780":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Indicador Beneficio Ley 1780","examples":[false]},"cantidad_establecimientos":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cantidad Establecimientos","examples":[2]},"clasificacion_importador_exportador":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clasificacion Importador Exportador","examples":["7"]},"grupo_niif":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grupo Niif","examples":[null]},"numero_empleados":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numero Empleados","examples":["9665"]},"porcentaje_empleados_temporales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Porcentaje Empleados Temporales","examples":["7.00000"]},"indicador_vendedor_juegos_suerte_azar":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Indicador Vendedor Juegos Suerte Azar","examples":[false]},"presencia_en_lista_vinculante":{"type":"boolean","title":"Presencia En Lista Vinculante","default":false,"examples":[false]},"presencia_en_lista_restrictiva":{"type":"boolean","title":"Presencia En Lista Restrictiva","default":false,"examples":[false]}},"type":"object","title":"InformacionDetalladaSchema"},"InformacionEsencialSchema":{"properties":{"nit":{"type":"string","title":"Nit","examples":["899999068"]},"razon_social":{"type":"string","title":"Razon Social","examples":["ECOPETROL S A"]},"sector_actividad_economica_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector Actividad Economica 1","examples":["EXPLOTACIÓN DE MINAS Y CANTERAS"]},"codigo_actividad_economica_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 1","examples":["0610"]},"descripcion_actividad_economica_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Actividad Economica 1","examples":["Extracción de petróleo crudo"]},"fecha_constitucion":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Constitucion","examples":["2025-03-27"]},"fecha_renovacion":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Renovacion","examples":["2025-03-27"]},"tamano":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tamano","examples":["GRANDE"]},"fecha_matricula":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Matricula","examples":["2003-07-18"]},"numero_empleados":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numero Empleados","examples":["9342"]},"municipio_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Municipio Comercial"},"departamento_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Departamento Comercial"},"organizacion_juridica":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organizacion Juridica","examples":["SOCIEDAD ANONIMA"]},"camara":{"type":"string","title":"Camara","examples":["BOGOTA"]},"grupo_niif":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grupo Niif","examples":[null]},"estado_matricula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estado Matricula","examples":["ACTIVA"]},"informacion_financiera":{"anyOf":[{"$ref":"#/components/schemas/InformacionFinancieraEsencialSchema"},{"type":"null"}]},"representantes_legales":{"items":{"$ref":"#/components/schemas/RepresentanteLegalSchema"},"type":"array","title":"Representantes Legales"}},"type":"object","required":["nit","razon_social","camara"],"title":"InformacionEsencialSchema"},"InformacionEstablecimientoSchema":{"properties":{"codigo_actividad_economica_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 1","examples":["4719"]},"codigo_actividad_economica_2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 2","examples":[null]},"codigo_actividad_economica_3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 3","examples":[null]},"codigo_actividad_economica_4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Actividad Economica 4","examples":[null]},"correo_electronico_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correo Electronico Comercial","examples":["TIENDA.ECOPETROL@ECOPETROL.COM.CO"]},"direccion_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direccion Comercial","examples":["Carrera 7#37-69"]},"fecha_cancelacion":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Cancelacion","examples":[null]},"fecha_matricula":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Matricula","examples":["2012-01-02"]},"fecha_renovacion":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Renovacion","examples":["2025-03-27"]},"matricula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matricula","examples":["0002167505"]},"numero_empleados":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Numero Empleados","examples":[2]},"razon_social":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Razon Social","examples":["LA TIENDA ECOPETROL"]},"telefono_comercial_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Comercial 1","examples":["2856503"]},"telefono_comercial_2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Comercial 2","examples":["2344000"]},"telefono_comercial_3":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Comercial 3","examples":["3176447953"]}},"type":"object","title":"InformacionEstablecimientoSchema"},"InformacionEstablecimientosSchema":{"properties":{"establecimientos":{"items":{"$ref":"#/components/schemas/InformacionEstablecimientoSchema"},"type":"array","title":"Establecimientos","examples":[[{"codigo_actividad_economica_1":"4719","correo_electronico_comercial":"TIENDA.ECOPETROL@ECOPETROL.COM.CO","direccion_comercial":"Carrera 7#37-69","fecha_matricula":"2012-01-02","fecha_renovacion":"2025-03-27","matricula":"0002167505","numero_empleados":2,"razon_social":"LA TIENDA ECOPETROL","telefono_comercial_1":"2856503","telefono_comercial_2":"2344000","telefono_comercial_3":"3176447953"}]]}},"type":"object","required":["establecimientos"],"title":"InformacionEstablecimientosSchema"},"InformacionFinancieraEsencialSchema":{"properties":{"ingresos_actividad_ordinaria":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingresos Actividad Ordinaria","examples":[null]},"activo_corriente":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activo Corriente","examples":["17910101723812.0"]},"activo_total":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activo Total","examples":["100647980203629.0"]},"pasivo_corriente":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pasivo Corriente","examples":["19496680041990.0"]},"pasivo_total":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pasivo Total","examples":["35389468361790.0"]},"margen_bruto":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Margen Bruto","examples":["1.0"]},"margen_neto":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Margen Neto","examples":["0.14429727515388635"]},"margen_operacional":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Margen Operacional","examples":["0.048438545891106834"]},"patrimonio_neto":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patrimonio Neto","examples":["65258511841839.0"]},"ano_informacion_financiera":{"type":"integer","title":"Ano Informacion Financiera","examples":[2013]}},"type":"object","required":["ano_informacion_financiera"],"title":"InformacionFinancieraEsencialSchema"},"InformacionFinancieraSchema":{"properties":{"capital":{"items":{"$ref":"#/components/schemas/CapitalSchema"},"type":"array","title":"Capital"},"capital_social":{"$ref":"#/components/schemas/CapitalSocialSchema"},"financiero":{"items":{"$ref":"#/components/schemas/FinancieraSchema"},"type":"array","title":"Financiero"}},"type":"object","required":["capital","capital_social","financiero"],"title":"InformacionFinancieraSchema"},"InformacionProponenteSchema":{"properties":{"activo_corriente":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activo Corriente","examples":["7336250947"]},"activo_fijo_neto":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activo Fijo Neto","examples":["0"]},"activo_total":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activo Total","examples":["16825870412"]},"codigo_camara_registro_unico_proponentes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Camara Registro Unico Proponentes","examples":["03"]},"costo_ventas":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Costo Ventas","examples":["0"]},"descripcion_camara_registro_unico_proponentes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Camara Registro Unico Proponentes","examples":["BARRANQUILLA"]},"descripcion_estado_proponentes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Estado Proponentes","examples":["NORMAL"]},"descripcion_municipio_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Municipio Comercial","examples":["BARRANQUILLA / ATLANTICO"]},"descripcion_municipio_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Municipio Fiscal","examples":["BARRANQUILLA / ATLANTICO"]},"descripcion_tamano_empresa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Tamano Empresa","examples":["PEQUEÑA"]},"digito_verificacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Digito Verificacion","examples":["7"]},"direccion_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direccion Comercial","examples":["CL 106 No 90-68"]},"direccion_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direccion Fiscal","examples":["CL 106 No 90-68"]},"fecha_cancelacion":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Cancelacion","examples":[null]},"fecha_corte_informacion_financiera":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Corte Informacion Financiera","examples":[null]},"fecha_inscripcion":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Inscripcion","examples":["2015-07-08"]},"fecha_renovacion":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Renovacion","examples":["2024-04-05"]},"gastos_intereses":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gastos Intereses","examples":["786554629"]},"gastos_no_operacionales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gastos No Operacionales","examples":["0"]},"gastos_operacionales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gastos Operacionales","examples":["0"]},"identificacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identificacion","examples":["NIT 800162492 - 7"]},"indice_endeudamiento":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indice Endeudamiento","examples":["0.46"]},"indice_liquidez":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indice Liquidez","examples":["2"]},"ingresos_no_operacionales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingresos No Operacionales","examples":["0"]},"ingresos_operacionales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingresos Operacionales","examples":["0"]},"numero_identificacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numero Identificacion","examples":["00000800162492"]},"otros_activos":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Otros Activos","examples":["0"]},"pasivo_corriente":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pasivo Corriente","examples":["3656246872"]},"pasivo_largo_plazo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pasivo Largo Plazo","examples":["0"]},"pasivo_total":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pasivo Total","examples":["7892059291"]},"patrimonio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patrimonio","examples":["8933811121"]},"razon_cobertura_intereses":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Razon Cobertura Intereses","examples":["2.26"]},"razon_social":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Razon Social","examples":["AQUAMAR S.A."]},"rentabilidad_activo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rentabilidad Activo","examples":["0.1"]},"rentabilidad_patrimonio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rentabilidad Patrimonio","examples":["0.19"]},"sigla":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sigla","examples":[null]},"telefono_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Comercial","examples":["6053112710"]},"telefono_fiscal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telefono Fiscal","examples":["6053112710"]},"utilidad_o_perdida_neta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utilidad O Perdida Neta","examples":["0"]},"utilidad_o_perdida_operacional":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utilidad O Perdida Operacional","examples":["1783908575"]},"valorizaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valorizaciones","examples":["0"]}},"type":"object","required":["gastos_operacionales"],"title":"InformacionProponenteSchema"},"InformacionVitalSchema":{"properties":{"codigo_postal_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Postal Comercial","examples":[null]},"departamento_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Departamento Comercial","examples":["BOGOTA"]},"direccion_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direccion Comercial","examples":["CRA . 13 N.36 - 24 PISO 12"]},"direccion_pagina_web":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direccion Pagina Web","examples":[null]},"estado_liquidacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estado Liquidacion","examples":["NO LIQUIDADA"]},"fecha_inicio_actividad_economica_1":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Inicio Actividad Economica 1","examples":[null]},"fecha_inicio_actividad_economica_2":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Inicio Actividad Economica 2","examples":[null]},"ingresos_en_smlv_ultimo_ano":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingresos En Smlv Ultimo Ano","examples":["81540912.9338"]},"ingresos_ultimo_ano":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ingresos Ultimo Ano","examples":["116073489561251.0"]},"municipio_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Municipio Comercial","examples":["BOGOTA, D.C."]},"tamano":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tamano","examples":["GRANDE"]},"ultimo_ano_financiero":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ultimo Ano Financiero","examples":[2025]},"zona_comercial":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zona Comercial","examples":["URBANA"]}},"type":"object","title":"InformacionVitalSchema"},"PILAAportantesTransformedSchema":{"properties":{"tipo_documento_aportante":{"$ref":"#/components/schemas/TipoDocumentoEnum","description":"Tipo de documento de identificación del aportante","examples":["CC","NI"]},"numero_documento_aportante":{"type":"string","title":"Numero Documento Aportante","description":"Número de identificación del aportante","examples":["7166826","860005314","901310572"]},"periodos":{"items":{"$ref":"#/components/schemas/PeriodoAportanteTransformedSchema"},"type":"array","title":"Periodos","description":"Lista de períodos de cotización con información detallada del aportante"}},"type":"object","required":["tipo_documento_aportante","numero_documento_aportante","periodos"],"title":"PILAAportantesTransformedSchema"},"PeriodoAportanteTransformedSchema":{"properties":{"periodo_cotizacion":{"type":"string","title":"Periodo Cotizacion","description":"Periodo de cotización del aportante en formato AAAAMM","examples":["202507","202501","202411"]},"razon_social":{"type":"string","title":"Razon Social","description":"Razón social de la empresa aportante","examples":["Panadería PIPO"]},"tipo_documento_representante_legal":{"anyOf":[{"$ref":"#/components/schemas/EmptyStrToNone"},{"$ref":"#/components/schemas/TipoDocumentoEnum"}],"title":"Tipo Documento Representante Legal","description":"Tipo de documento de identificación del representante legal","examples":["CC","NI"]},"numero_documento_representante_legal":{"anyOf":[{"$ref":"#/components/schemas/EmptyStrToNone"},{"type":"string"}],"title":"Numero Documento Representante Legal","description":"Número de identificación del representante legal","examples":["23152148","91258860","43874514"]},"primer_nombre_representante_legal":{"anyOf":[{"$ref":"#/components/schemas/EmptyStrToNone"},{"type":"string"}],"title":"Primer Nombre Representante Legal","description":"Primer nombre del representante legal","examples":["MIGUEL"]},"segundo_nombre_representante_legal":{"anyOf":[{"$ref":"#/components/schemas/EmptyStrToNone"},{"type":"string"}],"title":"Segundo Nombre Representante Legal","description":"Segundo nombre del representante legal","examples":["FERNANDO"]},"primer_apellido_representante_legal":{"anyOf":[{"$ref":"#/components/schemas/EmptyStrToNone"},{"type":"string"}],"title":"Primer Apellido Representante Legal","description":"Primer apellido del representante legal","examples":["ORTIZ"]},"segundo_apellido_representante_legal":{"anyOf":[{"$ref":"#/components/schemas/EmptyStrToNone"},{"type":"string"}],"title":"Segundo Apellido Representante Legal","description":"Segundo apellido del representante legal","examples":["VILLA"]},"codigo_actividad_economica":{"type":"string","title":"Codigo Actividad Economica","description":"Código de la actividad económica principal según clasificación CIIU","examples":["1081"]},"descripcion_actividad_economica":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Actividad Economica","description":"Descripción de la actividad económica principal","examples":["Elaboración de productos de panadería"]},"codigo_clase_aportante":{"$ref":"#/components/schemas/ClaseAportanteEnum","description":"Clasificación del aportante según su función en el sistema de seguridad social","examples":["I","B"]},"descripcion_clase_aportante":{"type":"string","title":"Descripcion Clase Aportante","description":"Descripción de la clasificación del aportante","examples":["Independiente","Aportante con menos de 200 cotizantes"]},"codigo_tipo_aportante":{"$ref":"#/components/schemas/TipoAportanteEnum","description":"Tipo de aportante según su relación laboral o contributiva","examples":["1","3"]},"descripcion_tipo_aportante":{"type":"string","title":"Descripcion Tipo Aportante","description":"Descripción del tipo de aportante","examples":["Independiente","Empleador"]},"codigo_tipo_persona":{"$ref":"#/components/schemas/TipoPersonaEnum","description":"Tipo de persona: jurídica o natural","examples":["N","J"]},"descripcion_tipo_persona":{"type":"string","title":"Descripcion Tipo Persona","description":"Descripción del tipo de persona","examples":["NATURAL","JURIDICA"]},"numero_de_empleados":{"type":"integer","title":"Numero De Empleados","description":"Cantidad total de empleados reportados por el aportante en el período","examples":[1,113,3,4]},"valor_nomina":{"type":"number","title":"Valor Nomina","description":"Valor total de la nómina reportada en el período de cotización","examples":[3026304,272541321,10633409]},"valor_sin_mora_parafiscales":{"type":"number","title":"Valor Sin Mora Parafiscales","description":"Valor de aportes parafiscales sin intereses moratorios","examples":[226100,21574300,3203000]},"valor_con_mora_parafiscales":{"type":"number","title":"Valor Con Mora Parafiscales","description":"Valor de aportes parafiscales con intereses moratorios incluidos","examples":["0"]},"valor_parafiscales":{"type":"number","title":"Valor Parafiscales","description":"Valor total de aportes parafiscales (principal + intereses)","examples":[226100,21574300,3203000]}},"type":"object","required":["periodo_cotizacion","razon_social","tipo_documento_representante_legal","numero_documento_representante_legal","primer_nombre_representante_legal","segundo_nombre_representante_legal","primer_apellido_representante_legal","segundo_apellido_representante_legal","codigo_actividad_economica","descripcion_actividad_economica","codigo_clase_aportante","descripcion_clase_aportante","codigo_tipo_aportante","descripcion_tipo_aportante","codigo_tipo_persona","descripcion_tipo_persona","numero_de_empleados","valor_nomina","valor_sin_mora_parafiscales","valor_con_mora_parafiscales","valor_parafiscales"],"title":"PeriodoAportanteTransformedSchema"},"PrecioEndpointSchema":{"properties":{"precio":{"type":"number","title":"Precio","description":"El precio asociado al uso de esta ruta","examples":[1000,1200,1250]},"ruta":{"type":"string","title":"Ruta","description":"Ruta del API","examples":["/api/v1/re/informacion-basica","/api/v1/re/informacion-detallada"]},"ultima_actualizacion":{"type":"string","format":"date-time","title":"Ultima Actualizacion","description":"Marca de tiempo de la última actualización","examples":["2024-01-15T10:30:00","2024-03-20T14:45:30"]}},"type":"object","required":["precio","ruta","ultima_actualizacion"],"title":"PrecioEndpointSchema"},"PreciosEndpointsSchema":{"properties":{"precio_endpoints":{"items":{"$ref":"#/components/schemas/PrecioEndpointSchema"},"type":"array","title":"Precio Endpoints","description":"Información de precios de los endpoints"}},"type":"object","required":["precio_endpoints"],"title":"PreciosEndpointsSchema"},"RepresentanteLegalSchema":{"properties":{"nombre":{"type":"string","title":"Nombre","description":"Nombre completo del representante legal en mayúsculas","examples":["RICARDO ROA BARRAGAN"]},"cargo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cargo","description":"Cargo del representante legal","examples":["PRESIDENTE"]},"tipo_documento":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tipo Documento","description":"Tipo de documento abreviado: CC, CE, TI, PP, NIT, RC, DE, PEP, PPT, NO IDENTIFICADO","examples":["CC"]},"numero_documento":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numero Documento","description":"Número de documento sin ceros a la izquierda ni caracteres especiales","examples":["19451246"]}},"type":"object","required":["nombre"],"title":"RepresentanteLegalSchema"},"RepresentantesLegalesSchema":{"properties":{"personas":{"items":{"$ref":"#/components/schemas/RepresentanteLegalSchema"},"type":"array","title":"Personas","description":"Lista de representantes legales"}},"type":"object","required":["personas"],"title":"RepresentantesLegalesSchema"},"TipoAportanteEnum":{"type":"string","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20"],"title":"TipoAportanteEnum"},"TipoDocumentoEnum":{"type":"string","enum":["CC","CD","CE","NI","PA","PE","PT","SC","TI",""],"title":"TipoDocumentoEnum","description":"Tipos de documento del aportante según el documento."},"TipoPersonaEnum":{"type":"string","enum":["J","N"],"title":"TipoPersonaEnum"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","description":"Contáctanos para obtener acceso.","scheme":"bearer"}}},"tags":[{"name":"Meta","description":"Consulta tu balance restante, costos por endpoint y otros metadatos de tu cuenta. Esta información no tiene coste."},{"name":"Registro Empresarial (RE)","description":"Obtén la información más reciente reportada por las empresas ante su cámara de comercio."},{"name":"Planilla Integrada de Liquidación de Aportes (PILA)","description":"Consulta información laboral y de seguridad social de empleados."},{"name":"Personalizado","description":"\nEndpoints personalizados diseñados para clientes que requieren datos específicos optimizados para sus casos de uso.\n\n## ¿Para quién es esto?\n\nLos endpoints personalizados están disponibles para clientes que:\n- Tienen alto volumen de tráfico y facturación en la API\n- Necesitan combinar datos de múltiples fuentes\n\n## ¿Cómo solicitar un endpoint personalizado?\n\nContáctanos y proporciona:\n1. Volumen de requests mensual que tienes en mente\n3. Campos específicos que necesitas\n4. Descripción del caso de uso\n\nNuestro equipo evaluará tu solicitud y diseñará la mejor solución para tus necesidades.\n"}],"servers":[{"url":"/api/v1"}]}