---
title: ¿Cómo importar facturas de venta, devoluciones y notas débito desde un archivo XML?
description: "Importa facturas, devoluciones y notas débito desde XML en Alegra y resuelve los errores habituales: CUFE duplicado, numeración inactiva o tipo inválido."
---

[Ir directamente al contenido](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#main-content)

![colombia](https://ayuda.alegra.com/hs-fs/hubfs/colombia.png?width=60&height=60&name=colombia.png)

- [Colombia](https://ayuda.alegra.com/col)
- [México](https://ayuda.alegra.com/mex)
- [R. Dominicana](https://ayuda.alegra.com/dom)
- [Costa Rica](https://ayuda.alegra.com/cri)
- [España](https://ayuda.alegra.com/esp)
- [Panamá](https://ayuda.alegra.com/pan)
- [Perú](https://ayuda.alegra.com/per)
- [Argentina](https://ayuda.alegra.com/arg)
- [Venezuela](https://ayuda.alegra.com/ven)

Abrir navegación principal

Cerrar navegación principal

- [Colombia](https://ayuda.alegra.com/col)
- [México](https://ayuda.alegra.com/mex)
- [R. Dominicana](https://ayuda.alegra.com/dom)
- [Costa Rica](https://ayuda.alegra.com/cri)
- [España](https://ayuda.alegra.com/esp)
- [Panamá](https://ayuda.alegra.com/pan)
- [Perú](https://ayuda.alegra.com/per)
- [Argentina](https://ayuda.alegra.com/arg)
- [Venezuela](https://ayuda.alegra.com/ven)

 Hola. ¿Cómo podemos ayudarte?

- No hay sugerencias porque el campo de búsqueda está vacío.

1. [Colombia](https://ayuda.alegra.com/col?hsLang=es)
2. [Alegra Contabilidad](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es)
3. [Facturación Electrónica](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#facturaci%C3%B3n-electr%C3%B3nica)

# ¿Cómo importar facturas de venta, devoluciones y notas débito desde un archivo XML?

En [Alegra](https://www.alegra.com/colombia/contabilidad/?utm_source=help-center&utm_medium=product-marketing&utm_campaign=col-ac-como_importar_facturas_de_venta_devoluciones_y_notas_debito_desde_un_archivo_xml-tmd_pmkt) puedes **importar facturas de venta, devoluciones y notas débito emitidas en otro sistema** mediante un **archivo XML**, de forma rápida y sencilla. Esto es especialmente útil cuando **migras desde otro proveedor tecnológico**, ya que te permite **centralizar tu información y mantener el historial de tus documentos en un solo lugar**.

#### **👉 Índice**

1. [📥 ¿Cómo importar facturas de venta desde un archivo XML?](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#P1).
2. [🔁 ¿Cómo importar devoluciones en ventas desde un archivo XML?](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#P2).
3. [📄 ¿Cómo importar notas débito desde un archivo XML?](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#P3).
4. [⚠️ ¿Por qué aparece un error al importar el archivo XML?](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#P4).

### 📥 ¿Cómo importar facturas de venta desde un archivo XML?

1\. Ve a **Ingresos** \> [Facturas de venta](https://app.alegra.com/invoice?utm_source=help-center&utm_medium=product-marketing&utm_campaign=col-ac-como_importar_facturas_de_venta_devoluciones_y_notas_debito_desde_un_archivo_xml-tmd_pmkt)**\> Más Acciones \> Nueva factura desde XML**.

2\. Haz clic en **Examinar \> Selecciona el archivo XML \> Adjuntar**.

3\. Verifica y completa la información del formulario con los datos extraídos del XML.

4\. Haz clic en **Emitir** para crear la factura.

📍 El prefijo y el número deben quedar **exactamente iguales a los del XML**. Si los modificas, Alegra no corrige el documento original: emite uno nuevo con el consecutivo que escribas.

[![XML\_I](https://ayuda.alegra.com/hs-fs/hubfs/XML_I.gif?width=670&height=377&name=XML_I.gif)](https://ayuda.alegra.com/hubfs/XML_I.mp4?hsLang=es)

> 📢 **Importante:** La información del documento **debe coincidir con los datos contenidos en el XML**. Los cambios realizados en Alegra **no reemplazarán los datos originales del archivo**.

[![Arriba Índice HC](https://ayuda.alegra.com/hs-fs/hubfs/Arriba%20%C3%8Dndice%20HC.png?width=30&height=30&name=Arriba%20%C3%8Dndice%20HC.png)](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#indice)

### 🔁 ¿Cómo importar devoluciones en ventas desde un archivo XML?

1\. Ve a **Ingresos** \> [Devoluciones en ventas](https://app.alegra.com/credit-note?utm_source=help-center&utm_medium=product-marketing&utm_campaign=col-ac-como_importar_facturas_de_venta_devoluciones_y_notas_debito_desde_un_archivo_xml-tmd_pmkt) \> **Más Acciones \> Nueva devolución desde XML**.

2\. Selecciona el archivo XML y haz clic en **Ir a crearla**. Luego, verifica y completa la información del formulario.

3\. Haz clic en **Guardar** para finalizar.

[![XML\_II](https://ayuda.alegra.com/hs-fs/hubfs/XML_II.gif?width=670&height=377&name=XML_II.gif)](https://ayuda.alegra.com/hubfs/XML_II.mp4?hsLang=es)

> 📢 **Importante**
> 
> - La devolución **debe contener el nombre del cliente** para vincularla correctamente.
> - La **factura original debe existir previamente en Alegra**.
> - Debes **vincular la devolución a una factura** desde el campo **Crédito a ventas** para evitar inconsistencias contables.

Además, la información registrada debe **coincidir con los datos del XML**.

[![Arriba Índice HC](https://ayuda.alegra.com/hs-fs/hubfs/Arriba%20%C3%8Dndice%20HC.png?width=30&height=30&name=Arriba%20%C3%8Dndice%20HC.png)](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#indice)

### 📄 ¿Cómo importar notas débito desde un archivo XML?

1\. Ve a **Ingresos** \> [Notas débito](https://app.alegra.com/income-debit-note?utm_source=help-center&utm_medium=product-marketing&utm_campaign=col-ac-como_importar_facturas_de_venta_devoluciones_y_notas_debito_desde_un_archivo_xml-tmd_pmkt) **\> Más Acciones \> Nueva nota débito desde XML.**

2\. Selecciona el archivo XML y haz clic en **Ir a crearla**. Luego, verifica y completa la información del formulario.

3\. Haz clic en **Guardar** para finalizar.

[![XML\_III](https://ayuda.alegra.com/hs-fs/hubfs/XML_III.gif?width=670&height=377&name=XML_III.gif)](https://ayuda.alegra.com/hubfs/XML_III.mp4?hsLang=es)

**[![Arriba Índice HC](https://ayuda.alegra.com/hs-fs/hubfs/Arriba%20%C3%8Dndice%20HC.png?width=30&height=30&name=Arriba%20%C3%8Dndice%20HC.png)](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#indice)**

### ⚠️ ¿Por qué aparece un error al importar el archivo XML?

Alegra lee el archivo tal como lo emitió el sistema de origen y lo compara con la información de tu empresa. Cuando algo no coincide, el aviso que ves corresponde a uno de estos cinco casos:

- **«El CUFE del timbre ya se encuentra asociado a una factura de venta»**: ese documento ya existe en Alegra, porque se importó antes o porque la empresa ya lo tenía registrado. Búscalo en **Ingresos \> Facturas de venta** por número o por CUFE antes de volver a cargarlo.
- **«La venta ya está emitida»**: el XML llega validado ante la DIAN y, al hacer clic en **Emitir**, Alegra intenta emitirlo otra vez. En ese caso haz clic en **Guardar**: el documento conserva el CUFE y el estado que trae el archivo.
- **«La numeración no está activa»**: la resolución con la que se emitió el documento no está activa en tu empresa. Actívala en [numeraciones de facturación](https://ayuda.alegra.com/col/configura-tus-numeraciones-de-facturacion?utm_source=help-center&utm_medium=product-marketing&utm_campaign=col-ac-como_importar_facturas_de_venta_devoluciones_y_notas_debito_desde_un_archivo_xml-tmd_pmkt&hsLang=es) y vuelve a cargar el archivo.
- **«El tipo de operación no es válido»**: el XML declara una operación —AIU, exportación, entre otras— que no está configurada en la empresa. Importa el documento con el tipo de operación con el que se emitió, no con el que usarías para una venta nacional.
- **El archivo no es del módulo correcto**: cada documento se carga desde su propia opción. Una devolución va en **Devoluciones en ventas** y una nota débito en **Notas débito**; si la subes en **Facturas de venta**, el formulario no encuentra los datos que espera.

> 📢 **Importante**: estos avisos se refieren al contenido del archivo, no al tamaño ni al nombre. Si el XML cumple con todo lo anterior y el error continúa, compártelo con Soporte junto con el número del documento y el mensaje exacto: así se revisa si el problema está en el archivo o en la configuración de la empresa.

[![Arriba Índice HC](https://ayuda.alegra.com/hs-fs/hubfs/Arriba%20%C3%8Dndice%20HC.png?width=30&height=30&name=Arriba%20%C3%8Dndice%20HC.png)](https://ayuda.alegra.com/col/importar-facturas-devoluciones-y-notas-debito-desde-xml#indice)

**¿Aún no tienes cuenta en Alegra?**

**[![Nuevo botónes Regístrate](https://ayuda.alegra.com/hs-fs/hubfs/Knowledge%20Base%20Import/Nuevo%20bot%C3%B3nes%20Reg%C3%ADstrate.png?width=137&height=50&name=Nuevo%20bot%C3%B3nes%20Reg%C3%ADstrate.png)](https://app.alegra.com/user/register?utm_source=help-center&utm_medium=product-marketing&utm_campaign=col-ac-como_importar_facturas_de_venta_devoluciones_y_notas_debito_desde_un_archivo_xml-tmd_pmkt)**

- [Alegra Contabilidad](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#main-content)

    - [Facturación Electrónica](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#facturaci%C3%B3n-electr%C3%B3nica)
    - [Ingresos](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#ingresos)
    - [Gastos](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#gastos)
    - [Documento Soporte Electrónico](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#documento-soporte-electr%C3%B3nico)
    - [Contactos](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#contactos)
    - [Inventario](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#inventario)
    - [Bancos](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#bancos)
    - [Contabilidad](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#contabilidad)
    - [Reportes inteligentes](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#reportes-inteligentes)
    - [Configuraciones](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#configuraciones)
    - [Impuestos y Retenciones](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#impuestos-y-retenciones)
    - [Sector Salud](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#sector-salud)
    - [Información Exógena](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#informaci%C3%B3n-ex%C3%B3gena)
    - [Casos de uso](https://ayuda.alegra.com/col/alegra-contabilidad?hsLang=es#casos-de-uso)
- [Alegra Nómina](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#main-content)

    - [Nómina Electrónica](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#n%C3%B3mina-electr%C3%B3nica)
    - [Empleados](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#empleados)
    - [Configuración | Solo Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#configuraci%C3%B3n-solo-emisi%C3%B3n)
    - [Nómina Electrónica | Solo Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#n%C3%B3mina-electr%C3%B3nica-solo-emisi%C3%B3n)
    - [Empleados | Solo Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#empleados-solo-emisi%C3%B3n)
    - [Liquidación](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#liquidaci%C3%B3n)
    - [Configuración | Liquidación + Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#configuraci%C3%B3n-liquidaci%C3%B3n-emisi%C3%B3n)
    - [Nómina Electrónica | Liquidación + Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#n%C3%B3mina-electr%C3%B3nica-liquidaci%C3%B3n-emisi%C3%B3n)
    - [Empleados | Liquidación + Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#empleados-liquidaci%C3%B3n-emisi%C3%B3n)
    - [Colilla de Pago | Liquidación + Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#colilla-de-pago-liquidaci%C3%B3n-emisi%C3%B3n)
    - [Contabilización | Liquidación + Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#contabilizaci%C3%B3n-liquidaci%C3%B3n-emisi%C3%B3n)
    - [Pagos | Liquidación + Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#pagos-liquidaci%C3%B3n-emisi%C3%B3n)
    - [Reportes | Liquidación + Emisión](https://ayuda.alegra.com/col/alegra-n%C3%B3mina?hsLang=es#reportes-liquidaci%C3%B3n-emisi%C3%B3n)
- [Alegra POS](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#main-content)

    - [Facturación Electrónica](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#facturaci%C3%B3n-electr%C3%B3nica)
    - [Documento POS Electrónico](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#documento-pos-electr%C3%B3nico)
    - [Inventario](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#inventario)
    - [Ingresos](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#ingresos)
    - [Turnos](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#turnos)
    - [Gestion de efectivo](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#gestion-de-efectivo)
    - [Devoluciones](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#devoluciones)
    - [Contactos](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#contactos)
    - [Configuraciones](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#configuraciones)
    - [Integraciones](https://ayuda.alegra.com/col/alegra-pos?hsLang=es#integraciones)
- [Alegra CRM](https://ayuda.alegra.com/col/alegra-crm?hsLang=es)
- [App Móvil](https://ayuda.alegra.com/col/app-m%C3%B3vil?hsLang=es)
- [Alegra IA: Tu Asistente Inteligente](https://ayuda.alegra.com/col/alegra-ia-tu-asistente-inteligente?hsLang=es)
- [MCP](https://ayuda.alegra.com/col/mcp?hsLang=es)
- [Contabilidad Inteligente](https://ayuda.alegra.com/col/contabilidad-inteligente?hsLang=es)
- [Sector Salud](https://ayuda.alegra.com/col/sector-salud?hsLang=es)
- [Migraciones](https://ayuda.alegra.com/col/migraciones?hsLang=es)
- [Integraciones](https://ayuda.alegra.com/col/integraciones?hsLang=es)
- [Alianzas Académicas](https://ayuda.alegra.com/col/alianzas-acad%C3%A9micas?hsLang=es)
- [Te puede interesar](https://ayuda.alegra.com/col/te-puede-interesar?hsLang=es)
- [Espacio Contador](https://ayuda.alegra.com/col/espacio-contador?hsLang=es)
- [Planes y Suscripciones](https://ayuda.alegra.com/col/planes-y-suscripciones?hsLang=es)
- [Solo Facturación](https://ayuda.alegra.com/col/solo-facturaci%C3%B3n?hsLang=es)
- [Casos de uso](https://ayuda.alegra.com/col/casos-de-uso?hsLang=es)

COPYRIGHT © 2026 Soluciones Alegra S.A.S.

<https://www.facebook.com/alegraweb> <https://www.instagram.com/alegraweb/> <https://twitter.com/alegraweb> <https://www.alegra.com/>

Copyright © 2026, Alegra