Este instructivo explica cómo crear un método de publicación con tipo de acceso Directo en Deals, qué campos requiere y cómo funciona el check Genera Job.
5 min
¿Para qué sirve?
El acceso Directo permite enviar información a Deals de forma inmediata mediante llamadas HTTP a su API. Es el tipo de acceso indicado cuando un sistema externo, un Bproc o un microservicio necesita publicar datos en tiempo real sin intervención manual ni archivos intermedios.
Antes de empezar
- Tener creado el documento en el Catálogo de Documentos con su SCHEMA definido.
- Tener configurada la Descarga asociada al documento (define qué hace Deals con los datos una vez procesados).
Modo de uso
Menú → Deals → Publicaciones → Nuevo
Campos comunes del método de publicación
Al crear un método de publicación (independientemente del tipo de acceso), se completan los siguientes campos:
| Campo | Descripción |
|---|---|
| Nombre del Método | Denominación funcional del flujo. Identifica el método en la grilla de publicaciones. |
| Control de Duplicados | Al activarse, impide el ingreso de registros repetidos. Si el SCHEMA del documento tiene campos marcados como Clave Única, la validación se aplica solo sobre esos campos. Si no hay ningún campo con Clave Única configurado, se valida la totalidad de la estructura del objeto JSON. |
| Informar duplicados en el monitor | Registra en el Monitor de Deals las publicaciones rechazadas por duplicación, permitiendo su auditoría posterior. |
| Código ID | Identificador único del método dentro del espacio de trabajo de Deals. Forma parte del endpoint final cuando el acceso es Directo. |
| Acceso | Define cómo se publica el método. Las opciones disponibles son: Directo, Archivo y Archivo PDF con IA. |
Configuración del Acceso Directo
Al seleccionar Directo en el campo Acceso, el método queda listo para recibir llamadas HTTP.
Endpoint de publicación
El endpoint final se construye combinando tres partes:
| Parte | Descripción |
|---|---|
| URL base del entorno | Dirección raíz del entorno Deals de la empresa (varía por cliente/entorno). |
| API para publicar del documento | Segmento de ruta definido por el Catálogo de Documentos al que pertenece el método. |
| Código ID del método | El valor configurado en el campo Código ID del método de publicación. |
El sistema expone el endpoint completo en la pantalla del método una vez guardado. El formato exacto de headers de autenticación y body requeridos debe verificarse con el equipo técnico, ya que no está detallado en la configuración de la interfaz.
Check “Genera Job” (Servicio Programable)
| Estado | Comportamiento |
|---|---|
| Desactivado (default) | El endpoint responde de forma sincrónica ante cada llamada HTTP recibida. |
| Activado | Deals genera automáticamente un Servicio Programable en la plataforma que ejecuta el proceso de forma asíncrona, sin intervención manual del usuario. Corre por defecto cada 12 horas. |
Ajustar la frecuencia del Servicio Programable:
- Ir a Menú → GO → Servicios Programables.
- Localizar el servicio generado por el método de publicación.
- Modificar la frecuencia según la necesidad operativa.
El Servicio Programable se crea automáticamente al activar el check; no requiere configuración manual adicional para empezar a funcionar con la frecuencia por defecto.
Qué hace y qué no hace
- Sí: expone un endpoint HTTP que sistemas externos, Bprocs o microservicios pueden invocar para publicar datos en tiempo real.
- Sí: permite configurar un servicio programable asíncrono que ejecuta la publicación cada 12 horas (ajustable).
- Sí: controla duplicados a nivel de campo (Clave Única) o de JSON completo según la configuración del SCHEMA.
- No: el acceso Directo no soporta carga de archivos Excel/CSV; para eso se usa el tipo Acceso Archivo.
- No verificado: el formato de autenticación del endpoint (headers, token) no está detallado en la fuente disponible; consultar con el equipo técnico antes de documentar ese apartado.