From 15ad379c50c9be77d01ce9728b426cc743ef48a0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Robert=20Mo=C5=84ka?= <robert.monka@versanis.pl>
Date: Thu, 14 May 2026 15:32:33 +0200
Subject: [PATCH] feat(datasources): add WebArm Comarch Optima API datasource

Add new `optima-api` engine for WebArm Comarch Optima ERP integration.
Includes configuration fields for api_base, api_key, and optional firma
selector with a test snippet that validates connectivity via /api/bazy.
---
 anton/core/datasources/datasources.md | 31 +++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/anton/core/datasources/datasources.md b/anton/core/datasources/datasources.md
index 26727b10..f046668f 100644
--- a/anton/core/datasources/datasources.md
+++ b/anton/core/datasources/datasources.md
@@ -604,6 +604,37 @@ test_snippet: |
 BigCommerce API tokens can be created in the BigCommerce control panel under Advanced Settings → API Accounts. Choose "Create API Account", then select "V2/V3 API Token" and grant the necessary permissions (e.g. "Products: Read-Only" to access product data).
 ---
 
+## WebArm Comarch Optima API
+
+```yaml
+engine: optima-api
+display_name: WebArm Comarch Optima API
+pip: httpx
+popular: false
+name_from: [api_base, firma]
+fields:
+  - { name: api_base, required: true,  secret: false, description: "Base URL of the WebArm Comarch Optima API, including scheme and port if needed (e.g. http://server:5000 or https://optima.example.com)" }
+  - { name: api_key,  required: true,  secret: true,  description: "API key/token sent in the X-Api-Key header" }
+  - { name: firma,    required: false, secret: false, description: "Optima company selector for X-Optima-Firma; use Baz_BazID when the company name contains non-ASCII characters" }
+test_snippet: |
+  import httpx, os
+  api_base = os.environ['DS_API_BASE'].rstrip('/')
+  api_key = os.environ['DS_API_KEY']
+  firma = os.environ.get('DS_FIRMA', '').strip()
+  headers = {'X-Api-Key': api_key}
+  if firma:
+      headers['X-Optima-Firma'] = firma
+  r = httpx.get(f'{api_base}/api/bazy', headers=headers, timeout=10)
+  assert r.status_code < 400, f'HTTP {r.status_code}: {r.text[:200]}'
+  print("ok")
+```
+
+WebArm Comarch Optima API is a REST API wrapper for Comarch Optima ERP. Use the public server URL
+as `api_base`; include a port only when the deployment is not published through a reverse proxy.
+The connection test calls `/api/bazy`, which validates `X-Api-Key` and lists available Optima
+companies without requiring `X-Optima-Firma`.
+---
+
 ## TimescaleDB
 
 ```yaml