Inicio › Blog › Tiendas online
Guía · Shopify · Tiendas online · 5 min de lecturaShopify y factura electrónica DIAN en Colombia: opciones 2026
Shopify vende bien en Colombia y no sabe nada de la DIAN: no genera factura electrónica, no pide cédula ni NIT en el checkout y no conoce el IVA colombiano por línea. Si tienes una tienda Shopify, cada pedido pagado tiene que convertirse en una factura electrónica válida por otra vía. Esta guía repasa las tres formas de hacerlo, qué cuesta cada una y cómo se hace por API con miPlata FACTURAR mientras la app nativa está en lista de espera.
Lo que Shopify no hace
Shopify genera órdenes, no facturas electrónicas. Las «facturas» que puedes imprimir desde el panel o con apps de PDF no tienen CUFE, no van firmadas y no las valida la DIAN: fiscalmente no existen. Tampoco tiene campos nativos para tipo de documento del comprador (cédula, NIT, pasaporte), régimen ni responsabilidad fiscal, y su cálculo de impuestos trabaja por región, no por línea de producto con tarifas del 0 %, 5 % y 19 % como exige el XML colombiano.
Como vendedor, la obligación es tuya: cada venta a un comprador que la pida necesita factura electrónica de venta (tipo 01) y, cuando el comprador no se identifica, una factura a consumidor final (NIT 222222222222) o el documento equivalente que corresponda.
Las tres opciones
| Opción | Cómo funciona | Costo típico | Límite |
|---|---|---|---|
| App de facturación de terceros (Shopify App Store) | La app lee los pedidos y los factura bajo el Software ID del desarrollador (proveedor tecnológico) | Suscripción por app + plan del facturador | Depende del proveedor; datos en su plataforma; cambiar de app implica cambiar de proveedor |
| Software de facturación con integración Shopify (Alegra Sync y similares) | El software contable se conecta a la tienda y crea la factura por pedido | Plan del software (tope de ingresos o documentos) | Mismos topes que el plan; facturación como proveedor tecnológico |
| Integración por API con software propio (miPlata FACTURAR) | Un webhook de pedido pagado llama a la API de tu instancia; la factura sale a nombre de tu NIT con tu Software ID y certificado | Plan fijo ($29.900/mes en el de 12 meses) con 1.000 documentos de API incluidos; recargas para más | Hay que configurar el webhook (10 líneas de código o una herramienta de automatización) |
Tiendanube y WooCommerce ya tienen conector propio (guía Tiendanube, plugin WooCommerce). La app nativa de miPlata para Shopify está en lista de espera; mientras tanto, la vía es la API.
Cómo facturar Shopify con la API de miPlata
- Pide los datos fiscales en el checkout. En Shopify, añade campos de «cédula o NIT» y «tipo de documento» (por ejemplo con Checkout Extensibility, atributos del pedido o una app de campos adicionales). Si no los pides, facturarás a consumidor final: válido, pero el comprador que necesite factura a su nombre tendrá que pedírtela después.
- Crea un webhook
orders/paiden Shopify (Configuración → Notificaciones → Webhooks) hacia tu pequeño servicio (una función serverless, un Make/Zapier/n8n o un script en tu servidor). - Traduce el pedido a la factura: comprador (nombre, documento, correo, ciudad), líneas con precio sin IVA y
tax_percentpor producto, envío como línea, forma de pago contado, y el número de pedido comoorder_referenceyIdempotency-Key. - Llama a la API:
POST https://tu-nit.miplata.co/api/external/invoicesconX-API-Key. La respuesta (201) trae número, CUFE y QR, ya enviada a la DIAN (dian_statusSENToACCEPTED;QUEUEDsi la DIAN no responde y miPlata reintenta sola); si aún no estaba aceptada, el webhookinvoice.acceptedte avisa en segundos. Si Shopify reenvía el webhook con el mismoIdempotency-Keyy el mismo cuerpo dentro de 24 horas, recibes200con el encabezadoIdempotent-Replayed: truey la misma factura. Pasadas las 24 horas, el mismoorder_referenceresponde409con los datos de la factura existente. En ningún caso se duplica. - Entrega la factura al comprador: miPlata la envía al correo del cliente (PDF + XML) con el QR, o tomas
GET /invoices/{id}/pdfy la adjuntas a la notificación de Shopify. - Devoluciones: un reembolso en Shopify (
refunds/create) se convierte en nota crédito (invoice_type: "91") que referencia la factura; te avisa el webhookcredit_note.accepted.
curl -sS -X POST https://TU-EMPRESA.miplata.co/api/external/invoices \
-H "X-API-Key: TU_LLAVE" -H "Content-Type: application/json" \
-H "Idempotency-Key: shopify-1001" \
-d '{
"order_reference": "shopify-1001",
"is_consumidor_final": true,
"customer_email": "comprador@correo.co",
"customer_phone": "3001234567",
"payment_means_code": "48",
"items": [
{ "description": "Camiseta algodón talla M", "quantity": 2, "unit_price": 59000, "tax_percent": 19 },
{ "description": "Envío", "quantity": 1, "unit_price": 12000, "tax_percent": 19, "is_service": true }
]
}'
Todo esto funciona primero en Sandbox (sin consumir cupo ni validez fiscal) y pasa a Producción con un interruptor. Tutorial completo: tu primera factura por API.
Preguntas frecuentes
¿Puedo facturar a consumidor final todos los pedidos de Shopify?
Sí, cuando el comprador no se identifica. Es legal y muy común en comercio electrónico. Pero si el comprador pide factura a su nombre (es empresa, o quiere deducir), debes emitirla con sus datos; pedir cédula o NIT en el checkout evita reprocesos.
¿Los precios de Shopify incluyen IVA?
Normalmente sí (precios al público). En la factura el precio unitario va sin IVA y el impuesto por línea; tu integración divide el precio por 1,19 (o la tarifa del producto) antes de enviarlo, o lo configuras en el mapeo.
¿Y Shopify Payments, Wompi, Mercado Pago?
La pasarela no cambia nada: la factura se emite cuando el pedido está pagado, con la forma de pago contado y el medio que corresponda (tarjeta, transferencia, etc.).
¿Cuántos documentos de API necesito?
Uno por factura y uno por nota crédito. El plan de 12 meses incluye 1.000; una tienda con 150 pedidos al mes necesita recargas, que se compran por bloques sin cambiar de plan.
¿Cuándo habrá app nativa para Shopify?
Está en lista de espera; regístrate en tiendas online para que te avisemos. La integración por API que hagas hoy sigue funcionando después.
¿Necesito programador?
Para la API, alguien que pueda configurar un webhook y una llamada HTTP: un desarrollador freelance en unas horas, o una herramienta sin código (Make, n8n, Zapier) con el módulo HTTP.
Tu Shopify, tu NIT, tu factura
Mientras llega la app, un webhook de pedido pagado y una llamada a la API bastan para que cada venta en Shopify salga como factura electrónica a nombre de tu empresa.