About this plugin
miPlata FACTURAR connects your WooCommerce store to your electronic-invoicing account at miPlata and issues a DIAN-validated electronic invoice ( factura electrónica, Colombia) for every paid order — no manual steps.
- Invoice on payment. When an order moves to Processing or Completed, the plugin registers it with miPlata using native WooCommerce data (lines, coupons, shipping, fees, taxes, buyer). miPlata builds and signs the UBL 2.1 invoice and the DIAN validates it.
- WAVA payments verified. If you take payments with the official WAVA plugin (Nequi, cards, PSE), the invoice is only issued once WAVA confirms the payment to miPlata: an unpaid order is never invoiced.
- PayPal in foreign currency. Orders in USD, EUR, GBP, CAD, CHF, MXN or JPY are invoiced in their currency with the day’s official exchange rate (TRM).
- Your store’s e-mail. The invoice (PDF + signed XML) is attached to your own WooCommerce e-mail, with your template and logo. The buyer can also open it with one click in My account → View invoice and on the order-received page.
- Refunds become credit notes. A full or partial refund issues the matching DIAN credit note ( nota crédito ).
- Only one new field. Buyer ID type and number — and only if no other plugin already asks for them. Optionally, the city as a DANE department → municipality dropdown.
- Optional miPlata gateways. “Pay with WAVA” and “Pay with PayPal (miPlata)” for merchants who prefer not to install another payment plugin.
- HPOS and Cart/Checkout blocks compatible.
The plugin’s admin screens and buyer-facing texts are in Spanish (Colombia), the language of its users.
Requirements
- A miPlata account with electronic invoicing enabled (DIAN test or production). Sign up at miplata.co.
- WooCommerce 7.9 or later, PHP 7.4 or later. The PHP sodium extension is recommended (WordPress’ bundled sodium_compat is used as a fallback).
- The store must be reachable over HTTPS on its public domain (used once to verify domain ownership when connecting).
Security
- The store is connected with a single-use code generated by an administrator in miPlata and bound to the store’s domain. miPlata will never ask you for that code.
- Every request is signed with an Ed25519 key generated on your server; miPlata only stores the public key. Keys are encrypted at rest with libsodium ( MIPLATA_ENCRYPTION_KEY in wp-config.php ) and wiped on uninstall.
- The connection can only create invoices for its own orders and read those invoices; it has no access to other customers, payroll or other documents in your miPlata account.
External services
This plugin is a client for the miPlata electronic-invoicing service, operated by miPlata SAS (Colombia). Nothing is sent before an administrator connects the store with a pairing code generated in their miPlata account (explicit opt-in). co:
- When an order is paid (status Processing / Completed ): it sends the order lines, totals, currency, payment method and the buyer’s billing data (name, ID type and number, e-mail, phone, address) so miPlata can issue the electronic invoice.
- While the invoice is being issued: it reads the invoice status and downloads the signed PDF and XML to attach them to the order e-mail and show them to the buyer.
- When an invoiced order is refunded (full or partial): it requests the corresponding credit note (amount and reason). An order cancelled or fully refunded before it was invoiced is withdrawn instead, so no invoice is issued.
- Once a day: it reports a diagnostic without personal data (plugin, PHP and WooCommerce versions; whether WP-Cron, an SMTP plugin and the WAVA plugin are active).
miPlata also calls your site: once, at connection time, a GET to /wp-json/miplata/v1/connect-key (public key only) to verify you control the domain, and afterwards signed webhooks to /wp-json/miplata/v1/webhook with each invoice’s status.
- Terms of service: https://facturar.miplata.co/terminos
- Privacy policy: https://facturar.miplata.co/privacidad
Invoices are validated by the Colombian tax authority (DIAN); miPlata transmits them on your behalf as your electronic-invoicing provider. co/User/SearchDocument.