---
name: csob-business-connector
description: |
  Kompletní skill pro práci s ČSOB Business Connector API.
  Použij tento skill VŽDY, když uživatel zmíní ČSOB, Business Connector,
  CEB, bankovní výpisy, platební příkazy, avíza, kurzovní lístky,
  automatickou komunikaci s bankou, nebo import/export bankovních dat.
  
  Skill pokrývá: SOAP webové služby (GetDownloadFileList v4, StartUploadFileList v3,
  FinishUploadFileList v2), REST API (HTTP download/upload, multipart form-data), 
  certifikáty a autentizaci (mutual TLS, I.CA, PostSignum, CEB Business Connector CA),
  formáty souborů (výpisy PDF/TXT/XML/BBGPC/BBMT940/BBTXT/BBBF/SEPAXML, avíza MT942/BBF/CAMT052, 
  dávky ABO/DUZ/MC/TXT/XLS/XLSX/MT101/XML SEPA, protokoly pain.002, kurzovní lístky QUOTES, 
  podepsané dávky CAdES-BES .p7m), instalaci a konfiguraci (Windows, Linux Debian, tar.gz).
category: finance
version: 1.0.0
author: Samuel Paluba
---

# ČSOB Business Connector Skill

## Přehled

Tento skill poskytuje kompletní podporu pro integraci s **ČSOB Business Connector** —
automatickou komunikaci s ČSOB pro přenos souborů (výpisy, avíza, kurzovní lístky,
dávky platebních příkazů, protokoly o importu).

## Struktura skill systému

```
csob-business-connector/
├── SKILL.md                    ← Tento soubor - hlavní router
└── references/
    ├── autentizace.md          ← Certifikáty, SSL, autentizace
    ├── soap-api.md             ← SOAP webové služby (WSDL, operace)
    ├── rest-api.md             ← REST API (HTTP download/upload)
    ├── formaty-souboru.md    ← Formáty výpisů, avíz, dávek, kurzů
    ├── instalace.md            ← Instalace a konfigurace
    ├── chyby.md                ← Chybové kódy, řešení problémů
    └── vlastni-implementace.md ← Kompletní implementační příručka pro vlastní vývoj (SOAP, REST, certifikáty, formáty)
```

## Kdy použít který reference

| Dotaz uživatele | Načíst reference |
|-----------------|------------------|
| "Jak získat certifikát?" | `references/autentizace.md` |
| "Jak se autentizovat?" | `references/autentizace.md` |
| "Jak stáhnout soubory?" | `references/soap-api.md` (GetDownloadFileList) |
| "Jak nahrát dávku?" | `references/soap-api.md` (StartUploadFileList) |
| "SOAP vs REST" | `references/rest-api.md` |
| "Formát výpisu" | `references/formaty-souboru.md` |
| "Formát avíza" | `references/formaty-souboru.md` |
| "Kurzovní lístek" | `references/formaty-souboru.md` |
| "Instalace aplikace" | `references/instalace.md` |
| "Chybový kód" | `references/chyby.md` |
| "Vlastní implementace" | `references/vlastni-implementace.md` |

## Základní URL

| Prostředí | URL |
|-----------|-----|
| **Produkční SOAP** | `https://ceb-bc.csob.cz/cebbc/api` |
| **Produkční REST download** | `https://ceb-bc.csob.cz/ExtFileHubDown/...` |
| **Produkční REST upload** | `https://ceb-bc.csob.cz/ExtFileHubUp/...` |
| **Demo/Sandbox SOAP** | `https://testceb-bc.csob.cz/cebbc/api` |
| **Demo/Sandbox REST download** | `https://testceb-bc.csob.cz/ceb-mock/download?id=...` |
| **Demo/Sandbox REST upload** | `https://testceb-bc.csob.cz/ceb-mock/upload?id=...` |
| **CEB Portál** | `https://www.csob.cz/ceb` |
| **WSDL** | `https://www.csob.cz/portal/documents/10710/15100026/cebbc-wsdl.zip` |

## Přehled služeb

### SOAP Webové služby

| Operace | Verze | Popis |
|---------|-------|-------|
| **GetDownloadFileList** | v4 | Seznam souborů ke stažení |
| **StartUploadFileList** | v3 | Zahájení nahrávání |
| **FinishUploadFileList** | v2 | Dokončení nahrávání |

### REST API

| Operace | Metoda | Popis |
|---------|--------|-------|
| **Download** | HTTP GET | Stažení konkrétního souboru |
| **Upload** | HTTP POST (Multipart) | Nahrání souboru |

### Typy souborů

| Typ | Směr | Formáty | Popis |
|-----|------|---------|-------|
| **Výpisy** | Banka → Klient | PDF, TXT, XML, BBGPC, BBMT940, BBTXT, BBBBF, SEPAXML | Výpisy z účtu |
| **Avíza** | Banka → Klient | MT942, BBF, CAMT052 | Avíza o příchozích platbách |
| **Kurzovní lístek** | Banka → Klient | BBF (QUOTES) | Denní kurzy ČNB a ČSOB |
| **Dávky** | Klient → Banka | ABO, DUZ, MC TPS/ZPS, TXT TPS/ZPS, XLS TPS/ZPS, XLSX TPS/ZPS, MT101, XML SEPA, XML TPS/ZPS | Platební příkazy |
| **Protokol** | Banka → Klient | XML PAIN.002 | Výsledek importu dávky |

## Autentizace - základní přehled

Business Connector používá **klientské certifikáty** pro autentizaci (mutual TLS):

1. **Certifikát vydaný bankou** — doporučeno, vytvořen v CEB portálu
2. **Certifikát od CA** — I.CA nebo PostSignum (Serverový komerční certifikát s klientskou autentizací)

### Požadavky na certifikát

| Parametr | Hodnota |
|----------|---------|
| Algoritmus podpisu | SHA-256 nebo silnější |
| Délka klíče | RSA min. 2048 bitů |
| Užití klíče | Digitální podpis nebo Výměna klíčů |
| Rozšířené užití | SSL klientská autentizace (OID 1.3.6.1.5.5.7.3.2) |
| Platnost | 1 rok |

### SSL/TLS požadavky

| Protokol | Verze |
|----------|-------|
| TLS | 1.3 doporučeno, min. 1.2 |
| Server CN | `ceb-bc.csob.cz` |

### HTTP/SOAP požadavky

| Parametr | Hodnota |
|----------|---------|
| HTTP | 1.1 nebo 1.0 |
| SOAP | 1.1 |
| Content-Type | `text/xml; charset=utf-8` |
| SOAPAction | `"{operace}"` (z WSDL) |

---

**Verze:** 1.0.0  
**Synchronizováno s:** ČSOB dokumentace (2024-10-20)  
**WSDL:** https://www.csob.cz/portal/documents/10710/15100026/cebbc-wsdl.zip