Utwórz produkt

Zakres: api:invoices:write.

POST

https://api.sandbox-infakt.pl/v3/products.json

Autoryzacja

ApiKey
opcjonalne
API key in header

Token
opcjonalne
API key in header

Treść żądania JSON required

product
object
wymagane
Wymagane są name (unikalna) i tax_symbol. Ceny nie są wyliczane: pominięte ceny zapisują się jako 0. tax_price musi być równe net_price × stawka VAT (±1 grosz, klucz błędu vat), a gross_price musi być równe net_price + tax_price (klucz błędu gross).
- name
  string
  wymagane
- tax_symbol
  string
  wymagane
  Symbol stawki VAT. Zobacz GET /vat_rates.json.
- pkwiu
  opcjonalne
  string
  maxLength: 50 · pattern: ^[.\d]+$
- cn
  opcjonalne
  string
  maxLength: 50 · pattern: ^[\d ]+$
- pkob
  opcjonalne
  string
  maxLength: 50 · pattern: ^\d+$
- gtin
  opcjonalne
  string
  maxLength: 20 · pattern: ^\d+$
- symbol
  opcjonalne
  string
  Ignorowane, gdy wysłano pkwiu, cn lub pkob.
- unit
  opcjonalne
  string
- flat_rate_tax_symbol
  opcjonalne
  string
- quantity
  opcjonalne
  number
  Domyślnie 1.
  
  format: double
- net_price
  opcjonalne
  integer
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
- tax_price
  opcjonalne
  integer
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
- gross_price
  opcjonalne
  integer
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
- unit_net_price
  opcjonalne
  integer
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
- purchase_unit_net_price
  opcjonalne
  integer
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
- purchase_unit_gross_price
  opcjonalne
  integer
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
- discount
  opcjonalne
  number
  Rabat w procentach; domyślnie 0.
  
  format: double · minimum: 0
- unit_net_price_before_discount
  opcjonalne
  integer
  Domyślnie unit_net_price.
  
  format: int64
- vat_exemption_reason
  opcjonalne
  integer
  format: int64
- gtu_id
  opcjonalne
  integer
  format: int64
}

Example requests

{
  "product": {
    "name": "Macbook Pro",
    "pkwiu": "234",
    "unit": "szt.",
    "tax_symbol": "23",
    "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
  }
}

{
  "product": {
    "name": "Macbook Air",
    "tax_symbol": "23",
    "quantity": 1,
    "net_price": 406423,
    "tax_price": 93477,
    "gross_price": 500000,
    "unit_net_price": 406423
  }
}

Odpowiedzi

201

Utworzono

JSON

id
integer
wymagane
format: int64
uuid
string
wymagane
format: uuid
name
string
wymagane
symbol
wymagane
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 / - / -.
One of the following:
string
null
}
pkwiu
wymagane
Kod PKWiU dla KSeF.
One of the following:
string
null
}
cn
wymagane
Kod CN dla KSeF.
One of the following:
string
null
}
pkob
wymagane
Kod PKOB dla KSeF.
One of the following:
string
null
}
gtin
wymagane
One of the following:
string
null
}
unit
wymagane
Jednostka miary, np. szt..
One of the following:
string
null
}
tax_symbol
string
wymagane
Symbol stawki VAT, np. 23, 8, zw. Zobacz GET /vat_rates.json.
flat_rate_tax_symbol
string
wymagane
Symbol stawki ryczałtu; "", gdy nie ustawiono.
quantity
number
wymagane
format: double
net_price
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

format: int64
tax_price
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

format: int64
gross_price
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

format: int64
unit_net_price
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

format: int64
purchase_unit_net_price
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

format: int64
purchase_unit_gross_price
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

format: int64
discount
string
wymagane
Rabat w procentach.

pattern: ^-?\d+(\.\d+)?$
unit_net_price_before_discount
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

format: int64
vat_exemption_reason
wymagane
Id podstawy zwolnienia z VAT. Zobacz GET /vat_exemptions.json.
One of the following:
integer
null
}
gtu_id
wymagane
Id kodu GTU. Zobacz GET /gtus.json.
One of the following:
integer
null
}

401

Brak klucza API, nieprawidłowy klucz albo klucz bez wymaganego zakresu uprawnień.

JSON

error
opcjonalne
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.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

402

API niedostępne w obecnym planie (limit: plan_upgrade_needed) albo osiągnięty limit dokumentów.

JSON

error
opcjonalne
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.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

406

Ścieżka nie kończy się na .json.

JSON

error
opcjonalne
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.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

422

Walidacja nie powiodła się; szczegóły w errors.

JSON

error
opcjonalne
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.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

423

Niepotwierdzony adres e-mail albo wymagana weryfikacja tożsamości.

JSON

error
opcjonalne
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.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

429

Przekroczony limit zapytań. Komunikat jest po angielsku, np. API rate limit exceeded. Try again in 60 seconds.

JSON

error
opcjonalne
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.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

curl --request POST \ --url https://api.sandbox-infakt.pl/v3/products.json \ --header 'Content-Type: application/json' \ --header 'X-inFakt-ApiKey: <X-inFakt-ApiKey>' \ --data ' { "product": { "name": "Macbook Pro", "pkwiu": "234", "unit": "szt.", "tax_symbol": "23", "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 } } '

{ "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 }