Pobierz deklarację VAT

Zakres: api:accounting:read. Gdy id należy do pliku JPK V7, a nie do deklaracji VAT-7, przekierowuje (302) na /saf_v7_files/{id}.json.

GET

https://api.sandbox-infakt.pl/v3/vat_taxes/{id}.json

Autoryzacja

ApiKey
opcjonalne
API key in header

Token
opcjonalne
API key in header

Path parameters

id
integer
wymagane
format: int64

Query parameters

fields
opcjonalne
string
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.

Header parameters

X-inFakt-ApiVersion
opcjonalne
3.1
3.1 zwraca status deklaracji sent zamiast printed.

Odpowiedzi

200

Sukces

JSON

id
integer
wymagane
format: int64
symbol
string
wymagane
PIT-5 (skala podatkowa), PIT-5L (podatek liniowy), PPE (ryczałt), VAT-7, VAT-7K, VAT-UE lub VAT-UEK (korekta).
period
string
wymagane
Pierwszy dzień okresu.

format: date
period_name
string
wymagane
period_type
string
wymagane
Miesięczny (M) lub kwartalny (Q).
correction_counter
integer
wymagane
format: int32
payment_date
string
wymagane
format: date
status
string
wymagane
Status deklaracji: draft, printed, sent lub paid. sent jest zwracany tylko z nagłówkiem X-inFakt-ApiVersion: 3.1, w przeciwnym razie jako printed.
vat_on_sale_price
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

format: int64
correction_reason
string
wymagane
edeclaration_enabled
boolean
wymagane
real_pay
integer
wymagane
Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.

format: int64
tax_office
object
wymagane
- info
  string
  wymagane
  Podpowiedź wyświetlana, gdy brakuje numeru rachunku podatkowego; w przeciwnym razie "".
- name
  string
  wymagane
- bank_name
  string
  wymagane
- account_number
  wymagane
  Indywidualny rachunek podatkowy (mikrorachunek).
  
  One of the following:
  string
  null
}
extensions
object
wymagane
- payments
  object
  wymagane
  Płatność online podatku w aplikacji inFakt.
  
  enabled
  boolean
  wymagane
  true, gdy podatek można teraz zapłacić online.
  
  pragma_offer_details_link
  null
  wymagane
  reason
  opcjonalne
  string
  Powód niedostępności płatności online, np. Płatność w trakcie przetwarzania; tylko przy enabled: false.
  
  webview
  opcjonalne
  object
  Przy enabled: true.
  
  link
  string
  wymagane
  Strona płatności online.
  
  pid
  string
  wymagane
  Identyfikator płatności bez znaczenia dla klienta API.
  
  link
  opcjonalne
  string
  Strona płatności online; przy enabled: true.
  
  pid
  opcjonalne
  string
  Przy enabled: true.
  
  amount
  opcjonalne
  integer
  Kwota do zapłaty; przy enabled: true.
  
  format: int64
  fee
  opcjonalne
  integer
  Opłata za płatność; przy enabled: true.
  
  format: int64
}
edeclaration_request
opcjonalne
object
Obecne po wysłaniu deklaracji elektronicznie.
- status
  string
  wymagane
- shippment_date
  string
  wymagane
  format: date
- description
  wymagane
  One of the following:
  string
  null
}

302

Przekierowanie na plik JPK V7.

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

403

Brak uprawnień, limit planu dla tej akcji (limit) albo zawieszone konto.

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

404

Nie znaleziono zasobu.

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

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

{ "id": 1, "symbol": "VAT-7", "period": "2020-09-01", "period_name": "Wrzesień 2020", "period_type": "M", "correction_counter": 0, "payment_date": "2020-10-26", "vat_on_sale_price": 230000, "vat_on_purchases_price": 46000, "overpaid_price": 0, "tax_to_pay_price": 184000, "status": "paid", "sale_in_poland_net_price": 1000000, "sale_in_poland_vat_price": 230000, "sale_services_abroad_net_price": 0, "sale_services_abroad_vat_price": 0, "sale_cargo_to_ue_net_price": 0, "sale_cargo_to_ue_vat_price": 0, "sale_cargo_outside_ue_net_price": 0, "sale_cargo_outside_ue_vat_price": 0, "purchase_of_fixed_assets_net_price": 0, "purchase_of_fixed_assets_vat_price": 0, "other_shopping_net_price": 200000, "other_shopping_vat_price": 46000, "correction_reason": "", "edeclaration_enabled": false, "real_pay": 184000, "tax_office": { "info": "", "name": "Urząd Skarbowy", "bank_name": "Narodowy Bank Polski", "account_number": "36101010100000000000000000" }, "extensions": { "payments": { "enabled": false, "pragma_offer_details_link": null } } }