Importar compras con XML del SRI en Quipuy

Si vas a registrar compras a mano cada mes, vas a perder horas. El SRI te entrega un archivo ZIP con TODOS tus comprobantes recibidos del mes — y Quipuy puede leerlo y crear las compras automáticamente con stock, IVA crédito y asiento contable.

Este tutorial te lleva desde descargar el ZIP del SRI hasta tener todas tus compras del mes registradas en Quipuy en menos de 5 minutos.

¿Qué hace el importador?

Lee los XML de tus comprobantes recibidos (facturas, NC, ND, retenciones y liquidaciones) y los convierte en registros de Quipuy:

Además:

• Crea proveedores nuevos si no existían (con RUC + razón social del XML)
• Sugiere productos si el código del proveedor coincide con tu catálogo
• Genera asientos contables automáticos si tienes el módulo de contabilidad activo
• Actualiza stock al confirmar la compra (módulo opcional)
• Conecta con el ATS mensual para que la conciliación cuadre

Antes de empezar — lo que necesitas

1. Acceso a tu portal SRI (sri.gob.ec) con clave del contribuyente
2. Empresa configurada en Quipuy con módulo purchases activo
3. (Opcional) Catálogo de productos registrado para que vincule las líneas

📌 Tip: descarga el ZIP del SRI mensualmente. Si esperas el final del año fiscal vas a procesar miles de comprobantes y el preview se demora.

Paso 1: Descarga el ZIP de comprobantes recibidos del SRI

Entra al portal SRI con tu clave y ve a Comprobantes electrónicos → Recibidos. Filtra por el mes que necesitas y click en Descargar XML.

Click para ampliar

Lo que vas a descargar:

• Un archivo .zip con los XML del mes
• Adentro hay carpetas por tipo: Facturas/, NotasCredito/, Retenciones/, etc.
• Cada XML tiene la clave de acceso de 49 dígitos como nombre

Paso 2: Ve al importador de compras en Quipuy

Desde el dashboard, Compras → Compras y click en + Importar XML.

Click para ampliar

Paso 3: Sube el ZIP o los XML

Arrastra el .zip que descargaste del SRI a la zona de drop, o click en Examinar para elegirlo desde tu computador.

Click para ampliar

Mientras se procesa (~10-30 segundos según volumen), Quipuy hace:

1. Descomprime el ZIP
2. Parsea cada XML extrayendo: emisor, número de comprobante, fecha, total, IVA, líneas
3. Cruza con tu base: si el comprobante ya existe (mismo proveedor + número), lo marca como duplicado
4. Sugiere proveedor: si el RUC del emisor está en tu base, lo vincula; si no, propone crearlo
5. Sugiere productos: si el código del proveedor coincide con un SKU tuyo, lo vincula

Paso 4: Revisa el preview

Después del análisis aparece una tabla con TODOS los comprobantes encontrados con su estado:

Click para ampliar

Códigos de color:

• 🟢 Verde: nuevo, se va a importar
• 🟡 Amarillo: duplicado en Quipuy, se omite
• 🔴 Rojo: error de validación (revisar manualmente)

Cosas que puedes ajustar antes de confirmar:

• Vincular producto manualmente: si una línea no se vinculó automáticamente, click en el dropdown y eliges del catálogo (o + Crear producto inline)
• Cambiar proveedor: si tu base ya tenía el proveedor con otro nombre/RUC similar, fusionalos
• Marcar como gasto personal: si una compra es para el dueño (no para el negocio), is_personal_expense=true evita que afecte inventario y contabilidad

Paso 5: Confirma y procesa la importación

Click en Confirmar importación. Quipuy procesa en lotes de 50 y muestra una barra de progreso.

Click para ampliar

Lo que pasa por debajo en cada compra:

1. Crea registro en purchase_documents con status CONFIRMADA
2. Crea líneas en purchase_document_lines con productos vinculados
3. Genera asiento contable según los mappings de tu empresa (DEBE: gasto + IVA crédito; HABER: proveedor o caja)
4. Si hay productos BIEN con stock asociado, genera INGRESO_COMPRA en kardex
5. Si es CRÉDITO, marca como pendiente en CxP

