Skip to content

What is a task’s action and how do I run it with one click?

A task can carry a ready-made action: an assistant action with its details already filled in. Whoever opens the task runs it by clicking a button, with their own permissions, and the result is noted on the task. It is how the ERP leaves ‘what is still to be decided’ to a person.

What do I need before I start?

The assistant’s actions must be enabled in the company and you must have permission for that particular action. A task with an action you can’t run opens all the same, but the button will tell you that you don’t have permission.

How do I give a task an action?

When creating or editing the task, in the Action on click block:

  1. Choose the action in the tree: the actions in the assistant’s catalogue are grouped by module, with the module’s icon (Sales, Warehouse, Treasury…). Expand a module and click one: create a quote, sync the store, run recurring invoicing, send a document by email… With Search by name… you filter the tree. The panel on the right says what the chosen action does and how you would ask the assistant for it. No action leaves the task without an action.
  2. Fill in the Action details, which appear below, one per line: the same details the assistant would ask for, with their help note; the required ones have an asterisk and the rest say ‘optional’.
  3. Save.

When you choose the action, the task’s Scope becomes that action’s module (a Warehouse action puts the task in the Warehouse inbox), if you can create tasks in it. You can change it afterwards.

If you change action, the details of the previous one are cleared: each action has its own.

How do I fill in an action that works with several items or several lines?

Actions that take a list —create, modify or replace several items, the lines of an order— show one panel per element with its own fields (name, code, price…). Fill in the first and click Add another for the next; the bin on each panel removes it. Panels you leave empty don’t count.

When the list is only of names or codes (for example, the items to delete), you type one per line.

What the action refers to —the supplier, the customer, a document, the payment method— is typed as it appears on the screens, never by an internal number:

Each document type numbers on its own, so the same number can be both a quote and a sales order. If that happens, the action tells you and you just type the type in front: ‘Quote A0002’, ‘Sales order A0002’.

Codes can contain letters. The message when running repeats what you typed (‘Purchase order 00002’).

Items can be given by their code or by their name, also when adjusting or transferring stock: ‘plate’ works just like its code. If two items have the same name, the action tells you their codes so you can choose.

Can I make the action run on its own, at a set time?

Yes. When creating the task, below the action details, in When does it run?:

Below it you can read in one sentence when it will run (‘It will run automatically every week on Mondays and Wednesdays at 08:30’). When you save, a schedule is created with that action (you will see it in Tasks → Schedules, with each run and its result) and the task is linked to it; the notice of each run reaches you as a notification.

An action that writes to the ERP only runs on its own if someone with permission approves it. If you have it, it is approved when you save; if not, the message tells you so and the schedule waits for someone who can to approve it, from Schedules.

What is the Tasks section of the action tree for?

For a task to do something with another task when its action button is clicked: create a new task (with its owner, scope and due date), assign it to another person or group, start it, postpone it, mark it as done, cancel it or reopen it. The task being acted on is given by its title, as it appears in the inbox, and the person by their name.

It is used to chain work: for example, a ‘Check the order’ task whose action creates the ‘Prepare the shipment’ task for the warehouse. There are also Schedule, which creates a schedule, and Migrate CRM activities, which turns the CRM’s earlier activities into tasks.

How is it run?

In the list, a task with an action has a lightning icon on its row. Click it, or open the task and click the action button, which says what it is going to do (‘Create quote for Talleres Ruiz’). The action runs at that moment with the permissions of whoever clicks, not those of whoever assigned it.

It only runs once. Afterwards, the task shows ‘Run on …’ with what it created (for example, ‘Quote 118’) and the button disappears. The task doesn’t close on its own: mark it Done when you finish.

What happens when I do it?

The same as if you had confirmed that action in the assistant chat: the quote is created, the store is synced, the email goes out. It is recorded in the history of assistant actions, with your name.

If the action fails, the task shows you the reason and keeps the button available so you can try again.

Where do tasks with an action come from?

From three places:

If something goes wrong

What you seeWhat has happenedWhat to do
‘This task has no action.’Run was clicked on a task with no actionNothing: add the action if needed
‘This task’s action has already been run.’It only runs onceIf it has to be repeated, create another task
‘The user does not have permission for “…”.’Your role doesn’t reach the level that action requiresHave someone with the permission run it, or ask for it
‘Assistant actions are disabled in this company.’The company has the actions switched offEnable them in Settings → POS and terminal settings → Terminals (‘Assistant actions’ card)
‘There is no item with code or name “…”.’Neither the code nor the name matches an item in this companyCheck how it is written in Warehouse → Items
‘There is no supplier with code or name “…”’The code doesn’t exist in this companyCopy it from the supplier list (or the customer list)
‘There is no document with number “…”’The number doesn’t match any in that moduleType it as it appears in the list
‘Several documents have the number “…”: …’Documents of different types have that numberType the type in front, as the message says: ‘Quote A0002’
‘Several documents have the number “…”: …’Documents of different types have that numberType the type in front, as the message says: ‘Quote A0002’
‘There are N items called “…”’Several items share the nameType the code of the one you want
The button shows the action’s technical name instead of a sentenceThe assistant’s catalogue isn’t loaded in this installationThe action runs all the same; tell support if it persists

See also: Assign a task · Ask the assistant to do something · Organising work with tasks and schedules