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:
- 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.
- 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’.
- 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:
- a supplier or a customer, by their code (‘00002’) or by their name as it is on the record;
- a document, by the number shown in the list (‘A0003’; a draft also has its own, ‘BOR0001’); several delivery notes, one per line;
- the payment method, the sales agent, the price list or the warehouse, by its code or its name;
- a line of a document, by its position: 1 is the first.
- a service report, by the number shown in the list of reports (‘A0001’).
- a production order, by the number in the list of orders (‘A0001’); the order that comes from a quote or sales order, by the number of that quote or sales order; and in a report for the order, each line by its position within the order (1 is the first).
- in Treasury: the account (cash or bank) by its code or name; an instalment by the number of the document it comes from, as in the open items, and if that document has several outstanding, with which one after it (‘A0001 2’ is the second); a payment on account, by the customer or supplier code if they only have one outstanding, or by the number of the operation that created it; the customer of a voucher, by their code.
- in the CRM: a contact by their name as it appears in Contacts, their Tax ID (NIF), their email or the customer code if they already are one; a board and its column by their name; a card by its title; an activity by its title, within the contact; the owner by the user’s name.
- in Change record field, the record by its code (or name), according to the chosen entity.
- an email, by its subject as it appears in the inbox; if several share a subject, with the sender after it: ‘March invoice from juan@empresa.com’.
- a task, by its title as it appears in the inbox; the person by their name and the group by its own.
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?:
- When the button is clicked: the usual; the action waits for someone to run it.
- Automatically, once: choose the day and time. When that moment comes it runs without anyone clicking anything.
- Automatically, repeating: every how many days, weeks or months, at what time, from which day and, if you want, to which one. With weeks, tick the days (M, T, W, T, F, S, S); with none ticked, the weekday of ‘from’.
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:
- You add them, when assigning a task.
- The contact’s record in the CRM: Request quote creates a task with the ‘create quote’ action pointing at the contact’s customer. Whoever opens it completes the lines and clicks.
- A schedule with a free-form step: when the assistant works on its own and proposes an action the schedule doesn’t have approved, it leaves it as an Awaiting confirmation: … task, with the action ready, in the name of the person the schedule runs for. See let the assistant work on its own.
If something goes wrong
| What you see | What has happened | What to do |
|---|---|---|
| ‘This task has no action.’ | Run was clicked on a task with no action | Nothing: add the action if needed |
| ‘This task’s action has already been run.’ | It only runs once | If it has to be repeated, create another task |
| ‘The user does not have permission for “…”.’ | Your role doesn’t reach the level that action requires | Have someone with the permission run it, or ask for it |
| ‘Assistant actions are disabled in this company.’ | The company has the actions switched off | Enable 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 company | Check how it is written in Warehouse → Items |
| ‘There is no supplier with code or name “…”’ | The code doesn’t exist in this company | Copy it from the supplier list (or the customer list) |
| ‘There is no document with number “…”’ | The number doesn’t match any in that module | Type it as it appears in the list |
| ‘Several documents have the number “…”: …’ | Documents of different types have that number | Type the type in front, as the message says: ‘Quote A0002’ |
| ‘Several documents have the number “…”: …’ | Documents of different types have that number | Type the type in front, as the message says: ‘Quote A0002’ |
| ‘There are N items called “…”’ | Several items share the name | Type the code of the one you want |
| The button shows the action’s technical name instead of a sentence | The assistant’s catalogue isn’t loaded in this installation | The 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