Add Queue Item

Tipo: queue-add-item · Paquete: Queue Activities v1.0.0 · Salida: ZoanQueueItem

Agrega un item nuevo a una cola de trabajo de Nexus. Es la actividad que usa el productor (dispatcher) para llenar la cola: por cada unidad de trabajo (una factura, un pago, un correo) encola un item con sus datos. Devuelve el ZoanQueueItem creado.

Parámetros requeridos

Parámetro	Editor	Descripción
`queueName`	expresión	Nombre de la cola. Debe existir en el entorno donde se ejecuta.
`specificContent`	JSON	El payload del item: un objeto con los datos que el bot leerá para procesarlo. Dentro del consumidor se lee con `= item.SpecificContent["campo"]`.

Parámetros opcionales

Parámetro	Editor	Descripción
`reference`	expresión	Referencia única por cola. Si vuelves a encolar la misma referencia, Nexus devuelve el item existente en vez de duplicar (idempotencia).
`priority`	enum	`high`, `normal` (por defecto) o `low`. Los de mayor prioridad se entregan antes.
`deferUntil`	expresión	Fecha/hora ISO 8601. El item no se entregará antes de ese momento. Vacío = procesable de inmediato.

Salida

Devuelve el ZoanQueueItem encolado (con su Id, Reference, Status = "new", etc.).

Ejemplo

Encolar una factura por validar, usando su número como referencia idempotente:

Add Queue Item
  queueName = "facturas-por-validar"
  reference = = factura["numero"]
  priority  = normal
  specificContent = {
    "facturaId": = factura["numero"],
    "monto":     = factura["monto"],
    "cliente":   = factura["cliente"]
  }
  → output: item

Actividades relacionadas

Get Queue Item — tomar items para procesarlos.
Colas de trabajo — crear la cola y entender los estados.