Pattern · Comprobante PDF

Comprobante de operación — plantilla PDF

No es una pantalla: es la plantilla del documento PDF que descarga el botón "Comprobante" del detalle de transacción (endpoint GET /v1/transactions/{id}/receipt). Formato carta, pensado para compartir e imprimir. Marca sobria, datos completos de la operación con desglose de comisión + IVA, datos del titular y pie legal de MICAPI S.A.S. Coherente con el detalle de tx y con la regla de transparencia §3.4.

PDF · formato carta GET /v1/transactions/{id}/receipt desglose comisión + IVA + tasa pie legal MICAPI S.A.S. · NIT sin dark — documento impreso
Plantilla anotada · compra completada

Documento de una página. Sin color de relleno salvo el pill de estado — imprime bien en blanco y negro. Tipografía del sistema: Inter para labels, JetBrains Mono para todos los valores.

marca + razón social
tipo + estado + fecha
operación · valores mono
desglose de costos · §3.4
titular
pie legal · NIT + contacto
MiCapiComprobante de operación
ID de operación
TX-2026-0847213

Compra de Bitcoin

5 de julio de 2026 · 14:32:08 (GMT-5, Bogotá)
COMPLETADA
Operación
Pagaste$500.000 COP
Recibiste0,00109 BTC
Tasa aplicada1 BTC = $458.320.000 COP
Acreditado aBilletera MiCapi
Desglose de costos
Monto de la operación$492.610 COP
Comisión MiCapi (1,26%)$6.210 COP
IVA sobre comisión (19%)$1.180 COP
Total pagado$500.000 COP
Titular
NombreLaura Méndez Rojas
DocumentoC.C. ***.***.892
Cuenta MiCapi+57 ******1658
MICAPI S.A.S. · NIT 901.XXX.XXX-X · Proveedor de Servicios de Activos Virtuales (PSAV) · Villavicencio, Colombia
soporte@micapi.com · micapi.com · Los criptoactivos no son moneda de curso legal en Colombia y su valor puede fluctuar. Este comprobante certifica la operación descrita y no constituye asesoría de inversión. Documento generado electrónicamente — válido sin firma.

Anatomía

  1. Cabecera de marcaWordmark en primary.700 (imprime como gris oscuro en B/N) + subtítulo del documento. Regla inferior de 2px como única línea fuerte. Derecha: ID de operación mono — el dato de referencia para soporte.
  2. Tipo + estado + fechaTítulo humano ("Compra de Bitcoin"), timestamp completo con zona horaria, y estado en pill semántico. Estados posibles: completada (success), pendiente (neutral), en revisión (warning — sin motivo, línea roja SAGRILAFT), fallida/devuelta (error).
  3. Bloque operaciónVocabulario del puente: Pagaste / Recibiste / Tasa. Todos los valores en mono tabular; BTC con 8 decimales, COP formato es-CO.
  4. Desglose completoMonto + comisión (con %) + IVA (19%) + total — la transparencia de §3.4 en papel: aquí el desglose sí es inline y completo, porque el comprobante es el registro contable.
  5. Titular con PII mínimaNombre completo (necesario contablemente) pero documento y celular enmascarados — el PDF se comparte por WhatsApp con contadores y terceros.
  6. Pie legal fijoRazón social, NIT, condición PSAV, ciudad, contacto y el disclaimer de volatilidad. Texto plantilla firmada por legal — el cliente no lo compone.
Variante · retiro cripto con hash

Cuando la operación es on-chain, el comprobante añade el bloque Red: dirección de destino completa (agrupada en bloques de 4, extremos resaltados — §4.15) y hash de la transacción. El PDF nunca trunca ni la dirección ni el hash.

Retiro cripto · bloque red
MiCapiComprobante de operación
ID de operación
TX-2026-0851004

Retiro de Bitcoin a wallet externa

7 de julio de 2026 · 09:15:42 (GMT-5, Bogotá)
CONFIRMADA ON-CHAIN
Operación
Enviaste0,00412 BTC
Equivalencia referencial≈ $1.888.278 COP
Comisión de red0,00002 BTC
Red · Bitcoin
Dirección de destino
bc1q xw4f 6kzd 5hml 9t2v 8rqe 03ua 7jn5 c4dk h2vw
Hash de la transacción
7a91 f0c3 88de 41b2 a6f5 0e97 3cd2 519b 84e0 cc1a f273 6d08 9b4e 52a1 d7f3 08e6
MICAPI S.A.S. · NIT 901.XXX.XXX-X · PSAV · Villavicencio, Colombia · soporte@micapi.com
Las transacciones en redes de criptoactivos son irreversibles. Verifica siempre la dirección de destino.

Reglas por tipo de operación

  1. Compra / ventaBloques: operación + desglose (comisión + IVA) + titular. La venta añade la cuenta bancaria de destino (banco + últimos 4).
  2. Swap"Entregaste / Recibiste" con ambos activos + tasa del par + desglose. Sin bloque de red (interno).
  3. Retiro / depósito criptoAñade bloque Red con dirección completa (§4.15: bloques de 4, extremos en bold) y hash. La equivalencia COP va marcada "referencial" — coherente con el hero del retiro.
  4. En revisiónEl comprobante existe también para operaciones en revisión: estado warning, sin motivo (línea roja SAGRILAFT), y nota "El resultado se te informará en la app."
  5. Sin dark modeEs un documento para imprimir/compartir — una sola variante clara, verificada en escala de grises.

Coherencia con el detalle de tx. El comprobante presenta exactamente los mismos valores que muestra el detalle de transacción en la app — misma tasa, mismo desglose, mismos labels del vocabulario (§4.1 del puente). Si el detalle y el PDF difieren, es un bug de datos, no de plantilla. El PDF del export multi-operación (A11) reusa esta cabecera y este pie.

Notas de implementación · Flutter

Generación server-side + entrega

Server-side

El PDF lo genera el backend (GET /v1/transactions/{id}/receipt → application/pdf) — fuente única de verdad contable, mismos datos que el detalle. El cliente nunca compone montos.

Entrega en app

Botón "Comprobante" del detalle: descarga con dio a caché temporal → share_plus abre el share sheet del SO (WhatsApp, correo, guardar). Estados del botón: normal → "Generando…" (spinner inline) → share sheet.

Tipografías embebidas

Inter + JetBrains Mono subset embebidas en el PDF — el documento se ve igual en cualquier visor. Tamaño objetivo < 120 KB.

Nombre de archivo

micapi_comprobante_TX-2026-0847213.pdf — el ID en el nombre facilita adjuntarlo a un PQRS (A8) o enviarlo a soporte.

Enmascarado

Documento y celular se enmascaran server-side. El nombre va completo por requisito contable; nunca dirección de residencia ni correo.

Verificación

El pie puede llevar URL de verificación micapi.com/v/{token} (post-MVP) para validar autenticidad del comprobante ante terceros.