Modul na volání TASu - TAS 2 TAS (zakládání procesů přes API)

Založení případu skrz API

Endpoint Start Process API umožňuje jedním voláním vytvořit nový případ z existující šablony, naplnit proměnné vstupními daty a okamžitě spustit workflow. Operace je atomická — případ buď vznikne kompletně, nebo vůbec.

Endpoint

Method: POST

URL: /api/plugins/api-extensions/start-process

Autentizace

Každé volání musí obsahovat Bearer token v HTTP hlavičce:

Authorization: Bearer <accessToken>
Content-Type: application/json

Vygenerování tokenu lze provést na straně aplikace v sekci API Tokeny.

Tělo požadavku

{
  "processId": 27, //ID hlavičky (headerId) spouštěného procesu
  "data": {
    "processVariable1": "value1",
    "processVariable2": "value2"
  }
}

Podporované typy hodnot v data

Příklad volání

try {
    const accessToken = 'xxxxxx';
    const configStartNewProces = {
        method: "post",
        url: `/api/plugins/api-extensions/start-process`,
        headers: {
            "Authorization": `Bearer ${accessToken}`,
            "Content-Type": "application/json"
        },
        data: JSON.stringify({
            processId: 27, //ID hlavičky (headerId) spouštěného procesu
            data: {
                "processVariable1": "value1",
                "processVariable2": "value2"
            }
        })
    };
    const requestStartNewProces = axios.getAxios().requestRaw(configStartNewProces);
    proc.warn(`requestStartNewProces Result`, { requestStartNewProces });
} catch (error) {
    proc.warn(`requestStartNewProces error`, { error });
}

Doporučení pro administrátora

• Do objektu data doporučujeme přidat proměnnou _isCaseCreatedByAPI s hodnotou "true". Šablona tak okamžitě rozpozná, že případ vznikl přes API, a může na to reagovat v podmínkách nebo routingu.
• Všechny hodnoty z data jsou dostupné již v úkolu Start — workflow s nimi může pracovat okamžitě (podmínky, routing, rozhodování) bez nutnosti čekat na další krok.

Chování při chybě

Pokud dojde k jakékoliv chybě (nevalidní vstup, neexistující processId, problém při startu workflow):

• případ se nevytvoří,
• žádná data se neuloží,
• v systému nezůstanou neúplné ani „rozbité" procesy.

Nahrání dokumentu přes API

Tato sekce popisuje, jak z externího systému nahrát dokument do již existujícího případu v TASu přes REST API. Předpokládá se, že případ už existuje a znáte jeho iprocId.

Předpoklady

• Znáte base URL cílové instance TASu (např. https://vase-instance.teamassistant.app). Všechna API volání směřují na {baseUrl}/api.
• Máte platný autentizační token (Bearer). Doporučený způsob je dlouhodobý API token (Administrace → API tokeny, od verze 5.17). Na starších verzích získáte token přes přihlášení na /api/authenticate.
• Znáte iprocId případu, do kterého chcete dokument nahrát.
• Uživatel, pod kterým token vystupuje, má oprávnění k danému případu.

Autentizace

Každé volání musí obsahovat token v HTTP hlavičce:

Authorization: Bearer <vas_token>

Získání tokenu (starší verze / bez API tokenu)

Pokud nepoužíváte dlouhodobý API token, přihlaste se a token si vyzvedněte z odpovědi:

Endpoint: POST {baseUrl}/api/authenticate

Tělo (JSON):

{
  "username": "INTEGRACE.EXTSYSTEM",
  "password": "********",
  "grant_type": "password"
}

Z odpovědi použijte vrácený token jako Bearer v dalších voláních.

Nahrání dokumentu

Dokument se nahrává jako multipart/form-data — soubor se posílá jako binární data v poli file, nikoliv jako Base64 v JSON.

Endpoint: POST {baseUrl}/api/dms/upload

Tělo (form-data):

Příklad — cURL

curl -X POST "https://vase-instance.teamassistant.app/api/dms/upload" \
  -H "Authorization: Bearer <vas_token>" \
  -F "file=@/cesta/k/souboru/faktura.pdf" \
  -F "filename=faktura-2026-001.pdf" \
  -F "iprocId=155286"

Příklad — Node.js (axios + form-data)

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const baseUrl = 'https://vase-instance.teamassistant.app';
const token = '<vas_token>';
const iprocId = '155286';

const form = new FormData();
form.append('file', fs.createReadStream('./faktura.pdf'));
form.append('filename', 'faktura-2026-001.pdf');
form.append('iprocId', iprocId);

await axios.post(`${baseUrl}/api/dms/upload`, form, {
  headers: {
    ...form.getHeaders(),
    Authorization: `Bearer ${token}`,
  },
});

Výsledek

Po úspěšném volání je dokument přiložen k případu iprocId a je dostupný v jeho dokumentech (DMS). Pokud jste uvedli itaskId, je navázán také na daný úkol.