Utwórz dowód wewnętrzny

Zakres: api:invoices:write. Zwraca 403, gdy użytkownik nie może zarządzać dowodami wewnętrznymi.

POST

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

Autoryzacja

ApiKey
opcjonalne
API key in header

Token
opcjonalne
API key in header

Treść żądania JSON required

internal_evidence
object
wymagane
- classification_symbol
  sold
  or
  salary
  wymagane
  sold (Sprzedaż) albo salary (Pozostałe przychody).
- service_name
  string
  wymagane
- number
  opcjonalne
  string
- invoice_date
  opcjonalne
  string
  Domyślnie dzisiaj.
  
  format: date
- notes
  opcjonalne
  string
- quantity
  opcjonalne
  number
  format: double · default: 1
- unit_price
  opcjonalne
  integer
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
- total_price
  opcjonalne
  integer
  Nie jest wyliczane z quantity i unit_price; domyślnie 0.
  
  format: int64
- flat_rate_tax_symbol
  opcjonalne
  string
- reconciliation_id
  opcjonalne
  string
}

Example request

{
  "internal_evidence": {
    "classification_symbol": "sold",
    "invoice_date": "2026-10-01",
    "service_name": "Sprzedaż złomu",
    "quantity": 1,
    "unit_price": 25000,
    "total_price": 25000
  }
}

Odpowiedzi

201

Utworzono

JSON

id
integer
wymagane
format: int64
uuid
string
wymagane
format: uuid
number
string
wymagane
status
draft
or
sent
or
printed
or
unpaid
or
paid
or
scheduled
wymagane
classification_symbol
wymagane
sold (Sprzedaż) albo salary (Pozostałe przychody).
One of the following:
string
null
}
invoice_date
string
wymagane
format: date
notes
wymagane
One of the following:
string
null
}
service_name
string
wymagane
quantity
string
wymagane
Liczba dziesiętna zapisana jako tekst.

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

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

format: int64
reconciliation_id
wymagane
One of the following:
string
null
}
flat_rate_tax_symbol
opcjonalne
Występuje tylko u ryczałtowców.
One of the following:
string
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

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

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/internal_evidences.json \ --header 'Content-Type: application/json' \ --header 'X-inFakt-ApiKey: <X-inFakt-ApiKey>' \ --data ' { "internal_evidence": { "classification_symbol": "sold", "invoice_date": "2026-10-01", "service_name": "Sprzedaż złomu", "quantity": 1, "unit_price": 25000, "total_price": 25000 } } '

{ "id": 3002, "uuid": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d1e", "number": "1/DW/10/2026", "status": "draft", "classification_symbol": "sold", "invoice_date": "2026-10-01", "notes": null, "service_name": "Sprzedaż złomu", "quantity": "1.0", "unit_price": 25000, "total_price": 25000, "reconciliation_id": null }