Získat API klíč
Přehled API · Reporty

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

Endpoint patří do sekce Subúčty. Vyžaduje partnerský API klíč (prefix 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

ParametrPopis
datepovinnéstringPražský obchodní den reportu, YYYY-MM-DD.

Tělo požadavku

application/json · ReconciliationResultBody

Podepiš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é.

PolePopis
statuspovinnéstringmatch, když vše sedí, mismatch, když jste našli rozdíly. Hodnoty: match, mismatch.
differencesvolitelnépole ReconciliationDifferenceBodyRozdí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éstringVariabilní symbol platby, které se rozdíl týká, nejvýš 20 znaků.
differences[].kindpovinnéstringDruh rozdílu. Hodnoty: missingPayment, missingOrder, amountMismatch, duplicatePayment, other.
differences[].descriptionpovinnéstringCo 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éstringKód měny částky, například BTC nebo CZK.

Odpověď

200 · application/json · ReconciliationResultResponse

Vý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.

PolePopis
datestringPražský obchodní den výsledku, YYYY-MM-DD.
statusstringZaznamenaný stav. Hodnoty: match, mismatch.
differencesCountinteger (int32)Počet zaznamenaných rozdílů.
receivedAtstringKdy Coinero výsledek zaznamenalo, ISO 8601 v UTC.
receivedAtMsinteger (int64)Stejný okamžik jako Unix timestamp v milisekundách.
replacedbooleanTrue, 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í.

PublicReconciliationStatusVýznam
matchvše sedí
mismatchnašli jste rozdíly
PublicReconciliationDifferenceKindVýznam
missingPaymentk provedenému pokynu chybí platba
missingOrderpokyn je jen na jedné straně
amountMismatchnesedí částka
duplicatePaymentk pokynu existuje víc plateb
otherjiný rozdíl

Chyby

Chyby mají formát application/problem+json; zpracovávejte je podle pole code. Podrobnosti najdete v přehledu chyb.

StavKódyŘešení
400INVALID_PARAMETEROpravte parametry uvedené v poli detail podle dokumentace. Opakovaný parametr se bere jako chybný.
401MISSING_API_KEY, INVALID_API_KEY, SIGNATURE_REQUIRED, INVALID_SIGNATURE, TIMESTAMP_OUT_OF_WINDOWDoplň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.
403INSUFFICIENT_PERMISSION, IP_NOT_ALLOWEDPole 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.
405METHOD_NOT_ALLOWEDPoužijte metodu z hlavičky Allow: GET a HEAD ke čtení, POST a DELETE jen u operací, které je mají v dokumentaci.
409CONCURRENT_UPDATETento 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.
429RATE_LIMIT_EXCEEDEDPřed dalším pokusem vyčkejte počet sekund z Retry-After.
503SERVICE_MAINTENANCEProbíhá údržba nebo je dočasně vypnuté obchodování či WebSocket; ověřte GET /v1/status a vyčkejte podle Retry-After.