Paso 6: Verifica el resultado en el listado de Compras

Cuando termina la importación, te lleva al listado con los nuevos registros ya visibles.

Click para ampliar

Cosas para revisar después de importar:

• Saldo de proveedores en /dashboard/compras/cuentas-por-pagar — si tienes compras a crédito recién entradas
• Stock de productos en /dashboard/productos — debería reflejar los ingresos
• Reporte de IVA crédito — los IVAs de las compras se suman para tu declaración mensual
• Conciliación con ATS — al generar el ATS del mes, las compras deberían coincidir con el reporte del SRI

Errores comunes y cómo resolverlos

"Comprobante ya existe en Quipuy"

Marcado en amarillo en el preview. No es un error real — el importador detectó que YA tienes esa compra registrada (importada antes o creada manualmente). Se omite del proceso sin tocar nada.

"Proveedor no autorizado para emitir"

Pasa cuando el RUC del emisor está SUSPENDIDO en el SRI. Solución: revisa la compra manualmente — puede que el comprobante sea legítimo pero el proveedor esté en proceso de regularización. Si decides registrarla, marca como pendiente y consulta a tu contador.

"Producto no se vinculó automáticamente"

El código del proveedor en el XML no coincide con ningún SKU de tu catálogo. Solución: en el preview, click en el dropdown de la línea y vincula manualmente. Quipuy memoriza la asociación para futuras compras del mismo proveedor.

El asiento contable no se generó

Pasa cuando NO tienes el módulo accounting activo, o cuando faltan mappings de cuentas (qué cuenta usa para IVA crédito, qué cuenta para gasto, etc.). Solución: ve a Configuración → Mappings contables y asigna las cuentas faltantes.

Stock no se actualizó

El producto vinculado es de tipo SERVICIO (no afecta inventario). O la compra está en estado BORRADOR. Solución: confirma la compra desde su detalle si quedó en borrador.

Preguntas frecuentes

¿Cuántos XMLs puedo subir a la vez?

Sin límite duro, pero el navegador se puede atascar con más de 500 comprobantes a la vez. Si tienes muchísimos, divide el ZIP en lotes más chicos o procesa por trimestre.

¿Quipuy detecta las NC recibidas también?

Sí. El importador procesa todos los tipos: facturas, NC, ND, retenciones, liquidaciones. Cada uno genera el registro correcto en su módulo.

¿Y las facturas a CONSUMIDOR FINAL (mías) que el SRI no descarga?

Esas las emites TÚ y ya están en Quipuy. El importador es solo para las que TE EMITEN otros proveedores.

¿Puedo importar XMLs del SRI de meses anteriores?

Sí — el importador no valida fecha. Útil cuando arrancas con Quipuy a mitad de año y quieres traer el histórico para que los reportes cuadren.

¿Y si el proveedor del XML no existe en mi base?

El importador lo CREA automáticamente como tercero tipo PROVEEDOR con el RUC y razón social del XML. Después puedes editar para agregarle email, teléfono, etc.

¿Hay forma de revertir una importación?

Sí. En el detalle de cada compra hay botón Anular (revierte stock, contabilidad y CxP). Útil cuando importaste por error o el comprobante venía duplicado en el ZIP del SRI.

Conclusión

Con la importación masiva, registrar compras deja de ser una tarea — pasa a ser 5 minutos al mes. El siguiente paso lógico es generar el ATS donde el SRI compara TU declaración con la suya.

Próximos tutoriales:

• Liquidaciones de compra al exterior — para Vercel, Apple, Meta, Anthropic, etc.
• Cuentas por cobrar y plan de cuotas — el otro lado del flujo de caja
• ATS mensual: generar y presentar al SRI — la conciliación final

¿El importador no procesó algún XML? Mándanos a soporte@quipuy.com el ZIP y el comprobante específico, y lo revisamos.

💼 ¿Aún no tienes cuenta? Empieza gratis e importa todas tus compras del SRI hoy mismo.