Esta página describe la arquitectura de miPlata FACTURAR: cómo quedas habilitado ante la DIAN y con qué certificado, por dónde pasan tus datos, quién puede ver qué, cómo se protege cada capa, cómo accede soporte, cómo se respaldan tus documentos y qué recibes si decides retirarte. Es la versión técnica de la promesa «Qué vemos. Qué no.»
Cada NIT recibe su propia instancia: su propia base de datos, su propio espacio de archivos y su propia clave de cifrado. Lo único compartido es el borde que recibe el tráfico y decide, antes de despertar tu instancia, si una petición es legítima.
Quién entra
Borde
Tu instancia
Afuera
La administración de miPlata es un sistema aparte. Allí están el contrato (NIT, razón social, correo), el plan, el contador de documentos de la API y los permisos de soporte. No tiene acceso a tu instancia ni a tu clave: cuando necesita saber algo de ti, consulta un número (cuántos documentos), nunca un documento.
miPlata es una casa de software: cada empresa se habilita ante la DIAN con su propio software y su propio certificado.
La DIAN reconoce dos formas de facturar electrónicamente: a través de un proveedor tecnológico, que transmite documentos por cuenta de muchos contribuyentes, o con software propio del facturador (modalidad de desarrollo informático adquirido, Resolución 000165 de 2023, art. 28). miPlata FACTURAR usa la segunda.
En la práctica: el software queda registrado en el portal de la DIAN a nombre de tu NIT, con su propio Software ID, PIN y set de pruebas; la resolución de numeración es la tuya; y cada documento se genera, se firma y se transmite desde tu instancia directamente al servicio web de la DIAN. No hay un tercero intermedio que emita, firme o transmita por tu empresa.
miPlata (LATAMPLAY S.A.S., NIT 901.404.090-6) actúa como casa de software: desarrolla, licencia y mantiene la aplicación y la infraestructura que arriendas. Así lo define el contrato, sección 2.
Firmar XML ante la DIAN exige un certificado de firma digital emitido a nombre de la empresa. Está incluido en el plan: lo tramitamos ante una entidad de certificación digital autorizada en Colombia con los documentos que aportas al contratar (CERL vigente, RUT y cédula del representante legal), y queda a nombre de tu empresa y de su representante legal por el periodo contratado.
Verificable en todo momento. En el portal de facturación electrónica de la DIAN, la configuración de software de tu empresa muestra el software propio con el mismo Software ID que ves en tu instancia; y en cualquier XML emitido, el firmante es tu empresa.
Tu instancia construye el XML, lo firma con tu certificado y lo transmite directamente a la DIAN. miPlata no es un intermediario de tus documentos: la DIAN te ve a ti.
El documento queda firmado y en cola con una marca de contingencia; se retransmite automáticamente dentro del plazo legal de 48 horas y tus integraciones reciben el evento invoice.pending_dian y luego invoice.accepted.
El ambiente de pruebas transmite a habilitación de la DIAN con un rango de pruebas: mismo ciclo, misma firma, sin validez fiscal, sin consumir folios ni cupo del plan.
XML y acuses permanecen en tu instancia durante toda la relación y puedes exportarlos cuando quieras (Estatuto Tributario art. 632: mínimo 5 años). Son tuyos, no de miPlata.
Cada empresa tiene un correo propio por NIT. Lo que llega a ese correo se cifra con tu clave antes de guardarse; no existe un buzón central de miPlata.
Lo que tus clientes te pagan a ti corre con tus propias credenciales de pasarela, cifradas con tu clave. miPlata no participa en el flujo del dinero ni ve el detalle de tus cobros. Solo si activas el módulo opcional de pagos en línea (Sistema Pagos), recibe totales agregados por periodo para liquidar la comisión; nunca cobro por cobro.
No almacenamos claves de billeteras ni datos de tarjetas. Las credenciales de tu cuenta en la pasarela se guardan cifradas con tu clave y solo las usa tu instancia.
«No vemos tus facturas» no es una política interna: es consecuencia de dónde está cada dato y con qué clave está cifrado.
| Dato | Tú | miPlata (operación de la plataforma) | Soporte | DIAN | Pasarela |
|---|---|---|---|---|---|
| Facturas, notas, nómina — XML, PDF, CUFE, líneas | Sí | cifrado con tu clave | solo con permiso vigente | lo que tu instancia transmite | No |
| Clientes, proveedores, productos, inventario, cartera | Sí | cifrado con tu clave | solo con permiso vigente | solo los datos del adquirente en cada documento | No |
| Correos recibidos de proveedores (buzón NIT@) | Sí | se guardan cifrados al llegar | solo con permiso vigente | No | No |
| Cobros: links, estados, conciliación | Sí | solo si activas el módulo opcional de pagos en línea: totales agregados por periodo para la comisión; nunca cobro por cobro | solo con permiso vigente | No | monto, referencia y datos mínimos del pagador |
| Certificado de firma, contraseña del certificado, credenciales DIAN | instalado por nosotros; nunca se vuelve a mostrar | solo al instalarlo; después queda cifrado en tu instancia | nunca, ni con permiso | solo ve la firma resultante | No |
| Usuarios, contraseñas, claves API, credenciales de pasarela | contraseñas y claves solo como hash | No | nunca, ni con permiso | No | No |
| NIT, razón social, correo y celular del contrato, plan y pagos del plan | Sí | datos del contrato | datos del contrato | No | cuando pagas el plan |
| Contador de documentos enviados por la API | Sí | solo el número, nunca el documento | solo el número | No | No |
| Registros técnicos: errores, tiempos, accesos de operador | tu propio registro de auditoría | sin contenido de negocio | sin contenido de negocio | No | No |
«Soporte» es siempre un acceso temporal que tú apruebas (ver sección 09). Con Modo Bóveda, la columna «Soporte» solo aplica mientras tengas una sesión abierta y lo autorices.
Cada capa asume que la anterior puede fallar.
TLS en todo: navegador, API, DIAN, pasarela y correo. HSTS, política de contenido estricta, sin iframes de terceros, cabeceras de seguridad en cada respuesta, incluidas las páginas de error.
Tu empresa se identifica por el dominio, nunca por algo que un cliente pueda escribir. Verificación anti-bots en el inicio de sesión, la tienda y el pago; límites por dirección IP y por empresa; bloqueo progresivo tras intentos fallidos; los dominios desconocidos responden igual que los inexistentes (sin enumeración). Una petición sin credencial válida nunca activa tu instancia.
Una base de datos por empresa, un espacio de archivos por empresa, una clave por empresa. Tu instancia no tiene credenciales propias: cada acceso a datos pasa por el borde, que le fija tu identidad desde su registro y rechaza cualquier intento de acceder a datos de otra empresa. Sin salida a internet salvo los destinos oficiales (DIAN) y la pasarela.
El proveedor de infraestructura cifra sus discos; encima, tu instancia cifra con tu clave: cada archivo (XML, PDF, correo, certificado) y cada campo sensible de la base de datos (contenido de documentos, notas, direcciones, teléfonos, claves técnicas, IP de auditoría). El certificado de firma y las credenciales de pasarela van con una capa adicional. Nombres, NIT, montos y contenido van cifrados; los que necesitan búsqueda exacta (NIT, CUFE, cédula) llevan además un índice ciego. Solo número de documento, fechas, estado e identificadores internos quedan legibles para que la aplicación pueda ordenar y filtrar.
Tu clave no se guarda sin cifrar: está protegida con una clave maestra que solo existe dentro del software del borde, no en consolas ni visores. Leerla requeriría desplegar código, y cada despliegue, cambio de secreto o lectura directa de almacenamiento fuera del proceso automatizado genera una alerta en nuestro registro de auditoría. El acceso del personal de miPlata a la infraestructura está restringido al mínimo necesario y cada acción se registra.
Si lo activas, miPlata deja de conservar una copia de tu clave que pueda abrir. La clave queda envuelta bajo la contraseña de cada usuario (derivación lenta, cientos de miles de iteraciones) y bajo un código de recuperación de 24 palabras que se muestra una sola vez. Al iniciar sesión, la clave se abre en el borde y se divide en dos mitades: una en el almacenamiento de tu instancia, otra en una cookie de tu navegador. Ninguna mitad sirve sola.
Mientras nadie tiene sesión abierta la instancia está bloqueada: API, reintentos DIAN, cobros, correos y WhatsApp quedan en pausa y lo que llega se guarda cifrado hasta el siguiente desbloqueo. Si pierdes contraseña y código, nadie —ni miPlata— puede recuperar los datos. Ver Términos §13.
| Rol | Qué puede hacer |
|---|---|
| Administrador | Todo: operación diaria, configuración DIAN, usuarios, claves API, webhooks, privacidad, pagos y permisos de soporte. |
| Gerente | Operación diaria y configuración DIAN y de la empresa. No gestiona usuarios, claves API ni credenciales. |
| Operador | Operación diaria: facturas, nómina, contactos, productos, buzón, compras, cotizaciones, cartera y POS. Solo lectura en configuración. |
| Solo lectura | Ve lo mismo que los demás; no modifica nada salvo su propia contraseña. |
| Soporte (con tu permiso) | Rol temporal: puede corregir configuración y documentos; nunca elimina, nunca ve usuarios, claves API ni credenciales. |
Los roles se aplican dos veces: en cada función de la aplicación y en una validación general que revisa toda operación de escritura antes de llegar a la lógica de negocio. La consulta de información es igual para todos los roles de tu empresa.
Tres condiciones, todas necesarias, ninguna suficiente por sí sola. Y todo queda registrado y avisado.
Contraseñas, claves API, credenciales de pasarela, contraseña del certificado y la clave de tu instancia. Tampoco puede crear usuarios ni asignarse permisos.
Solo puedes aprobar soporte con tu sesión abierta. La clave se cede únicamente a ese permiso y se elimina con él: al revocarlo o al vencer, la instancia que soporte activó se apaga.
Acciones que podrían tomar el control de una cuenta —contraseña temporal, cambio del correo del dueño, apagar o eliminar una instancia— exigen la confirmación de un segundo operador.
Cada noche se exporta tu base de datos y tu registro de configuración; tus archivos se replican cada vez que cambian. Todo se cifra antes de salir, con una clave cuya parte privada no está en la nube.
Se generó fuera de línea y está dividida entre dos custodios. Nunca toca la nube: un acceso indebido a los respaldos obtiene solo texto cifrado. Los tres —datos, clave de respaldos y clave maestra— nunca coinciden en un mismo lugar.
Cada ejecución deja un manifiesto firmado con el hash de cada archivo, que se verifica en cada restauración. Un respaldo que no llega en 36 horas genera una alerta. Trimestralmente se hace una prueba de restauración con una instancia elegida al azar, en un ambiente de pruebas, y se registra el resultado.
Ninguna instancia se destruye sin una instantánea final exitosa; si falla, no se elimina nada. Además existe restauración a un punto en el tiempo de los últimos 30 días para errores de operación sobre una base de datos en uso.
Con Modo Bóveda el respaldo contiene tu clave envuelta: solo se restaura con tu contraseña o tu código de recuperación.
El documento se firma igual, se marca en contingencia y se retransmite con la cadencia que indica la DIAN hasta por 48 horas. Tus integraciones reciben los eventos; nada se pierde ni se duplica.
Las actualizaciones de la instancia se hacen fuera del horario laboral de Bogotá. Durante la ventana (unos minutos) las consultas por API siguen funcionando; las escrituras responden 503 con Retry-After ≤ 60 s para reintentar sin intervención.
Errores de plataforma, respaldos atrasados, accesos de emergencia a la infraestructura y fallos de entrega generan incidentes que el equipo recibe en tiempo real, sin contenido de negocio.
Sin uso, tu instancia se apaga sola y arranca en segundos cuando vuelves. Las colas (DIAN, correo, cobros) la activan solo para trabajo real. Una instancia apagada no expone superficie de ataque.
Un pago notificado mientras tu instancia está apagada se conserva cifrado (hasta 30 días) y se procesa en cuanto se activa. Las firmas inválidas se descartan en el borde.
Todo cambio pasa por pruebas automáticas (servidor, borde y aplicación) antes de poder publicarse; las publicaciones son deliberadas y auditadas, nunca automáticas al guardar código.
«Exportar todo» (Configuración → Datos personales) genera el paquete dentro de tu instancia, lo guarda cifrado en tus archivos durante 7 días y te avisa por correo (una exportación completa por día). También puedes exportar por rango de fechas o por selección en cualquier momento, sin esperar a retirarte. Formatos abiertos, sin herramientas propietarias.
| Archivo | Contenido | Formato |
|---|---|---|
| Un ZIP por año · ventas | Por cada factura, nota crédito/débito, exportación y POS: XML firmado (UBL 2.1), AttachedDocument con el acuse de la DIAN (documentos aceptados) y la representación gráfica. | XML · PDF |
| Un ZIP por año · nómina | Cada documento de nómina electrónica y sus ajustes, con su XML firmado (CUNE) y el desprendible. | XML · PDF |
| Un ZIP por año · recibidos | Facturas de proveedores recibidas en tu buzón, con el XML original y el PDF de cada una. | XML · PDF |
| Un ZIP por año · pruebas | Lo emitido en sandbox / habilitación, separado de lo fiscal. | XML · PDF |
| datos.zip | Clientes, proveedores, productos, compras y sus líneas, cartera, kardex, empleados, pagos, documentos y sus líneas, nómina y recibidos: una tabla por archivo, con encabezados, lista para Excel o para importar en otro sistema. | CSV UTF-8 |
Mientras la licencia está activa, exportas cuando quieras. Si no renuevas, la instancia pasa a vencida y durante 60 días puedes seguir ingresando, consultando, descargando y exportando todo (contrato §9). Después queda suspendida con los datos cifrados conservados y la reactivación es asistida; la supresión definitiva ocurre al cumplirse la retención, nunca antes de que hayas podido exportar.
Ley 1581 de 2012 y Decreto 1377 de 2013 (datos personales), Estatuto Tributario art. 632 y Resolución DIAN 000165 de 2023 (conservación de documentos electrónicos ≥ 5 años, a cargo del facturador). Detalle en Privacidad y Términos.
demo.miplata.co es la aplicación real, compilada con una empresa ficticia (El Convite de Mirringa S.A.S.) y datos generados en tu navegador. Misma interfaz, mismas pantallas, mismos cálculos. No se guarda nada de lo que hagas.
Todo lo demás —navegación, formularios, cálculos de IVA, retenciones y nómina, PDFs— es el mismo código que corre en una instancia real.
¿Por qué no hacemos una demostración en vivo con tu empresa antes de contratar? Porque transmitir a la DIAN —incluso al ambiente de habilitación— requiere un certificado de firma digital emitido a nombre de tu empresa y el registro de tu software propio en el portal de la DIAN. Ese certificado se compra a tu nombre y está incluido en el plan: no existe un «certificado genérico» con el que podamos firmar por ti, y hacerlo contradiría el modelo descrito arriba. Si quieres comprobar el ciclo completo con la DIAN real —factura aceptada, rechazo y corrección, nota crédito, documento soporte, nómina y contingencia—, el Plan 3 Meses es la forma de hacerlo: normalmente en menos de 24 horas hábiles tienes tu instancia habilitada con tu propio certificado y set de pruebas, y lo que emitas en sandbox no tiene validez fiscal ni consume cupo. Con gusto te acompañamos en una sesión guiada sobre tu propia instancia para recorrer cada uno de esos casos.
Escríbenos a privacidad@miplata.co. Si reportas una vulnerabilidad de forma responsable, te respondemos y te mantenemos informado hasta resolverla.
Empezar ahora