--- title: "Pobierz listę produktów" description: "Zakres: `api:invoices:read`. Sortowanie po `name`, chyba że podano `order`.\n\nFiltry i `order` na `unit_net_price` i `unit_net_price_before_discount` są ignorowane; na `symbol` używają\n`pkwiu`, a na `tax_symbol` i `flat_rate_tax_symbol` porównują wewnętrzne id stawki, nie symbol.\n`fields` z `symbol`, `unit_net_price` lub `unit_net_price_before_discount` powoduje `500`." --- > Documentation Index > Fetch the complete documentation index at: https://docs.niebieskiorzel.pl/llms.txt > Use this file to discover all available pages before exploring further. Path: inFakt API › Produkty `GET /products.json` Zakres: `api:invoices:read`. Sortowanie po `name`, chyba że podano `order`. Filtry i `order` na `unit_net_price` i `unit_net_price_before_discount` są ignorowane; na `symbol` używają `pkwiu`, a na `tax_symbol` i `flat_rate_tax_symbol` porównują wewnętrzne id stawki, nie symbol. `fields` z `symbol`, `unit_net_price` lub `unit_net_price_before_discount` powoduje `500`. ## Authentication Requires one of the following: - `ApiKey`, apiKey, in header, header `X-inFakt-ApiKey` - `Token`, apiKey, in header, header `X-Token` ## Query parameters - `page` (`Products_list.query.page`; integer, optional) — Numer strony liczony od 1; ignorowany, gdy wysłany jest `offset`. - format `int32`; default `1` - `per_page` (`Products_list.query.per_page`; integer, optional) — Liczba wyników na stronę przy `page`. Serwer jej nie ogranicza. - format `int32`; default `10` - `offset` (`Products_list.query.offset`; integer, optional) — Indeks pierwszego wyniku (liczba pomijanych encji). - format `int32` - `limit` (`Products_list.query.limit`; integer, optional) — Liczba wyników na stronę przy `offset`; domyślnie 10, ignorowana bez `offset`. Większość list bez błędu obniża wartości powyżej 100 do 100. - format `int32` - `pagination_without_total` (`Products_list.query.pagination_without_total`; boolean, optional) — Pomiń liczenie; `metainfo.total_count` przyjmuje wartość `null`. - `fields` (`Products_list.query.fields`; string, optional) — Zawężenie pól: nazwy pól API rozdzielone przecinkami, np. `id,company_name`; `id` jest zwykle dodawane. Odpowiedź zawiera wtedy tylko te pola, więc nie odpowiada pełnemu schematowi. Pola wyliczane, a nie zapisywane, mogą kończyć się błędem `500`; operacja je wymienia. - `order` (`Products_list.query.order`; string, optional) — Sortowanie: ``, ` asc` albo ` desc` z nazwą pola API, np. `name desc`. Pole, po którym nie da się sortować, jest ignorowane bez błędu. - `q[name_eq]` (`Products_list.query.q[name_eq]`; string, optional) — Nazwa równa. - `q[name_cont]` (`Products_list.query.q[name_cont]`; string, optional) — Nazwa zawiera. - `q[pkwiu_eq]` (`Products_list.query.q[pkwiu_eq]`; string, optional) — Kod PKWiU równy. - `q[cn_eq]` (`Products_list.query.q[cn_eq]`; string, optional) — Kod CN równy. - `q[gtin_eq]` (`Products_list.query.q[gtin_eq]`; string, optional) — GTIN równy. - `q[unit_eq]` (`Products_list.query.q[unit_eq]`; string, optional) — Jednostka równa, np. `szt.`. ## Code samples ### cURL ```bash curl --request GET \ --url https://api.sandbox-infakt.pl/v3/products.json \ --header 'X-inFakt-ApiKey: ' ``` ### TypeScript ```typescript const url = 'https://api.sandbox-infakt.pl/v3/products.json'; const options = {method: 'GET', headers: {'X-inFakt-ApiKey': ''}}; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err)); ``` ### Python ```python import requests url = "https://api.sandbox-infakt.pl/v3/products.json" headers = {"X-inFakt-ApiKey": ""} response = requests.get(url, headers=headers) print(response.text) ``` ## Responses ### 200 Sukces #### Example ```json { "metainfo": { "count": 1, "total_count": 1, "next": "https://api.infakt.pl/v3/products.json?q%5Bname_cont%5D=Macbook&offset=10&limit=10", "previous": "https://api.infakt.pl/v3/products.json?q%5Bname_cont%5D=Macbook&offset=0&limit=10" }, "entities": [ { "id": 1007, "uuid": "c41f7a2d-9b3e-4d58-a6c1-0e7b2f9d3a85", "name": "Macbook Pro", "symbol": "234 / - / -", "pkwiu": "234", "cn": null, "pkob": null, "gtin": null, "unit": "szt.", "tax_symbol": "23", "flat_rate_tax_symbol": "", "quantity": 1, "net_price": 406423, "tax_price": 93477, "gross_price": 499900, "unit_net_price": 406423, "purchase_unit_net_price": 350000, "purchase_unit_gross_price": 430500, "discount": "0.0", "unit_net_price_before_discount": 406423, "vat_exemption_reason": null, "gtu_id": null } ] } ``` - `metainfo` (`Products_list.response.200.metainfo`; object, required) - `count` (`Products_list.response.200.metainfo.count`; integer, required) — Liczba encji na tej stronie. - format `int32` - `total_count` (`Products_list.response.200.metainfo.total_count`; any of, required) — Liczba pasujących encji; `null`, gdy `pagination_without_total=true`. - any of: `integer`, `null` - `next` (`Products_list.response.200.metainfo.next`; string, required) — Bezwzględny URL następnej strony w postaci `offset`/`limit`. - `previous` (`Products_list.response.200.metainfo.previous`; string, required) — Bezwzględny URL poprzedniej strony w postaci `offset`/`limit`. - `entities` (`Products_list.response.200.entities`; array, required) - `id` (`Products_list.response.200.entities.id`; integer, required) - format `int64` - `uuid` (`Products_list.response.200.entities.uuid`; string, required) - format `uuid` - `name` (`Products_list.response.200.entities.name`; string, required) - `symbol` (`Products_list.response.200.entities.symbol`; any of, required) — Klasyfikacja drukowana na dokumentach. Gdy ustawiono `pkwiu`, `cn` lub `pkob`, ma postać `pkwiu / cn / pkob` z `-` w miejscu każdego brakującego kodu, np. `234 / - / -`. - any of: `string`, `null` - `pkwiu` (`Products_list.response.200.entities.pkwiu`; any of, required) — Kod PKWiU dla KSeF. - any of: `string`, `null` - `cn` (`Products_list.response.200.entities.cn`; any of, required) — Kod CN dla KSeF. - any of: `string`, `null` - `pkob` (`Products_list.response.200.entities.pkob`; any of, required) — Kod PKOB dla KSeF. - any of: `string`, `null` - `gtin` (`Products_list.response.200.entities.gtin`; any of, required) - any of: `string`, `null` - `unit` (`Products_list.response.200.entities.unit`; any of, required) — Jednostka miary, np. `szt.`. - any of: `string`, `null` - `tax_symbol` (`Products_list.response.200.entities.tax_symbol`; string, required) — Symbol stawki VAT, np. `23`, `8`, `zw`. Zobacz `GET /vat_rates.json`. - `flat_rate_tax_symbol` (`Products_list.response.200.entities.flat_rate_tax_symbol`; string, required) — Symbol stawki ryczałtu; `""`, gdy nie ustawiono. - `quantity` (`Products_list.response.200.entities.quantity`; number, required) - format `double` - `net_price` (`Products_list.response.200.entities.net_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `tax_price` (`Products_list.response.200.entities.tax_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `gross_price` (`Products_list.response.200.entities.gross_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `unit_net_price` (`Products_list.response.200.entities.unit_net_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `purchase_unit_net_price` (`Products_list.response.200.entities.purchase_unit_net_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `purchase_unit_gross_price` (`Products_list.response.200.entities.purchase_unit_gross_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `discount` (`Products_list.response.200.entities.discount`; string, required) — Rabat w procentach. - pattern `^-?\d+(\.\d+)?$` - `unit_net_price_before_discount` (`Products_list.response.200.entities.unit_net_price_before_discount`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `vat_exemption_reason` (`Products_list.response.200.entities.vat_exemption_reason`; any of, required) — Id podstawy zwolnienia z VAT. Zobacz `GET /vat_exemptions.json`. - any of: `integer`, `null` - `gtu_id` (`Products_list.response.200.entities.gtu_id`; any of, required) — Id kodu GTU. Zobacz `GET /gtus.json`. - any of: `integer`, `null` ### 400 Nieprawidłowe parametry wyszukiwania (`q[...]`); na niektórych endpointach także nieprawidłowe parametry stronicowania. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`Products_list.response.400.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`Products_list.response.400.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`Products_list.response.400.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`Products_list.response.400.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`Products_list.response.400.url`; string, optional) - `action_url` (`Products_list.response.400.action_url`; string, optional) ### 401 Brak klucza API, nieprawidłowy klucz albo klucz bez wymaganego zakresu uprawnień. #### Example ```json { "error": "Klucz API który podałeś jest nieprawidłowy." } ``` - `error` (`Products_list.response.401.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`Products_list.response.401.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`Products_list.response.401.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`Products_list.response.401.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`Products_list.response.401.url`; string, optional) - `action_url` (`Products_list.response.401.action_url`; string, optional) ### 402 API niedostępne w obecnym planie (`limit: plan_upgrade_needed`) albo osiągnięty limit dokumentów. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`Products_list.response.402.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`Products_list.response.402.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`Products_list.response.402.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`Products_list.response.402.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`Products_list.response.402.url`; string, optional) - `action_url` (`Products_list.response.402.action_url`; string, optional) ### 406 Ścieżka nie kończy się na `.json`. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`Products_list.response.406.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`Products_list.response.406.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`Products_list.response.406.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`Products_list.response.406.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`Products_list.response.406.url`; string, optional) - `action_url` (`Products_list.response.406.action_url`; string, optional) ### 423 Niepotwierdzony adres e-mail albo wymagana weryfikacja tożsamości. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`Products_list.response.423.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`Products_list.response.423.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`Products_list.response.423.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`Products_list.response.423.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`Products_list.response.423.url`; string, optional) - `action_url` (`Products_list.response.423.action_url`; string, optional) ### 429 Przekroczony limit zapytań. Komunikat jest po angielsku, np. `API rate limit exceeded. Try again in 60 seconds.` #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`Products_list.response.429.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`Products_list.response.429.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`Products_list.response.429.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`Products_list.response.429.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`Products_list.response.429.url`; string, optional) - `action_url` (`Products_list.response.429.action_url`; string, optional) Source: https://docs.niebieskiorzel.pl/api/products-json/list/index.md