API je obecný termín, který označuje rozhraní pro programování aplikací. WebAPI ABRA Gen je konkrétní řešení od ABRA Software. Více viz Věcný obsah, základní pojmy - Web API.

Projděte si kapitolu Nastavení Web API.

Web API dodržuje nastavená pravidla obecné ochrany dat i práva k chráněným objektům. Je zapotřebí zkontrolovat efektivní práva uživatele, kterého pro přístup k Web API využíváte.

Více informací o vztahu Web API k chráněným objektům naleznete v kapitole Autentizace a autorizace v sekci Přístup k chráněným objektům.

Více informací o vztahu Web API k obecné ochraně dat naleznete v samostatné kapitole Web API a ochrana dat.

Ano, je to možné. Doporučujeme ukládat kódy z čipů do položky token ve vlastnostech uživatele, která následně slouží k ověřování totožnosti místo kombinace přihlašovacího jména a hesla. Podmínkou je zatržení volby Umožnit rychlé přihlášení přes token (aby k přihlášení postačil samotný token uložený na čipu, bez nutnosti uvádění uživatelského jména) a unikátnost tokenu v rámci spojení na databázi (pokud je zatržena volba Umožnit rychlé přihlášení přes token, systém tuto unikátnost kontroluje automaticky).

Kromě ručního zadání tokenu v agendě Uživatelé lze token nastavit také pomocí Web API (od verze ABRA Gen 21.3.4 včetně). V obou případech se token ukládá do databáze v zašifrované podobě. (Šifrování provádí systém ABRA Gen rovněž automaticky.)

Požadavek na tisk sestavy vrací chybu "Okno Výběr tiskárny (TNxSelectPrinterDialog) nelze modálně zobrazit"

K tomuto problému dochází, pokud je Web API server spuštěn jako služba a místní systémový účet, pod kterým služba běží, nemá nastavenou výchozí tiskárnu. Pokud služba běží pod uživatelem, který má výchozí tiskárnu nastavenu, k podobnému problému nedochází. Více informací viz související poznámky v kapitole Tiskové sestavy.

Nedaří se mi vytvořit doklad pomocí importního manažeru - požadavek končí chybou 500 (Chyba v zadání položky).

K této chybě typicky dochází, když se importní manažer pokusí uložit cílový doklad s prázdnými hodnotami v položkách, jejichž vyplnění je povinné. Řešením je předvyplnění těchto položek s využitím vlastnosti output_document_update. Podrobnější informace včetně ilustračního příkladu naleznete v dokumentaci k Web API(kapitola Struktura URI).

Pomocí importního manažeru se mi nedaří vytvořit daňový zálohový list vydaný ze zálohového listu vydaného. Požadavek končí chybou 1520 (Doklad musí být vystaven přesně na zvolenou částku).

Při importu je zapotřebí použít parametr importdepositrows, který po nastavení na hodnotu true způsobí přenos řádků s částkou zálohy. K dispozici jsou také parametry pro přenos textových řádků a pro nastavení výchozí DPH sazby na řádcích, pokud není DPH sazba na odpovídajících zdrojových řádcích ZLV vyplněna. Podívejte se na ilustrační příklad.

Je možné aktualizovat obsah hlavičky i řádků existujícího dokladu v jednom kroku? Jak by mělo vypadat tělo takového požadavku?

Je to možné, podívejte se na ilustrační příklad.

Je možné ve Web API vytvářet dokumenty (přílohy)?

Je to možné (je možné dokumenty nejen vytvářet, ale také je připojovat k existujícím dokladům), podívejte se na ilustrační příklad.

Potřebuji napolohovat převodku výdej. Využívám importní manager Převodka výdej→Vyskladnění z pozic.

Požadavek vypadá následovně:

POST http://localhost/data/import?select=ID, DisplayName HTTP/1.1
Host: localhost
Content-Type: application/json
Authorization: Basic QVBJOmFwaQ==
Cache-Control: no-cache
Postman-Token: d5910570-9efd-43a6-9b5c-4ee2121d21a1
{
	"input_document_clsid": "0P0I5SAOS3DL3ACU03KIU0CLP4",
	"output_document_clsid": "LNQ1VOVM1TE4XJDLGNXAK0I1FS",
	"input_documents": "60K0000101",
	"params": {
		"StoreGateway_ID": "1000000101",
		"DocQueue_ID": "X000000101",
	}
}

Doklad Vyskladnění z pozic se vytvoří, ale nemá obsah (neobsahuje žádné řádky). V čem je chyba? Podporuje Web API plnohodnotné vytváření polohovacích dokladů?

V těle požadavku nejsou obsaženy některé parametry, které jsou pro automatické polohování zapotřebí. Podívejte se na ilustrační příklad.

Zkusil jsem založit firmu se dvěma osobami ve firmě. Firma se mi však založila s jedinou osobou. Jak je to možné?

Při používání metod POST a PUT je zapotřebí zacházet obezřetně s vlastností ID. Může nastat scénář ilustrovaný následujícím příkladem.

Příklad ...

POST http://localhost/data/firms HTTP/1.1
Host: localhost
Content-Type: application/json
Authorization: Basic QVBJOmFwaQ==
Cache-Control: no-cache
Postman-Token: d5910570-9efd-43a6-9b5c-4ee2121d21a1
{
	"name": "Web API firma",
	"firmpersons": [
		{
			"Person_ID": "4U00000101"
		},
		{
			"ID": "N400000101",
			"Person_ID": "L000000101"
		}
	]
}

Pokud systém přidělí první zakládané osobě ve firmě (navázané na osobu 4U00000101) jiné ID než N400000101, je vše v pořádku a volání metody POST založí firmu se dvěma připojenými osobami. Pokud se však první osobě náhodou přidělí ID N400000101 (což není možné ovlivnit), při připojování druhé osoby dojde k přepsání první připojené osoby a v konečném důsledku se k firmě připojí jenom jedna osoba (druhá z uvedených). Chybou je uvádění ID v těle požadavku.