Postpone Transaction

Postpone Transaction

Type: queue-postpone-transaction  ·  Package: Queue Activities v1.0.0  ·  Output: —

Defers an item you are processing: returns it from in_progress to state new and sets a time after which it can be delivered again. Unlike a failure, it does not count as an attempt (decrements the counter), so it does not consume retries.

It is used when the item cannot be processed now, but can be processed later: a system under maintenance, a document that is not yet available, a time window. Instead of failing, you postpone it and another (or the same) bot will pick it up later.

Required parameters

Parameter	Editor	Description
item	expression	The ZoanQueueItem returned by Get Queue Item.
deferUntil	expression	ISO 8601 date/time from which the item can be delivered again.

Example

If the supplier portal is under maintenance, postpone the item for one hour:

If   condition = = portalEnMantenimiento
  └─ then:
       Postpone Transaction
         item = = item
         deferUntil = = now().AddHours(1).ToString("o")

The attempt does not count

Since deferring does not consume a retry, avoid deferring looping over the same permanent condition (you’d end up requeuing forever). Use it for limited waits; for definitive errors use Set Transaction Status with failed.

Related activities

• Get Queue Item — take the item.
• Set Transaction Status — close the item as success or failure.