{ "openapi": "3.0.1", "info": { "title": "Czech VAT Checker & Supplier Bank Account Monitor", "description": "Check up to 10,000 Czech VAT IDs against the official ADIS register. Monitor unreliable-payer status and published supplier bank accounts, compare invoice accounts, and export typed changes between runs. Failed checks preserve the last verified baseline.", "version": "0.1", "x-build-id": "9vg3KNSNMv2mIilBP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automa-flow~czech-vat-supplier-change-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automa-flow-czech-vat-supplier-change-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/automa-flow~czech-vat-supplier-change-monitor/runs": { "post": { "operationId": "runs-sync-automa-flow-czech-vat-supplier-change-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/automa-flow~czech-vat-supplier-change-monitor/run-sync": { "post": { "operationId": "run-sync-automa-flow-czech-vat-supplier-change-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "suppliers" ], "properties": { "suppliers": { "title": "Supplier watchlist", "minItems": 1, "maxItems": 10000, "type": "array", "description": "One row per supplier. vatId accepts CZ, spaces and dashes; 8-digit DIC are checksum-validated before any request is sent. reference is echoed back unchanged so results join to your ERP. expectedBankAccount is optional and is compared only against the accounts the tax authority currently publishes.", "items": { "type": "object", "required": [ "vatId" ], "properties": { "vatId": { "title": "Supplier DIC", "type": "string", "description": "Czech VAT ID / DIC. The CZ prefix, spaces and dashes are normalized away; the official service takes 8-10 digits. An 8-digit DIC must pass the ICO checksum.", "editor": "textfield", "maxLength": 64 }, "reference": { "title": "Your reference", "type": "string", "description": "Optional AP, ERP, vendor or invoice join key, echoed unchanged in this row's result and never written to logs.", "editor": "textfield", "maxLength": 200 }, "expectedBankAccount": { "title": "Invoice / payment account", "type": "string", "description": "Optional. Czech domestic form ([prefix-]number/bankCode) or an IBAN. A Czech IBAN and its domestic form are treated as the same account. The result says whether it is among the accounts the tax authority publishes for this DIC - not whether a payment is safe.", "editor": "textfield", "maxLength": 64 } }, "additionalProperties": false } }, "monitorKey": { "title": "Monitor key", "pattern": "^[A-Za-z0-9_-]{1,80}$", "minLength": 1, "maxLength": 80, "type": "string", "description": "Names the stored baseline this run compares against. Use one key per watchlist (for example accounts-payable-prod). Changing it starts a fresh baseline.", "default": "default" }, "mode": { "title": "What to return", "enum": [ "changesOnly", "snapshotAndChanges" ], "type": "string", "description": "changesOnly returns the first-run baseline and, after that, only suppliers whose official record changed. snapshotAndChanges also returns every unchanged supplier's current status.", "default": "changesOnly" }, "firstRunBehavior": { "title": "First run", "enum": [ "emitCurrent", "baselineOnly" ], "type": "string", "description": "emitCurrent returns every supplier's current status on the first run under a monitor key. baselineOnly stores the baseline silently so the first scheduled alert is a real change.", "default": "emitCurrent" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }