Wyślij faktury do KSeF

Zakres: api:invoices:write. Kolejkuje faktury do wysyłki do KSeF. Zwraca 207, gdy co najmniej jedna faktura została odrzucona (status: rejected, request_uuid: null), i 404, gdy żaden z uuid nie jest fakturą konta.

POST

https://api.sandbox-infakt.pl/v3/ksef2/documents/send.json

Autoryzacja

ApiKey
opcjonalne
API key in header

Token
opcjonalne
API key in header

Query parameters

allow_correction
opcjonalne
boolean
Potwierdź akcję, która skoryguje złożone deklaracje (zamknięty okres księgowy). Bez tego takie żądania zwracają 422 z errors.allow_correction albo errors.locked_accounting, gdy plan nie pozwala na korekty (wtedy ta flaga jest ignorowana). Można też podać w treści żądania.

Treść żądania JSON required

uuids
wymagane
Identyfikatory uuid faktur oddzielone przecinkami albo tablica.
One of the following:
string
array<unknown>
}

Example requests

{
  "uuids": [
    "9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f"
  ]
}

{
  "uuids": "9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f,00000000-0000-0000-0000-000000000000"
}

{
  "uuids": "00000000-0000-0000-0000-000000000000"
}

Odpowiedzi

200

Sukces

JSON

entities
array of
object
wymagane
- request_uuid
  wymagane
  null dla faktur odrzuconych przed wysyłką.
  
  One of the following:
  string
  null
- invoice_uuid
  wymagane
  One of the following:
  Uuid
  null
- invoice_kind
  wymagane
  One of the following:
  InvoiceKind
  null
- ksef_number
  wymagane
  Numer KSeF nadany po przyjęciu.
  
  One of the following:
  string
  null
- status
  pending
  or
  sent
  or
  success
  or
  error
  or
  cancelled
  or
  rejected
  wymagane
  rejected tylko w odpowiedziach zbiorczych, dla dokumentów, których w ogóle nie wysłano.
- status_description
  wymagane
  One of the following:
  string
  null
- timestamps
  object
  wymagane
  request_created_at
  string
  wymagane
  request_finished_at
  wymagane
  One of the following:
  string
  null
}

207

Część faktur została odrzucona; szczegóły w entities.

JSON

entities
array of
object
wymagane
- request_uuid
  wymagane
  null dla faktur odrzuconych przed wysyłką.
  
  One of the following:
  string
  null
- invoice_uuid
  wymagane
  One of the following:
  Uuid
  null
- invoice_kind
  wymagane
  One of the following:
  InvoiceKind
  null
- ksef_number
  wymagane
  Numer KSeF nadany po przyjęciu.
  
  One of the following:
  string
  null
- status
  pending
  or
  sent
  or
  success
  or
  error
  or
  cancelled
  or
  rejected
  wymagane
  rejected tylko w odpowiedziach zbiorczych, dla dokumentów, których w ogóle nie wysłano.
- status_description
  wymagane
  One of the following:
  string
  null
- timestamps
  object
  wymagane
  request_created_at
  string
  wymagane
  request_finished_at
  wymagane
  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

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

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/ksef2/documents/send.json \ --header 'Content-Type: application/json' \ --header 'X-inFakt-ApiKey: <X-inFakt-ApiKey>' \ --data ' { "uuids": [ "9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f" ] } '

{ "entities": [ { "request_uuid": "7d6c5b4a-3e2f-4a1b-9c8d-0e1f2a3b4c5d", "invoice_uuid": "9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f", "invoice_kind": "vat", "ksef_number": null, "status": "pending", "status_description": "Faktura oczekuje na wysłanie do KSeF.", "timestamps": { "request_created_at": "2026-10-02 12:00:00 +0200", "request_finished_at": "2026-10-02 12:00:00 +0200" } } ] }

{ "entities": [ { "request_uuid": "7d6c5b4a-3e2f-4a1b-9c8d-0e1f2a3b4c5d", "invoice_uuid": "9bdc76fd-7a02-42ec-a4a3-42bc867b9a9f", "invoice_kind": "vat", "ksef_number": null, "status": "pending", "status_description": "Faktura oczekuje na wysłanie do KSeF.", "timestamps": { "request_created_at": "2026-10-02 12:00:00 +0200", "request_finished_at": "2026-10-02 12:00:00 +0200" } }, { "request_uuid": null, "invoice_uuid": "00000000-0000-0000-0000-000000000000", "invoice_kind": null, "ksef_number": null, "status": "rejected", "status_description": "Faktura nie może zostać wysłana do KSeF.", "timestamps": { "request_created_at": "2026-10-02 12:00:00 +0200", "request_finished_at": null } } ] }