Integraciones
Formulario simple
CyberPuerta Api
Conecta a CyberPuerta con Comercia por su API: consulta tu catálogo, sus pedidos entran como ventas y Comercia le manda el folio fiscal de cada factura.
¿Qué hace este ajuste?
Esta pantalla enlaza a Comercia con CyberPuerta por medio de su API, dentro del grupo Dropshipping de Integraciones. CyberPuerta consulta en Comercia el catálogo, el inventario de los almacenes que elijas y los precios de las listas convenidas, y cada pedido que coloca entra a Comercia como una venta a nombre del cliente que indiques en Cliente No., con el estado que traiga el pedido o, si no trae, con el que definas aquí (Apartado o Autorizado). De regreso, cuando una de esas ventas se factura, Comercia le manda a CyberPuerta el folio fiscal de la factura vigente y deja en la venta un comentario con su respuesta; para eso hace falta el Token / API key que entrega CyberPuerta. Si un producto del pedido no existe en Comercia (se busca por SKU), el pedido se rechaza completo y no entra ninguna venta; si existe pero no tiene precio en la lista del cliente ni precio base, entra con precio de 999,999 para que se note y se corrija. Con Restringir a usuario solo ese usuario puede meter pedidos por esta vía, y con Restringir por campo compartes solo una parte del catálogo. Es la versión vigente; la pantalla Integración CyberPuerta es la anterior.
Datos del ajuste
- Nombre técnico
TreebesIRVCyberPuertaApi- Tipo de pantalla
- Formulario simple
- Ruta en comercia.io
-
index.php?module=TreebesIRVCyberPuertaApi&parent=Settings&view=IndexAbrir en CRM - Categoría
- Integraciones
Estructura de datos
Información General
8 campos sin título en ComerciaConecta Comercia.io con CyberPuerta por su API moderna para compartir catálogo y recibir pedidos.
Esta sección guarda los datos de la conexión nueva con CyberPuerta vía API. Permite definir bajo qué cliente entran las ventas, qué listas de precios y almacenes se comparten, y a qué usuario se asignan los registros. Es la versión vigente; la pantalla anterior de CyberPuerta se mantiene solo por compatibilidad.
Cuándo entrar aquí: La configura el administrador o el equipo de marketplaces cuando se levanta la integración nueva con CyberPuerta o cuando se actualiza el token de acceso.
-
Activo
ti_cp_active- Tipo Interruptor
- Opcional
- Editable
-
Default
0
Enciende o apaga la integración con CyberPuerta.Cuando se marca en "Sí" se intercambian catálogo, precios e inventarios y empiezan a llegar las ventas de CyberPuerta. En "No" se detiene el intercambio pero los datos ya enviados allá permanecen.El administrador lo enciende una vez que se completaron las pruebas de conexión; lo apaga cuando se desea pausar la operación con CyberPuerta. -
Cliente No.
ti_cp_account_no- Tipo Texto
- Opcional
- Editable
Número del cliente al que se asignan todas las ventas recibidas desde CyberPuerta.Es el código del cliente dentro de Comercia.io (con letras y números, por ejemplo ACC123) que representa a CyberPuerta. Todas las ventas entrantes se registran a su nombre. Si el cliente no existe, el sistema marca un error y no se guarda la configuración.Lo define el administrador en conjunto con ventas para concentrar bajo una sola cuenta toda la facturación y comisiones del canal CyberPuerta. -
Token
ti_cp_access_token- Tipo Texto
- Opcional
- Editable
Llave de acceso que CyberPuerta entrega para autorizar las llamadas a su API.Es la credencial que el proveedor genera para autenticar las solicitudes. Debe pegarse tal cual la entrega CyberPuerta. Si se cambia o caduca, deja de llegar el catálogo y las ventas.El administrador lo captura al dar de alta la cuenta y lo actualiza cuando CyberPuerta lo solicita o cuando expira por seguridad. -
Estado Predeterminado Venta
ti_cp_sostatus- Tipo Lista desplegable
- Opcional
- Editable
-
Default
Approved
Estado con el que nace la venta cuando el pedido de CyberPuerta no trae uno: Apartado o Autorizado.Si el pedido llega con estado Apartado, Autorizado o Cancelado, se respeta el del pedido; si no trae ninguno, la venta nace con el que se elija aquí. Apartado reserva la mercancía y deja la venta pendiente de autorizar; Autorizado habilita desde el inicio la entrega y la facturación. Una venta que ya estaba Autorizada no regresa a Apartado cuando llega una actualización del mismo pedido.Lo decide el administrador junto con operación cuando se define cómo van a fluir las ventas de CyberPuerta (con o sin paso de revisión previa). -
Lista de Precios
ti_cp_pricebookid- Tipo Lista múltiple
- Opcional
- Editable
Listas de precios que se comparten con CyberPuerta.Se eligen una o varias listas para que CyberPuerta consuma los precios. Si después se retira una lista, los precios ya publicados allá no se borran solos; hay que limpiar manualmente desde el panel de CyberPuerta.El responsable de pricing o marketplaces ajusta estas listas cuando cambia la estrategia comercial con CyberPuerta o se crean nuevas tarifas. -
Almacenes a mandar
ti_cp_almacenes- Tipo Lista múltiple
- Opcional
- Editable
Almacenes cuyo stock se envía a CyberPuerta.Se eligen los almacenes que efectivamente pueden surtir pedidos de CyberPuerta. Si se quita un almacén, los inventarios ya enviados no se actualizan ni se borran automáticamente del lado de CyberPuerta; hay que retirarlos a mano.El equipo de operación o almacén define qué sucursales o bodegas atienden este canal; usualmente las que tienen mejor stock y proceso de envíos. -
Restringir a usuario
ti_cp_userid- Tipo Lista desplegable
- Opcional
- Editable
Usuario de Comercia.io al que se asignan los registros recibidos desde CyberPuerta.Define a qué usuario de Comercia.io le quedan asignadas las ventas y productos que llegan desde CyberPuerta. También sirve para que las llamadas entrantes usen el ComerciaKey de ese usuario como autenticación.El administrador elige un usuario dedicado al canal (por ejemplo "CyberPuerta Bot" o el responsable de marketplaces) para mantener separadas las ventas por canal. -
Restringir por campo
ti_cp_rfname- Tipo Lista desplegable
- Opcional
- Editable
Campo que filtra qué productos se exponen a CyberPuerta.Permite restringir el catálogo enviado a CyberPuerta usando un campo booleano del producto (por ejemplo "publicar en CyberPuerta"). Si se cambia después de haber enviado productos, los que ya están publicados no se retiran de CyberPuerta automáticamente.Marketing o el responsable de marketplaces lo activa cuando solo quiere exponer una parte del catálogo a este canal y no todo el inventario disponible.