Especificaciones técnicas

02 · ¿Todo esto es posible con el API?

Requerimientos vs capacidades POSGOLD.

Cada fila cruza una necesidad del negocio con el endpoint del API que la resuelve. La respuesta corta: sí, todo lo solicitado es viable — con algunas consideraciones que detallamos.

✓ Cubierto ◐ Híbrido (web + POS) ⚠ Con limitación / polling ✕ No cubierto

Inventario y stock

Existencias actualizadas desde POSGOLD en la web.

GET /apiGold/ProductoApi/GetProduct_V6

Con parámetro ult_mov (polling diferencial cada 2–5 min). Filtro por bodegaid para la bodega web.

✓ Cubierto

Productos y detalles

Código, descripción, precio, grupo, categoría.

GET /apiGold/ProductoApi/GetProduct_V6

Paginación hasta 50.000 por llamada. Campos api/api2 para marcar "publicable en web".

✓ Cubierto

Categorías y grupos

Árbol de clasificación nativo del POS.

GET /apiGold/CategoriaAPI/GetCategoriasGrupos

Sincronización diaria suficiente (cambian poco).

✓ Cubierto

Detalles adicionales en la web

Descripciones enriquecidas, tags, destacados, SEO, orden personalizado.

DB local de la web + panel admin propio. POSGOLD es fuente de precio/stock/código; la web añade capa de enriquecimiento editorial.

◐ Híbrido

Imágenes de producto

Fotos del producto para catálogo y ficha.

GET /apiGold/ProductoManifiestoApi/GetProductoManifiestoBase64

POSGOLD expone PDFs de fichas técnicas, no imágenes de producto. Las imágenes se gestionan en la web (S3 o volumen local, asociadas por código/SKU).

⚠ Gestión en web

Creación de pedido desde la web

Compra registrada o como invitado; se crea el pedido en POSGOLD.

POST /apiGold/PedidoApi/PedidoCreateExternal

POST /apiGold/PedidoApi/PedidoCreateExternal_Anonimo

Idempotencia nativa con Id_Externo. Canal "PAGINA WEB" ya existe activo en POSGOLD.

✓ Cubierto

Cambios de estado del pedido

El cliente ve 3 estados claros: Creado → Despacho → Facturado. Internamente se reciben 5 webhooks (Terminado y Aprobado son pasos operativos invisibles al cliente).

POSGOLD envía 5 webhooks que cubren el flujo completo — la web los recibe en tiempo real, sin polling.

POST https://dyvyny.goldpos.com.co/webhook

✓ Webhooks en vivo

Estado "Facturado" → envío de factura

Cuando POSGOLD emite la factura DIAN, la web la envía al cliente por correo.

Webhook Pedido_05 notifica la transición a "Facturado"; la web consulta y descarga la factura:

GET /apiGold/FacturaApi/GetFacturaPedido

GET /apiGold/FacturaApi/GetFormatoFactura

PDF en base64. Se envía al correo del cliente en segundos tras la emisión.

✓ Cubierto

Panel de administración web

Registros, analítica, herramientas — información sincronizada.

Panel propio en la web para: gestión de contenido, imágenes, banners, cupones web, usuarios registrados, carritos abandonados, analítica de comportamiento. POSGOLD sigue siendo fuente de verdad para ventas e inventario; el panel muestra esos datos sincronizados.

◐ Híbrido

Clientes y terceros

Identificar cliente recurrente por NIT al facturar.

GET /apiGold/TerceroApi/BuscarTerceroLimite

Búsqueda por NIT, descripción o ciudad. Máximo 50 por llamada.

✓ Cubierto

✓ Confirmado (buena noticia)

POSGOLD envía webhooks para todo el ciclo del pedido. Nosotros usamos los 5 del flujo principal (Crear · Terminado · Aprobado · Despachos · Facturado) y al cliente le mostramos los 3 estados relevantes — el resto son pasos operativos internos. Todo en tiempo real, sin polling, reduciendo carga y mejorando experiencia.

Pendientes menores por confirmar con POSGOLD

· Disponibilidad de ambiente sandbox con credenciales de prueba.
· Rate limits por token / por empresa.
· TTL del JWT (duración de la sesión segura).
· Si el canal "PAGINA WEB" puede preconfigurarse como default en órdenes API.
· Firma/validación de los webhooks (cómo autenticamos que vienen de POSGOLD).

Bonus · Flujo del pedido

5 webhooks, 3 estados visibles.

POSGOLD notifica la web en cada transición. Nosotros mostramos al cliente solo lo relevante — los estados operativos internos corren en silencio. Endpoint: POST /webhook

Lo que ve el cliente

Creado

Pedido recibido. El cliente ve confirmación inmediata.

← Webhook Pedido_01

Despacho

El pedido sale de la bodega. Notificación al cliente.

← Webhook Pedido_04

Facturado

Factura DIAN emitida y enviada al correo del cliente.

← Webhook Pedido_05

Flujo técnico completo (5 webhooks)

Pedido_01

Crear pedido

Visible

Pedido_02

Creación → Terminado

Interno

Pedido_03

Terminado → Aprobado

Interno

Pedido_04

Aprobado → Despachos

Visible

Pedido_05

Despachos → Facturado

Visible · dispara factura

Los webhooks "Terminado" y "Aprobado" son pasos operativos internos de POSGOLD — los recibimos para mantener consistencia pero no generan notificación al cliente.

Ventaja técnica: al usar webhooks (vs polling), el servidor no hace llamadas constantes al API — reduce uso de red, mejora tiempos de respuesta y permite notificar al cliente del estado de su pedido casi al instante que pasa en POSGOLD.

03 · Imágenes y procesamiento

Cómo manejamos las 1.000 fotos.

Las imágenes son responsabilidad de la web (POSGOLD no las expone). Si se busca un look uniforme (producto sin fondo sobre color de marca), hay dos caminos para la remoción de fondo.

Opción A

Procesamiento propio (auto-hosteado)

Costo fijo

Modelo open-source (rembg o similar) corriendo en una instancia dedicada. Procesa lotes en segundo plano. Tarifa fija sin importar el volumen de imágenes.

·Integrado al panel de admin (botón "quitar fondo")
·Batch inicial de 1.000 fotos en una noche
·Configuración única: ~6–10 horas de trabajo
·Calidad: buena para catálogo; no perfecta para productos con cabellos finos

Sin costo mensual adicional

Corre dentro de la infraestructura ya incluida en el hospedaje.

Opción B

API externa (remove.bg / Bria)

Pago por imagen

Servicio comercial con calidad superior (detección de cabello, transparencias, joyería). Integración directa desde el panel de admin.

·Calidad consistente, sin mantenimiento
·Remove.bg: ~$0.20 USD por imagen (~$800 COP)
·Setup: ~3–5 horas de trabajo
·Procesado instantáneo (1–2 seg por imagen)

Costo mensual recurrente: ~$40.000 COP

Con ~50 fotos nuevas al mes (~$0.20 USD por imagen)

Recomendación: empezar con la Opción A (auto-hospedada) y, si la calidad no alcanza para ciertos productos delicados, migrar selectivamente a B solo en esos casos.

04 · Infraestructura

Dos escenarios de hosting.

La aplicación está pensada para correr contenerizada (Docker). Eso nos da libertad de montarla en un servidor propio o en infraestructura cloud gestionada.

