SigFilasWeb
Y SOLUCIONES TECNOLÓGICAS S.A.S.
Especificación de Integración RemiWEB – GK API (V1)
Flujos de Impresión de Documentos · SUPERTIENDAS Y DROGUERÍAS OLÍMPICA S.A.
📄 CAR – 442co
v1.0
📅 25-05-2026
✅ Aprobado
Identificación del Documento
📋 Metadatos
| ID Documento | CAR – 442co |
| Versión | 1.0 |
| Fecha Creación | 25-05-2026 |
| Fecha Aprobación | 25-05-2026 |
| Responsable SFW | John Bravo |
| Responsable Olímpica | Roberto Carlos Campy |
| Destinatario | Ing. Doris Cadena |
| Páginas | 13 |
🎯 Objetivo
Consolidar la arquitectura, reglas de negocio, distribución de responsabilidades y estructuras JSON para la integración entre el sistema de convenios RemiWEB (Olímpica) y la API de impresión y control fiscal de GK.
Esta versión agrega datos del adquiriente, estandariza identificadores de prueba real, renombra nodos de liquidación y detalla flujos de excepción y contingencia.
FE Electrónica
Contingencia Fiscal
Remisión
Pendientes
Matriz de Responsabilidad de Datos
| Bloque de Información | Campos Clave | Responsable | Observación |
|---|---|---|---|
| Datos Empresa Fijos | Razón Social, NIT (890101487-3), Admin/Tel, Dirección, Régimen Fiscal, Res. DIAN | GK | Preconfigurados localmente en GK por caja. No viajan en el payload. |
| Textos Fiscales Estáticos | Texto Fiscal 2 (RemiWEB software de facturación in house…) | GK | Administrado en almacenamiento local de GK. |
| Datos Transaccionales de Atención | Nro. Transacción, Nro. Remisión, Código/Nombre Cajero, Código/Nombre Negocio, Lo atendió, Fecha/Hora | RemiWEB | Debe ser idéntico en FE, Remisiones y Pendientes para auditoría. |
| Datos Liquidación y Cálculos (Fiscal) | Subtotales, Totales, Copago, Convenio, Total artículos, Líneas, Descuentos, Totales UM | RemiWEB | GK NO calcula en bloque fiscal. Nodo renombrado: datos_copago. |
| Cálculos Operativos (Remisión) | Cambio (dinero a devolver al usuario) | GK calcula | GK calcula diferencia efectivo recibido vs pago_usuario. Campos credito y pago_usuario van fuera del array productos. |
| Detalle de Impuestos IVA | Tipo (%), Compra (IVA incluido), Base/Imp, Impto (valor neto IVA) | RemiWEB | Desglose tributario calculado por RemiWEB. |
| Datos del Adquiriente / Beneficiario | Tipo ID, Número ID, Nombre, Correo Electrónico, Dirección, Teléfono | RemiWEB | Mapeo ampliado del cliente institucional o paciente. Requerido por DIAN. |
Documentos que genera el sistema
🧾 Factura Electrónica (FE)
- Tipo:
EMITIR_FACTURA_ELECTRONICA - Producto: "COPAGO REMISION: [Nro]"
- Código fijo:
8888888 - Cantidad fija: 1
- Incluye datos adquiriente completos (DIAN)
- Desglose IVA por RemiWEB
📄 Factura Contingencia (FC)
- Tipo:
EMITIR_FACTURA_CONTINGENCIA - Se activa si FE falla (Escenario A) o internamente (Escenario B)
- Mismo producto consolidado de recaudo
- GK asigna consecutivo PAPF-XXXXXX
- Campo
tipo_aprobado: "FC"
🖨️ Tirilla Remisión
- Tipo:
IMPRESION_REMISION - Lista medicamentos reales con cantidades
- Incluye datos convenio, beneficiario, diagnósticos
- GK calcula el CAMBIO
imprimir_valores_tirilla_beneficiario: configurable
⏳ Tirilla Pendientes
- Tipo:
IMPRESION_PENDIENTES - Solo en generación o entrega de saldos pendientes
- Balance: recetada / entregada / pendiente
- Forma dispensación por ítem
- Incluye datos de entrega domiciliaria
⚠️ Errores Tipificados
GK-504: Timeout DIAN / rechazo operadorGK-E102: Falla hardware impresoraGK-E400: Error validación payload DIANGK-200: Éxito (FE o FC)
🔑 Parámetros de Prueba Real
- Cajero:
CAJ-001 - Negocio:
STO410 - Tienda: Droguería Olímpica Calle 72
- NIT Olímpica:
890101487-3 - Proveedor tecnológico: Carvajal
Flujos de Facturación Electrónica y Contingencia Fiscal
🔷 Escenario A — Control Descentralizado (RemiWEB Orquesta)
🔶 Escenario B — Gestión Autónoma por GK (Caja Negra)
Comparativa de Escenarios
🔷 Escenario A — RemiWEB orquesta
- RemiWEB envía
EMITIR_FACTURA_ELECTRONICA - Si GK recibe
GK-504→ RemiWEB registra fallo en BD - RemiWEB envía un segundo request
EMITIR_FACTURA_CONTINGENCIA - Ventaja: Trazabilidad total en backend Olímpica, control nativo de cada intento y reintento
🔶 Escenario B — GK autónomo
- RemiWEB envía un único
EMITIR_FACTURA_ELECTRONICA - GK conmuta internamente si el canal principal falla
- GK responde con
tipo_aprobado: "FE"o"FC" - Ventaja: Simplicidad para RemiWEB — una sola llamada, respuesta unificada
Flujo de Impresión de Remisión Operativa
Estructura JSON — Remisión (nodos principales)
📦 Nodos del JSON de Remisión
- tipo_solicitud:
IMPRESION_REMISION - transaccion_remision: identidad + timestamps
- configuracion_impresion_convenio: flag de valores al beneficiario
- datos_del_convenio: EPS, beneficiario, nivel, diagnósticos
- productos[]: medicamentos con item, código, cantidad, valor, total, fuera_vademecum
- liquidacion_totales: total_transaccion, cuota_copago, credito, pago_usuario
💊 Ejemplo — 3 medicamentos
- ACETAMINOFEN 500MG TAB X10 — 2 uds → $24,000
- LOSARTAN POTASICO 50MG TAB X30 — 1 ud → $45,000
- IBUPROFENO 400MG CAP X20 — 3 uds → $45,000
- Total: $114,000
- Cuota copago: $15,000
- Crédito convenio: $99,000
- Pago usuario: $15,000
Flujo de Impresión de Tirilla de Pendientes
Estructura JSON — Tirilla de Pendientes
📦 Nodos del JSON de Pendientes
- tipo_solicitud:
IMPRESION_PENDIENTES - evento_operativo:
GENERACION_PENDIENTEoENTREGA_PENDIENTE - datos_generales_del_pendiente: número pendiente, convenio, remisión, transacción, cajero, negocio, fecha
- productos[]: balance_cantidades (recetada/entregada/pendiente) + forma_dispensacion
- datos_para_entrega_del_pendiente: nombre, dirección, teléfono
📋 Reglas operativas
- Solo se imprime en generación o entrega de saldos pendientes
- El número de transacción largo, código negocio y cajero se homologan del flujo fiscal (consistencia de auditoría)
- Cada ítem indica su
forma_dispensacion:ENTREGA_DOMICILIARIAoENTREGA_PRESENCIAL - Datos de entrega del pendiente incluyen dirección para despacho domiciliario
Muestras de Documentos Impresos
FACTURA ELECTRÓNICA
OLIMPICA S.A.
DIAG 31 NO 71-130 DO 613
NIT: 890107487-3
Admon: LILIANA ARRIETA
Tel: 3001234567
STO410
────────────────────────────
FECHA EXPEDICION: 2026-05-25
13:15:00
────────────────────────────
# UM CODIGO PRODUCTO CANT PRECIO
────────────────────────────
1 un 8888888
COPAGO REMISION: 9999999999
1 x 12,000.00
============================
Subtotal: 12,000.00
TOTAL: 12,000.00
────────────────────────────
MEDIOS DE PAGO
PAGO EFECTIVO: 12,000.00
────────────────────────────
Total artículos vendidos = 1
Total Líneas Artículos = 1
Total Líneas por un = 1
────────────────────────────
FORMA DE PAGO: CONTADO
────────────────────────────
** DETALLE IMPUESTOS IVA **
TIPO COMPRA BASE/IMP IMPTO
19% 12,000 10,084.03 1,915.97
────────────────────────────
Adquiriente: CC 1012379588
Nombre: PEDRO ALONSO PEREZ GOMEZ
Email: pedro.perez@email.com
Dir: Calle 100 No. 15-22 Apto 302
Tel: 3001234567
────────────────────────────
REGIMEN COMUN
FACTURA ELECTRONICA
DE VENTA
Cajero: CAJ-001 · Negocio: STO410
LO ATENDIO: LILIANA ARRIETA GOMEZ
────────────────────────────
SISTEMA P.O.S.: RemiWEB
Software facturación in house
OLIMPICA S.A.
FACTURA CONTINGENCIA
OLIMPICA S.A.
CALLE 45 # 20-09
NIT: 890.107.487-3
Admon: LILIANA ARRIETA
STO410
Fecha: 2026-05-25 17:20:15
════════════════════════════
*** FACTURA DE CONTINGENCIA ***
════════════════════════════
# UM CODIGO PRODUCTO CANT PRECIO
────────────────────────────
1 un 8888888
COPAGO REMISION: 9999999999
1 x 12,000.00
Sub Total: 12,000.00
TOTAL: 12,000.00
────────────────────────────
MEDIOS DE PAGO
PAGO EFECTIVO: 12,000.00
Total artículos vendidos = 1
Total Líneas Artículos = 1
Total Líneas por un = 1
FORMA DE PAGO: CONTADO
────────────────────────────
*-* DETALLE IMPUESTOS IVA *-*
TIPO COMPRA BASE/IMP IMPTO
S/IVA 12,000 12,000.00 0
────────────────────────────
-*-* DATOS DE LA FACTURA *-*-
Adquiriente: PEDRO ALONSO PEREZ
Tipo ID: CC
Identificación: 1012379588
Remisión: 9999999999
────────────────────────────
FACTURA CONTINGENCIA: PAPF-500124
Fecha expedición: 2026-05-25
Consecutivo GK asignado
SISTEMA P.O.S.: RemiWEB
Proveedor tecnológico: Carvajal
LO ATENDIO: LILIANA ARRIETA GOMEZ
TIRILLA REMISIÓN MEDICAMENTOS
OLIMPICA S.A.
NIT: 890.107.487-3
Admon: LILIANA ARRIETA
────────────────────────────
SURAMERICANA EPS
SURA REGIONAL BOGOTA
────────────────────────────
Beneficiario: PEDRO ALONSO PEREZ
Identificación: 1012379588
Nivel o Rango: 99
Iden. Médico: 9999999999
Diag. PPal: I10X
Diag. Rel: E11X
────────────────────────────
COD PRODUCTO TOTAL
────────────────────────────
1234567 ACETAMINOFEN 500MG
TAB X10
2 x 12,000.00 24,000
2345678 LOSARTAN POTASICO
50MG TAB X30
1 x 45,000.00 45,000
3456789 IBUPROFENO 400MG
CAP X20
3 x 15,000.00 45,000
============================
TOTAL ───> 114,000.00
Crédito 99,000.00
Pago Usuario 15,000.00
CAMBIO ────> 0.00
────────────────────────────
Remisión: 9999999999
Total trx: 114,000.00
Cuota: 15,000.00
────────────────────────────
***** ESTA ES UNA REMISION *****
LO ATENDIO: LILIANA ARRIETA GOMEZ
Ctrl#: 890107487170011001S0410
2026-05-25 13:15:00
TIRILLA ARTÍCULOS PENDIENTES
OLIMPICA S.A.
NIT: 890.107.487-3
***** ESTA ES UNA REMISION *****
════════════════════════════
A R T I C U L O S P E N D I E N T E S
────────────────────────────
PENDIENTE No.: 99999
Convenio: SURAMERICANA EPS
Remision No.: 99999999
Ctrl#: 890107487170011001...
Cajero: CAJ-001
Negocio: STO410
Fecha: 2026-05-25 13:15:00
────────────────────────────
COD DESCRIPCION CANT
────────────────────────────
1234567 LOSARTAN POTASICO
50MG TAB
Recetada: 60
Entregada: 30
Pendiente: 30 → DOMICILIO
5566778 METFORMINA 850MG
TAB X30
Recetada: 90
Entregada: 30
Pendiente: 60 → DOMICILIO
9988776 ATORVASTATINA 20MG
TAB X10
Recetada: 30
Entregada: 10
Pendiente: 20 → PRESENCIAL
────────────────────────────
NOMB: PEDRO ALONSO PEREZ GOMEZ
Dir: Calle 100 No. 15-22 Apto 302
Tel: 3001234567
────────────────────────────
******* COPIA DE LA DROGUERIA *******
Catálogo Técnico de Respuestas y Excepciones
GK utiliza estas estructuras estándar para que RemiWEB pueda tipificar correctamente las fallas de hardware y negocio.
⏱️ GK-504 — Timeout Operador / Rechazo DIAN
Estado: RECHAZADO
Origen: PROVEEDOR_TECNOLOGICO_CARVAJAL
Motivo: TIMEOUT_CONEXION_DIAN
Contingencia manual:
true→ Activa Escenario A: RemiWEB envía EMITIR_FACTURA_CONTINGENCIA
{
"codigo_respuesta": "GK-504",
"estado": "RECHAZADO",
"error_detallado": {
"descripcion_tecnica": "Timeout 3000ms. Canal saturado.",
"requiere_contingencia_manual": true
}
}
🖨️ GK-E102 — Falla Hardware de Impresión
Estado: ERROR_HARDWARE
Origen: SPOOLER_IMPRESION_LOCAL
Motivo: PRINTER_OFFLINE_OR_NO_PAPER
Contingencia manual:
false→ Verificar conexión USB o rollo de papel en caja STO410
{
"codigo_respuesta": "GK-E102",
"estado": "ERROR_HARDWARE",
"error_detallado": {
"descripcion_tecnica": "Impresora térmica no responde.",
"requiere_contingencia_manual": false
}
}
📋 GK-E400 — Error Validación Payload DIAN
Estado: ERROR_VALIDACION_DATO
Origen: GK_VALIDATOR_ENGINE
Motivo: MISSING_MANDATORY_ADQUIRIENTE_FIELDS
Contingencia manual:
false→ Campo obligatorio: adquiriente.correo_electronico para FE
{
"codigo_respuesta": "GK-E400",
"estado": "ERROR_VALIDACION_DATO",
"error_detallado": {
"motivo": "MISSING_MANDATORY_ADQUIRIENTE_FIELDS",
"requiere_contingencia_manual": false
}
}
✅ GK-200 — Respuesta Exitosa
Estado: EXITOSO
tipo_aprobado: "FE" o "FC"
consecutivo_asignado_gk: ej. PAPF-500124
cufe_cude: hash DIAN de la factura
→ Se procede a imprimir el documento correspondiente
{
"codigo_respuesta": "GK-200",
"estado": "EXITOSO",
"tipo_aprobado": "FC",
"consecutivo_asignado_gk": "PAPF-500124",
"cufe_cude": "d41d8cd98f00b204e98009...",
"fecha_procesamiento": "2026-05-25T13:16:02"
}
Resumen de Códigos de Respuesta GK
| Código | Estado | Origen | ¿Requiere contingencia? | Acción RemiWEB |
|---|---|---|---|---|
| GK-200 | EXITOSO | GK | No | Imprimir documento. Registrar tipo_aprobado y CUFE. |
| GK-504 | RECHAZADO | Operador / DIAN | Sí (Escenario A) | Registrar fallo → enviar EMITIR_FACTURA_CONTINGENCIA |
| GK-E102 | ERROR HARDWARE | Spooler local | No | Alertar al operador: verificar impresora / papel. |
| GK-E400 | ERROR VALIDACIÓN | Validador GK | No | Corregir payload (campo obligatorio faltante) y reintentar. |
SigFilasWeb
Y SOLUCIONES TECNOLÓGICAS S.A.S.
Especificación de Integración RemiWEB – GK API (V1)
Flujos de Impresión de Documentos · SUPERTIENDAS Y DROGUERÍAS OLÍMPICA S.A.
📄 CAR – 442co
v1.0
📅 25-05-2026
✅ Aprobado
Identificación del Documento
📋 Metadatos
| ID Documento | CAR – 442co |
| Versión | 1.0 |
| Fecha Creación | 25-05-2026 |
| Fecha Aprobación | 25-05-2026 |
| Responsable SFW | John Bravo |
| Responsable Olímpica | Roberto Carlos Campy |
| Destinatario | Ing. Doris Cadena |
| Páginas | 13 |
🎯 Objetivo
Consolidar la arquitectura, reglas de negocio, distribución de responsabilidades y estructuras JSON para la integración entre el sistema de convenios RemiWEB (Olímpica) y la API de impresión y control fiscal de GK.
Esta versión agrega datos del adquiriente, estandariza identificadores de prueba real, renombra nodos de liquidación y detalla flujos de excepción y contingencia.
FE Electrónica
Contingencia Fiscal
Remisión
Pendientes
Matriz de Responsabilidad de Datos
| Bloque de Información | Campos Clave | Responsable | Observación |
|---|---|---|---|
| Datos Empresa Fijos | Razón Social, NIT (890101487-3), Admin/Tel, Dirección, Régimen Fiscal, Res. DIAN | GK | Preconfigurados localmente en GK por caja. No viajan en el payload. |
| Textos Fiscales Estáticos | Texto Fiscal 2 (RemiWEB software de facturación in house…) | GK | Administrado en almacenamiento local de GK. |
| Datos Transaccionales de Atención | Nro. Transacción, Nro. Remisión, Código/Nombre Cajero, Código/Nombre Negocio, Lo atendió, Fecha/Hora | RemiWEB | Debe ser idéntico en FE, Remisiones y Pendientes para auditoría. |
| Datos Liquidación y Cálculos (Fiscal) | Subtotales, Totales, Copago, Convenio, Total artículos, Líneas, Descuentos, Totales UM | RemiWEB | GK NO calcula en bloque fiscal. Nodo renombrado: datos_copago. |
| Cálculos Operativos (Remisión) | Cambio (dinero a devolver al usuario) | GK calcula | GK calcula diferencia efectivo recibido vs pago_usuario. Campos credito y pago_usuario van fuera del array productos. |
| Detalle de Impuestos IVA | Tipo (%), Compra (IVA incluido), Base/Imp, Impto (valor neto IVA) | RemiWEB | Desglose tributario calculado por RemiWEB. |
| Datos del Adquiriente / Beneficiario | Tipo ID, Número ID, Nombre, Correo Electrónico, Dirección, Teléfono | RemiWEB | Mapeo ampliado del cliente institucional o paciente. Requerido por DIAN. |
Documentos que genera el sistema
🧾 Factura Electrónica (FE)
- Tipo:
EMITIR_FACTURA_ELECTRONICA - Producto: "COPAGO REMISION: [Nro]"
- Código fijo:
8888888 - Cantidad fija: 1
- Incluye datos adquiriente completos (DIAN)
- Desglose IVA por RemiWEB
📄 Factura Contingencia (FC)
- Tipo:
EMITIR_FACTURA_CONTINGENCIA - Se activa si FE falla (Escenario A) o internamente (Escenario B)
- Mismo producto consolidado de recaudo
- GK asigna consecutivo PAPF-XXXXXX
- Campo
tipo_aprobado: "FC"
🖨️ Tirilla Remisión
- Tipo:
IMPRESION_REMISION - Lista medicamentos reales con cantidades
- Incluye datos convenio, beneficiario, diagnósticos
- GK calcula el CAMBIO
imprimir_valores_tirilla_beneficiario: configurable
⏳ Tirilla Pendientes
- Tipo:
IMPRESION_PENDIENTES - Solo en generación o entrega de saldos pendientes
- Balance: recetada / entregada / pendiente
- Forma dispensación por ítem
- Incluye datos de entrega domiciliaria
⚠️ Errores Tipificados
GK-504: Timeout DIAN / rechazo operadorGK-E102: Falla hardware impresoraGK-E400: Error validación payload DIANGK-200: Éxito (FE o FC)
🔑 Parámetros de Prueba Real
- Cajero:
CAJ-001 - Negocio:
STO410 - Tienda: Droguería Olímpica Calle 72
- NIT Olímpica:
890101487-3 - Proveedor tecnológico: Carvajal
Flujos de Facturación Electrónica y Contingencia Fiscal
🔷 Escenario A — Control Descentralizado (RemiWEB Orquesta)
🔶 Escenario B — Gestión Autónoma por GK (Caja Negra)
Comparativa de Escenarios
🔷 Escenario A — RemiWEB orquesta
- RemiWEB envía
EMITIR_FACTURA_ELECTRONICA - Si GK recibe
GK-504→ RemiWEB registra fallo en BD - RemiWEB envía un segundo request
EMITIR_FACTURA_CONTINGENCIA - Ventaja: Trazabilidad total en backend Olímpica, control nativo de cada intento y reintento
🔶 Escenario B — GK autónomo
- RemiWEB envía un único
EMITIR_FACTURA_ELECTRONICA - GK conmuta internamente si el canal principal falla
- GK responde con
tipo_aprobado: "FE"o"FC" - Ventaja: Simplicidad para RemiWEB — una sola llamada, respuesta unificada
Flujo de Impresión de Remisión Operativa
Estructura JSON — Remisión (nodos principales)
📦 Nodos del JSON de Remisión
- tipo_solicitud:
IMPRESION_REMISION - transaccion_remision: identidad + timestamps
- configuracion_impresion_convenio: flag de valores al beneficiario
- datos_del_convenio: EPS, beneficiario, nivel, diagnósticos
- productos[]: medicamentos con item, código, cantidad, valor, total, fuera_vademecum
- liquidacion_totales: total_transaccion, cuota_copago, credito, pago_usuario
💊 Ejemplo — 3 medicamentos
- ACETAMINOFEN 500MG TAB X10 — 2 uds → $24,000
- LOSARTAN POTASICO 50MG TAB X30 — 1 ud → $45,000
- IBUPROFENO 400MG CAP X20 — 3 uds → $45,000
- Total: $114,000
- Cuota copago: $15,000
- Crédito convenio: $99,000
- Pago usuario: $15,000
Flujo de Impresión de Tirilla de Pendientes
Estructura JSON — Tirilla de Pendientes
📦 Nodos del JSON de Pendientes
- tipo_solicitud:
IMPRESION_PENDIENTES - evento_operativo:
GENERACION_PENDIENTEoENTREGA_PENDIENTE - datos_generales_del_pendiente: número pendiente, convenio, remisión, transacción, cajero, negocio, fecha
- productos[]: balance_cantidades (recetada/entregada/pendiente) + forma_dispensacion
- datos_para_entrega_del_pendiente: nombre, dirección, teléfono
📋 Reglas operativas
- Solo se imprime en generación o entrega de saldos pendientes
- El número de transacción largo, código negocio y cajero se homologan del flujo fiscal (consistencia de auditoría)
- Cada ítem indica su
forma_dispensacion:ENTREGA_DOMICILIARIAoENTREGA_PRESENCIAL - Datos de entrega del pendiente incluyen dirección para despacho domiciliario
Muestras de Documentos Impresos
FACTURA ELECTRÓNICA
OLIMPICA S.A.
DIAG 31 NO 71-130 DO 613
NIT: 890107487-3
Admon: LILIANA ARRIETA
Tel: 3001234567
STO410
────────────────────────────
FECHA EXPEDICION: 2026-05-25
13:15:00
────────────────────────────
# UM CODIGO PRODUCTO CANT PRECIO
────────────────────────────
1 un 8888888
COPAGO REMISION: 9999999999
1 x 12,000.00
============================
Subtotal: 12,000.00
TOTAL: 12,000.00
────────────────────────────
MEDIOS DE PAGO
PAGO EFECTIVO: 12,000.00
────────────────────────────
Total artículos vendidos = 1
Total Líneas Artículos = 1
Total Líneas por un = 1
────────────────────────────
FORMA DE PAGO: CONTADO
────────────────────────────
** DETALLE IMPUESTOS IVA **
TIPO COMPRA BASE/IMP IMPTO
19% 12,000 10,084.03 1,915.97
────────────────────────────
Adquiriente: CC 1012379588
Nombre: PEDRO ALONSO PEREZ GOMEZ
Email: pedro.perez@email.com
Dir: Calle 100 No. 15-22 Apto 302
Tel: 3001234567
────────────────────────────
REGIMEN COMUN
FACTURA ELECTRONICA
DE VENTA
Cajero: CAJ-001 · Negocio: STO410
LO ATENDIO: LILIANA ARRIETA GOMEZ
────────────────────────────
SISTEMA P.O.S.: RemiWEB
Software facturación in house
OLIMPICA S.A.
FACTURA CONTINGENCIA
OLIMPICA S.A.
CALLE 45 # 20-09
NIT: 890.107.487-3
Admon: LILIANA ARRIETA
STO410
Fecha: 2026-05-25 17:20:15
════════════════════════════
*** FACTURA DE CONTINGENCIA ***
════════════════════════════
# UM CODIGO PRODUCTO CANT PRECIO
────────────────────────────
1 un 8888888
COPAGO REMISION: 9999999999
1 x 12,000.00
Sub Total: 12,000.00
TOTAL: 12,000.00
────────────────────────────
MEDIOS DE PAGO
PAGO EFECTIVO: 12,000.00
Total artículos vendidos = 1
Total Líneas Artículos = 1
Total Líneas por un = 1
FORMA DE PAGO: CONTADO
────────────────────────────
*-* DETALLE IMPUESTOS IVA *-*
TIPO COMPRA BASE/IMP IMPTO
S/IVA 12,000 12,000.00 0
────────────────────────────
-*-* DATOS DE LA FACTURA *-*-
Adquiriente: PEDRO ALONSO PEREZ
Tipo ID: CC
Identificación: 1012379588
Remisión: 9999999999
────────────────────────────
FACTURA CONTINGENCIA: PAPF-500124
Fecha expedición: 2026-05-25
Consecutivo GK asignado
SISTEMA P.O.S.: RemiWEB
Proveedor tecnológico: Carvajal
LO ATENDIO: LILIANA ARRIETA GOMEZ
TIRILLA REMISIÓN MEDICAMENTOS
OLIMPICA S.A.
NIT: 890.107.487-3
Admon: LILIANA ARRIETA
────────────────────────────
SURAMERICANA EPS
SURA REGIONAL BOGOTA
────────────────────────────
Beneficiario: PEDRO ALONSO PEREZ
Identificación: 1012379588
Nivel o Rango: 99
Iden. Médico: 9999999999
Diag. PPal: I10X
Diag. Rel: E11X
────────────────────────────
COD PRODUCTO TOTAL
────────────────────────────
1234567 ACETAMINOFEN 500MG
TAB X10
2 x 12,000.00 24,000
2345678 LOSARTAN POTASICO
50MG TAB X30
1 x 45,000.00 45,000
3456789 IBUPROFENO 400MG
CAP X20
3 x 15,000.00 45,000
============================
TOTAL ───> 114,000.00
Crédito 99,000.00
Pago Usuario 15,000.00
CAMBIO ────> 0.00
────────────────────────────
Remisión: 9999999999
Total trx: 114,000.00
Cuota: 15,000.00
────────────────────────────
***** ESTA ES UNA REMISION *****
LO ATENDIO: LILIANA ARRIETA GOMEZ
Ctrl#: 890107487170011001S0410
2026-05-25 13:15:00
TIRILLA ARTÍCULOS PENDIENTES
OLIMPICA S.A.
NIT: 890.107.487-3
***** ESTA ES UNA REMISION *****
════════════════════════════
A R T I C U L O S P E N D I E N T E S
────────────────────────────
PENDIENTE No.: 99999
Convenio: SURAMERICANA EPS
Remision No.: 99999999
Ctrl#: 890107487170011001...
Cajero: CAJ-001
Negocio: STO410
Fecha: 2026-05-25 13:15:00
────────────────────────────
COD DESCRIPCION CANT
────────────────────────────
1234567 LOSARTAN POTASICO
50MG TAB
Recetada: 60
Entregada: 30
Pendiente: 30 → DOMICILIO
5566778 METFORMINA 850MG
TAB X30
Recetada: 90
Entregada: 30
Pendiente: 60 → DOMICILIO
9988776 ATORVASTATINA 20MG
TAB X10
Recetada: 30
Entregada: 10
Pendiente: 20 → PRESENCIAL
────────────────────────────
NOMB: PEDRO ALONSO PEREZ GOMEZ
Dir: Calle 100 No. 15-22 Apto 302
Tel: 3001234567
────────────────────────────
******* COPIA DE LA DROGUERIA *******
Catálogo Técnico de Respuestas y Excepciones
GK utiliza estas estructuras estándar para que RemiWEB pueda tipificar correctamente las fallas de hardware y negocio.
⏱️ GK-504 — Timeout Operador / Rechazo DIAN
Estado: RECHAZADO
Origen: PROVEEDOR_TECNOLOGICO_CARVAJAL
Motivo: TIMEOUT_CONEXION_DIAN
Contingencia manual:
true→ Activa Escenario A: RemiWEB envía EMITIR_FACTURA_CONTINGENCIA
{
"codigo_respuesta": "GK-504",
"estado": "RECHAZADO",
"error_detallado": {
"descripcion_tecnica": "Timeout 3000ms. Canal saturado.",
"requiere_contingencia_manual": true
}
}
🖨️ GK-E102 — Falla Hardware de Impresión
Estado: ERROR_HARDWARE
Origen: SPOOLER_IMPRESION_LOCAL
Motivo: PRINTER_OFFLINE_OR_NO_PAPER
Contingencia manual:
false→ Verificar conexión USB o rollo de papel en caja STO410
{
"codigo_respuesta": "GK-E102",
"estado": "ERROR_HARDWARE",
"error_detallado": {
"descripcion_tecnica": "Impresora térmica no responde.",
"requiere_contingencia_manual": false
}
}
📋 GK-E400 — Error Validación Payload DIAN
Estado: ERROR_VALIDACION_DATO
Origen: GK_VALIDATOR_ENGINE
Motivo: MISSING_MANDATORY_ADQUIRIENTE_FIELDS
Contingencia manual:
false→ Campo obligatorio: adquiriente.correo_electronico para FE
{
"codigo_respuesta": "GK-E400",
"estado": "ERROR_VALIDACION_DATO",
"error_detallado": {
"motivo": "MISSING_MANDATORY_ADQUIRIENTE_FIELDS",
"requiere_contingencia_manual": false
}
}
✅ GK-200 — Respuesta Exitosa
Estado: EXITOSO
tipo_aprobado: "FE" o "FC"
consecutivo_asignado_gk: ej. PAPF-500124
cufe_cude: hash DIAN de la factura
→ Se procede a imprimir el documento correspondiente
{
"codigo_respuesta": "GK-200",
"estado": "EXITOSO",
"tipo_aprobado": "FC",
"consecutivo_asignado_gk": "PAPF-500124",
"cufe_cude": "d41d8cd98f00b204e98009...",
"fecha_procesamiento": "2026-05-25T13:16:02"
}
Resumen de Códigos de Respuesta GK
| Código | Estado | Origen | ¿Requiere contingencia? | Acción RemiWEB |
|---|---|---|---|---|
| GK-200 | EXITOSO | GK | No | Imprimir documento. Registrar tipo_aprobado y CUFE. |
| GK-504 | RECHAZADO | Operador / DIAN | Sí (Escenario A) | Registrar fallo → enviar EMITIR_FACTURA_CONTINGENCIA |
| GK-E102 | ERROR HARDWARE | Spooler local | No | Alertar al operador: verificar impresora / papel. |
| GK-E400 | ERROR VALIDACIÓN | Validador GK | No | Corregir payload (campo obligatorio faltante) y reintentar. |