Descripción
miPlata FACTURAR conecta su tienda WooCommerce con su cuenta de facturación electrónica en miPlata y emite una factura electrónica validada por la DIAN (Colombia) para cada pedido pagado, sin pasos manuales.
- Factura al pagar. Cuando un pedido pasa a Procesando o Completado, el plugin lo registra en miPlata con los datos nativos de WooCommerce (líneas, cupones, envío, cargos, impuestos, comprador). miPlata arma y firma la factura UBL 2.1 y la DIAN la valida.
- Pagos WAVA verificados. Si cobra con el plugin oficial de WAVA (Nequi, tarjetas, PSE), la factura solo se emite cuando WAVA confirma el pago a miPlata: un pedido sin pagar nunca se factura.
- PayPal en moneda extranjera. Los pedidos en USD, EUR, GBP, CAD, CHF, MXN o JPY se facturan en su moneda con la tasa de cambio oficial del día (TRM).
- El correo de su tienda. La factura (PDF + XML firmado) va adjunta a su propio correo de WooCommerce, con su plantilla y su logo. El comprador también puede abrirla con un clic en Mi cuenta Ver factura y en la página de pedido recibido.
- Las devoluciones se vuelven notas crédito. Un reembolso total o parcial emite la nota crédito DIAN correspondiente.
- Un solo campo nuevo. Tipo y número de documento del comprador, y solo si ningún otro plugin ya los pide. Opcionalmente, la ciudad como lista desplegable DANE departamento municipio.
- Optional miPlata gateways. “Pay with WAVA” and “Pay with PayPal (miPlata)” for merchants who prefer not to install another payment plugin.
- Compatible con HPOS y los bloques de Carrito/Finalizar compra.
Las pantallas de administración y los textos para el comprador están en español (Colombia), el idioma de sus usuarios.
Requisitos
- Una cuenta miPlata con facturación electrónica habilitada (DIAN pruebas o producción). Regístrese en miplata.co.
- WooCommerce 7.9 o posterior, PHP 7.4 o posterior. Se recomienda la extensión sodium de PHP (si falta, se usa sodium_compat incluido en WordPress).
- La tienda debe ser accesible por HTTPS en su dominio público (se usa una vez para verificar la propiedad del dominio al conectar).
Seguridad
- La tienda se conecta con un código de un solo uso generado por un administrador en miPlata y ligado al dominio de la tienda. miPlata nunca le pedirá ese código.
- Cada solicitud se firma con una clave Ed25519 generada en su servidor; miPlata solo guarda la clave pública. Las claves se cifran en reposo con libsodium (
MIPLATA_ENCRYPTION_KEYenwp-config.php) y se borran al desinstalar. - La conexión solo puede crear facturas de sus propios pedidos y leer esas facturas; no tiene acceso a otros clientes, a la nómina ni a otros documentos de su cuenta miPlata.
Servicios externos
Este plugin es un cliente del servicio de facturación electrónica miPlata, operado por miPlata SAS (Colombia). No se envía nada antes de que un administrador conecte la tienda con un código de conexión generado en su cuenta miPlata (consentimiento explícito). Después, el plugin solo se comunica con el host de su propia cuenta https://<su-cuenta>.miplata.co:
- Cuando un pedido se paga (estado Procesando / Completado): envía las líneas del pedido, totales, moneda, medio de pago y los datos de facturación del comprador (nombre, tipo y número de documento, correo, teléfono, dirección) para que miPlata emita la factura electrónica.
- Mientras se emite la factura: consulta su estado y descarga el PDF y el XML firmado para adjuntarlos al correo del pedido y mostrarlos al comprador.
- Cuando se reembolsa un pedido facturado (total o parcial): solicita la nota crédito correspondiente (valor y motivo). Un pedido cancelado o reembolsado por completo antes de facturarse se retira, de modo que no se emite factura.
- Una vez al día: reporta un diagnóstico sin datos personales (versiones del plugin, de PHP y de WooCommerce; si WP-Cron, un plugin SMTP y el plugin de WAVA están activos).
miPlata también llama a su sitio: una vez, al conectar, un GET a /wp-json/miplata/v1/connect-key (solo la clave pública) para verificar que usted controla el dominio, y luego webhooks firmados a /wp-json/miplata/v1/webhook con el estado de cada factura.
- Términos del servicio: https://facturar.miplata.co/terminos
- Política de privacidad: https://facturar.miplata.co/privacidad
Las facturas las valida la autoridad tributaria de Colombia (DIAN); miPlata las transmite en su nombre como su proveedor de facturación electrónica. El comprador puede verificar cualquier factura en https://catalogo-vpfe.dian.gov.co/User/SearchDocument.
Capturas