Escenario A
Hospedaje gestionadoen nuestra infraestructura (Docker)
Recomendado
~$130.000
COP / mes · todo incluido (promedio de mercado)
Incluye todo lo necesario:
·Servidor dedicado para Dyvyny (Docker)
·PostgreSQL + Redis + Nginx configurados
·Cloudflare CDN + WAF (protección y velocidad)
·Certificado SSL (HTTPS) automatizado
·Backups diarios a almacenamiento remoto
·Correo transaccional (confirmaciones, facturas)
·Monitoreo de uptime 24/7
·Actualizaciones del sistema operativo
·Soporte de infraestructura
Capacidad inicial (2 vCPU · 4 GB RAM · 80 GB SSD · 4 TB/mes):
~3.000 visitas diarias
~150 órdenes / día
Crecimiento: ampliación de recursos bajo demanda
Base del precio (promedio mercado 2026):
VPS 2v/4GB/80GB (DigitalOcean, Linode, Vultr):~$100.000
Backups offsite + monitoreo + SSL + email:~$30.000
Total al cliente:~$130.000

              A favor: precio fijo en pesos, uptime monitoreado por nosotros, una sola factura,
              sin dólares fluctuando, soporte directo por WhatsApp.

              A considerar: crecimiento superior a 5.000 visitas/día requiere upgrade.
            

Escenario B
AWScuenta propia del cliente
Cloud directo
~$240–280K
COP / mes (≈ USD $60–70)
Servicios AWS (factura directa al cliente):
·EC2 t3.small — $15 USD
·RDS PostgreSQL db.t3.micro — $13 USD
·ElastiCache Redis t3.micro — $12 USD
·S3 (imágenes) + CloudFront CDN — $10–15 USD
·SES (correos transaccionales) — $1 USD
·Route 53 (DNS) — $0.50 USD
·Backups automáticos RDS — incluido
Capacidad inicial:
~5.000 visitas diarias sin problema
~200 órdenes / día con holgura
Escalamiento vertical en 1 clic

              A favor: factura directa del cliente con Amazon, máxima escalabilidad.

              A considerar: precio en USD (fluctúa con TRM), gestión de cuenta AWS a cargo del cliente, costos suben con tráfico.
            

Recomendación

Para el primer año exploratorio, el Escenario A es la apuesta más lógica: precio fijo en pesos, sin preocupaciones técnicas, nosotros gestionamos todo y respondemos por el uptime. Si en el futuro el crecimiento lo justifica, migrar a AWS (B) es un proceso directo — misma base Docker, solo cambia el hosting.

05 · Costos mensuales totales

Cuánto cuesta mantener esto prendido.

Concepto

Escenario A · Gestionado

Escenario B · AWS

Servidor / cómputo

App + API + workers

incluido

~$60.000

Base de datos

PostgreSQL

incluido

~$52.000

Cache / colas (Redis)

Reservas de stock, jobs

incluido

~$48.000

Almacenamiento imágenes + CDN

~1.000 imágenes + tráfico

incluido

~$50.000

Correo transaccional

Confirmaciones, facturas, recuperación

incluido

~$4.000

DNS + SSL + Cloudflare

Resolución de dominio, certificados, CDN

incluido

~$2.000

Backups diarios + monitoreo

Respaldo offsite, uptime 24/7

incluido

Procesado imágenes (opcional)

Auto-hosteado (A) o API externa (B) · 50 fotos/mes

incluido

+~$40.000

Total mensual infraestructura

~$130K

~$256K

Estos son costos solo de infraestructura — lo que cobran los proveedores (o nosotros en el escenario gestionado) por tener la tienda prendida cada mes. El plan de mantenimiento y el desarrollo inicial están cotizados aparte en la propuesta comercial.

Especificaciones técnicas y costos de operación.

Qué tamaño tiene esto.

Requerimientos vs capacidades POSGOLD.

5 webhooks, 3 estados visibles.

Cómo manejamos las 1.000 fotos.

Procesamiento propio (auto-hosteado)

API externa (remove.bg / Bria)

Dos escenarios de hosting.

Hospedaje gestionado

AWS

Cuánto cuesta mantener esto prendido.

Qué pasa cuando crece.

Lo que nos falta para arrancar.