Firmenwatch — Swiss Company Register
Search and verify Swiss companies, UID status and register changes with dated official sources.
使うべきか
品質と安全性
A
検出事項（2）
- LOWTool 'firma_suchen' description lacks action verbfirma_suchen 内
- LOWTool 'bestand_status' description lacks action verbbestand_status 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~10,851トークン数（ツール定義）
~20.2 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 8.48%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"firmenwatch": {
"url": "https://firmenwatch.ch/api/mcp"
}
}
}リモートエンドポイント
https://firmenwatch.ch/api/mcpstreamable-httpできること
ツール一覧
ツール（6）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢firma_suchen(suchbegriff, kanton, status, anzahl)
Sucht Firmen im Schweizer Handelsregister nach Name oder UID. Liefert Firma, UID, Rechtsform, Sitz, Adresse und Status. Nutze dies, wenn die UID nicht bekannt ist.
入力スキーマ
{
"type": "object",
"properties": {
"suchbegriff": {
"type": "string",
"minLength": 2,
"maxLength": 160,
"description": "Firmenname oder Teil davon, oder eine UID wie CHE-123.456.789"
},
"kanton": {
"type": "string",
"description": "Kantonskürzel, z. B. ZH. Erlaubt: AG, AI, AR, BE, BL, BS, FR, GE, GL, GR, JU, LU, NE, NW, OW, SG, SH, SO, SZ, TG, TI, UR, VD, VS, ZG, ZH"
},
"status": {
"type": "string",
"enum": [
"active",
"in_liquidation",
"bankrupt",
"deleted"
],
"description": "Auf einen Status einschränken"
},
"anzahl": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"description": "Höchstzahl Treffer, 1 bis 25",
"default": 10
}
},
"required": [
"suchbegriff"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"treffer_gesamt": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"weitere_treffer": {
"type": "boolean"
},
"firmen": {
"type": "array",
"items": {
"type": "object",
"required": [
"firma",
"uid",
"rechtsform",
"sitz",
"kanton",
"adresse",
"status",
"letzte_meldung",
"profil"
],
"properties": {
"firma": {
"type": "string"
},
"uid": {
"type": "string"
},
"rechtsform": {
"type": [
"string",
"null"
]
},
"sitz": {
"type": [
"string",
"null"
]
},
"kanton": {
"type": [
"string",
"null"
]
},
"adresse": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string",
"enum": [
"active",
"in_liquidation",
"bankrupt",
"deleted"
]
},
"letzte_meldung": {
"type": [
"string",
"null"
],
"format": "date"
},
"profil": {
"type": "string",
"format": "uri"
}
}
}
},
"datenstand": {
"type": [
"string",
"null"
],
"format": "date"
},
"neueste_verfuegbare_publikation": {
"type": [
"string",
"null"
],
"format": "date"
},
"lueckenlos_verifiziert_bis": {
"type": [
"string",
"null"
],
"format": "date"
},
"datenqualitaetsstatus": {
"type": "string",
"enum": [
"current",
"processing",
"degraded",
"unavailable"
]
},
"unvollstaendig_ab": {
"type": [
"string",
"null"
],
"format": "date"
},
"historienabdeckung": {
"type": "object",
"required": [
"ab",
"vollstaendigkeit_zugesichert",
"fruehere_stichtage_verfuegbar"
],
"properties": {
"ab": {
"type": "string",
"format": "date",
"const": "2025-01-03"
},
"vollstaendigkeit_zugesichert": {
"type": "boolean",
"const": false
},
"fruehere_stichtage_verfuegbar": {
"type": "boolean",
"const": false
}
}
},
"quellen": {
"type": "object",
"required": [
"stammdaten",
"aktualisierungen"
],
"properties": {
"stammdaten": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
},
"aktualisierungen": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"quellenhinweis": {
"type": "string"
},
"hinweis": {
"type": "string"
},
"fehler": {
"type": "string",
"minLength": 1
},
"code": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"required": [
"fehler"
]
},
{
"required": [
"treffer_gesamt",
"weitere_treffer",
"firmen",
"datenstand",
"datenqualitaetsstatus",
"hinweis"
],
"not": {
"required": [
"fehler"
]
}
}
]
}🟢firma_details(uid, mit_verlauf)
Liefert die öffentlichen Angaben zu einer Firma anhand der UID: Stammdaten, Registerkapital nur mit belegter Währung, Personen- und Organabdeckung ohne Namen, Revision, Registerbefunde, belegbare Registerbezüge und den jüngsten Verlauf sowie den aktuellen MWST-, FINMA- und SECO-Abgleich mit amtlicher Quelle, Stand und Grenzen. Der öffentliche KI-Zugang gibt keine Namen natürlicher Personen und keine Finanzschätzungen aus.
入力スキーマ
{
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "UID im Format CHE-123.456.789 oder nur die neun Ziffern"
},
"mit_verlauf": {
"type": "boolean",
"description": "Meldungsverlauf mitliefern",
"default": true
}
},
"required": [
"uid"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"firma": {
"type": "string"
},
"uid": {
"type": "string"
},
"rechtsform_code": {
"type": [
"string",
"null"
]
},
"rechtsform": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string",
"enum": [
"active",
"in_liquidation",
"bankrupt",
"deleted"
]
},
"sitz": {
"type": [
"string",
"null"
]
},
"kanton": {
"type": [
"string",
"null"
]
},
"adresse": {
"type": "object",
"required": [
"strasse",
"hausnummer",
"plz",
"ort"
],
"properties": {
"nicht_oeffentlich": {
"type": "boolean",
"const": true
},
"strasse": {
"type": [
"string",
"null"
]
},
"hausnummer": {
"type": [
"string",
"null"
]
},
"plz": {
"type": [
"string",
"null"
]
},
"ort": {
"type": [
"string",
"null"
]
}
}
},
"kapital_nominal": {
"type": "number",
"minimum": 0
},
"kapital_einbezahlt": {
"type": [
"number",
"null"
],
"minimum": 0
},
"kapital_waehrung": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"zweck": {
"type": [
"string",
"null"
]
},
"branche": {
"type": "string"
},
"branchenableitung": {
"type": "object",
"required": [
"code",
"konfidenz",
"einordnung",
"basis"
],
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"konfidenz": {
"type": "number",
"minimum": 0.45,
"maximum": 1
},
"einordnung": {
"type": "string",
"enum": [
"derived",
"probable"
]
},
"basis": {
"type": "string",
"const": "registered_purpose_text"
}
}
},
"erstmals_eingetragen": {
"type": [
"string",
"null"
],
"format": "date"
},
"geloescht_am": {
"type": [
"string",
"null"
],
"format": "date"
},
"letzte_meldung": {
"type": [
"string",
"null"
],
"format": "date"
},
"verlauf": {
"type": "array",
"items": {
"type": "object",
"required": [
"ereignis_id",
"publikations_id",
"datum",
"art",
"art_code",
"beschreibung",
"amtlicher_beleg"
],
"properties": {
"ereignis_id": {
"type": "string"
},
"publikations_id": {
"type": "string"
},
"datum": {
"type": "string",
"format": "date"
},
"art": {
"type": "string"
},
"art_code": {
"type": "string",
"enum": [
"new_registration",
"name_change",
"address_change",
"seat_change",
"purpose_change",
"capital_change",
"legal_form_change",
"officer_added",
"officer_removed",
"auditor_change",
"liquidation_opened",
"liquidation_closed",
"deletion",
"bankruptcy_opened",
"bankruptcy_suspended",
"bankruptcy_closed",
"moratorium",
"debt_enforcement",
"branch_opened",
"branch_closed",
"merger",
"other"
]
},
"beschreibung": {
"type": [
"string",
"null"
]
},
"amtlicher_beleg": {
"type": "string",
"format": "uri"
}
}
}
},
"profil": {
"type": "string",
"format": "uri"
},
"datenstand": {
"type": [
"string",
"null"
],
"format": "date"
},
"analyse": {
"type": "object",
"required": [
"basis",
"data_status",
"officer_overview",
"event_history",
"sources",
"legal_effect"
],
"properties": {
"basis": {
"type": "string",
"const": "register_evidence_only",
"description": "Ausschliesslich Registerstammdaten und erfasste SHAB-Ereignisse; keine Finanzschaetzungen."
},
"data_status": {
"type": "object",
"required": [
"latest_available_publication",
"verified_through",
"quality",
"incomplete_from"
],
"description": "Kanonischer Firmenwatch-Datenqualitaetsstatus. Ein neueres Maximaldatum ist kein Vollstaendigkeitsbeleg; fuer lueckenlose Aussagen gilt verified_through.",
"properties": {
"latest_available_publication": {
"type": [
"string",
"null"
],
"format": "date"
},
"verified_through": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Letzter Publikationstag vor jeder bekannten offenen technischen Freigabebarriere."
},
"quality": {
"type": "string",
"enum": [
"current",
"processing",
"degraded",
"unavailable"
]
},
"incomplete_from": {
"type": [
"string",
"null"
],
"format": "date"
}
}
},
"registered_capital": {
"type": "object",
"required": [
"verification",
"nominal",
"paid",
"currency",
"evidence_basis",
"publication"
],
"properties": {
"verification": {
"type": "string",
"const": "currency_evidenced",
"description": "Der Registerbetrag wird nur ausgegeben, wenn der zugehoerige ISO-Waehrungscode in einer erfassten SHAB-Publikation belegt ist."
},
"nominal": {
"type": "number",
"minimum": 0
},
"paid": {
"type": [
"number",
"null"
],
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"evidence_basis": {
"type": "string",
"const": "structured_shab_company_capital",
"description": "Betrag und ISO-Waehrung stammen aus demselben strukturierten Zustandsblock einer amtlichen SHAB-Publikation."
},
"publication": {
"type": "object",
"required": [
"id",
"date",
"number",
"sub_rubric",
"state",
"url"
],
"properties": {
"id": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"number": {
"type": [
"string",
"null"
]
},
"sub_rubric": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"commonsActual",
"commonsNew"
]
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"industry_classification": {
"type": "object",
"required": [
"label",
"code",
"confidence",
"qualification",
"basis"
],
"properties": {
"label": {
"type": "string"
},
"code": {
"type": [
"string",
"null"
]
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"qualification": {
"type": "string",
"enum": [
"derived",
"probable"
]
},
"basis": {
"type": "string",
"const": "registered_purpose_text"
}
}
},
"officer_overview": {
"type": "object",
"required": [
"observed_active_entries",
"observed_former_entries",
"observed_total_entries",
"scope"
],
"properties": {
"observed_active_entries": {
"type": "integer",
"minimum": 0
},
"observed_former_entries": {
"type": "integer",
"minimum": 0
},
"observed_total_entries": {
"type": "integer",
"minimum": 0
},
"scope": {
"type": "object",
"required": [
"basis",
"coverage",
"verified_complete",
"basis_publication_id",
"basis_date",
"observed_from",
"observed_through",
"state_updated_at",
"result_interpretation",
"description",
"empty_result_means",
"official_register_url"
],
"properties": {
"basis": {
"type": "string",
"const": "captured_shab_history"
},
"coverage": {
"type": "string",
"enum": [
"none",
"partial",
"complete"
]
},
"verified_complete": {
"type": "boolean"
},
"basis_publication_id": {
"type": [
"string",
"null"
]
},
"basis_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"observed_from": {
"type": [
"string",
"null"
],
"format": "date"
},
"observed_through": {
"type": [
"string",
"null"
],
"format": "date"
},
"state_updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"result_interpretation": {
"type": "string",
"enum": [
"observed_entries",
"no_entries",
"data_being_completed"
]
},
"description": {
"type": "string"
},
"empty_result_means": {
"type": [
"string",
"null"
]
},
"official_register_url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"revision": {
"type": "object",
"required": [
"opting_out",
"statement",
"basis",
"publication"
],
"properties": {
"opting_out": {
"type": "boolean"
},
"statement": {
"type": "string"
},
"basis": {
"type": "string",
"const": "structured_shab_revision"
},
"publication": {
"type": "object",
"required": [
"id",
"date",
"number",
"sub_rubric",
"state",
"url"
],
"properties": {
"id": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"number": {
"type": [
"string",
"null"
]
},
"sub_rubric": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"commonsActual",
"commonsNew"
]
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"registered_domicile": {
"type": "object",
"required": [
"no_address",
"status",
"evidence_basis",
"publication"
],
"properties": {
"no_address": {
"type": "boolean",
"const": true
},
"status": {
"type": "string",
"const": "officially_marked_no_address"
},
"evidence_basis": {
"type": "string",
"const": "structured_shab_company_no_address"
},
"publication": {
"type": "object",
"required": [
"id",
"date",
"number",
"sub_rubric",
"state",
"url"
],
"properties": {
"id": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"number": {
"type": [
"string",
"null"
]
},
"sub_rubric": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"commonsActual",
"commonsNew"
]
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"first_registration": {
"type": "object",
"required": [
"date",
"evidence_basis",
"publication"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "SHAB publication date of the earliest evidenced new registration; not the cantonal journal date."
},
"evidence_basis": {
"type": "string",
"const": "structured_shab_new_registration"
},
"publication": {
"type": "object",
"required": [
"id",
"date",
"number",
"sub_rubric",
"state",
"url"
],
"properties": {
"id": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"number": {
"type": [
"string",
"null"
]
},
"sub_rubric": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"commonsActual",
"commonsNew"
]
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"event_history": {
"type": "object",
"required": [
"captured_publications",
"evaluated_events",
"evaluated_from",
"evaluated_through",
"possibly_more_events",
"by_type",
"coverage"
],
"properties": {
"captured_publications": {
"type": "integer",
"minimum": 0
},
"evaluated_events": {
"type": "integer",
"minimum": 0,
"maximum": 200
},
"evaluated_from": {
"type": [
"string",
"null"
],
"format": "date"
},
"evaluated_through": {
"type": [
"string",
"null"
],
"format": "date"
},
"possibly_more_events": {
"type": "boolean"
},
"by_type": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"label",
"count"
],
"properties": {
"type": {
"type": "string"
},
"label": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 1
}
}
}
},
"coverage": {
"type": "object",
"required": [
"available_from",
"complete_history_guaranteed",
"before_start"
],
"properties": {
"available_from": {
"type": "string",
"format": "date",
"const": "2025-01-03"
},
"complete_history_guaranteed": {
"type": "boolean",
"const": false
},
"before_start": {
"type": "string",
"const": "not_available"
}
}
}
}
},
"register_findings": {
"type": "object",
"required": [
"classification",
"score",
"method",
"findings",
"limitation"
],
"properties": {
"classification": {
"type": "string",
"enum": [
"keine",
"beobachten",
"erhoeht",
"kritisch"
]
},
"score": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"method": {
"type": "string",
"const": "transparent_rules_on_register_facts"
},
"findings": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"code",
"label",
"weight",
"detail",
"since"
],
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string"
},
"weight": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"detail": {
"type": "string"
},
"since": {
"type": [
"string",
"null"
],
"format": "date"
}
}
}
},
"limitation": {
"type": "string"
}
}
},
"register_relationships": {
"type": "object",
"required": [
"returned_companies",
"possibly_more_companies",
"evidence_basis",
"companies_by_evidence",
"companies",
"interpretation_limit"
],
"properties": {
"returned_companies": {
"type": "integer",
"minimum": 0,
"maximum": 12
},
"possibly_more_companies": {
"type": "boolean"
},
"evidence_basis": {
"type": "object",
"required": [
"registered_address",
"person_auditor_shareholder_entries",
"officer_scope_reference"
],
"properties": {
"registered_address": {
"type": "string",
"const": "imported_register_master_data"
},
"person_auditor_shareholder_entries": {
"type": "string",
"const": "captured_shab_officer_projection"
},
"officer_scope_reference": {
"type": "string",
"const": "officer_overview.scope"
}
}
},
"registered_entities_at_same_address": {
"type": "integer",
"minimum": 2
},
"companies_by_evidence": {
"type": "object",
"required": [
"same_registered_address",
"shared_person_entries",
"shared_auditor_entries",
"shared_shareholder_entries"
],
"properties": {
"same_registered_address": {
"type": "integer",
"minimum": 0
},
"shared_person_entries": {
"type": "integer",
"minimum": 0
},
"shared_auditor_entries": {
"type": "integer",
"minimum": 0
},
"shared_shareholder_entries": {
"type": "integer",
"minimum": 0
}
}
},
"companies": {
"type": "array",
"maxItems": 12,
"items": {
"type": "object",
"required": [
"uid",
"name",
"status",
"canton",
"town",
"profile",
"evidence"
],
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"canton": {
"type": [
"string",
"null"
]
},
"town": {
"type": [
"string",
"null"
]
},
"profile": {
"type": "string",
"format": "uri"
},
"evidence": {
"type": "object",
"required": [
"same_registered_address",
"shared_person_entries",
"shared_auditor_entries",
"shared_shareholder_entries"
],
"properties": {
"same_registered_address": {
"type": "boolean"
},
"shared_person_entries": {
"type": "integer",
"minimum": 0
},
"shared_auditor_entries": {
"type": "integer",
"minimum": 0
},
"shared_shareholder_entries": {
"type": "integer",
"minimum": 0
}
}
}
}
}
},
"interpretation_limit": {
"type": "string",
"const": "A register relationship alone does not prove control, ownership or group membership."
}
}
},
"sources": {
"type": "object",
"required": [
"master_data",
"publications"
],
"properties": {
"master_data": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string",
"const": "Zefix dataset via LINDAS"
},
"url": {
"type": "string",
"format": "uri"
}
}
},
"publications": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"legal_effect": {
"type": "string",
"const": "not_an_official_register_extract"
}
}
},
"compliance": {
"type": "object",
"required": [
"basis",
"vat",
"finma",
"seco",
"sources",
"legal_effect"
],
"properties": {
"basis": {
"type": "string",
"const": "official_external_sources"
},
"vat": {
"type": "object",
"required": [
"status",
"uid_vat",
"entry_date",
"end_date",
"source_checked_at",
"source"
],
"properties": {
"status": {
"type": "string",
"enum": [
"active",
"registered",
"ended",
"not_registered",
"unknown",
"unavailable"
],
"description": "Amtlicher MWST-Status der konkreten UID. unknown und unavailable sind ausdrücklich keine Negativaussage."
},
"uid_vat": {
"type": [
"string",
"null"
]
},
"entry_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"end_date": {
"type": [
"string",
"null"
],
"format": "date"
},
"source_checked_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"source": {
"oneOf": [
{
"type": "object",
"required": [
"key",
"name",
"url",
"machine_url",
"source_date",
"checked_at",
"source_date_basis",
"coverage_status",
"coverage_verified_through",
"record_checked_at",
"freshness_basis",
"fetched_at",
"activated_at",
"source_version",
"freshness",
"freshness_problem_after_hours",
"limitation"
],
"properties": {
"key": {
"type": "string",
"enum": [
"uid_vat",
"finma_authorisations",
"finma_warnings",
"seco_sanctions"
]
},
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"machine_url": {
"type": "string",
"format": "uri"
},
"source_date": {
"type": "string",
"format": "date"
},
"source_date_basis": {
"type": "string",
"enum": [
"uid_delta_window_end",
"http_last_modified",
"latest_entry_publication_date",
"official_list_issue_date"
],
"description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at."
},
"coverage_status": {
"type": "string",
"enum": [
"not_applicable",
"delta_only",
"building",
"complete"
],
"description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden."
},
"coverage_verified_through": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag."
},
"record_checked_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung."
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"freshness_basis": {
"type": "string",
"enum": [
"source_last_success_at",
"record_checked_at",
"complete_coverage_last_success_at"
]
},
"fetched_at": {
"type": "string",
"format": "date-time"
},
"activated_at": {
"type": "string",
"format": "date-time"
},
"source_version": {
"type": "string"
},
"freshness": {
"type": "string",
"enum": [
"fresh",
"stale_warning",
"stale_problem"
]
},
"freshness_problem_after_hours": {
"type": "integer",
"minimum": 1
},
"limitation": {
"type": "string"
}
}
},
{
"type": "null"
}
]
}
}
},
"finma": {
"type": "object",
"required": [
"authorisation_check",
"authorisations_total",
"authorisations_truncated",
"authorisations",
"warning_check",
"warning_matches_total",
"warning_matches_truncated",
"warning_matches",
"authorisations_source",
"warnings_source"
],
"properties": {
"authorisation_check": {
"type": "string",
"enum": [
"listed",
"no_uid_match",
"unavailable"
],
"description": "Exakter UID-Abgleich mit der veröffentlichten FINMA-Liste. no_uid_match bedeutet nur, dass diese UID im geprüften Listenstand nicht vorkommt."
},
"authorisations_total": {
"type": "integer",
"minimum": 0,
"description": "Exakte Zahl der UID-Treffer vor der begrenzten Ausgabe."
},
"authorisations_truncated": {
"type": "boolean"
},
"authorisations": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_record_id",
"name",
"city",
"uid",
"authorisation_type"
],
"properties": {
"source_record_id": {
"type": "string"
},
"name": {
"type": "string"
},
"city": {
"type": "string"
},
"uid": {
"type": [
"string",
"null"
]
},
"authorisation_type": {
"type": "string"
}
}
}
},
"warning_check": {
"type": "string",
"enum": [
"possible_match",
"no_exact_name_location_match",
"unavailable"
],
"description": "Konservativer Abgleich von exaktem Firmennamen und Ort. Ein Ergebnis ist weder Identitäts- noch Unbedenklichkeitsnachweis."
},
"warning_matches_total": {
"type": "integer",
"minimum": 0,
"description": "Exakte Zahl der Namens-/Ortstreffer vor der begrenzten Ausgabe."
},
"warning_matches_truncated": {
"type": "boolean"
},
"warning_matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_record_id",
"title",
"name",
"seat",
"warning_date",
"official_url",
"match_basis",
"identity"
],
"properties": {
"source_record_id": {
"type": "string"
},
"title": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"seat": {
"type": [
"string",
"null"
]
},
"warning_date": {
"type": "string",
"format": "date"
},
"official_url": {
"type": "string",
"format": "uri"
},
"match_basis": {
"type": "string",
"enum": [
"exact_register_reference",
"exact_name_and_location"
]
},
"identity": {
"type": "string",
"enum": [
"confirmed_by_register_reference",
"candidate_requires_review"
]
}
}
}
},
"authorisations_source": {
"oneOf": [
{
"type": "object",
"required": [
"key",
"name",
"url",
"machine_url",
"source_date",
"checked_at",
"source_date_basis",
"coverage_status",
"coverage_verified_through",
"record_checked_at",
"freshness_basis",
"fetched_at",
"activated_at",
"source_version",
"freshness",
"freshness_problem_after_hours",
"limitation"
],
"properties": {
"key": {
"type": "string",
"enum": [
"uid_vat",
"finma_authorisations",
"finma_warnings",
"seco_sanctions"
]
},
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"machine_url": {
"type": "string",
"format": "uri"
},
"source_date": {
"type": "string",
"format": "date"
},
"source_date_basis": {
"type": "string",
"enum": [
"uid_delta_window_end",
"http_last_modified",
"latest_entry_publication_date",
"official_list_issue_date"
],
"description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at."
},
"coverage_status": {
"type": "string",
"enum": [
"not_applicable",
"delta_only",
"building",
"complete"
],
"description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden."
},
"coverage_verified_through": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag."
},
"record_checked_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung."
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"freshness_basis": {
"type": "string",
"enum": [
"source_last_success_at",
"record_checked_at",
"complete_coverage_last_success_at"
]
},
"fetched_at": {
"type": "string",
"format": "date-time"
},
"activated_at": {
"type": "string",
"format": "date-time"
},
"source_version": {
"type": "string"
},
"freshness": {
"type": "string",
"enum": [
"fresh",
"stale_warning",
"stale_problem"
]
},
"freshness_problem_after_hours": {
"type": "integer",
"minimum": 1
},
"limitation": {
"type": "string"
}
}
},
{
"type": "null"
}
]
},
"warnings_source": {
"oneOf": [
{
"type": "object",
"required": [
"key",
"name",
"url",
"machine_url",
"source_date",
"checked_at",
"source_date_basis",
"coverage_status",
"coverage_verified_through",
"record_checked_at",
"freshness_basis",
"fetched_at",
"activated_at",
"source_version",
"freshness",
"freshness_problem_after_hours",
"limitation"
],
"properties": {
"key": {
"type": "string",
"enum": [
"uid_vat",
"finma_authorisations",
"finma_warnings",
"seco_sanctions"
]
},
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"machine_url": {
"type": "string",
"format": "uri"
},
"source_date": {
"type": "string",
"format": "date"
},
"source_date_basis": {
"type": "string",
"enum": [
"uid_delta_window_end",
"http_last_modified",
"latest_entry_publication_date",
"official_list_issue_date"
],
"description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at."
},
"coverage_status": {
"type": "string",
"enum": [
"not_applicable",
"delta_only",
"building",
"complete"
],
"description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden."
},
"coverage_verified_through": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag."
},
"record_checked_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung."
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"freshness_basis": {
"type": "string",
"enum": [
"source_last_success_at",
"record_checked_at",
"complete_coverage_last_success_at"
]
},
"fetched_at": {
"type": "string",
"format": "date-time"
},
"activated_at": {
"type": "string",
"format": "date-time"
},
"source_version": {
"type": "string"
},
"freshness": {
"type": "string",
"enum": [
"fresh",
"stale_warning",
"stale_problem"
]
},
"freshness_problem_after_hours": {
"type": "integer",
"minimum": 1
},
"limitation": {
"type": "string"
}
}
},
{
"type": "null"
}
]
}
}
},
"seco": {
"type": "object",
"required": [
"direct_match_check",
"candidates_total",
"candidates_truncated",
"candidates",
"source"
],
"properties": {
"direct_match_check": {
"type": "string",
"enum": [
"possible_match",
"no_exact_match",
"unavailable"
],
"description": "Exakter Abgleich mit direkt gelisteten amtlichen Haupt- und Alternativnamen; Eigentums- und Kontrollbeziehungen sind nicht abschliessend erfasst."
},
"candidates_total": {
"type": "integer",
"minimum": 0,
"description": "Exakte Zahl der amtlich belegten Namenstreffer vor der begrenzten Ausgabe."
},
"candidates_truncated": {
"type": "boolean"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_record_id",
"name",
"matched_name",
"matched_name_kind",
"program",
"listing_effective_date",
"listing_effective_date_basis",
"country_code",
"official_search_url",
"machine_evidence_url",
"address",
"match_basis",
"identity"
],
"properties": {
"source_record_id": {
"type": "string"
},
"name": {
"type": "string"
},
"matched_name": {
"type": "string"
},
"matched_name_kind": {
"type": "string",
"enum": [
"primary_name",
"official_alias",
"former_name",
"spelling_variant"
]
},
"program": {
"type": "string"
},
"listing_effective_date": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Wirksamkeitsdatum der juengsten amtlichen listed-Modifikation; bleibt null, wenn die Quelle kein solches Datum nennt."
},
"listing_effective_date_basis": {
"type": "string",
"const": "latest_official_listed_modification_effective_date"
},
"country_code": {
"type": [
"string",
"null"
]
},
"official_search_url": {
"type": "string",
"format": "uri",
"description": "Menschenlesbare offizielle SECO-Suche; die SSID steht in source_record_id."
},
"machine_evidence_url": {
"type": "string",
"format": "uri",
"description": "Fuer den Abgleich verwendete amtliche XML-Gesamtliste; fuer Maschinen, nicht als leichter Einzellink."
},
"address": {
"type": [
"string",
"null"
]
},
"match_basis": {
"type": "string",
"enum": [
"exact_legal_name",
"exact_legal_name_and_location",
"exact_official_alias"
]
},
"identity": {
"type": "string",
"const": "candidate_requires_review"
}
}
}
},
"source": {
"oneOf": [
{
"type": "object",
"required": [
"key",
"name",
"url",
"machine_url",
"source_date",
"checked_at",
"source_date_basis",
"coverage_status",
"coverage_verified_through",
"record_checked_at",
"freshness_basis",
"fetched_at",
"activated_at",
"source_version",
"freshness",
"freshness_problem_after_hours",
"limitation"
],
"properties": {
"key": {
"type": "string",
"enum": [
"uid_vat",
"finma_authorisations",
"finma_warnings",
"seco_sanctions"
]
},
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"machine_url": {
"type": "string",
"format": "uri"
},
"source_date": {
"type": "string",
"format": "date"
},
"source_date_basis": {
"type": "string",
"enum": [
"uid_delta_window_end",
"http_last_modified",
"latest_entry_publication_date",
"official_list_issue_date"
],
"description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at."
},
"coverage_status": {
"type": "string",
"enum": [
"not_applicable",
"delta_only",
"building",
"complete"
],
"description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden."
},
"coverage_verified_through": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag."
},
"record_checked_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung."
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"freshness_basis": {
"type": "string",
"enum": [
"source_last_success_at",
"record_checked_at",
"complete_coverage_last_success_at"
]
},
"fetched_at": {
"type": "string",
"format": "date-time"
},
"activated_at": {
"type": "string",
"format": "date-time"
},
"source_version": {
"type": "string"
},
"freshness": {
"type": "string",
"enum": [
"fresh",
"stale_warning",
"stale_problem"
]
},
"freshness_problem_after_hours": {
"type": "integer",
"minimum": 1
},
"limitation": {
"type": "string"
}
}
},
{
"type": "null"
}
]
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"name",
"url",
"machine_url",
"source_date",
"checked_at",
"source_date_basis",
"coverage_status",
"coverage_verified_through",
"record_checked_at",
"freshness_basis",
"fetched_at",
"activated_at",
"source_version",
"freshness",
"freshness_problem_after_hours",
"limitation"
],
"properties": {
"key": {
"type": "string",
"enum": [
"uid_vat",
"finma_authorisations",
"finma_warnings",
"seco_sanctions"
]
},
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"machine_url": {
"type": "string",
"format": "uri"
},
"source_date": {
"type": "string",
"format": "date"
},
"source_date_basis": {
"type": "string",
"enum": [
"uid_delta_window_end",
"http_last_modified",
"latest_entry_publication_date",
"official_list_issue_date"
],
"description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at."
},
"coverage_status": {
"type": "string",
"enum": [
"not_applicable",
"delta_only",
"building",
"complete"
],
"description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden."
},
"coverage_verified_through": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag."
},
"record_checked_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung."
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"freshness_basis": {
"type": "string",
"enum": [
"source_last_success_at",
"record_checked_at",
"complete_coverage_last_success_at"
]
},
"fetched_at": {
"type": "string",
"format": "date-time"
},
"activated_at": {
"type": "string",
"format": "date-time"
},
"source_version": {
"type": "string"
},
"freshness": {
"type": "string",
"enum": [
"fresh",
"stale_warning",
"stale_problem"
]
},
"freshness_problem_after_hours": {
"type": "integer",
"minimum": 1
},
"limitation": {
"type": "string"
}
}
}
},
"legal_effect": {
"type": "string",
"const": "screening_aid_not_official_confirmation"
}
}
},
"quellen": {
"type": "object",
"required": [
"stammdaten",
"aktualisierungen"
],
"properties": {
"stammdaten": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
},
"aktualisierungen": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"hinweis": {
"type": "string"
},
"fehler": {
"type": "string",
"minLength": 1
},
"code": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"required": [
"fehler"
]
},
{
"required": [
"firma",
"uid",
"status",
"adresse",
"verlauf",
"profil",
"datenstand",
"analyse",
"compliance",
"quellen",
"hinweis"
],
"not": {
"required": [
"fehler"
]
}
}
]
}🟢uid_pruefen(uid)
Prüft eine Schweizer UID auf Format und Prüfziffer (Modulo 11 nach Spezifikation des Bundesamts für Statistik) und schlägt sie im Bestand nach. Nutze dies, bevor du eine UID in ein System übernimmst — Tippfehler werden so erkannt.
入力スキーマ
{
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "Zu prüfende UID"
}
},
"required": [
"uid"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"gueltig": {
"type": "boolean"
},
"normalisiert": {
"type": "string"
},
"im_bestand": {
"type": "boolean"
},
"firma": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"profil": {
"type": [
"string",
"null"
],
"format": "uri"
},
"grund": {
"type": "string"
},
"erlaeuterung": {
"type": "string"
},
"datenstand": {
"type": [
"string",
"null"
],
"format": "date"
},
"neueste_verfuegbare_publikation": {
"type": [
"string",
"null"
],
"format": "date"
},
"lueckenlos_verifiziert_bis": {
"type": [
"string",
"null"
],
"format": "date"
},
"datenqualitaetsstatus": {
"type": "string",
"enum": [
"current",
"processing",
"degraded",
"unavailable"
]
},
"unvollstaendig_ab": {
"type": [
"string",
"null"
],
"format": "date"
},
"historienabdeckung": {
"type": "object",
"required": [
"ab",
"vollstaendigkeit_zugesichert",
"fruehere_stichtage_verfuegbar"
],
"properties": {
"ab": {
"type": "string",
"format": "date",
"const": "2025-01-03"
},
"vollstaendigkeit_zugesichert": {
"type": "boolean",
"const": false
},
"fruehere_stichtage_verfuegbar": {
"type": "boolean",
"const": false
}
}
},
"quellen": {
"type": "object",
"required": [
"stammdaten",
"aktualisierungen"
],
"properties": {
"stammdaten": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
},
"aktualisierungen": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"quellenhinweis": {
"type": "string"
},
"hinweis": {
"type": "string"
},
"fehler": {
"type": "string",
"minLength": 1
},
"code": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"required": [
"fehler"
]
},
{
"required": [
"gueltig"
],
"not": {
"required": [
"fehler"
]
}
}
]
}🟢firma_risiko(uid)
Fasst zusammen, was im Handelsamtsblatt zu einer Firma publiziert wurde und geschäftlich relevant ist: Konkurs, Liquidation, Nachlassstundung, Kapitalherabsetzung und häufige Organwechsel. Jeder Befund ist einzeln benannt und datiert. Dies ist KEINE Bonitätsauskunft und bewertet KEINE natürlichen Personen.
入力スキーマ
{
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "UID der Firma"
}
},
"required": [
"uid"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"firma": {
"type": "string"
},
"uid": {
"type": "string"
},
"verfuegbar": {
"type": "boolean"
},
"stufe_code": {
"type": "string",
"enum": [
"keine",
"beobachten",
"erhoeht",
"kritisch"
]
},
"stufe": {
"type": "string"
},
"punktwert": {
"type": "number"
},
"befunde": {
"type": "array",
"items": {
"type": "object",
"required": [
"befund_code",
"befund",
"gewicht",
"erlaeuterung",
"seit"
],
"properties": {
"befund_code": {
"type": "string"
},
"befund": {
"type": "string"
},
"gewicht": {
"type": "number"
},
"erlaeuterung": {
"type": "string"
},
"seit": {
"type": [
"string",
"null"
],
"format": "date"
}
}
}
},
"einschraenkung": {
"type": "string"
},
"profil": {
"type": "string",
"format": "uri"
},
"datenstand": {
"type": [
"string",
"null"
],
"format": "date"
},
"neueste_verfuegbare_publikation": {
"type": [
"string",
"null"
],
"format": "date"
},
"lueckenlos_verifiziert_bis": {
"type": [
"string",
"null"
],
"format": "date"
},
"datenqualitaetsstatus": {
"type": "string",
"enum": [
"current",
"processing",
"degraded",
"unavailable"
]
},
"unvollstaendig_ab": {
"type": [
"string",
"null"
],
"format": "date"
},
"historienabdeckung": {
"type": "object",
"required": [
"ab",
"vollstaendigkeit_zugesichert",
"fruehere_stichtage_verfuegbar"
],
"properties": {
"ab": {
"type": "string",
"format": "date",
"const": "2025-01-03"
},
"vollstaendigkeit_zugesichert": {
"type": "boolean",
"const": false
},
"fruehere_stichtage_verfuegbar": {
"type": "boolean",
"const": false
}
}
},
"quellen": {
"type": "object",
"required": [
"stammdaten",
"aktualisierungen"
],
"properties": {
"stammdaten": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
},
"aktualisierungen": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"quellenhinweis": {
"type": "string"
},
"hinweis": {
"type": "string"
},
"fehler": {
"type": "string",
"minLength": 1
},
"code": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"required": [
"fehler"
]
},
{
"required": [
"firma",
"uid",
"verfuegbar"
],
"not": {
"required": [
"fehler"
]
}
}
]
}🟢tagesbriefing(datum, arten, kantone, stichwoerter, anzahl)
Liefert die wichtigsten strukturierten Firmenänderungen des jüngsten lückenlos verifizierten Publikationstags und zählt sie nach Art. Nutze dieses Werkzeug für einen täglichen KI-Lauf, ein Morgenbriefing oder eine automatisierte Marktbeobachtung. Optional lässt sich das Briefing nach Kanton, Meldungsart und Stichwort eingrenzen.
入力スキーマ
{
"type": "object",
"properties": {
"datum": {
"type": "string",
"description": "Optionaler Publikationstag JJJJ-MM-TT. Ohne Angabe wird die jüngste lückenlos verifizierte Grenze verwendet."
},
"arten": {
"type": "array",
"items": {
"type": "string",
"enum": [
"new_registration",
"name_change",
"address_change",
"seat_change",
"purpose_change",
"capital_change",
"legal_form_change",
"officer_added",
"officer_removed",
"auditor_change",
"liquidation_opened",
"liquidation_closed",
"deletion",
"bankruptcy_opened",
"bankruptcy_suspended",
"bankruptcy_closed",
"moratorium",
"debt_enforcement",
"branch_opened",
"branch_closed",
"merger",
"other"
]
},
"minItems": 1,
"maxItems": 20,
"description": "Optional auf Meldungsarten einschränken"
},
"kantone": {
"type": "array",
"items": {
"type": "string",
"enum": [
"AG",
"AI",
"AR",
"BE",
"BL",
"BS",
"FR",
"GE",
"GL",
"GR",
"JU",
"LU",
"NE",
"NW",
"OW",
"SG",
"SH",
"SO",
"SZ",
"TG",
"TI",
"UR",
"VD",
"VS",
"ZG",
"ZH"
]
},
"minItems": 1,
"maxItems": 20,
"description": "Optional auf Kantone einschränken"
},
"stichwoerter": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"minItems": 1,
"maxItems": 20,
"description": "Stichwörter im Firmennamen oder bereinigten Meldungstext"
},
"anzahl": {
"type": "integer",
"minimum": 1,
"maximum": 48,
"default": 48
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"publikationstag": {
"type": "string",
"format": "date"
},
"anzahl": {
"type": "integer",
"minimum": 0
},
"begrenzt": {
"type": "boolean"
},
"auswahl_nach_art": {
"type": "object",
"additionalProperties": {
"type": "integer",
"minimum": 1
}
},
"meldungen": {
"type": "array",
"items": {
"type": "object",
"required": [
"ereignis_id",
"datum",
"art",
"art_code",
"beschreibung",
"firma",
"uid",
"rechtsform",
"kanton",
"ort",
"profil",
"amtlicher_beleg"
],
"properties": {
"ereignis_id": {
"type": "string"
},
"datum": {
"type": "string",
"format": "date"
},
"art": {
"type": "string"
},
"art_code": {
"type": "string",
"enum": [
"new_registration",
"name_change",
"address_change",
"seat_change",
"purpose_change",
"capital_change",
"legal_form_change",
"officer_added",
"officer_removed",
"auditor_change",
"liquidation_opened",
"liquidation_closed",
"deletion",
"bankruptcy_opened",
"bankruptcy_suspended",
"bankruptcy_closed",
"moratorium",
"debt_enforcement",
"branch_opened",
"branch_closed",
"merger",
"other"
]
},
"beschreibung": {
"type": [
"string",
"null"
]
},
"firma": {
"type": "string"
},
"uid": {
"type": "string"
},
"rechtsform": {
"type": [
"string",
"null"
]
},
"kanton": {
"type": [
"string",
"null"
]
},
"ort": {
"type": [
"string",
"null"
]
},
"profil": {
"type": "string",
"format": "uri"
},
"amtlicher_beleg": {
"type": "string",
"format": "uri"
}
}
}
},
"datenstand": {
"type": [
"string",
"null"
],
"format": "date"
},
"neueste_verfuegbare_publikation": {
"type": [
"string",
"null"
],
"format": "date"
},
"lueckenlos_verifiziert_bis": {
"type": [
"string",
"null"
],
"format": "date"
},
"datenqualitaetsstatus": {
"type": "string",
"enum": [
"current",
"processing",
"degraded",
"unavailable"
]
},
"unvollstaendig_ab": {
"type": [
"string",
"null"
],
"format": "date"
},
"historienabdeckung": {
"type": "object",
"required": [
"ab",
"vollstaendigkeit_zugesichert",
"fruehere_stichtage_verfuegbar"
],
"properties": {
"ab": {
"type": "string",
"format": "date",
"const": "2025-01-03"
},
"vollstaendigkeit_zugesichert": {
"type": "boolean",
"const": false
},
"fruehere_stichtage_verfuegbar": {
"type": "boolean",
"const": false
}
}
},
"quellen": {
"type": "object",
"required": [
"stammdaten",
"aktualisierungen"
],
"properties": {
"stammdaten": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
},
"aktualisierungen": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"quellenhinweis": {
"type": "string"
},
"hinweis": {
"type": "string"
},
"fehler": {
"type": "string",
"minLength": 1
},
"code": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"required": [
"fehler"
]
},
{
"required": [
"publikationstag",
"anzahl",
"begrenzt",
"auswahl_nach_art",
"meldungen",
"datenstand",
"hinweis"
],
"not": {
"required": [
"fehler"
]
}
}
]
}🟢bestand_status
Trennt die neueste verfügbare Publikation von der lückenlos verifizierten Grenze und meldet den Datenqualitätsstatus. Nennt zusätzlich Frische und Abdeckung von MWST, FINMA und SECO. Nutze dies, bevor du dich auf eine Auskunft verlässt.
入力スキーマ
{
"type": "object",
"properties": {},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"datenstand": {
"type": [
"string",
"null"
],
"format": "date"
},
"neueste_verfuegbare_publikation": {
"type": [
"string",
"null"
],
"format": "date"
},
"lueckenlos_verifiziert_bis": {
"type": [
"string",
"null"
],
"format": "date"
},
"datenqualitaetsstatus": {
"type": "string",
"enum": [
"current",
"processing",
"degraded",
"unavailable"
]
},
"erwartet_bis": {
"type": [
"string",
"null"
],
"format": "date"
},
"alter_in_tagen": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"neueste_publikation_alter_in_tagen": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"aktuell": {
"type": "boolean"
},
"counts_estimated": {
"const": true
},
"firmen": {
"type": "integer",
"minimum": 0
},
"meldungen": {
"type": "integer",
"minimum": 0
},
"publikationen": {
"type": "integer",
"minimum": 0
},
"ereignisstrom_bis": {
"type": "integer",
"minimum": 0
},
"unvollstaendig_ab": {
"type": [
"string",
"null"
],
"format": "date"
},
"unvollstaendiger_scope": {
"type": [
"string",
"null"
]
},
"unvollstaendiger_status": {
"type": [
"string",
"null"
]
},
"historie_verfuegbar_ab": {
"type": "string",
"format": "date",
"const": "2025-01-03"
},
"historische_vollstaendigkeit_zugesichert": {
"const": false
},
"compliance_screening": {
"type": "object",
"required": [
"status",
"healthy",
"checked_at",
"checked_sources",
"problem_codes",
"warning_codes",
"sources"
],
"properties": {
"status": {
"type": "string",
"enum": [
"checked",
"unavailable"
]
},
"healthy": {
"type": "boolean"
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"checked_sources": {
"type": "integer",
"minimum": 0,
"maximum": 4
},
"problem_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"warning_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"sync_status",
"coverage_status",
"last_success_at",
"last_complete_at",
"freshness",
"freshness_warning_after_hours",
"freshness_problem_after_hours",
"problem_codes",
"warning_codes"
],
"properties": {
"key": {
"type": "string",
"enum": [
"uid_vat",
"finma_authorisations",
"finma_warnings",
"seco_sanctions"
]
},
"sync_status": {
"type": "string",
"enum": [
"idle",
"fetching",
"healthy",
"error",
"missing"
]
},
"coverage_status": {
"type": "string",
"enum": [
"not_applicable",
"delta_only",
"building",
"complete",
"unknown"
]
},
"last_success_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"last_complete_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"freshness": {
"type": "string",
"enum": [
"fresh",
"stale_warning",
"stale_problem",
"unknown"
]
},
"freshness_warning_after_hours": {
"type": "integer",
"minimum": 1
},
"freshness_problem_after_hours": {
"type": "integer",
"minimum": 1
},
"problem_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"warning_codes": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"hinweis": {
"type": "string"
},
"fehler": {
"type": "string",
"minLength": 1
},
"code": {
"type": "string"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"required": [
"fehler"
]
},
{
"required": [
"datenqualitaetsstatus",
"aktuell",
"counts_estimated",
"firmen",
"meldungen",
"publikationen",
"ereignisstrom_bis",
"historie_verfuegbar_ab",
"historische_vollstaendigkeit_zugesichert",
"compliance_screening",
"hinweis"
],
"not": {
"required": [
"fehler"
]
}
}
]
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 6 件
検証済みバージョンは記録されていませんツール 6 件
検証済みバージョンは記録されていませんツール 6 件