Xetux Docs
XPedidos

Activación de Sucursales con Appio

Guía técnica para la configuración e integración de plataformas de delivery (Uber, Rappi, DiDi) mediante el motor Appio en Xetux.

Appio actúa como el integrador central para recibir pedidos de plataformas externas (Delivery) directamente en el punto de venta Xetux. Este procedimiento detalla la ejecución del script SQL necesario para inicializar la configuración de plataformas en nuevas cuentas.

Requisitos Previos

  • Ambientes Creados: Los ambientes (Environments) correspondientes a cada plataforma (UBER, RAPPI, DIDI) deben estar creados y activos en Xetux.
  • Formas de Pago: Deben existir las formas de pago homónimas para la conciliación automática.
  • Privilegios: Acceso a SQL Server Management Studio con permisos de db_owner.

Procedimiento de Configuración SQL

Definición de Plataformas

En el inicio del script, se deben declarar las plataformas que el cliente ha contratado. Cambie el valor a 1 para activar o 0 para omitir:

DECLARE @tiene_uber BIT = 1;
DECLARE @tiene_rappi BIT = 1;
DECLARE @tiene_didi BIT = 1;

Ejecución del Script de Integración

El siguiente bloque realiza las siguientes acciones:

  1. Habilita el sistema externo de Appio (ID 6).
  2. Vincula los IDs de tienda externos (External Store IDs).
  3. Crea el descuento técnico DSCTO APPIO para el manejo de promociones de plataforma.
  4. Configura los parámetros de estación y usuario para la facturación automática de pedidos entrantes.
USE [XETUXPOS]
GO

-- Habilitar sistema externo Appio
UPDATE T_SYS_EXTERNAL_SYSTEM SET enabled = 1 WHERE id = 6;

-- [Bloque de inserción en T_POS_WEB_SALES_CONFIG y T_SYS_CONFIG_XPEDIDOS]
-- Se omiten los INSERT detallados para brevedad, pero deben ejecutarse íntegramente

Verificación de Configuración

Una vez ejecutado el script, validar en la tabla T_SYS_CONFIG_XPEDIDOS que las rutas de integración y las llaves de Appio coincidan con los IDs de sucursal proporcionados por el equipo de implementaciones.

Si el servidor central está habilitado (central_server_enabled), el script activará automáticamente la búsqueda por adicionales secundarios para mantener la paridad de precios entre la nube y el local.

Tabla de Mapeo de IDs (Referencia)

PlataformaExternal Store ID (Ejemplo)Puerto de Integración
Uber Eats096fc2e4-66df-4d71-9b5a-5d3290d75d6dXpedidos Service
Rappi10a241cb-26ec-4b8b-8016-21526f269701Xpedidos Service
DiDi Food95dcf417-aeb7-465f-a7b9-74c056385c22Xpedidos Service
Tras la ejecución del script, es necesario reiniciar el servicio de Xpedidos en el servidor para que los conectores inicien la escucha de pedidos en tiempo real.
Copyright © 2026