Consultas

El API de TAXO WS te permite realizar consultas para obtener información relevante sobre contribuyentes y sus documentos fiscales registrados en el SRI. Estas consultas te ayudan a acceder a datos actualizados de manera eficiente y segura.

¿Qué puedes consultar?

Nuestro API te permite realizar diferentes tipos de consultas, organizadas en las siguientes categorías:

📋 Información de Contribuyentes

• Régimen Fiscal - Consulta asíncrona del régimen tributario de un contribuyente
• Obligaciones Fiscales - Consulta asíncrona de las obligaciones fiscales (tributarias) de un contribuyente
• Registro Público del Contribuyente (RUC) - Consulta síncrona de información pública por RUC
• Consulta y Búsqueda de Contribuyentes - Listado paginado y búsqueda de contribuyentes de tu organización

📄 Documentos y Declaraciones

• Solicitud de Extracción y Descarga de Documentos (RIDE/XML) - Descarga de documentos electrónicos en formato PDF o XML
• Solicitud de Descarga de Declaraciones (PDF) del SRI - Descarga de declaraciones tributarias en formato PDF
• Solicitud de Categorización de Documento con IA - Categorización automática de documentos usando Inteligencia Artificial

📬 Notificaciones y Alertas

• Buzón Tributario (Inbox) del Contribuyente - Consulta del historial de alertas y notificaciones oficiales del SRI

Tipos de Consultas

Consultas Síncronas

Algunas consultas devuelven la información directamente en la respuesta, como:

• Registro Público del Contribuyente (RUC)
• Consulta y Búsqueda de Contribuyentes
• Buzón Tributario (Inbox)

Consultas Asíncronas

Otras consultas inician una tarea en segundo plano y el resultado se entrega mediante Webhook:

• Régimen Fiscal
• Obligaciones Fiscales
• Solicitud de Extracción y Descarga de Documentos
• Solicitud de Descarga de Declaraciones
• Solicitud de Categorización de Documento con IA

Beneficios

✅ Información en tiempo real - Accede a datos actualizados del SRI
✅ Consultas eficientes - Respuestas rápidas y optimizadas
✅ Datos estructurados - Información en formato JSON para fácil integración
✅ Seguridad garantizada - Conexión directa y encriptada con el SRI
✅ Inteligencia Artificial - Categorización automática de documentos
✅ Paginación y búsqueda - Filtrado y paginación para grandes volúmenes de datos

Comenzar

Explora las secciones de consultas disponibles para conocer los detalles específicos de cada tipo de consulta y cómo implementarlas en tu aplicación. Cada endpoint incluye ejemplos de código, estructura de respuestas y códigos HTTP esperados.