{"id":168,"date":"2026-01-11T00:34:48","date_gmt":"2026-01-11T00:34:48","guid":{"rendered":"https:\/\/ksef24.com\/?page_id=168"},"modified":"2026-03-15T23:51:36","modified_gmt":"2026-03-15T23:51:36","slug":"ksef-bramka-black-box","status":"publish","type":"page","link":"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/","title":{"rendered":"KSeF gate (black-box)"},"content":{"rendered":"<h1 style=\"text-align: center;\">KSeF Gateway Integration Documentation (black-box)<br \/>\nfor the National e-Invoice System (KSeF 2.0)<\/h1>\n<p><strong>Attention<\/strong>! The KSeF Gateway (black-box) component provides the operations described in this chapter, which are dedicated to the component, as well as all the operations described in the chapter <a href=\"https:\/\/ksef24.com\/en\/\">KSEF REST API<\/a>A company that decides to integrate its system using the KSeF Gateway (black-box) independently decides how to use individual operations.<\/p>\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_75 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewbox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewbox=\"0 0 24 24\" version=\"1.2\" baseprofile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#Komponenty\" >Components<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#Operacje\" >Operations<\/a><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#boxUploadInvoice\" >boxUploadInvoice<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#boxUploadInvoiceStatus\" >boxUploadInvoiceStatus<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#boxUploadBatch\" >boxUploadBatch<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#boxUploadBatchStatus\" >boxUploadBatchStatus<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#boxDownloadInvoices\" >boxDownloadInvoices<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#boxDownloadInvoicesResult\" >boxDownloadInvoicesResult<\/a><\/li><\/ul><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#Parametry\" >Parameters<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#Path\" >Path<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/ksef24.com\/en\/ksef-bramka-black-box\/#RequestBody\" >RequestBody<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n<h2 style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"Komponenty\"><\/span>Components<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p><span>For the purposes of this documentation, three basic components have been adopted that participate in business processes related to the management of KSeF invoices using the KSeF Gateway:<\/span><\/p>\n<p style=\"text-align: center;\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-4.png\" width=\"1070\" height=\"212\" alt=\"Bramka KSeF 2.0 (black-box) - komponenty\" class=\"aligncenter wp-image-182 size-full\" title=\"KSeF 2.0 gateway (black-box) - components\" srcset=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-4.png 1070w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-4-300x59.png 300w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-4-1024x203.png 1024w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-4-768x152.png 768w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-4-18x4.png 18w\" sizes=\"auto, (max-width: 1070px) 100vw, 1070px\" \/><span>Diagram: Components<\/span><\/p>\n<h6>Calling system<\/h6>\n<p>The Client&#039;s IT system that communicates with KSeF 2.0 via the KSeF Gateway (black-box) implemented on-premise (locally at the client&#039;s premises).<\/p>\n<h6>National e-Invoice System (KSeF 2.0)<\/h6>\n<p><a href=\"https:\/\/ksef.mf.gov.pl\/\">National e-Invoice System<\/a><span>\u00a0<\/span>is a central repository of structured electronic invoices that is managed and maintained by the Ministry of Finance.<\/p>\n<h6>KSeF gate (black-box)<\/h6>\n<p>A technical component implemented in the Docker architecture or as a VM (virtual machine), providing basic functionalities related to sending invoices to KSeF. The KSeF gateway (black box) is implemented and maintained within the client&#039;s infrastructure.<\/p>\n<h2 style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"Operacje\"><\/span>Operations<span class=\"ez-toc-section-end\"><\/span><span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>The chapter contains a description of the operations available within the KSeF Gateway (black-box).<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-35.png\" width=\"525\" height=\"520\" alt=\"Bramka KSeF (black-box) interfejsy, KSeF Gateway interface\" class=\"aligncenter wp-image-246 size-full\" srcset=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-35.png 525w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-35-300x297.png 300w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-35-150x150.png 150w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-35-12x12.png 12w\" sizes=\"auto, (max-width: 525px) 100vw, 525px\" \/><\/p>\n<p style=\"text-align: center;\"><span>Diagram: Interface for the KSeF Gateway (black-box) with available methods<\/span><\/p>\n<h4 id=\"boxUploadInvoice\" style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"boxUploadInvoice\"><\/span><a href=\"https:\/\/ksefapi.pl\/public\/rest\/#\/box\/boxUploadInvoice\">boxUploadInvoice<\/a><span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>This method allows you to send a single invoice to KSeF. Click on the operation name to go to <strong><a href=\"https:\/\/ksefapi.pl\/public\/rest\/\">Swagger UI<\/a><\/strong>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-5.png\" width=\"951\" height=\"228\" alt=\"Bramka KSeF 2.0 - wys\u0142anie faktury\" class=\"wp-image-183 size-full aligncenter\" title=\"KSeF 2.0 Gateway - sending an invoice\" srcset=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-5.png 951w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-5-300x72.png 300w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-5-768x184.png 768w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-5-18x4.png 18w\" sizes=\"auto, (max-width: 951px) 100vw, 951px\" \/><\/p>\n<p style=\"text-align: center;\">Diagram: boxUploadInvoice<\/p>\n<h5><em>BoxUploadInvoiceRequest<\/em><\/h5>\n<p>The class is described in the chapter <a href=\"#BoxUploadInvoiceRequest\">BoxUploadInvoiceRequest<\/a>.<\/p>\n<h5><em>BoxUploadInvoiceResponse<\/em><\/h5>\n<p>The class represents a response informing about the status of an invoice sent to the KSeF Gateway (black-box).<\/p>\n<p><code data-no-translation=\"\">result<\/code> : boolean \u2013 Attribute value <strong>true<\/strong>, informs about the correct receipt of the entire invoice package by the KSeF Gateway (black-box).<\/p>\n<h4 id=\"boxUploadInvoiceStatus\" style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"boxUploadInvoiceStatus\"><\/span><a href=\"https:\/\/ksefapi.pl\/public\/rest\/#\/box\/boxUploadInvoiceStatus\">boxUploadInvoiceStatus<\/a><span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>This method allows you to check the status of a single invoice sent to KSeF. Click on the operation name to go to <strong><a href=\"https:\/\/ksefapi.pl\/public\/rest\/\">Swagger UI<\/a><\/strong>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-6.png\" width=\"908\" height=\"478\" alt=\"Bramka KSeF 2.0 - sprawdzanie statusu wys\u0142anej faktury\" class=\"aligncenter wp-image-184 size-full\" title=\"KSeF 2.0 Gateway - checking the status of a sent invoice\" srcset=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-6.png 908w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-6-300x158.png 300w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-6-768x404.png 768w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-6-18x9.png 18w\" sizes=\"auto, (max-width: 908px) 100vw, 908px\" \/><\/p>\n<p>&nbsp;<\/p>\n<p style=\"text-align: center;\">Diagram: boxUploadInvoiceStatus<\/p>\n<h5><em>UploadId<\/em><span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>The class is described in the chapter <a href=\"#UploadId\">UploadId<\/a>.<\/p>\n<h5><em>BoxUploadInvoiceStatusResponse<\/em><\/h5>\n<p>The class represents a response informing about the status of an invoice sent to KSeF.<\/p>\n<p><code data-no-translation=\"\"><strong>uploadId<\/strong><\/code><span>\u00a0<\/span>: string \u2013 Unique identifier of the invoice being sent.<\/p>\n<p><code data-no-translation=\"\">invoiceInfo<\/code> :\u00a0<a href=\"https:\/\/ksef24.com\/en\/#InvoiceInfo\">InvoiceInfo<\/a><span>\u00a0<\/span>\u2013 This attribute contains tables of information detailing the status of sent invoices. This complex type is described in the chapter <a href=\"https:\/\/ksef24.com\/en\/#InvoiceInfo\">InvoiceInfo<\/a>.<\/p>\n<p><code data-no-translation=\"\">sessionId<\/code>: string \u2013 Attribute described in the chapter <a href=\"\/en\/#SessionId\">SessionId<\/a>.<\/p>\n<p><code data-no-translation=\"\">upo<\/code> : string \u2013 The attribute contains a UPO, i.e. a base64 encoded XML file.<\/p>\n<h4 id=\"boxUploadBatch\" style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"boxUploadBatch\"><\/span><a href=\"https:\/\/ksefapi.pl\/public\/rest\/#\/box\/boxUploadBatch\">boxUploadBatch<\/a><span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>This method allows you to send an invoice package to KSeF. Click on the operation name to go to <strong><a href=\"https:\/\/ksefapi.pl\/public\/rest\/\">Swagger UI<\/a><\/strong>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-8.png\" width=\"1000\" height=\"481\" alt=\"Bramka KSeF 2.0 - wys\u0142anie paczki faktur\" class=\"aligncenter wp-image-186 size-full\" title=\"KSeF 2.0 Gateway - sending a batch of invoices\" srcset=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-8.png 1000w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-8-300x144.png 300w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-8-768x369.png 768w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-8-18x9.png 18w\" sizes=\"auto, (max-width: 1000px) 100vw, 1000px\" \/><\/p>\n<p style=\"text-align: center;\">Diagram: boxUploadBatch<\/p>\n<h5><em>BoxUploadBatchRequest<\/em><\/h5>\n<p>The class is described in the chapter <a href=\"#BoxUploadBatchRequest\">BoxUploadBatchRequest<\/a>.<\/p>\n<h5><em>BoxUploadBatchResponse<\/em><\/h5>\n<p>The class represents a response informing about the status of a batch of invoices sent to the KSeF Gateway (black-box).<\/p>\n<p><code data-no-translation=\"\">result<\/code> : boolean \u2013 Attribute value <strong>true<\/strong>, informs about the correct receipt of the entire invoice package by the KSeF Gateway (black-box).<\/p>\n<h4 id=\"boxUploadBatchStatus\" style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"boxUploadBatchStatus\"><\/span><a href=\"https:\/\/ksefapi.pl\/public\/rest\/#\/box\/boxUploadBatchStatus\">boxUploadBatchStatus<\/a><span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>This method allows you to check the status of a batch of invoices sent to KSeF. Click on the operation name to go to <strong><a href=\"https:\/\/ksefapi.pl\/public\/rest\/\">Swagger UI<\/a><\/strong>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-7.png\" width=\"1055\" height=\"482\" alt=\"Bramka KseF 2.0 - sprawdzenie statusu wysy\u0142ki paczki faktur\" class=\"aligncenter wp-image-185 size-full\" title=\"KseF 2.0 Gateway - checking the shipment status of a batch of invoices\" srcset=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-7.png 1055w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-7-300x137.png 300w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-7-1024x468.png 1024w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-7-768x351.png 768w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-7-18x8.png 18w\" sizes=\"auto, (max-width: 1055px) 100vw, 1055px\" \/><\/p>\n<p style=\"text-align: center;\">Diagram: boxUploadBatchStatus<\/p>\n<h5><em>UploadId<\/em><span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>The class is described in the chapter <a href=\"#UploadId\">UploadId<\/a>.<\/p>\n<h5><em>BoxUploadBatchStatusResponse<\/em><\/h5>\n<p>The class represents a response informing about the status of invoices sent to KSeF.<\/p>\n<p><code data-no-translation=\"\"><strong>uploadId<\/strong><\/code><span>\u00a0<\/span>: string \u2013 Unique identifier of the invoice batch being sent.<\/p>\n<p><code data-no-translation=\"\">invoiceInfo<\/code> :\u00a0<a href=\"https:\/\/ksef24.com\/en\/#InvoiceInfo\">InvoiceInfo<\/a><span>\u00a0<\/span>\u2013 This attribute contains tables of information detailing the status of sent invoices. This complex type is described in the chapter <a href=\"https:\/\/ksef24.com\/en\/#InvoiceInfo\">InvoiceInfo<\/a>.<\/p>\n<p><code data-no-translation=\"\">sessionId<\/code>: string \u2013 Attribute described in the chapter <a href=\"\/en\/#SessionId\">SessionId<\/a>.<\/p>\n<p><code data-no-translation=\"\">upo<\/code> : string \u2013 The attribute contains a UPO, i.e. a base64 encoded XML file.<\/p>\n<h4 id=\"boxDownloadInvoices\" style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"boxDownloadInvoices\"><\/span><a href=\"https:\/\/ksefapi.pl\/public\/rest\/#\/box\/boxDownloadInvoices\">boxDownloadInvoices<\/a><span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>This method allows you to define and send to KSeF search criteria for which invoices will be returned. Click on the operation name to go to <strong><a href=\"https:\/\/ksefapi.pl\/public\/rest\/\">Swagger UI<\/a><\/strong>.<\/p>\n<p style=\"text-align: center;\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-37.png\" width=\"1025\" height=\"531\" alt=\"Bramka KSeF 2.0 - wyszukiwanie faktur KSeF do pobrania\" class=\"wp-image-250 size-full aligncenter\" srcset=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-37.png 1025w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-37-300x155.png 300w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-37-768x398.png 768w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-37-18x9.png 18w\" sizes=\"auto, (max-width: 1025px) 100vw, 1025px\" \/><\/p>\n<p style=\"text-align: center;\">Diagram: boxDownloadInvoices<\/p>\n<h5><em>BoxDownloadInvoicesRequest<\/em><\/h5>\n<p>The class is described in the chapter <a href=\"#BoxDownloadInvoicesRequest\">BoxDownloadInvoicesRequest<\/a>.<\/p>\n<h5><em>BoxDownloadInvoicesResponse<\/em><\/h5>\n<p>The class represents a response informing about the status of the query sent to KSeF.<\/p>\n<p><code data-no-translation=\"\">result<\/code> : boolean \u2013 Attribute value <strong>true<\/strong>, informs about the correct submission of the KSeF invoice search request to the KSeF Gateway (black-box).<\/p>\n<h4 id=\"boxDownloadInvoicesResult\" style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"boxDownloadInvoicesResult\"><\/span><a href=\"https:\/\/ksefapi.pl\/public\/rest\/#\/box\/boxDownloadInvoicesResult\">boxDownloadInvoicesResult<\/a><span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>The method allows you to download from KSeF all found invoices that meet the search criteria defined in the request <a href=\"#BoxDownloadInvoicesRequest\">BoxDownloadInvoicesRequest<\/a>Click on the name of the operation to go to <strong><a href=\"https:\/\/ksefapi.pl\/public\/rest\/\">Swagger UI<\/a><\/strong>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-38-1024x193.png\" width=\"750\" height=\"141\" alt=\"Bramka KSeF 2.0 - Pobieranie wszystkich znalezionych faktur KSeF\" class=\"aligncenter wp-image-251 size-large\" srcset=\"https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-38-1024x193.png 1024w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-38-300x56.png 300w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-38-768x144.png 768w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-38-18x3.png 18w, https:\/\/ksef24.com\/wp-content\/uploads\/2026\/01\/image-38.png 1042w\" sizes=\"auto, (max-width: 750px) 100vw, 750px\" \/><\/p>\n<p style=\"text-align: center;\">Diagram: boxDownloadInvoicesResult<\/p>\n<h5><em>DownloadId<\/em><\/h5>\n<p>The class is described in the chapter <a href=\"#DownloadId\">DownloadId<\/a>.<\/p>\n<h5><em>ApplicationZipContent<\/em><\/h5>\n<p>The class is described in the chapter <a href=\"https:\/\/ksef24.com\/en\/#post-449-BKM_0F091857_5CA9_4A1C_9E5F_B65F98CDF963\">ApplicationZipContent<\/a>.<\/p>\n<h2 style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"Parametry\"><\/span>Parameters<span class=\"ez-toc-section-end\"><\/span><span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>The chapter contains a summary of all parameters by type:<\/p>\n<ul>\n<li>path \u2013 parameter passed in the URL path<\/li>\n<li>requestBody \u2013 parameter passed in the request body<\/li>\n<\/ul>\n<h3 style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"Path\"><\/span>Path<span class=\"ez-toc-section-end\"><\/span><span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Parameters for calling the operation included in the path.<\/p>\n<h5 id=\"UploadId\"><em>UploadId<\/em><span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>The class represents the transmitted identifier of an invoice or batch of invoices.<\/p>\n<p><code data-no-translation=\"\"><strong>uploadId<\/strong><\/code><span>\u00a0<\/span>: string \u2013 Unique identifier of the invoice or invoice batch being sent.<\/p>\n<h5 id=\"DownloadId\"><em>DownloadId<\/em><\/h5>\n<p>The class represents the uploaded invoice search identifier.<\/p>\n<p><code data-no-translation=\"\">downloadId<\/code> : string \u2013 Unique invoice search identifier, generated when sending the request <a href=\"#BoxDownloadInvoicesRequest\">BoxDownloadInvoicesRequest<\/a>, and used as an input parameter in the operation <a href=\"#boxDownloadInvoicesResult\">boxDownloadInvoicesResult<\/a>.<\/p>\n<h3 style=\"text-align: center;\"><span class=\"ez-toc-section\" id=\"RequestBody\"><\/span>RequestBody<span class=\"ez-toc-section-end\"><\/span><span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Parameters of the requestBody type passed in the request body.<\/p>\n<h5 id=\"BoxUploadInvoiceRequest\"><em>BoxUploadInvoiceRequest<\/em><\/h5>\n<p>The class describes the data necessary to send a structured invoice to KSeF.<\/p>\n<p><code data-no-translation=\"\"> uploadId<\/code> : string \u2013 ID of the invoice being sent.<\/p>\n<p><code data-no-translation=\"\">offline<\/code> : boolean \u2013 Value <strong>true<\/strong> attribute means that an invoice generated in offline24 mode is being sent.<\/p>\n<p><code data-no-translation=\"\">notify<\/code> : boolean \u2013 Value <strong>true<\/strong> attribute means that the user has defined a webhook in the user panel to which the system should send information in the event of information about the status of sent invoices appearing in KSeF.<\/p>\n<p><code data-no-translation=\"\">upo<\/code> : boolean \u2013 Value <strong>true<\/strong> attribute that operations <a href=\"\/en\/ksef-bramka-black-box\/#boxUploadInvoiceStatus\">boxUploadInvoiceStatus<\/a> and <a href=\"\/en\/ksef-bramka-black-box\/#boxUploadBatchStatus\">boxUploadBatchStatus<\/a> they will immediately return the collective Official Confirmation of Receipt (UPO) with the result,<\/p>\n<p><code data-no-translation=\"\">invoiceData<\/code> : string \u2013 The invoice being sent, compliant with the applicable FA(2) or FA(3) scheme, encoded using Base64.<\/p>\n<h5 id=\"BoxUploadBatchRequest\"><em>BoxUploadBatchRequest<\/em><\/h5>\n<p>The class describes the data necessary to send the entire package of structured invoices to KSeF.<\/p>\n<p><code data-no-translation=\"\">uploadId<\/code> : string \u2013 ID of the invoice being sent.<\/p>\n<p><code data-no-translation=\"\">offline<\/code> : boolean \u2013 Value <strong>true<\/strong> attribute means that an invoice generated in offline24 mode is being sent.<\/p>\n<p><code data-no-translation=\"\">notify<\/code> : boolean \u2013 Value <strong>true<\/strong> attribute means that the user has defined a webhook in the user panel to which the system should send information in the event of information about the status of sent invoices appearing in KSeF.<\/p>\n<p><code data-no-translation=\"\">upo<\/code> : boolean \u2013 Value <strong>true<\/strong> attribute that operations <a href=\"\/en\/ksef-bramka-black-box\/#boxUploadInvoiceStatus\">boxUploadInvoiceStatus<\/a> and <a href=\"\/en\/ksef-bramka-black-box\/#boxUploadBatchStatus\">boxUploadBatchStatus<\/a> they will immediately return the collective Official Confirmation of Receipt (UPO) with the result,<\/p>\n<p><code data-no-translation=\"\">invoiceVersion<\/code> : KsefInvoiceVersion \u2013 This attribute contains information about the schema of the invoices being sent. All invoices must be of the same schema. Content type<span> was described in the chapter <\/span><a href=\"https:\/\/ksef24.com\/en\/#KsefInvoiceVersion\">KsefInvoiceVersion<\/a><span>.<\/span><\/p>\n<h5 id=\"BoxDownloadInvoicesRequest\"><em>BoxDownloadInvoicesRequest<\/em><\/h5>\n<p>The class represents a request that allows defining parameters for searching invoices in KSeF.<\/p>\n<p><code data-no-translation=\"\">downloadId<\/code> : string \u2013 Generated unique search identifier, which is used in the method <a href=\"#boxDownloadInvoicesResult\">boxDownloadInvoicesResult<\/a> possible download of found invoices.<\/p>\n<p><code data-no-translation=\"\">notify<\/code> : boolean \u2013 Value <strong>true<\/strong> attribute means that the user has defined a webhook in the user panel to which the system should send information in the event of information about the status of sent invoices appearing in KSeF.<\/p>\n<p><code data-no-translation=\"\">subjectType<\/code> : <a href=\"https:\/\/ksef24.com\/en\/#SubjectType\">SubjectType<\/a> \u2013 Specifying what type of invoice we are searching for. The content type is described in the chapter <a href=\"https:\/\/ksef24.com\/en\/#SubjectType\">SubjectType<\/a>.<\/p>\n<p><code data-no-translation=\"\">range<\/code> : <a href=\"https:\/\/ksef24.com\/en\/#KsefInvoiceQueryStartRange\">KsefInvoiceQueryStartRange<\/a> \u2013 Select the period for which invoices are to be searched. Content type described in the chapter <a href=\"https:\/\/ksef24.com\/en\/#KsefInvoiceQueryStartRange\">KsefInvoiceQueryStartRange<\/a>.<\/p>\n<p>&nbsp;<\/p>","protected":false},"excerpt":{"rendered":"<p>KSeF Gateway (black-box) Integration Documentation for the National e-Invoice System (KSeF 2.0) Note: The KSeF Gateway (black-box) component provides the operations described in this chapter, which are dedicated to the component, as well as all operations described in the KSEF REST API chapter. A company that decides to integrate its system using the KSeF Gateway [\u2026]<\/p>","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"page-templates\/template-fullwidth.php","meta":{"footnotes":""},"class_list":["post-168","page","type-page","status-publish","hentry"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/ksef24.com\/en\/wp-json\/wp\/v2\/pages\/168","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ksef24.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ksef24.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ksef24.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ksef24.com\/en\/wp-json\/wp\/v2\/comments?post=168"}],"version-history":[{"count":0,"href":"https:\/\/ksef24.com\/en\/wp-json\/wp\/v2\/pages\/168\/revisions"}],"wp:attachment":[{"href":"https:\/\/ksef24.com\/en\/wp-json\/wp\/v2\/media?parent=168"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}