POST /v1/reports/daily/{date}/result
Zaznamená výsledek vaší kontroly denního reportu za den v cestě (YYYY-MM-DD).
Partnerský klíč s oprávněním subaccounts
pk_) s oprávněním subaccounts a podpis požadavku; klientský klíč dostane 403 INSUFFICIENT_PERMISSION. Postup je na stránkách Podpis požadavků a Klíč partnera.Parametry cesty
| Parametr | Popis |
|---|---|
| datepovinnéstring | Pražský obchodní den reportu, YYYY-MM-DD. |
Tělo požadavku
application/json · ReconciliationResultBodyPodepište a odešlete bajt po bajtu totéž tělo, bez přeformátování. Neznámá pole API ignoruje a pole s hodnotou null je totéž jako pole vynechané.
| Pole | Popis |
|---|---|
| statuspovinnéstring | match, když vše sedí, mismatch, když jste našli rozdíly. Hodnoty: match, mismatch. |
| differencesvolitelnépole ReconciliationDifferenceBody | Rozdíly: u match žádné (nebo vynechané), u mismatch 1 až 100. Celé tělo má nejvýš 64 KiB. |
| differences[].orderNumbervolitelnéstring | Číslo pokynu, kterého se rozdíl týká, nejvýš 24 znaků. |
| differences[].variableSymbolvolitelnéstring | Variabilní symbol platby, které se rozdíl týká, nejvýš 20 znaků. |
| differences[].kindpovinnéstring | Druh rozdílu. Hodnoty: missingPayment, missingOrder, amountMismatch, duplicatePayment, other. |
| differences[].descriptionpovinnéstring | Co se liší, 1 až 300 znaků bez řídicích a neviditelných formátovacích znaků. Nepište osobní údaje. |
| differences[].amountvolitelnéApiMoney | Částka rozdílu, nepovinná. |
| differences[].amount.amountpovinnéstring | Částka jako desetinný řetězec s tečkou a nejméně s tolika místy, kolik má její měna. Zpracujte ji jako desetinné číslo, ne jako číslo s pohyblivou řádovou čárkou. |
| differences[].amount.currencypovinnéstring | Kód měny částky, například BTC nebo CZK. |
Odpověď
200 · application/json · ReconciliationResultResponseVýsledek za den jde poslat až od uzávěrky dne (closesAt reportu, ve výchozím nastavení 3:00 pražského času následujícího dne), kdy je report konečný, a nejvýš 90 dní zpět.
Pošlete status match, když vše sedí, nebo mismatch s 1 až 100 rozdíly. Každý rozdíl uvádí orderNumber nebo variableSymbol, druh (missingPayment, missingOrder, amountMismatch, duplicatePayment nebo other), popis o délce 1 až 300 znaků bez řídicích a neviditelných formátovacích znaků a volitelně částku. Celé podepsané tělo má nejvýš 64 KiB. Do popisu nepište osobní údaje.
mismatch u Coinera založí případ k prověření a upozorní kontakty pro rekonciliaci na obou stranách; pozdější match za stejný den ho uzavře.
Opakované odeslání za stejný den předchozí výsledek přepíše (replaced je true) a je bezpečné ho opakovat; totožný výsledek nic nezmění a nikoho neupozorní. Ze dvou výsledků za stejný den odeslaných současně skončí jeden chybou 409 CONCURRENT_UPDATE; ten zopakujte.
Vadné tělo vrací 400 INVALID_PARAMETER s názvem body, status nebo differences.
Vyžaduje partnerský API klíč s oprávněním subaccounts a podepsaný požadavek. Odpověď se neukládá do cache.
| Pole | Popis |
|---|---|
| datestring | Pražský obchodní den výsledku, YYYY-MM-DD. |
| statusstring | Zaznamenaný stav. Hodnoty: match, mismatch. |
| differencesCountinteger (int32) | Počet zaznamenaných rozdílů. |
| receivedAtstring | Kdy Coinero výsledek zaznamenalo, ISO 8601 v UTC. |
| receivedAtMsinteger (int64) | Stejný okamžik jako Unix timestamp v milisekundách. |
| replacedboolean | True, když výsledek přepsal dřívější výsledek za stejný den. |
Hodnoty stavů
Nové hodnoty mohou přibýt i v rámci v1; neznámou hodnotu zpracujte bez selhání.
| PublicReconciliationStatus | Význam |
|---|---|
match | vše sedí |
mismatch | našli jste rozdíly |
| PublicReconciliationDifferenceKind | Význam |
|---|---|
missingPayment | k provedenému pokynu chybí platba |
missingOrder | pokyn je jen na jedné straně |
amountMismatch | nesedí částka |
duplicatePayment | k pokynu existuje víc plateb |
other | jiný rozdíl |
Chyby
Chyby mají formát application/problem+json; zpracovávejte je podle pole code. Podrobnosti najdete v přehledu chyb.
| Stav | Kódy | Řešení |
|---|---|---|
| 400 | INVALID_PARAMETER | Opravte parametry uvedené v poli detail podle dokumentace. Opakovaný parametr se bere jako chybný. |
| 401 | MISSING_API_KEY, INVALID_API_KEY, SIGNATURE_REQUIRED, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_WINDOW | Doplňte hlavičku X-COINERO-APIKEY. Ověřte hodnotu a stav klíče i aktivitu účtu. Doplňte hlavičky X-COINERO-TIMESTAMP a X-COINERO-SIGNATURE podle stránky Podpis požadavků. Zkontrolujte kanonický řetězec (časová značka, metoda velkými písmeny, cesta s dotazem, tělo bajt po bajtu) a že secret před HMAC dekódujete z Base64; stránka Podpis požadavků má referenční vektor. Použijte aktuální čas v milisekundách; pole serverTime a serverTimeMs v odpovědi nesou čas serveru, podle kterého opravte hodiny klienta. |
| 403 | INSUFFICIENT_PERMISSION, IP_NOT_ALLOWED | Pole requiredPermission uvádí, které oprávnění chybí. Oprávnění klíče nelze změnit; vytvořte nový klíč s potřebným oprávněním. Odešlete požadavek z adresy povolené u klíče, nebo vytvořte nový klíč, jehož seznam adresu obsahuje; seznam nelze dodatečně změnit. |
| 405 | METHOD_NOT_ALLOWED | Použijte metodu z hlavičky Allow: GET a HEAD ke čtení, POST a DELETE jen u operací, které je mají v dokumentaci. |
| 409 | CONCURRENT_UPDATE | Tento požadavek nic nezměnil. Zadání pokynu je bezpečné zopakovat (se stejným clientOrderId, pokud jste ho poslali); u ostatních operací nejdřív přečtěte aktuální stav a požadavek zopakujte, pokud dává stále smysl. |
| 429 | RATE_LIMIT_EXCEEDED | Před dalším pokusem vyčkejte počet sekund z Retry-After. |
| 503 | SERVICE_MAINTENANCE | Probíhá údržba nebo je dočasně vypnuté obchodování či WebSocket; ověřte GET /v1/status a vyčkejte podle Retry-After. |