# TuRuc - contenido completo > Servicio gratuito e independiente para consultar y verificar el RUC de > contribuyentes de Paraguay por nombre, apellido o documento. Datos públicos de > la DNIT, más de 1.8 millones de registros, sin registro y con API REST gratuita. TuRuc no es la DNIT ni Marangatú. Documentación de la API: https://docs.turuc.com.py --- # Cómo integrar la consulta de RUC en tu sistema de ventas Categoría: Desarrolladores URL: https://turuc.com.py/blog/desarrolladores/integrar-ruc-sistema-ventas/ Automatizá la verificación de RUC en tu sistema de facturación con la API gratuita de TuRuc: endpoints, datos que devuelve y ejemplos prácticos. import SifendeInline from '@/components/astro/SifendeInline.astro'; ## El problema: verificación manual de RUC Si alguna vez trabajaste en un negocio que emite facturas, sabés lo tedioso que es el proceso de verificar un RUC. El escenario típico es así: un cliente llega a la caja, te dice su número de RUC, vos lo anotás a mano o lo buscás en el navegador, copiás los datos y los pegás en tu sistema. Todo esto mientras el cliente espera. El problema no es solo la lentitud. Cada paso manual es una oportunidad para cometer errores. Un dígito mal copiado, un nombre incompleto, un RUC inactivo que nadie verificó. Y esos errores tienen consecuencias reales: una factura con un RUC inválido puede ser rechazada por la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home), lo que significa pérdida de tiempo, retrabajo y posibles sanciones. En muchas empresas paraguayas, este proceso se repite decenas o cientos de veces al día. Los empleados alternan entre el sistema de facturación y el navegador, copiando y pegando datos manualmente. Es ineficiente, propenso a errores y completamente innecesario en 2026. ## La solución: la API gratuita de TuRuc TuRuc ofrece una API REST completamente gratuita que te permite consultar datos de contribuyentes de forma programática. No necesitás registrarte, no necesitás una API key, no necesitás pagar nada. Simplemente hacés una petición HTTP y recibís los datos en formato JSON. La URL base de la API es: ``` https://turuc.com.py/api ``` Fue diseñada pensando en la facilidad de integración. Si tu sistema puede hacer una petición HTTP (y prácticamente todos pueden), podés integrar la consulta de RUC en minutos. No importa si tu sistema está hecho en Java, Python, PHP, JavaScript o cualquier otro lenguaje. ## Endpoints disponibles La API de TuRuc tiene dos endpoints principales que cubren los casos de uso más comunes: ### GET /api/contribuyente/\{ruc\} Este endpoint te permite buscar un contribuyente por su número de RUC exacto. Devuelve el registro completo del contribuyente si existe en la base de datos. **Caso de uso típico:** cuando el usuario de tu sistema ya tiene el número de RUC (porque el cliente se lo dictó o lo leyó de una tarjeta), tu sistema puede llamar a este endpoint para autocompletar automáticamente el nombre, la razón social y verificar que el RUC esté activo antes de emitir la factura. ``` GET https://turuc.com.py/api/contribuyente/80012345-6 ``` ### GET /api/contribuyente/search?q=\{query\} Este endpoint te permite buscar contribuyentes por nombre o por un fragmento del RUC. Devuelve una lista de contribuyentes que coinciden con la búsqueda. **Caso de uso típico:** cuando el cliente no sabe su número de RUC pero sí su nombre o razón social, tu sistema puede usar este endpoint para buscarlo. Mostrás los resultados en un dropdown y el usuario selecciona el correcto. ``` GET https://turuc.com.py/api/contribuyente/search?q=EMPRESA%20EJEMPLO ``` ## ¿Qué datos devuelve la API? La API devuelve los datos en formato JSON. Cada registro de contribuyente incluye campos como el número de RUC, la razón social, el nombre de fantasía, el estado del contribuyente (activo, cancelado, suspendido), la categoría y otros datos de registro. A continuación, un ejemplo conceptual de la respuesta: ```json { "ruc": "80012345-6", "razonSocial": "EMPRESA EJEMPLO SA", "nombreFantasia": "EJEMPLO", "estado": "ACTIVO", "categoria": "GRANDE" } ``` Los campos más útiles para un sistema de facturación son: - **ruc:** el número de RUC completo con dígito verificador. - **razonSocial:** el nombre legal del contribuyente, tal como figura en el registro de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). - **nombreFantasia:** el nombre comercial, si tiene uno registrado. - **estado:** indica si el contribuyente está ACTIVO, CANCELADO o en otro estado. Fundamental para validar antes de facturar. - **categoria:** la categoría del contribuyente según la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). ## ¿Cómo integrar en tu sistema? La integración es conceptualmente sencilla. Estos son los pasos generales que tu sistema debería seguir: ### 1. El usuario ingresa el RUC En tu formulario de facturación o venta, el usuario escribe el número de RUC del cliente en el campo correspondiente. ### 2. Tu sistema consulta la API Cuando el usuario termina de escribir (o presiona un botón de búsqueda), tu sistema hace una petición GET a `/api/contribuyente/{ruc}` con el número ingresado. ### 3. La API devuelve los datos TuRuc responde con el registro del contribuyente en formato JSON, incluyendo razón social, estado y demás campos. ### 4. Autocompletá los campos y validá Tu sistema rellena automáticamente el nombre del cliente y verifica que el estado sea ACTIVO. Si no lo es, podés mostrar una advertencia al operador. ### 5. Continuá con la facturación Si todo está correcto, el proceso de facturación continúa normalmente, ahora con datos verificados y sin errores de tipeo. Para documentación técnica detallada, ejemplos de código en varios lenguajes y guías de integración paso a paso, visitá la [documentación completa en docs.turuc.com.py](https://docs.turuc.com.py). ## Casos de uso La API de TuRuc se adapta a múltiples escenarios. Estos son los más comunes entre los sistemas que ya la utilizan: - **Sistemas POS (punto de venta):** validá el RUC del cliente en el momento del cobro, antes de imprimir la factura. Evitá facturas con datos incorrectos que después no podés usar para el IVA. - **Software de facturación:** autocompletá los datos del contribuyente cuando el operador ingresa el RUC. Verificá que el estado sea ACTIVO antes de emitir el comprobante. - **E-commerce:** cuando un cliente empresarial se registra en tu tienda online, validá su RUC en tiempo real. Asegurate de que los datos de facturación sean correctos desde el principio. - **Sistemas ERP:** si manejás una base de datos de proveedores, podés hacer una validación masiva de todos los RUCs para asegurarte de que estén actualizados y activos. - **Contabilidad:** antes del cierre mensual, verificá que todos los RUCs de proveedores y clientes en tus registros estén vigentes. Detectá contribuyentes cancelados o suspendidos antes de presentar tus declaraciones. ## Preguntas frecuentes ### ¿La API es realmente gratuita? Sí, completamente gratuita. No necesitás crear una cuenta, no necesitás una API key y no hay costos ocultos. TuRuc es un proyecto abierto que busca facilitar el acceso a datos públicos de contribuyentes paraguayos. ### ¿Hay límite de consultas? No hay un límite estricto definido, pero te pedimos que seas razonable con el uso. Si tu sistema necesita hacer un volumen muy alto de consultas (miles por minuto), te recomendamos contactar al equipo de TuRuc para coordinar y asegurar la mejor experiencia para todos los usuarios. ### ¿Qué pasa si la API no responde? Como con cualquier servicio externo, es buena práctica tener un plan alternativo. Si la API no responde en un tiempo razonable, tu sistema podría permitir el ingreso manual de datos y reintentar la validación más tarde. Nunca bloquees completamente tu proceso de facturación por una dependencia externa. ### ¿Puedo usar la API en aplicaciones comerciales? Sí, podés usar la API de TuRuc en tus aplicaciones comerciales sin restricciones. Muchos sistemas de facturación y software empresarial en Paraguay ya la integran para ofrecer una mejor experiencia a sus usuarios. ### ¿Dónde encuentro la documentación completa? La documentación técnica completa, con ejemplos de código, descripción detallada de cada campo y guías de integración, está disponible en [docs.turuc.com.py](https://docs.turuc.com.py). También podés explorar la documentación interactiva de la API en [docs.turuc.com.py](https://docs.turuc.com.py). --- # ¿Cada cuánto se actualiza la base de datos de TuRuc? Categoría: Datos URL: https://turuc.com.py/blog/datos/cuando-se-actualiza/ Conocé de dónde vienen los datos de TuRuc, con qué frecuencia se actualiza la base de datos de RUC Paraguay y qué hacer si un RUC no aparece. ## ¿De dónde vienen los datos? Toda la información que encontrás en TuRuc proviene del portal público de la **Dirección Nacional de Ingresos Tributarios ([DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home))**, el organismo del Ministerio de Hacienda encargado de administrar el sistema tributario en Paraguay. La [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) pone a disposición del público ciertos datos de los contribuyentes registrados, y eso es exactamente lo que TuRuc recopila, procesa e indexa para que puedas buscarlo de forma rápida y sencilla. Los datos que vas a encontrar en TuRuc incluyen: - **Número de RUC** y dígito verificador - **Razón social** o nombre del contribuyente - **Estado** del contribuyente (activo, cancelado, suspendido, etc.) - **Categoría** y tipo de contribuyente - Otros datos públicos del registro, como la fecha de inicio de actividades Es importante aclarar que TuRuc **no tiene acceso a datos privados** de ningún contribuyente. No podemos ver movimientos fiscales, declaraciones juradas, montos facturados ni información financiera. Solo trabajamos con los datos que la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) publica de forma abierta para consulta pública. ## ¿Con qué frecuencia se actualizan? La base de datos de TuRuc se actualiza de forma periódica mediante un **pipeline ETL automatizado** (Extract, Transform, Load). Este proceso se encarga de buscar registros nuevos y modificados en el portal de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home), transformarlos al formato que usamos internamente y cargarlos en nuestra base de datos. Las actualizaciones se ejecutan de manera regular con el objetivo de mantener los datos lo más vigentes posible. Cuando un contribuyente se registra en la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) o cuando cambia su estado (por ejemplo, de activo a cancelado), ese cambio se refleja en TuRuc después del siguiente ciclo de actualización. En la práctica, esto significa que si un RUC fue creado hoy en la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home), puede que aparezca en TuRuc en los próximos días, dependiendo de cuándo se ejecute la siguiente sincronización. No es en tiempo real, pero trabajamos para que el desfase sea lo más corto posible. ## ¿Qué hacer si un RUC no aparece? Si buscaste un número de RUC y no aparece en TuRuc, no te preocupes. Hay varias razones posibles: 1. **El RUC fue creado recientemente** y la última actualización todavía no lo incluyó. Dale unos días y volvé a intentar. 2. **Hay un error de tipeo** en el número que ingresaste. Verificá que el número sea correcto, incluyendo el dígito verificador. 3. **El contribuyente aún no está registrado en la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home).** Si la persona o empresa todavía no completó su inscripción ante la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home), no va a aparecer en ningún sistema de consulta pública. Algunos consejos prácticos: - **Probá buscar por nombre** en vez de por número. A veces es más fácil encontrar al contribuyente escribiendo su razón social o nombre completo. - **Revisá bien el número.** Un solo dígito de diferencia te va a dar un resultado distinto o ninguno. - **Esperá unos días** y volvé a intentar si sospechás que el RUC es nuevo. - **Consultá directamente en el portal de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home)** en [www.dnit.gov.py](https://www.dnit.gov.py) para verificar la información de primera mano. ## ¿Cómo reportar una discrepancia? Si encontrás datos que parecen incorrectos o desactualizados en TuRuc, podés comunicarte con nosotros a través del [formulario de contacto](/#contact) en nuestra página principal. Revisamos cada reporte para entender qué pasó. Tené en cuenta que TuRuc refleja fielmente lo que la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) publica en su portal. Si los datos en la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) son distintos a lo que ves en TuRuc, lo más probable es que haya un desfase temporal por el ciclo de actualización. En ese caso, la información se corregirá automáticamente en la próxima sincronización. Si el dato es incorrecto directamente en la fuente (la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home)), la corrección tiene que hacerse ante la propia [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Una vez que ellos actualicen su registro, TuRuc va a reflejar el cambio en el siguiente ciclo. ## Preguntas frecuentes ### ¿Los datos de TuRuc son oficiales? Los datos que mostramos provienen del portal público de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home), que es la fuente oficial de información tributaria en Paraguay. TuRuc los procesa y los presenta de una forma más accesible y rápida de buscar. Sin embargo, TuRuc no es un organismo oficial del Estado; somos una herramienta independiente que facilita el acceso a información pública. ### ¿Puedo confiar en el estado que muestra TuRuc? Sí, el estado que ves en TuRuc (activo, cancelado, suspendido, etc.) refleja lo que publica la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Dicho esto, si necesitás esta información para trámites oficiales, te recomendamos verificarla directamente en el portal de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) en [www.dnit.gov.py](https://www.dnit.gov.py) para tener la versión más actualizada posible. ### ¿Por qué un RUC aparece con datos distintos en la DNIT? Esto puede ocurrir por un desfase temporal entre la última actualización de TuRuc y un cambio reciente en el registro de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Nuestro sistema se sincroniza periódicamente, así que si hubo una modificación reciente en la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home), puede que todavía no esté reflejada en TuRuc. Esperá al próximo ciclo de actualización y los datos deberían coincidir. ### ¿TuRuc almacena datos privados? No. TuRuc solamente almacena y muestra datos públicos del registro de contribuyentes que la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) pone a disposición de forma abierta. No tenemos acceso a declaraciones juradas, movimientos financieros, montos de facturación ni ningún otro dato privado o sensible de los contribuyentes. --- # Cómo verificar el RUC de un proveedor antes de facturar Categoría: Para contadores URL: https://turuc.com.py/blog/para-contadores/verificar-ruc-proveedor/ Verificar el RUC de un proveedor es una obligación fiscal antes de facturar en Paraguay. Aprendé cómo hacerlo en segundos y gratis con TuRuc. import SifendeInline from '@/components/astro/SifendeInline.astro'; ## ¿Por qué es importante verificar el RUC? Si trabajás en contabilidad o administración en Paraguay, verificar el RUC de un proveedor antes de emitir una factura no es solo una buena práctica: **es una obligación fiscal**. La Dirección Nacional de Ingresos Tributarios ([DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home)) establece que toda factura debe contener datos correctos del contribuyente, incluyendo un RUC válido y activo. ¿Qué pasa si emitís una factura a un contribuyente cuyo RUC está **BLOQUEADO** o **CANCELADO**? La factura puede ser considerada inválida por la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Esto significa que no podrás utilizar ese comprobante para respaldar gastos deducibles en tu liquidación de impuestos. En otras palabras, perdés el derecho a la deducción y podrías enfrentar ajustes fiscales en una eventual auditoría. La normativa tributaria paraguaya, particularmente la Ley 6380/19 de Modernización y Simplificación del Sistema Tributario Nacional, refuerza la importancia de que los comprobantes de venta sean emitidos con datos fidedignos. El Decreto 3107/19 reglamenta las condiciones que deben reunir los documentos para tener validez fiscal. Verificar el RUC protege a tu empresa de varias formas: - **Evitás facturas inválidas** que la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) puede rechazar como sustento de crédito fiscal. - **Protegés la deducibilidad** de tus gastos e inversiones. - **Confirmás la identidad** del proveedor con quien estás haciendo negocios. - **Prevenís fraudes** y operaciones con empresas fantasma. ## Cómo verificar un RUC paso a paso El proceso de verificación es sencillo y toma menos de un minuto usando [TuRuc](/). Seguí estos pasos: ### 1. Pedí el RUC al proveedor Antes de emitir cualquier factura, solicitá al proveedor su número de RUC completo, incluyendo el dígito verificador. Por ejemplo: `80012345-6`. Este dato debería figurar en sus documentos comerciales, presupuestos o contratos. ### 2. Ingresá a turuc.com.py Abrí tu navegador y visitá [turuc.com.py](/). No necesitás crear una cuenta ni registrarte. El servicio es completamente gratuito. ### 3. Escribí el RUC en el buscador En el campo de búsqueda principal, ingresá el número de RUC del proveedor. También podés buscar por razón social o nombre comercial si no tenés el número a mano. ### 4. Verificá que el estado sea ACTIVO Una vez que aparezcan los resultados, revisá el campo **Estado**. Solo debés emitir la factura si el estado del contribuyente es **ACTIVO**. Si aparece BLOQUEADO, CANCELADO o SUSPENDIDO, no procedas con la facturación. ### 5. Confirmá que la razón social coincida Compará la razón social que aparece en TuRuc con la que te proporcionó el proveedor. Deben coincidir exactamente. Si hay diferencias, pedí aclaraciones al proveedor antes de facturar. ### 6. Procedé a emitir la factura Si el RUC está activo y la razón social coincide, ya podés emitir la factura con tranquilidad. Tenés la certeza de que el comprobante será válido ante la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). ## ¿Qué campos revisar? Cuando consultás un RUC en TuRuc, se muestran varios datos del contribuyente. Estos son los campos clave que debés revisar antes de facturar: - **Estado:** Es el campo más importante. Debe decir **ACTIVO**. Si aparece BLOQUEADO, CANCELADO o SUSPENDIDO, no emitas la factura bajo ninguna circunstancia. Una factura emitida a un RUC inactivo puede ser invalidada por la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) y perdés el derecho a deducir ese gasto. - **Razón social:** Debe coincidir exactamente con lo que el proveedor te indicó. Si hay diferencias en el nombre (por ejemplo, abreviaciones distintas o errores tipográficos), aclará la situación antes de facturar. Una discrepancia puede generar observaciones en una auditoría. - **Número de RUC:** Verificá que el número completo, incluyendo el dígito verificador (el número que aparece después del guión), sea correcto. Un dígito verificador incorrecto indica que el RUC proporcionado tiene un error. - **Categoría:** Tomá nota de la categoría del contribuyente (por ejemplo, GRANDE, MEDIANO, PEQUEÑO o NO DESIGNADO). Esta información puede ser relevante para determinar el régimen tributario aplicable y las retenciones que correspondan. ## ¿Qué significan los estados del RUC? Entender los estados del RUC te permite tomar decisiones informadas al momento de facturar. Estos son los estados posibles y lo que significan para vos como contador o administrador: - **ACTIVO:** El contribuyente está al día con sus obligaciones ante la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Es seguro emitir facturas a este RUC. La factura tendrá plena validez fiscal. - **BLOQUEADO:** El contribuyente tiene problemas pendientes con la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home), como falta de presentación de declaraciones juradas o irregularidades detectadas. **No emitas facturas a un RUC bloqueado.** El comprobante puede ser invalidado. - **CANCELADO:** El RUC fue dado de baja definitivamente. Esto puede ocurrir por cierre de empresa, fallecimiento del titular o decisión administrativa. **Nunca emitas facturas a un RUC cancelado.** No existe como contribuyente activo. - **SUSPENDIDO:** El contribuyente tiene una suspensión temporal. Esto suele indicar inactividad temporal declarada o una situación administrativa transitoria. **Verificá con el proveedor** si la suspensión fue resuelta antes de emitir la factura. En caso de duda, no factures hasta confirmar la reactivación. > **Consejo profesional:** Si un proveedor recurrente aparece con estado BLOQUEADO o SUSPENDIDO, comunicale la situación. Muchas veces el contribuyente no sabe que su RUC tiene problemas y puede regularizarse rápidamente ante la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). ## Verificación de alto volumen con la API Si tu empresa trabaja con muchos proveedores y necesitás verificar decenas o cientos de RUCs de forma regular, hacer la consulta manual uno por uno puede ser impráctico. Para estos casos, TuRuc ofrece una **API REST gratuita** que podés integrar directamente en tu sistema de facturación o ERP. El endpoint principal para verificar un contribuyente es: ``` GET https://turuc.com.py/api/contribuyente/{ruc} ``` Por ejemplo, para consultar el RUC `80012345-6`: ``` GET https://turuc.com.py/api/contribuyente/80012345-6 ``` La API devuelve los datos del contribuyente en formato JSON, incluyendo la razón social, el estado, la categoría y más. No requiere autenticación ni registro: es completamente libre y gratuita. Algunos casos de uso prácticos: - **Validación automática al cargar proveedores:** Tu sistema puede consultar la API al momento de registrar un nuevo proveedor y alertar si el RUC no está activo. - **Verificación periódica masiva:** Podés programar un script que recorra tu lista de proveedores y verifique el estado de cada RUC diariamente o semanalmente. - **Bloqueo de facturación:** Configurá tu sistema para que no permita emitir facturas a proveedores con RUC no activo. Para documentación completa de la API, visitá [docs.turuc.com.py](https://docs.turuc.com.py). Ahí encontrarás todos los endpoints disponibles, ejemplos de respuesta y guías de integración. ## Preguntas frecuentes ### ¿Qué pasa si facturo a un RUC bloqueado? La factura puede ser considerada inválida por la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Esto significa que no podrás utilizar ese comprobante para respaldar deducciones fiscales. En una auditoría, la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) puede rechazar el gasto y aplicar ajustes a tu liquidación de impuestos, incluyendo multas e intereses por la diferencia resultante. ### ¿Con qué frecuencia debo verificar el RUC de un proveedor recurrente? Lo recomendable es verificar el RUC **cada vez que vas a emitir una factura**, incluso si es un proveedor habitual. El estado del RUC puede cambiar en cualquier momento: un proveedor que ayer estaba activo, hoy puede aparecer bloqueado. La verificación toma segundos y te ahorra potenciales problemas fiscales. ### ¿Puedo verificar varios RUCs a la vez? Desde la web de TuRuc podés verificar de a uno por vez. Sin embargo, si necesitás hacer verificaciones masivas, la [API de TuRuc](https://docs.turuc.com.py) te permite automatizar el proceso. Podés integrarla en tu sistema para verificar cientos de RUCs de forma programática. ### ¿La verificación en TuRuc reemplaza la consulta en la DNIT? Para verificaciones rápidas del estado y datos básicos de un contribuyente, TuRuc es una herramienta confiable y mucho más ágil que el portal de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Sin embargo, para trámites oficiales, presentación de declaraciones juradas o gestiones formales ante la administración tributaria, siempre debés utilizar los canales oficiales de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) y Marangatú. ### ¿Es gratuito verificar RUC en TuRuc? Sí, completamente gratuito. Tanto la consulta web como la API son de uso libre, sin límites de consultas y sin necesidad de registro. Podés verificar todos los RUCs que necesites sin costo alguno. --- # TuRuc no es la DNIT Categoría: Guías RUC URL: https://turuc.com.py/blog/guias-ruc/turuc-vs-dnit/ Comparación clara entre TuRuc y Marangatú de la DNIT: descubrí qué podés consultar en cada plataforma y cuál usar según tu necesidad. ## ¿Qué es TuRuc y qué es la DNIT? Sabemos que puede confundir. Muchas personas llegan a TuRuc pensando que es el portal oficial de tributación del país, y cuando no encuentran la opción de pagar o presentar una declaración jurada, se preguntan qué está pasando. Tranquilo, es más común de lo que pensás y tiene una explicación sencilla. La **[DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home)** (Dirección Nacional de Ingresos Tributarios) es la autoridad tributaria del Paraguay. Es el organismo del gobierno encargado de administrar y recaudar los impuestos del país. Su portal en línea, conocido como **Marangatú**, es la plataforma oficial donde los contribuyentes presentan declaraciones juradas, pagan impuestos, solicitan constancias y realizan todo tipo de trámites tributarios. **TuRuc**, en cambio, es un servicio independiente y gratuito que te permite buscar y verificar datos públicos del Registro Único del Contribuyente (RUC) a partir de la información que la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) publica. No pertenecemos a la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) ni somos parte del gobierno. Somos una herramienta complementaria pensada para hacerte la vida más fácil cuando necesitás consultar un RUC rápidamente. ## ¿Qué podés hacer en TuRuc? TuRuc está diseñado para consultas rápidas y verificaciones. Esto es lo que podés hacer: - **Buscar contribuyentes por RUC o nombre:** Ingresá un número de RUC o el nombre de una persona o empresa y obtené resultados al instante. Podés buscar entre más de 1.8 millones de registros. - **Verificar el estado de un contribuyente:** Comprobá si un contribuyente está ACTIVO, BLOQUEADO, CANCELADO o en cualquier otro estado. Esto es clave antes de emitir una factura. - **Consultar razón social y datos públicos:** Accedé al nombre completo, razón social y dígito verificador de cualquier contribuyente registrado. - **Usar la API gratuita para integrar en tus sistemas:** Si sos desarrollador, podés consumir nuestra API REST para automatizar consultas de RUC desde tu sistema de facturación, ERP o cualquier aplicación. - **Buscar sin registro ni login:** No necesitás crear una cuenta, no te pedimos contraseña ni datos personales. Entrás, buscás y listo. ## ¿Qué NO podés hacer en TuRuc? Hay varias cosas que solo se pueden hacer en el portal oficial de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home): - **Presentar declaraciones juradas:** Las DDJJ mensuales y anuales se cargan y envían desde el sistema Marangatú de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). - **Reactivar un RUC bloqueado o cancelado:** Si tu RUC aparece como BLOQUEADO o CANCELADO, el trámite de reactivación se gestiona directamente con la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home), ya sea en línea o de forma presencial. - **Ver movimientos o estados de cuenta:** El historial de pagos, deudas y movimientos tributarios está disponible solo en tu cuenta de Marangatú. - **Inscribirte como contribuyente:** La inscripción al RUC es un trámite oficial que se realiza en la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Podés iniciarlo en [www.dnit.gov.py](https://www.dnit.gov.py/). - **Obtener constancias oficiales:** Las constancias de cumplimiento tributario, certificados de no adeudar y otros documentos oficiales se emiten únicamente desde Marangatú. ## Tabla comparativa TuRuc vs DNIT Para que lo veas de un vistazo, acá te dejamos una comparación lado a lado: | Funcionalidad | TuRuc | DNIT / Marangatú | | --- | --- | --- | | Buscar RUC por nombre | ✓ | ✓ | | Verificar estado del contribuyente | ✓ | ✓ | | API gratuita | ✓ | ✗ | | Sin registro necesario | ✓ | ✗ (algunos servicios) | | Pagar impuestos | ✗ | ✓ | | Declaraciones juradas | ✗ | ✓ | | Reactivar RUC | ✗ | ✓ | | Constancias oficiales | ✗ | ✓ | ## ¿Cuándo usar cada uno? La regla es simple: - **Usá TuRuc** cuando necesités verificar rápidamente un RUC, buscar la razón social de un contribuyente, confirmar si está activo antes de facturar, o integrar la consulta de RUC en tu sistema mediante la API. Es instantáneo, gratuito y no requiere login. - **Usá la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) / Marangatú** cuando necesités realizar cualquier trámite oficial: pagar impuestos, presentar declaraciones juradas, solicitar constancias, reactivar tu RUC o consultar tu estado de cuenta tributario. TuRuc es tu herramienta de consulta rápida. La [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) es donde hacés los trámites oficiales. ## Preguntas frecuentes ### ¿TuRuc pertenece a la DNIT? No. TuRuc es un proyecto independiente desarrollado por particulares. No somos parte de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) ni del gobierno paraguayo. Utilizamos datos públicos que la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) pone a disposición para ofrecer un servicio de consulta rápida y gratuita. ### ¿Los datos de TuRuc son confiables? Sí. Toda la información que mostramos proviene del registro público de contribuyentes de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Nuestra base de datos se actualiza periódicamente para reflejar los cambios oficiales. Igualmente, para trámites formales siempre recomendamos verificar en el portal de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). ### ¿Puedo pagar impuestos desde TuRuc? No. TuRuc es exclusivamente una herramienta de consulta. Para pagar impuestos, presentar declaraciones o realizar cualquier trámite tributario, tenés que ingresar a [Marangatú](https://marangatu.set.gov.py/), el portal oficial de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). ### ¿Necesito crear una cuenta para usar TuRuc? No. Podés buscar y verificar cualquier RUC sin necesidad de registrarte, crear una cuenta o iniciar sesión. El servicio es completamente abierto y gratuito, tanto la web como la API. --- # Cómo consultar tu RUC en Paraguay (gratis y al instante) Categoría: Guías RUC URL: https://turuc.com.py/blog/guias-ruc/consultar-ruc-paraguay/ Aprendé cómo consultar el RUC de cualquier contribuyente paraguayo en segundos: guía completa con pasos y preguntas frecuentes. Es gratis y sin registro. Si alguna vez necesitaste verificar los datos de un contribuyente en Paraguay (ya sea para facturar, contratar un proveedor o simplemente confirmar que un RUC es válido), sabés lo tedioso que puede ser el proceso. En esta guía te mostramos cómo hacerlo en segundos usando [TuRuc](/), una herramienta gratuita que te permite consultar cualquier RUC registrado en la base de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). ## ¿Qué es el RUC? El **RUC** (Registro Único del Contribuyente) es el número de identificación tributaria que la **[DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home)** (Dirección Nacional de Ingresos Tributarios) asigna a toda persona física o jurídica que realiza actividades económicas en Paraguay. Es obligatorio para emitir facturas, presentar declaraciones juradas y cumplir con las obligaciones fiscales. Cada RUC está compuesto por un número base seguido de un **dígito verificador** separado por un guion (por ejemplo, `80012345-6`). Este dígito se calcula a partir de los anteriores y sirve para validar que el número sea correcto. Conocer el RUC de una persona o empresa es fundamental en varias situaciones: - **Emitir una factura:** la ley exige que incluyas el RUC del comprador si es contribuyente. - **Verificar proveedores:** antes de pagar, conviene confirmar que el proveedor tiene un RUC activo. - **Trámites legales y bancarios:** muchas instituciones te piden el RUC como requisito. - **Transparencia:** cualquier persona puede consultar si un contribuyente está al día o no. ## Cómo buscar un RUC paso a paso Con TuRuc, la consulta es directa: no necesitás crear una cuenta, no hay captcha y no hace falta instalar nada. Seguí estos pasos: ### 1. Ingresá a turuc.com.py Abrí tu navegador (desde el celular o la computadora) y andá a [turuc.com.py](/). La página carga rápido. ### 2. Escribí el número de RUC o el nombre En el campo de búsqueda, podés ingresar el **número de RUC** (con o sin dígito verificador) o el **nombre / razón social** del contribuyente. La búsqueda acepta texto parcial: si ponés "farmacia" te va a mostrar todas las farmacias registradas. ### 3. Hacé clic en "Buscar" o presioná Enter El sistema busca en más de 1.8 millones de registros y te devuelve los resultados en menos de un segundo. ### 4. Revisá los resultados La tabla de resultados te muestra el RUC, la razón social, el nombre de fantasía (si tiene) y el estado del contribuyente. Podés ordenar y filtrar directamente en la tabla. ### 5. Verificá el estado del contribuyente Prestá atención a la columna **Estado**. Un contribuyente puede estar **ACTIVO**, **BLOQUEADO**, **CANCELADO** o **SUSPENDIDO**. Si necesitás facturar a nombre de esa persona o empresa, lo ideal es que figure como ACTIVO. ## Buscar por número de RUC Si ya conocés el número de RUC del contribuyente, esta es la forma más rápida de consultar. Simplemente ingresá el número en el campo de búsqueda. Podés escribirlo de varias maneras: - **Con dígito verificador:** `80012345-6` - **Sin dígito verificador:** `80012345` - **Sin guion:** `800123456` TuRuc interpreta el formato automáticamente y te muestra el registro correspondiente. Si el número coincide exactamente con un RUC registrado, vas a ver un solo resultado. Si el número es parcial (por ejemplo, `8001234`), el sistema te va a devolver todos los RUC que contengan esa secuencia. > Los RUC de personas físicas suelen ser más cortos (por ejemplo, `1234567-8`), mientras que los de empresas y sociedades empiezan con números más altos y tienen más dígitos (por ejemplo, `80098765-4`). ## Buscar por nombre o razón social Cuando no tenés el número de RUC a mano, podés buscar por el nombre de la persona o la razón social de la empresa. Este tipo de búsqueda es muy útil en situaciones cotidianas: - Un cliente te pide una factura pero no recuerda su RUC. - Querés verificar los datos de una empresa antes de hacer negocios. - Necesitás encontrar el RUC de un profesional independiente. Algunos consejos para buscar por nombre: - **Usá palabras clave:** en vez de escribir "Juan Carlos López Martínez", probá con "López Martínez" para obtener resultados más amplios. - **Probá con la razón social:** las empresas están registradas con su denominación legal (por ejemplo, "COMERCIAL RODRIGUEZ S.A."), no necesariamente con el nombre de fantasía. - **No te preocupes por mayúsculas:** la búsqueda no distingue entre mayúsculas y minúsculas. ## ¿Qué datos vas a encontrar? Al buscar un RUC en TuRuc, la plataforma te devuelve la información pública del contribuyente tal como está registrada en la base de datos de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Los campos que podés ver son: | Campo | Descripción | | --- | --- | | **RUC** | Número de Registro Único del Contribuyente con dígito verificador. | | **Razón social** | Nombre legal completo del contribuyente (persona física o jurídica). | | **Nombre de fantasía** | Nombre comercial con el que opera (no todos los contribuyentes tienen uno). | | **Estado** | Situación actual: ACTIVO, BLOQUEADO, CANCELADO o SUSPENDIDO. | Estos datos son de acceso público. TuRuc no muestra información privada como dirección, teléfono ni datos bancarios del contribuyente. ## Lo que TuRuc NO puede hacer Es importante aclarar que TuRuc es una **herramienta de consulta**. No es un portal transaccional ni está afiliada a la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Esto significa que con TuRuc **no podés**: - **Pagar impuestos** ni realizar ningún tipo de transacción tributaria. - **Presentar declaraciones juradas** (IVA, Renta, etc.). - **Reactivar o modificar un RUC** bloqueado, cancelado o suspendido. - **Acceder a Marangatú**, el sistema en línea de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) para contribuyentes. - **Consultar movimientos**, saldos ni estados de cuenta tributarios. - **Inscribirte como contribuyente** ni obtener un RUC nuevo. Para todas esas gestiones, necesitás ingresar al portal oficial de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) en [www.dnit.gov.py](https://www.dnit.gov.py) o acudir personalmente a una oficina regional. ## Preguntas frecuentes ### ¿Es gratis consultar el RUC en TuRuc? Sí, completamente gratis. No necesitás registrarte, no hay planes de pago ni límites de consultas para uso normal. TuRuc es un proyecto abierto que busca facilitar el acceso a la información pública de contribuyentes. ### ¿Los datos son oficiales? Los datos provienen de la base pública de contribuyentes de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) (Dirección Nacional de Ingresos Tributarios). TuRuc los organiza y los hace más fáciles de buscar, pero la fuente original es la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Si necesitás un certificado oficial o un documento con validez legal, debés solicitarlo directamente a la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). ### ¿Puedo buscar por cédula de identidad? No directamente. El sistema de TuRuc está diseñado para buscar por número de RUC o por nombre/razón social. En muchos casos, el número de cédula de identidad coincide con el RUC de la persona física, pero esto no siempre es así. Si tenés la cédula, podés probar ingresándola como número de RUC para ver si hay coincidencia. ### ¿Con qué frecuencia se actualizan los datos? La base de datos de TuRuc se actualiza periódicamente a partir de los datos publicados por la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). La frecuencia exacta depende de cuándo la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) publica nuevas versiones de su base. Si un contribuyente se inscribió recientemente y no aparece, es posible que la actualización aún no haya llegado. Podés leer más en nuestro artículo [¿Cada cuánto se actualiza la base de datos de TuRuc?](/blog/datos/cuando-se-actualiza) ### ¿TuRuc es lo mismo que la DNIT? No. TuRuc es un proyecto independiente que no tiene afiliación con la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) ni con ninguna entidad gubernamental. TuRuc utiliza datos públicos para ofrecer una herramienta de búsqueda rápida y gratuita, pero no reemplaza los servicios oficiales de la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Para trámites tributarios, siempre consultá [www.dnit.gov.py](https://www.dnit.gov.py). --- # Más información en TuRuc: entidades públicas y personas jurídicas Categoría: Novedades URL: https://turuc.com.py/blog/novedades/mas-informacion/ TuRuc ahora muestra información detallada de entidades públicas y personas jurídicas: consultá datos de organismos del Estado y empresas registradas en Paraguay. Sumamos dos nuevas categorías de información a TuRuc: **entidades públicas** y **personas jurídicas**. Cuando buscás un RUC y el contribuyente pertenece a alguna de estas categorías, ahora vas a ver datos adicionales específicos de cada tipo. ## Entidades públicas Las entidades públicas son organismos del Estado paraguayo: ministerios, gobernaciones, municipalidades, entes autónomos y autárquicos. Para estos contribuyentes, TuRuc ahora puede mostrar: - **Nivel de la entidad** (nacional, departamental, municipal) - **Descripción del nivel** - **Código de entidad** asignado por el Ministerio de Hacienda - **Sigla** oficial de la institución - **Página web** y **correo electrónico** institucional (cuando está disponible) - **Dirección** y **teléfono** de contacto (cuando está disponible) Esta información proviene de los datos que publica el Ministerio de Hacienda y se actualiza junto con el resto de la base de datos de TuRuc. ## Personas jurídicas Las personas jurídicas son empresas, sociedades y organizaciones registradas formalmente ante la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Para estos contribuyentes, TuRuc ahora incluye: - **Categoría de contribuyente** (que antes no se mostraba para personas jurídicas) - **Tipo de persona jurídica** (SRL, SA, SCS, fundación, cooperativa, etc.) Esta fue una de las funcionalidades más pedidas por usuarios y contadores. La categoría del contribuyente es información relevante para verificar el tipo de régimen tributario al que pertenece una empresa. ## Nuevos endpoints en la API Para los desarrolladores, sumamos dos nuevos endpoints a la API REST: - `GET /api/contribuyente/entidad-publica?ruc={ruc}`: devuelve los datos extendidos de una entidad pública - `GET /api/contribuyente/persona-juridica?ruc={ruc}`: devuelve los datos extendidos de una persona jurídica Podés explorarlos en el [Swagger UI](https://docs.turuc.com.py) o leer la documentación completa en [docs.turuc.com.py](https://docs.turuc.com.py). ## ¿Cómo ver esta información? No necesitás hacer nada especial. Cuando buscás un RUC en TuRuc y el contribuyente es una entidad pública o persona jurídica, los datos adicionales aparecen automáticamente al hacer clic en el resultado para ver el detalle completo. ## Preguntas frecuentes ### ¿Todos los RUCs tienen datos de entidad pública o persona jurídica? No. Solo los contribuyentes que están registrados como entidad pública o persona jurídica tienen estos datos adicionales. Las personas físicas (contribuyentes individuales) no entran en estas categorías y no tendrán los campos extendidos. ### ¿Por qué algunos campos aparecen vacíos? Algunos campos como el correo electrónico, teléfono o página web de entidades públicas no siempre están disponibles en la fuente de datos. TuRuc muestra lo que está disponible y omite los campos vacíos. --- # Nuevo medio de contacto: escribinos directamente desde TuRuc Categoría: Novedades URL: https://turuc.com.py/blog/novedades/medio-de-contacto/ TuRuc incorpora un formulario de contacto para consultas, soporte, reclamos y sugerencias. Ahora podés comunicarte con el equipo desde la propia página. Desde hoy TuRuc tiene un **formulario de contacto** integrado en la página principal. Si tenés alguna duda, encontraste un error, querés hacer una sugerencia o simplemente querés contarnos algo, ahora podés escribirnos directamente sin salir del sitio. ## ¿Cómo contactarnos? El formulario está disponible en la sección [Contacto](/#contact) de la página principal. Solo necesitás ingresar tu nombre, correo electrónico, el motivo de tu mensaje y el mensaje en sí. Te responderemos a la brevedad posible. ## ¿Para qué podés escribirnos? El formulario tiene las siguientes categorías de motivo: - **Consulta:** si tenés preguntas sobre cómo funciona TuRuc, cómo usar la API, o cualquier duda general. - **Soporte:** si algo no está funcionando correctamente en el sitio o la API. - **Reclamo:** si encontraste datos incorrectos, un RUC que no aparece cuando debería, o cualquier otro problema con la información. - **Sugerencia:** si tenés ideas para mejorar el servicio, nuevas funcionalidades, o feedback general. - **Otro:** para cualquier otra cosa que no encaje en las categorías anteriores. ## Antes de escribirnos Si tu pregunta es sobre **cómo reactivar tu RUC, pagar impuestos, o hacer trámites tributarios**, esas gestiones no se hacen a través de TuRuc. Somos un servicio de consulta de datos públicos, no la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home). Para esos trámites, ingresá directamente a [Marangatú](https://www.marangatú.gov.py). Si tu pregunta es sobre **por qué tu RUC no aparece** en TuRuc, revisá primero nuestra guía sobre [frecuencia de actualización de datos](/blog/datos/cuando-se-actualiza). La respuesta probablemente esté ahí. Para el resto, [escribinos](/#contact). Leemos todos los mensajes. --- # Librerías TuRuc para Python, Java y JavaScript Categoría: Novedades URL: https://turuc.com.py/blog/novedades/librerias-disponibles/ TuRuc ofrece librerías oficiales para Python, Java y JavaScript que te permiten integrar la consulta de RUC Paraguay en tus proyectos con pocas líneas. Integrar TuRuc en tus proyectos ahora es más fácil que nunca. Publicamos **librerías oficiales** para los tres lenguajes de programación más usados en Paraguay para desarrollo backend y fullstack: **Python, Java y JavaScript**. ## ¿Por qué usar las librerías en lugar de la API directamente? Podés usar la API REST de TuRuc directamente haciendo peticiones HTTP desde cualquier lenguaje. Pero las librerías te ahorran ese trabajo: ya manejan la construcción de la URL, el parseo de la respuesta JSON, los errores de red y los casos borde. En vez de escribir el cliente HTTP, escribís la lógica de negocio que realmente importa. ## Librería para Python Ideal para scripts de automatización, sistemas de procesamiento de datos, o aplicaciones Django/FastAPI. [tu-ruc-python-client en GitHub](https://github.com/ithdev/tu-ruc-python-client) También está disponible como paquete en [PyPI](https://pypi.org) para instalación con pip. ## Librería para Java Diseñada para integrarse en aplicaciones Spring Boot, sistemas ERP, o cualquier proyecto Java empresarial. El propio backend de TuRuc está construido en Spring Boot, así que la librería comparte la misma arquitectura. [tu-ruc-java-client en GitHub](https://github.com/ithdev/tu-ruc-java-client) ## Librería para JavaScript Para integrar TuRuc en aplicaciones Node.js, sistemas de facturación web, o formularios de e-commerce que necesiten validar el RUC del comprador en tiempo real. [tu-ruc-js-client en GitHub](https://github.com/ithdev/tu-ruc-js-client) ## Casos de uso comunes - **Validación de RUC en formularios:** cuando el cliente ingresa su RUC, consultás la API en tiempo real y completás automáticamente la razón social. - **Verificación antes de facturar:** antes de emitir una factura, verificás que el RUC del cliente o proveedor esté activo. - **Enriquecimiento de bases de datos:** tenés una lista de RUCs y querés agregar nombres, estados y categorías a tu base de datos. - **Sistemas POS:** al momento de la venta, el cajero ingresa el RUC y el sistema busca el nombre automáticamente. --- # Calculadora de IVA Paraguay: calculá el 10% y 5% al instante Categoría: Novedades URL: https://turuc.com.py/blog/novedades/calculadora-de-iva/ TuRuc incorpora una calculadora de IVA gratuita para Paraguay: calculá el IVA del 10% y del 5% de cualquier producto o servicio de forma rápida y sencilla. Sumamos una nueva herramienta a TuRuc: la **calculadora de IVA para Paraguay**. Podés calcular el IVA del 10% y del 5% de cualquier importe de forma rápida y gratuita, directamente desde nuestra página. ## ¿Cómo funciona? Es muy simple: ingresás el monto del producto o servicio, elegís si el IVA es del 10% (para la mayoría de bienes y servicios) o del 5% (para algunos productos de la canasta básica y servicios específicos), y la calculadora te muestra al instante: - El **monto base** (precio sin IVA) - El **monto del IVA** correspondiente - El **total con IVA** incluido También funciona en sentido inverso: si tenés el precio final con IVA incluido, podés descomponer cuánto corresponde al IVA y cuánto al precio base. ## Tasas del IVA en Paraguay En Paraguay, el Impuesto al Valor Agregado (IVA) tiene dos tasas principales: - **IVA 10%:** aplica a la mayoría de bienes y servicios. Es la tasa general. - **IVA 5%:** aplica a productos de la canasta familiar básica, medicamentos, servicios de salud, arrendamientos de inmuebles destinados a vivienda, y otros bienes específicos definidos por la Ley N° 125/91. Si tenés dudas sobre qué tasa aplica a un producto o servicio específico, te recomendamos consultar directamente con la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) o con tu contador. ## ¿Para qué sirve en la práctica? La calculadora es útil en varias situaciones cotidianas: - **Verificar el IVA de una factura** antes de aprobarla. - **Calcular el precio final** de un producto cuando el proveedor te da el precio base sin IVA. - **Desglosar el IVA incluido** en un precio para registrarlo contablemente. - **Estimaciones rápidas** de costos en presupuestos y cotizaciones. --- # Swagger UI en TuRuc: Explorá la API de forma interactiva Categoría: Novedades URL: https://turuc.com.py/blog/novedades/swagger-api-turuc/ TuRuc ahora tiene Swagger UI integrado: explorá y probá todos los endpoints de la API de RUC Paraguay de forma interactiva, sin herramientas externas. Una de las cosas que más nos pidieron desde el lanzamiento fue una forma de explorar la API sin tener que leer documentación estática. A partir de hoy, TuRuc tiene **Swagger UI integrado**. ## ¿Qué es Swagger UI? Swagger UI es una interfaz visual e interactiva que muestra todos los endpoints disponibles en una API REST. Te permite ver qué parámetros acepta cada endpoint, qué devuelve, y lo más importante: **probarlo directamente desde el navegador** sin necesidad de Postman, curl ni ninguna herramienta externa. ## ¿Cómo acceder? Podés abrir el Swagger de TuRuc desde cualquier navegador: [Abrir Swagger UI](https://docs.turuc.com.py) ## Endpoints disponibles En el Swagger vas a encontrar todos los endpoints de la API de TuRuc: - `GET /api/contribuyente/{ruc}`: consulta un RUC específico por número - `GET /api/contribuyente/search`: búsqueda por nombre o razón social (paginada) - `GET /api/contribuyente/table`: formato DataTables para integración con tablas - `GET /api/contribuyente/persona-juridica`: datos extendidos de personas jurídicas - `GET /api/contribuyente/entidad-publica`: datos de entidades públicas Para cada endpoint podés ver los parámetros que acepta, los códigos de respuesta posibles y el schema del JSON que devuelve. Y podés ejecutarlo directamente con el botón "Try it out". ## Para desarrolladores Si estás integrando TuRuc en tu sistema, el Swagger es el punto de partida ideal. También tenemos [documentación completa](https://docs.turuc.com.py) y [librerías oficiales](/blog/novedades/librerias-disponibles) para Python, Java y JavaScript. --- # Lanzamiento de TuRuc: Consulta de RUC gratis en Paraguay Categoría: Novedades URL: https://turuc.com.py/blog/novedades/inicio-de-turuc/ Lanzamos TuRuc, la herramienta gratuita para consultar el RUC de cualquier contribuyente paraguayo: casi 2 millones de registros, API y librerías oficiales. Estamos emocionados de anunciar el lanzamiento de **TuRuc**, la herramienta gratuita que permite consultar el Registro Único de Contribuyentes (RUC) de Paraguay de forma rápida y sin complicaciones. El proyecto nació de una necesidad concreta: acceder a información de contribuyentes en Paraguay era lento, engorroso y dependía de portales oficiales con interfaces poco amigables. Junto con mi compañero [Esteban Fernández](https://github.com/estebanfern), decidimos construir algo mejor. ## ¿Qué es TuRuc? [turuc.com.py](/) es un buscador público y gratuito del registro de contribuyentes de Paraguay. Permite buscar por número de RUC o por nombre/razón social y obtener en segundos el estado del contribuyente, su categoría y otros datos del registro oficial. La base de datos incluye **casi 2 millones de contribuyentes**, alimentada directamente desde los datos públicos que publica la [DNIT](https://www.dnit.gov.py/en/web/portal-institucional/home) (Dirección Nacional de Ingresos Tributarios). No requiere registro y es completamente gratuito. ## Características principales - **Búsqueda instantánea:** por número de RUC o por nombre/razón social. Los resultados aparecen en tiempo real. - **Base de datos amplia:** casi 2 millones de registros de contribuyentes paraguayos. - **API REST gratuita:** para integrar la consulta de RUC directamente en tus aplicaciones, sistemas de facturación o software de ventas. - **Librerías oficiales:** disponibles para Python, Java y JavaScript, para que la integración sea lo más sencilla posible. - **Sin registro:** no necesitás crear una cuenta ni pagar nada. ## ¿Para quién es TuRuc? Construimos TuRuc pensando en varios tipos de usuarios: - **Contadores y estudios contables** que necesitan verificar el RUC de proveedores y clientes antes de procesar facturas. - **Empresas y comercios** que quieren validar datos de contribuyentes en sus sistemas de facturación o cajas. - **Desarrolladores** que necesitan integrar la consulta de RUC en aplicaciones propias a través de la API. - **El público general** que quiere consultar su propio RUC o el de cualquier empresa. ## ¿Qué sigue? Este es solo el comienzo. Tenemos en mente varias mejoras: más datos por contribuyente, mejor soporte para personas jurídicas y entidades públicas, y una experiencia de usuario aún más pulida. Seguí el proyecto en [GitHub](https://github.com/seb5433) para enterarte de las novedades. Si encontrás algún error, tenés una sugerencia o simplemente querés saludar, podés escribirnos a través del [formulario de contacto](/#contact).