Oznacz koszty jako opłacone

Zakres: api:costs:write. Koszty i skany dokumentów. Z uuids i włączonym automatycznym księgowaniem różnic kursowych koszty w walucie obcej są pomijane i zgłaszane jako failure; oznaczaj je pojedynczo przez uuid.

PUT

https://api.sandbox-infakt.pl/v3/documents/costs/paid_many.json

Autoryzacja

ApiKey
opcjonalne
API key in header

Token
opcjonalne
API key in header

Treść żądania JSON required

uuids
opcjonalne
string
Identyfikatory uuid oddzielone przecinkami.
uuid
opcjonalne
string
format: uuid
allow_correction
opcjonalne
boolean
Potwierdza zmianę, gdy dotyczy zamkniętego okresu księgowego; w przeciwnym razie 422. Przyjmowane też jako parametr zapytania.
paid_on
opcjonalne
string
Domyślnie dzisiaj; z calculate_exchange_difference nie może być datą przyszłą.

format: date
calculate_exchange_difference
opcjonalne
boolean
Zaksięguj różnicę kursową kosztu w walucie obcej. Tylko z uuid; z uuids zwraca 422.

default: false
payment_currency
opcjonalne
string
Waluta płatności; wymagana z calculate_exchange_difference.
received_amount
opcjonalne
integer
Kwota faktycznie zapłacona, w groszach; wymagana (większa od 0), gdy payment_currency to PLN.

format: int64

Example requests

{
  "uuids": "2f6e8a1c-3b4d-4e5f-9a6b-7c8d9e0f1a2b",
  "paid_on": "2026-10-10"
}

{
  "uuid": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
  "paid_on": "2026-10-10",
  "calculate_exchange_difference": true,
  "payment_currency": "PLN",
  "received_amount": 43150
}

{
  "uuids": "2f6e8a1c-3b4d-4e5f-9a6b-7c8d9e0f1a2b,5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
  "calculate_exchange_difference": true,
  "payment_currency": "PLN",
  "received_amount": 43150
}

{
  "uuid": "2f6e8a1c-3b4d-4e5f-9a6b-7c8d9e0f1a2b"
}

Odpowiedzi

200

Sukces

JSON

success
boolean
wymagane
true, gdy operacja powiodła się dla wszystkich dokumentów.
entities
array of
object
wymagane
- uuid
  string
  wymagane
  Uuid dokumentu; dla nieznalezionego uuid wartość taka, jak wysłano.
- number
  string
  wymagane
  "" dla nieznalezionego uuid.
- status
  success
  or
  failure
  wymagane
}

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 PUT \ --url https://api.sandbox-infakt.pl/v3/documents/costs/paid_many.json \ --header 'Content-Type: application/json' \ --header 'X-inFakt-ApiKey: <X-inFakt-ApiKey>' \ --data ' { "uuids": "2f6e8a1c-3b4d-4e5f-9a6b-7c8d9e0f1a2b", "paid_on": "2026-10-10" } '