﻿{"id":23068,"date":"2019-11-19T13:56:13","date_gmt":"2019-11-19T13:56:13","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/?post_type=ht_kb&#038;p=23068"},"modified":"2024-05-21T10:37:15","modified_gmt":"2024-05-21T10:37:15","slug":"comarch-ocr-api-instrukcja-uzytkownika","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/dokumentacja\/comarch-ocr-api-instrukcja-uzytkownika\/","title":{"rendered":"API do us\u0142ugi Comarch OCR"},"content":{"rendered":"<p style=\"text-align: left;\"><div class=\"su-list\" style=\"margin-left:0px\">\n<div class=\"su-spoiler su-spoiler-style-fancy su-spoiler-icon-caret su-spoiler-closed\" data-scroll-offset=\"0\" data-anchor-in-url=\"no\"><div class=\"su-spoiler-title\" tabindex=\"0\" role=\"button\"><span class=\"su-spoiler-icon\"><\/span>Spis tre\u015bci<\/div><div class=\"su-spoiler-content su-u-clearfix su-u-trim\">\n<ul>\n<li style=\"padding-left: 30px;\"><a href=\"#1\">Tworzenie sesji u\u017cytkownika (POST)<\/a><\/li>\n<li style=\"padding-left: 30px;\"><a href=\"#2\">Usuwanie sesji u\u017cytkownika (DELETE)<\/a><\/li>\n<li style=\"padding-left: 30px;\"><a href=\"#3\">Przetwarzanie dokumentu (POST)<\/a><\/li>\n<\/ul>\n<\/div><\/div>\n<\/div>\n\n<table id=\"tablepress-491\" class=\"tablepress tablepress-id-491\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Us\u0142uga<\/th><th class=\"column-2\">Adres<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">Comarch OCR \u2013 panel do zarz\u0105dzania<\/td><td class=\"column-2\">https:\/\/www.erp.comarch.pl\/OCR\/<\/td>\n<\/tr>\n<tr class=\"row-3\">\n\t<td class=\"column-1\">Comarch OCR - API<\/td><td class=\"column-2\">https:\/\/cr.erp.comarch.pl\/api\/v1\/<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-491 from cache -->\n<section class=\"msp-alert-box msp-alert-info\"><div class=\"msp-alert-icon\"><svg width=\"16\" height=\"16\" class=\"kb-icon kb-icon--info\" aria-hidden=\"true\" focusable=\"false\" viewBox=\"0 0 32 32\" version=\"1.1\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" xmlns:xlink=\"http:\/\/www.w3.org\/1999\/xlink\">\r\n    <g id=\"[AP]-Iconography\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\r\n        <g id=\"Iconography_sortowanie-po-kategorii\" transform=\"translate(-715.000000, -3631.000000)\" fill=\"currentColor\">\r\n            <g id=\"Group-8\" transform=\"translate(286.000000, 548.000000)\">\r\n                <g id=\"Iconography-Card-\" transform=\"translate(381.000000, 3043.000000)\">\r\n                    <g id=\"0-Icons-\/-24-\/-Data-\/-Info-\/-Outlined\" transform=\"translate(48.000000, 40.000000)\">\r\n                        <path d=\"M15.9993333,2.024 C23.706,2.024 29.9753333,8.29333333 29.9753333,16 C29.9753333,23.7066667 23.706,29.976 15.9993333,29.976 C8.294,29.976 2.02466667,23.7066667 2.02466667,16 C2.02466667,8.29333333 8.294,2.024 15.9993333,2.024 Z M15.9993333,4.024 C9.39666667,4.024 4.02466667,9.396 4.02466667,16 C4.02466667,22.604 9.39666667,27.976 15.9993333,27.976 C22.6033333,27.976 27.9753333,22.604 27.9753333,16 C27.9753333,9.396 22.6033333,4.024 15.9993333,4.024 Z M15.9993333,14.9877333 C16.69,14.9877333 17.2486667,15.5477333 17.2486667,16.2370667 L17.2486667,22.6770667 C17.2486667,23.3677333 16.69,23.9264 15.9993333,23.9264 C15.3086667,23.9264 14.75,23.3677333 14.75,22.6770667 L14.75,16.2370667 C14.75,15.5477333 15.3086667,14.9877333 15.9993333,14.9877333 Z M15.9993333,9.32293333 C16.862,9.32293333 17.566,10.0256 17.566,10.8896 C17.566,11.7536 16.862,12.4562667 15.9993333,12.4562667 C15.1366667,12.4562667 14.434,11.7536 14.434,10.8896 C14.434,10.0256 15.1366667,9.32293333 15.9993333,9.32293333 Z\" id=\"Color\"><\/path>\r\n                    <\/g>\r\n                <\/g>\r\n            <\/g>\r\n        <\/g>\r\n    <\/g>\r\n<\/svg><\/div><div class=\"msp-alert-body\"><div class=\"msp-alert-title\">Informacja<\/div><div class=\"msp-alert-content\">W celu korzystania z us\u0142ugi Comarch OCR nale\u017cy odblokowa\u0107 komunikacj\u0119 do adres\u00f3w *.erp.comarch.pl na porcie 443 (SSL).<\/div><\/div><\/section>\n<p>W pierwszym kroku nale\u017cy zalogowa\u0107 si\u0119 w aplikacji <a href=\"https:\/\/www.erp.comarch.pl\/OCR\/\">Comarch OCR<\/a> i wygenerowa\u0107 klucze dost\u0119powe.<\/p>\n<h2>Metody<\/h2>\n<p><a name=\"1\"><\/a><\/p>\n<h3>Tworzenie sesji u\u017cytkownika &#8222;session&#8221; (POST)<\/h3>\n<p>Adres: <a href=\"https:\/\/cr.erp.comarch.pl\/api\/v1\/session\">https:\/\/cr.erp.comarch.pl\/api\/v1\/session<\/a><\/p>\n<p>&nbsp;<\/p>\n<p>W nag\u0142\u00f3wku zapytania nale\u017cy do\u0142\u0105czy\u0107 nast\u0119puj\u0105ce dane uwierzytelniaj\u0105ce:<\/p>\n\n<table id=\"tablepress-369\" class=\"tablepress tablepress-id-369\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Klucz<\/th><th class=\"column-2\">Warto\u015b\u0107<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">authKey<\/td><td class=\"column-2\">Klucz wygenerowany w panelu do zarz\u0105dzania Comarch OCR<\/td>\n<\/tr>\n<tr class=\"row-3\">\n\t<td class=\"column-1\">authSecret<\/td><td class=\"column-2\">Sekret wygenerowany w panelu do zarz\u0105dzania Comarch OCR<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-369 from cache -->\n<p>Opis struktury JSON odpowiedzi<\/p>\n\n<table id=\"tablepress-370\" class=\"tablepress tablepress-id-370\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Property<\/th><th class=\"column-2\">Opis<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">sessionToken<\/td><td class=\"column-2\">Token sesji<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-370 from cache -->\n<p>Przyk\u0142adowa odpowied\u017a JSON<\/p>\n<p><code>{<br \/>\n\"sessionToken\": \"00000000-0000-0000-0000-000000000000\"\"<br \/>\n}<br \/>\n<\/code><\/p>\n<p>Mo\u017cliwe kody odpowiedzi HTTP:<\/p>\n\n<table id=\"tablepress-371\" class=\"tablepress tablepress-id-371\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Kod<\/th><th class=\"column-2\">Znaczenie<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">200<\/td><td class=\"column-2\">Poprawnie wygenerowano token sesji.<\/td>\n<\/tr>\n<tr class=\"row-3\">\n\t<td class=\"column-1\">400<\/td><td class=\"column-2\">Brak wymaganych parametr\u00f3w w nag\u0142\u00f3wku \u017c\u0105dania lub b\u0142\u0119dne dane.<\/td>\n<\/tr>\n<tr class=\"row-4\">\n\t<td class=\"column-1\">403<\/td><td class=\"column-2\">Wymagane jest u\u017cycie SSL<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-371 from cache -->\n<a name=\"2\"><\/a><\/p>\n<h3>Usuwanie sesji u\u017cytkownika &#8222;session&#8221; (DELETE)<\/h3>\n<p>Adres: <a href=\"https:\/\/cr.erp.comarch.pl\/api\/v1\/session\">https:\/\/cr.erp.comarch.pl\/api\/v1\/session<\/a><\/p>\n<p>&nbsp;<\/p>\n<p style=\"text-align: left;\">W nag\u0142\u00f3wku zapytania nale\u017cy do\u0142\u0105czy\u0107 nast\u0119puj\u0105ce warto\u015bci:<\/p>\n\n<table id=\"tablepress-372\" class=\"tablepress tablepress-id-372\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Klucz<\/th><th class=\"column-2\">Warto\u015b\u0107<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">authToken<\/td><td class=\"column-2\">Token sesji<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-372 from cache -->\n\n<table id=\"tablepress-374\" class=\"tablepress tablepress-id-374\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Kod<\/th><th class=\"column-2\">Znaczenie<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">204<\/td><td class=\"column-2\">Sesja poprawnie zako\u0144czona<\/td>\n<\/tr>\n<tr class=\"row-3\">\n\t<td class=\"column-1\">400<\/td><td class=\"column-2\">Brak tokenu sesji w nag\u0142\u00f3wku \u017c\u0105dania.<\/td>\n<\/tr>\n<tr class=\"row-4\">\n\t<td class=\"column-1\">403<\/td><td class=\"column-2\">Wymagane jest u\u017cycie SSL<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-374 from cache -->\n<a name=\"3\"><\/a><\/p>\n<p>Adres: <a href=\"https:\/\/cr.erp.comarch.pl\/api\/v1\/invoice\/recognize\">https:\/\/cr.erp.comarch.pl\/api\/v1\/invoice\/recognize<\/a><\/p>\n<p>&nbsp;<\/p>\n<p>Opis struktury JSON zapytania<\/p>\n\n<table id=\"tablepress-492\" class=\"tablepress tablepress-id-492\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Property<\/th><th class=\"column-2\">Opis<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">File<\/td><td class=\"column-2\">Plik o rozszerzeniu *.jpg, *.png, *bmp lub *.pdf w postaci binarnej<\/td>\n<\/tr>\n<tr class=\"row-3\">\n\t<td class=\"column-1\">Guid<\/td><td class=\"column-2\">Opcjonalne - GUID<\/td>\n<\/tr>\n<tr class=\"row-4\">\n\t<td class=\"column-1\">RecognizeConfiguration.RecognitionLanguage<\/td><td class=\"column-2\">Opcjonalny - j\u0119zyk rozpoznawania dokumentu,<br \/>\n0 - j. polski (je\u015bli na fakturze zostanie rozpoznany j\u0119zyk angielski, rozpoznanie nast\u0105pi jak dla faktur angielskich),<br \/>\n1 - j. niemiecki,<br \/>\n2 - j. francuski,<br \/>\n3 - j. angielski<br \/>\n-1 \u2013 rozpoznanie na podstawie j\u0119zyka wykrytego na dokumencie<br \/>\n(domy\u015blnie - j. polski)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-5\">\n\t<td class=\"column-1\">RecognizeConfiguration.ReturnData<\/td><td class=\"column-2\">Opcjonalny - informacja czy us\u0142uga ma w odpowiedzi odes\u0142a\u0107 pliki dla przetworzonych dokument\u00f3w <br \/>\n0 \u2013 bez plik\u00f3w<br \/>\n1 \u2013 z plikami<br \/>\n(domy\u015blnie \u2013 opcja 0)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-6\">\n\t<td class=\"column-1\">RecognizeConfiguration.BarCodeRecognition<\/td><td class=\"column-2\">Opcjonalny - informacja czy nale\u017cy rozpoznawa\u0107 kody kreskowe da dokumentach,<br \/>\n0 - nie rozpoznaje kod\u00f3w<br \/>\n1 - rozpoznaje kody<br \/>\n2 - \u0142\u0105czy strony na podstawie rozpoznanych kod\u00f3w<br \/>\n(domy\u015blnie \u2013 opcja 0)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-7\">\n\t<td class=\"column-1\">RecognizeConfiguration.MergingPagesOption<\/td><td class=\"column-2\">Opcjonalny - informacja czy nale\u017cy rozpoznawa\u0107 kody kreskowe da dokumentach,<br \/>\n0 - nie rozpoznaje kod\u00f3w<br \/>\n1 - rozpoznaje kody<br \/>\n2 - \u0142\u0105czy strony na podstawie rozpoznanych kod\u00f3w<br \/>\n(domy\u015blnie \u2013 opcja 0)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-8\">\n\t<td class=\"column-1\">RecognizeConfiguration.ReturnDocumentPositions<\/td><td class=\"column-2\">Opcjonalny \u2013 czy na rozpoznanych dokumentach maj\u0105 by\u0107 zwr\u00f3cone poszczeg\u00f3lne pozycje z tabeli produkt\u00f3w<br \/>\n0 \u2013 bez pozycji<br \/>\n1 \u2013 z pozycjami<br \/>\n(domy\u015blnie \u2013 opcja 0)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-9\">\n\t<td class=\"column-1\">RecognizeConfiguration.PaymentMethodMapping<\/td><td class=\"column-2\">Opcjonalny \u2013 czy na rozpoznanych dokumentach metoda p\u0142atno\u015bci ma by\u0107 mapowana do standardowych form p\u0142atno\u015bci czy odczytana zgodnie z tre\u015bci\u0105 na dokumencie<br \/>\n0 \u2013 bez mapowania<br \/>\n1 \u2013 z mapowaniem<br \/>\n(domy\u015blnie \u2013 opcja 0)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-10\">\n\t<td class=\"column-1\">RecognizeConfiguration.RawRecognitionText<\/td><td class=\"column-2\">Opcjonalny \u2013 informacja czy ma zosta\u0107 zwr\u00f3cona oryginalna, niezmieniona tre\u015b\u0107 wykryta na stronie<br \/>\n0 - brak oryginalnej tre\u015bci<br \/>\n1 - oryginalna tre\u015b\u0107 zostanie zwr\u00f3cona  (domy\u015blnie \u2013 opcja 0)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-11\">\n\t<td class=\"column-1\">RecognizeConfiguration.DefaultPaymentForm<\/td><td class=\"column-2\">Opcjonalny \u2013 domy\u015blna forma p\u0142atno\u015bci jaka ma zosta\u0107 zwr\u00f3cona w przypadku nie wykrycia formy p\u0142atno\u015bci na dokumencie (np. \u201egot\u00f3wka\u201d)<br \/>\n(domy\u015blnie \u2013 brak)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-12\">\n\t<td class=\"column-1\">RecognizeConfiguration.PagesToRecognize<\/td><td class=\"column-2\">Opcjonalny \u2013 informacja o numerze NIP kontrahenta kt\u00f3ry wysy\u0142a dokument (np. \"1234567890\")<br \/>\n(domy\u015blnie \u2013 brak)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-13\">\n\t<td class=\"column-1\">RecognizeConfiguration.DateRange<\/td><td class=\"column-2\">Opcjonalny \u2013 informacja jakie daty na dokumencie maj\u0105 zosta\u0107 uwzgl\u0119dnione w rozpoznaniu (np. \"1.01.2023-31.12.2023\")<br \/>\n(domy\u015blnie \u2013 brak)<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-14\">\n\t<td class=\"column-1\">RecognizeConfiguration.RegisterType<\/td><td class=\"column-2\">Opcjonalny \u2013 typ rejestru, kt\u00f3ry ma by\u0107 uwzgl\u0119dniony przy rozpoznaniu<br \/>\n0 \u2013 rejestr zakupu<br \/>\n1 \u2013 rejestr sprzeda\u017cy<br \/>\n(domy\u015blnie \u2013 rejestr zakupu)<br \/>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-492 from cache -->\n<p>W nag\u0142\u00f3wku zapytania nale\u017cy do\u0142\u0105czy\u0107 nast\u0119puj\u0105ce warto\u015bci:<\/p>\n\n<table id=\"tablepress-372-no-2\" class=\"tablepress tablepress-id-372\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Klucz<\/th><th class=\"column-2\">Warto\u015b\u0107<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">authToken<\/td><td class=\"column-2\">Token sesji<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-372-no-2 from cache -->\n<p>Schemat zapytania (request body):<br \/>\n\n<table id=\"tablepress-493\" class=\"tablepress tablepress-id-493\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Parametr<\/th><th class=\"column-2\">File to recognize<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">File<br \/>\nstring($binary)<br \/>\n<\/td><td class=\"column-2\"><\/td>\n<\/tr>\n<tr class=\"row-3\">\n\t<td class=\"column-1\">Guid<br \/>\nstring<br \/>\n<\/td><td class=\"column-2\"><\/td>\n<\/tr>\n<tr class=\"row-4\">\n\t<td class=\"column-1\">ErpModule<br \/>\nstring<br \/>\n<\/td><td class=\"column-2\"><\/td>\n<\/tr>\n<tr class=\"row-5\">\n\t<td class=\"column-1\">RecognizeConfiguration.RegisterType<br \/>\ninteger($int32)<br \/>\n<\/td><td class=\"column-2\">1 = Purchase<br \/>\n2 = Sale<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-6\">\n\t<td class=\"column-1\">RecognizeConfiguration.RecognitionLanguage<br \/>\ninteger($int32)<br \/>\n<\/td><td class=\"column-2\">0 = PL<br \/>\n1 = DE<br \/>\n2 = FR<br \/>\n3 = EN<br \/>\n-1 = UNSET<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-7\">\n\t<td class=\"column-1\">RecognizeConfiguration.ReturnData<br \/>\ninteger($int32)<br \/>\n<\/td><td class=\"column-2\">0 = WithoutData<br \/>\n1 = WithData<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-8\">\n\t<td class=\"column-1\">RecognizeConfiguration.BarCodeRecognition<br \/>\ninteger($int32)<br \/>\n<\/td><td class=\"column-2\">0 = NoRecognition<br \/>\n1 = CodeRecognition<br \/>\n2 = DocumentBundleRecognition<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-9\">\n\t<td class=\"column-1\">RecognizeConfiguration.MergingPagesOption<br \/>\ninteger($int32)<\/td><td class=\"column-2\">0 = MergingAlgorithm<br \/>\n1 = FileIsOneDocument<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-10\">\n\t<td class=\"column-1\">RecognizeConfiguration.ReturnDocumentPositions<br \/>\ninteger($int32)<br \/>\n<\/td><td class=\"column-2\">0 = WithPositions<br \/>\n1 = WithoutPositions<\/td>\n<\/tr>\n<tr class=\"row-11\">\n\t<td class=\"column-1\">RecognizeConfiguration.PaymentMethodMapping<br \/>\ninteger($int32)<br \/>\n<\/td><td class=\"column-2\">0 = WithoutMapping<br \/>\n1 = WithMapping<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-12\">\n\t<td class=\"column-1\">RecognizeConfiguration.RawRecognitionText<br \/>\ninteger($int32)<br \/>\n<\/td><td class=\"column-2\">0 = WithoutRawRecognitionText<br \/>\n1 = WithRawRecognitionText<br \/>\n<\/td>\n<\/tr>\n<tr class=\"row-13\">\n\t<td class=\"column-1\">RecognizeConfiguration.DefaultPaymentForm<br \/>\nstring<br \/>\n<\/td><td class=\"column-2\"><\/td>\n<\/tr>\n<tr class=\"row-14\">\n\t<td class=\"column-1\">RecognizeConfiguration.PagesToRecognize<br \/>\nstring<br \/>\n<\/td><td class=\"column-2\"><\/td>\n<\/tr>\n<tr class=\"row-15\">\n\t<td class=\"column-1\">RecognizeConfiguration.ConfigurationNipNumber<br \/>\nstring<br \/>\n<\/td><td class=\"column-2\"><\/td>\n<\/tr>\n<tr class=\"row-16\">\n\t<td class=\"column-1\">RecognizeConfiguration.DateRange<br \/>\nstring<br \/>\n<\/td><td class=\"column-2\"><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-493 from cache -->\n<p>&nbsp;<\/p>\n<p>Opis struktury JSON odpowiedzi<\/p>\n\n<table id=\"tablepress-375\" class=\"tablepress tablepress-id-375\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">Property<\/th><th class=\"column-2\">Opis<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">ExportString<\/td><td class=\"column-2\">Odpowied\u017a w formacie JSON<\/td>\n<\/tr>\n<tr class=\"row-3\">\n\t<td class=\"column-1\">Message<\/td><td class=\"column-2\">Komunikat o wyniku przetwarzania dokumentu przez us\u0142ug\u0119<\/td>\n<\/tr>\n<tr class=\"row-4\">\n\t<td class=\"column-1\">Code<\/td><td class=\"column-2\">Kod odpowiedzi<\/td>\n<\/tr>\n<tr class=\"row-5\">\n\t<td class=\"column-1\">Status<\/td><td class=\"column-2\">Status odpowiedzi<\/td>\n<\/tr>\n<tr class=\"row-6\">\n\t<td class=\"column-1\">AdditionalMessage<\/td><td class=\"column-2\">Dodatkowa informacja o pozosta\u0142ych dokumentach, gdy w pakiecie pozosta\u0142o 10 lub mniej dokument\u00f3w<\/td>\n<\/tr>\n<tr class=\"row-7\">\n\t<td class=\"column-1\">UriToDownload<\/td><td class=\"column-2\">Adres URL do strony sp\u00f3jnej z kodem odpowiedzi<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-375 from cache -->\n<p>Schemat odpowiedzi<br \/>\nKod 200<\/p>\n<pre>{\r\n  \"invoices\": [\r\n    {\r\n      \"recognizedElements\": {\r\n        \"documentNumber\": \"string\",\r\n        \"kSeFNumber\": \"string\",\r\n        \"dateOfIssue\": \"string\",\r\n        \"dateOfSale\": \"string\",\r\n        \"dueDate\": \"string\",\r\n        \"paymentForm\": \"string\",\r\n        \"bankAccountNumber\": \"string\",\r\n        \"orderNumber\": \"string\",\r\n        \"isCorrection\": true,\r\n        \"correctedDocumentNumber\": \"string\",\r\n        \"currency\": \"string\",\r\n        \"currencyExchange\": {\r\n          \"rate\": 0,\r\n          \"multiplier\": 0,\r\n          \"date\": \"string\"\r\n        },\r\n        \"language\": \"string\",\r\n        \"carBodyNumber\": \"string\",\r\n        \"isDateInRange\": true\r\n      },\r\n      \"sellerContractor\": {\r\n        \"tin\": \"string\",\r\n        \"companyName\": \"string\",\r\n        \"street\": \"string\",\r\n        \"streetNumber\": \"string\",\r\n        \"apartmentsNumber\": \"string\",\r\n        \"postCode\": \"string\",\r\n        \"postOffice\": \"string\",\r\n        \"city\": \"string\",\r\n        \"voivodeship\": \"string\",\r\n        \"activeVATTaxpayer\": true\r\n      },\r\n      \"buyerContractor\": {\r\n        \"tin\": \"string\",\r\n        \"companyName\": \"string\",\r\n        \"street\": \"string\",\r\n        \"streetNumber\": \"string\",\r\n        \"apartmentsNumber\": \"string\",\r\n        \"postCode\": \"string\",\r\n        \"postOffice\": \"string\",\r\n        \"city\": \"string\",\r\n        \"voivodeship\": \"string\",\r\n        \"activeVATTaxpayer\": true\r\n      },\r\n      \"vatPositions\": [\r\n        {\r\n          \"vatRate\": 0,\r\n          \"vatRateDecimal\": 0,\r\n          \"vatStatus\": 0,\r\n          \"subtotal\": 0,\r\n          \"vat\": 0,\r\n          \"total\": 0\r\n        }\r\n      ],\r\n      \"pageProperties\": {\r\n        \"firstPageNumber\": 0,\r\n        \"documentLength\": 0,\r\n        \"pageRotation\": 0\r\n      },\r\n      \"pages\": [\r\n        {\r\n          \"pageNumber\": 0,\r\n          \"image\": \"string\",\r\n          \"rawText\": \"string\"\r\n        }\r\n      ],\r\n      \"productItems\": [\r\n        {\r\n          \"name\": \"string\",\r\n          \"unit\": \"string\",\r\n          \"productCode\": \"string\",\r\n          \"ean\": \"string\",\r\n          \"contractNumber\": \"string\",\r\n          \"count\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          },\r\n          \"nettoUnitPrice\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          },\r\n          \"bruttoUnitPrice\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          },\r\n          \"netto\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          },\r\n          \"brutto\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          },\r\n          \"vatRate\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          },\r\n          \"vatAmount\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          },\r\n          \"vatStatus\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          },\r\n          \"discount\": {\r\n            \"value\": 0,\r\n            \"status\": 0\r\n          }\r\n        }\r\n      ],\r\n      \"attachment\": {\r\n        \"canRead\": true,\r\n        \"canWrite\": true,\r\n        \"canSeek\": true,\r\n        \"canTimeout\": true,\r\n        \"length\": 0,\r\n        \"position\": 0,\r\n        \"readTimeout\": 0,\r\n        \"writeTimeout\": 0\r\n      },\r\n      \"fileUrl\": \"string\",\r\n      \"barcode\": {\r\n        \"text\": \"string\",\r\n        \"type\": \"string\"\r\n      },\r\n      \"barcodes\": [\r\n        {\r\n          \"text\": \"string\",\r\n          \"type\": \"string\"\r\n        }\r\n      ],\r\n      \"guid\": \"string\"\r\n    }\r\n  ],\r\n  \"message\": \"string\",\r\n  \"url\": \"string\",\r\n  \"numberOfPagesLeft\": 0,\r\n  \"guid\": \"string\"\r\n}\r\n\r\n<\/pre>\n<p>Kod 400<\/p>\n<pre>{\r\n  \"httpCode\": 0,\r\n  \"internalErrorCode\": 0,\r\n  \"message\": \"string\",\r\n  \"url\": \"string\"\r\n}\r\n\r\n<\/pre>\n<p>Kod 403<\/p>\n<pre>{\r\n  \"httpCode\": 0,\r\n  \"internalErrorCode\": 0,\r\n  \"message\": \"string\",\r\n  \"url\": \"string\"\r\n}\r\n<\/pre>\n<p>Kod 415<\/p>\n<pre>{\r\n  \"httpCode\": 0,\r\n  \"internalErrorCode\": 0,\r\n  \"message\": \"string\",\r\n  \"url\": \"string\"\r\n}\r\n\r\n<\/pre>\n<p>Tabela b\u0142\u0119d\u00f3w metody &#8222;invoice\/recognize&#8221; w przypadku kodu b\u0142\u0119du &gt;= 400<br \/>\n\n<table id=\"tablepress-494\" class=\"tablepress tablepress-id-494\">\n<thead>\n<tr class=\"row-1\">\n\t<th class=\"column-1\">HttpCode<\/th><th class=\"column-2\">InternalErrorCode<\/th><th class=\"column-3\">Opis<\/th><th class=\"column-4\">Dodatkowe informacje<\/th>\n<\/tr>\n<\/thead>\n<tbody class=\"row-striping row-hover\">\n<tr class=\"row-2\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">101<\/td><td class=\"column-3\">B\u0142\u0105d podczas autentykacji u\u017cytkownika<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-3\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">102<\/td><td class=\"column-3\">Niepoprawny numer klucza<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-4\">\n\t<td class=\"column-1\">503<\/td><td class=\"column-2\">104<\/td><td class=\"column-3\">Przerwa techniczna<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-5\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">105<\/td><td class=\"column-3\">Token sesji wygas\u0142 lub jest niepoprawny<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-6\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">106<\/td><td class=\"column-3\">Brak podpisanej klauzuli RODO<\/td><td class=\"column-4\">Link do formularza z umow\u0105 w 'Url'<\/td>\n<\/tr>\n<tr class=\"row-7\">\n\t<td class=\"column-1\">402<\/td><td class=\"column-2\">107<\/td><td class=\"column-3\">Brak wykupionego pakietu przez klienta<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-8\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">108<\/td><td class=\"column-3\">Klient zosta\u0142 zablokowany ze wzgl\u0119du na brak op\u0142aconego pakietu<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-9\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">109<\/td><td class=\"column-3\">Brak dost\u0119pu do API OCR (autentykacja przez token)<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-10\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">110<\/td><td class=\"column-3\">Wykorzystany pakiet dokument\u00f3w<\/td><td class=\"column-4\">Link do sklepu w 'Url'<\/td>\n<\/tr>\n<tr class=\"row-11\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">111<\/td><td class=\"column-3\">Brak wystarczaj\u0105cej liczby dokument\u00f3w w pakiecie<\/td><td class=\"column-4\">Link do sklepu w 'Url'<\/td>\n<\/tr>\n<tr class=\"row-12\">\n\t<td class=\"column-1\">500<\/td><td class=\"column-2\">112-116,199<\/td><td class=\"column-3\">B\u0142\u0119dy po stronie serwera<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-13\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">117<\/td><td class=\"column-3\">B\u0142\u0105d podczas autentykacji u\u017cytkownika z wykorzystaniem NIPu<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-14\">\n\t<td class=\"column-1\">503<\/td><td class=\"column-2\">118<\/td><td class=\"column-3\">Przerwa serwisowa<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-15\">\n\t<td class=\"column-1\">400<\/td><td class=\"column-2\">119<\/td><td class=\"column-3\">Niepoprawny parametr<\/td><td class=\"column-4\">Nazwa parametru w 'Message'<\/td>\n<\/tr>\n<tr class=\"row-16\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">101<\/td><td class=\"column-3\">B\u0142\u0105d podczas autentykacji u\u017cytkownika<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-17\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">102<\/td><td class=\"column-3\">Niepoprawny numer klucza<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-18\">\n\t<td class=\"column-1\">503<\/td><td class=\"column-2\">104<\/td><td class=\"column-3\">Przerwa techniczna<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<tr class=\"row-19\">\n\t<td class=\"column-1\">401<\/td><td class=\"column-2\">105<\/td><td class=\"column-3\">Token sesji wygas\u0142 lub jest niepoprawny<\/td><td class=\"column-4\"><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<!-- #tablepress-494 from cache -->\n<p><strong>W przypadku odpowiedzi z serwera z Code innym ni\u017c wymienione w tabeli powy\u017cej nale\u017cy wy\u015bwietli\u0107 informacj\u0119 zgodnie ze Statusem.<\/p>\n<p>Komunikat tej informacji znajduje si\u0119 w Message lub AdditionalMessage, i ewentualny link w UriToDownload.<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"<p>W pierwszym kroku nale\u017cy zalogowa\u0107 si\u0119 w aplikacji Comarch OCR i wygenerowa\u0107 klucze dost\u0119powe. Metody Tworzenie sesji u\u017cytkownika &#8222;session&#8221; (POST) Adres: https:\/\/cr.erp.comarch.pl\/api\/v1\/session &nbsp; W nag\u0142\u00f3wku zapytania nale\u017cy do\u0142\u0105czy\u0107 nast\u0119puj\u0105ce dane uwierzytelniaj\u0105ce: Opis struktury JSON odpowiedzi Przyk\u0142adowa odpowied\u017a JSON { &#8222;sessionToken&#8221;: &#8222;00000000-0000-0000-0000-000000000000&#8243;&#8221; } Mo\u017cliwe kody odpowiedzi HTTP: Usuwanie sesji u\u017cytkownika &#8222;session&#8221; (DELETE) Adres: https:\/\/cr.erp.comarch.pl\/api\/v1\/session &nbsp; W [&hellip;]<\/p>\n","protected":false},"author":11,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_ht_kb_usefulness":1,"_ht_kb_post_views_count":3916,"_ht_kb_article_order":0,"_ht_kb_reading_time":4,"footnotes":""},"ht_kb_category":[462],"ht_kb_tag":[],"class_list":["post-23068","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-ocr-jak-zaczac"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/ht_kb\/23068","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/users\/11"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/comments?post=23068"}],"version-history":[{"count":34,"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/ht_kb\/23068\/revisions"}],"predecessor-version":[{"id":42731,"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/ht_kb\/23068\/revisions\/42731"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/media?parent=23068"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/ht_kb_category?post=23068"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/optima\/pl\/2027\/wp-json\/wp\/v2\/ht_kb_tag?post=23068"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}