Instalación
- Instale y active el plugin (WooCommerce debe estar activo).
- Recomendado: agregue
define( 'MIPLATA_ENCRYPTION_KEY', '<64 caracteres hexadecimales aleatorios>' );awp-config.php. - En miPlata: Configuración Integraciones Conectar tienda WooCommerce, escriba el dominio de su tienda y copie el código (válido 10 minutos, un solo uso).
- En WooCommerce miPlata, pegue el código y haga clic en Conectar tienda.
- Revise los ajustes: cómo se envía la factura, clases de impuesto de WooCommerce impuestos DIAN y el campo de documento del comprador.
Preguntas frecuentes
-
¿Necesito una cuenta miPlata?
-
Sí. miPlata es el proveedor de facturación electrónica que firma las facturas y las envía a la DIAN. El plugin no hace nada hasta que se conecta a una cuenta.
-
¿Necesito el plugin de WAVA?
-
No. Si cobra con WAVA, use su plugin oficial; miPlata verifica cada pago de WAVA antes de facturar. Si no, se facturan los pedidos pagados con cualquier medio de pago, o puede activar las pasarelas opcionales de miPlata.
-
¿Qué pasa si el comprador no ingresa su número de documento?
-
Depende de la política configurada en miPlata para esta conexión: facturar a consumidor final, enviar al comprador un enlace para completar sus datos o dejar el pedido en espera.
-
¿Dónde se guardan las facturas?
-
In miPlata (5 years, as the DIAN requires) and a private copy on your server for the “View invoice” button, in a non-guessable folder under uploads (direct access denied on Apache). The plugin serves them only to the order owner, a store manager, or a guest holding the order key.
-
¿Puedo probar sin emitir facturas reales?
-
Sí. Una cuenta miPlata en el ambiente de pruebas de la DIAN (habilitación) emite facturas con numeración de prueba que nunca se reportan como reales.
-
¿Hay soporte?
-
Sí: hola@miplata.co, o la sección de soporte de su cuenta miPlata.
Reseñas
No hay reseñas para este plugin.
Colaboradores y desarrolladores
Este software es de código abierto. Las siguientes personas han contribuido a este plugin.
ColaboradoresTraduce “miPlata FACTURAR” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.0.3
- Los avisos de administración solo aparecen en la página de miPlata, la pantalla de Plugins y las pantallas de pedidos de WooCommerce.
- Los errores de acceso a documentos usan la página de error estándar de WordPress (sin estilos en línea).
- Se quitó una inclusión innecesaria del núcleo.
1.0.2
- Plugin name is now “miPlata FACTURAR” (the product name).
- El dominio de texto ahora es
miplata, el slug del plugin en WordPress.org, para que las traducciones se carguen desde los paquetes de idioma de WordPress.org. - La desinstalación usa un marcador de identificador para la tabla de metadatos HPOS.
1.0.1
- Corrección: la conexión ya no falla en servidores sin la extensión sodium de PHP (sodium_compat de WordPress no puede borrar la memoria; el plugin ahora lo maneja sin errores).
- La pantalla del pedido muestra el número de la nota crédito recibido en el webhook firmado.
- Probado con WordPress 7.1 y WooCommerce 11.1.
- readme en inglés (requisito de WordPress.org).
1.0.0
- First release: pairing by code, automatic invoicing, WAVA payment verification, PayPal in foreign currency, e-mail with PDF + XML, “View invoice” in My account, credit notes on refunds, optional gateways.
