Si vendes por internet en Colombia, cada pedido pagado debe convertirse en una factura electrónica de venta válida ante la DIAN. Hacerlo a mano (copiar datos del pedido a una plataforma de facturación) no escala cuando recibes decenas o cientos de ventas al día. La solución es integrar tu e-commerce con la facturación electrónica para que el proceso ocurra solo: tu tienda emite el pedido, una API genera la factura, la firma, la valida ante la DIAN y la envía al cliente, todo en segundos.
Esta integración funciona igual sin importar la plataforma que uses: Shopify, WooCommerce, VTEX, Magento o una tienda propia desarrollada a la medida. El punto en común es que tu plataforma debe poder avisarle al facturador cada vez que una venta se confirma, y el facturador debe poder devolverle a tu cliente la factura legal. A continuación verás cómo encaja cada pieza y cómo Gestiova lo resuelve con una sola integración. Automatiza tus ventas respetando el anexo técnico DIAN.
El flujo automático: de la venta a la factura en segundos
Cuando un comprador confirma el pago en tu tienda, se dispara una cadena de eventos que termina con la factura legal en su correo. Este es el flujo de integración entre tu e-commerce y la facturación electrónica:
Venta confirmada
El cliente completa el checkout y la pasarela de pagos confirma la transacción. Tu plataforma (Shopify, WooCommerce, VTEX, Magento o tienda propia) marca el pedido como pagado.
Webhook a la API
Un webhook envía los datos del pedido (ítems, valores, impuestos y datos del comprador) en formato JSON a la API de Documentos Electrónicos de Gestiova mediante una petición REST.
Generación del XML
La API construye internamente el XML del documento según el anexo técnico de la DIAN, con todos los campos obligatorios: NIT emisor, identificación del comprador, ítems, IVA y totales.
Firma y envío a la DIAN
El XML se firma con el certificado digital del emisor, se calcula el CUFE y se transmite a los servicios web de la DIAN, que valida y timbra el documento.
Correo al cliente
Una vez aceptada por la DIAN, la factura se envía al comprador por correo electrónico con el XML timbrado y el PDF de representación gráfica adjuntos.
Respuesta a tu tienda
La API devuelve a tu plataforma el estado DIAN, el número de factura y los binarios del XML y PDF, para que guardes la referencia junto al pedido.
Todo este recorrido sucede de forma asíncrona y automática: tu equipo no copia datos ni entra a ninguna plataforma adicional. El cliente recibe su factura legal minutos después de comprar, lo que mejora la experiencia y evita reclamos de quienes necesitan la factura para sus deducciones.
Integración por API o por plugins: ¿cuál te conviene?
Existen dos caminos para conectar tu tienda con la facturación electrónica, y la elección depende de tu plataforma y de tu equipo técnico:
Integración directa por API REST
Es la opción más flexible y la recomendada para tiendas propias, arquitecturas headless o cuando ya tienes un backend que orquesta los pedidos. Tu desarrollador conecta la API REST de Gestiova: configura los webhooks de tu plataforma para que, al confirmarse un pago, se envíe el payload del pedido a un endpoint, y guarda la respuesta con el número de factura. Esta vía te da control total sobre cuándo y cómo se factura cada venta.
Integración por conectores y webhooks
Plataformas como WooCommerce, Shopify, VTEX y Magento exponen eventos y webhooks nativos (por ejemplo "pedido pagado" o "pedido completado") que se pueden enrutar hacia la API sin necesidad de un desarrollo grande. En estos casos se configura el evento de la plataforma para que dispare la facturación, mapeando los campos del pedido a los que exige la DIAN. Es la vía más rápida para tiendas estándar que no quieren mantener código propio.
Datos del comprador: el punto crítico de la automatización
El mayor reto al automatizar la facturación de un e-commerce no es técnico sino de captura de datos. La DIAN exige identificar al adquirente, así que tu checkout debe recoger la información fiscal del cliente para que la factura salga completa:
- Tipo y número de documento: cédula de ciudadanía, NIT o RUT para empresas y consumidor final cuando no se identifica al comprador.
- Nombre o razón social tal como figura en el RUT del cliente cuando es responsable del IVA.
- Correo electrónico, indispensable porque es el canal por el que se entrega el XML y el PDF.
- Ciudad y dirección fiscal, requeridas para clientes empresariales y para algunos tipos de operación.
La recomendación es añadir un campo opcional en el checkout para que quien necesite factura con datos completos ingrese su documento y razón social. Si el cliente no los entrega, la venta se factura como consumidor final con los valores genéricos que admite la normativa DIAN vigente, sin frenar la operación.
Devoluciones y cambios: notas crédito automáticas
En el comercio electrónico las devoluciones son parte del negocio, y cada reembolso debe reflejarse fiscalmente con una nota crédito electrónica que referencia la factura original. Si un cliente devuelve un producto o cancela parte de su pedido, no se "borra" la factura: se emite un documento de ajuste que anula total o parcialmente su valor.
Con la API de Gestiova esto también se automatiza. Cuando tu plataforma registra una devolución o un reembolso, basta enviar el identificador de la factura original y los ítems devueltos; el sistema genera la nota crédito, la firma, la valida ante la DIAN y la envía al cliente. Así tu contabilidad y tu inventario quedan consistentes sin trabajo manual ni riesgo de descuadres con la DIAN.
La API de Documentos Electrónicos de Gestiova
El corazón de toda esta automatización es la API REST de Documentos Electrónicos de Gestiova, diseñada para que cualquier plataforma de e-commerce facture ante la DIAN con una sola integración. Estos son los tipos de documento que tu tienda puede emitir de forma automática:
La API recibe el payload del pedido en formato JSON, se autentica mediante token Bearer y se encarga internamente de construir el XML según el anexo técnico, firmarlo, enviarlo a la DIAN y devolver el XML timbrado y el PDF de representación gráfica en una sola llamada. El tiempo medio de respuesta en condiciones normales de la DIAN es inferior a 10 segundos.
Características que facilitan tu integración
- Autenticación mediante token Bearer con renovación automática.
- Payload en JSON sencillo: envías los datos del pedido, no el XML completo.
- Respuesta estructurada con estado DIAN, número de factura, errores detallados y el XML y PDF en Base64.
- Webhook opcional para notificar a tu tienda cambios de estado asíncronos.
- Modo habilitación (pruebas) y producción en el mismo contrato para integrar sin riesgo.
- Generación de notas crédito referenciando la factura original para devoluciones.
Gestiova actúa como intermediario tecnológico ante la DIAN: tu empresa mantiene su NIT habilitado y nosotros gestionamos la firma, la transmisión y el seguimiento de respuestas. El servicio de API se contrata por cotización, según el volumen de documentos mensual, y ofrecemos acompañamiento técnico durante toda la integración para dejar tu tienda facturando antes de pasar a producción.
Preguntas frecuentes sobre facturar desde tu tienda online
Gestiova S.A.S — Cali, Colombia
¿Quieres que tu tienda online facture sola a la DIAN?
Cuéntanos qué plataforma de e-commerce usas y el volumen de ventas que manejas. Te respondemos con una propuesta concreta para automatizar tu facturación electrónica, sin compromiso.