Utwórz fakturę wewnętrzną

Zakres: api:invoices:write. Zwraca 403, gdy faktury wewnętrzne nie są dostępne dla konta.

POST

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

Autoryzacja

ApiKey
opcjonalne
API key in header

Token
opcjonalne
API key in header

Treść żądania JSON required

internal_invoice
object
wymagane
- transaction_kind_symbol
  string
  wymagane
  Zobacz GET /transaction_kinds.json.
- services
  array of
  object
  wymagane
  tax_symbol
  string
  wymagane
  name
  opcjonalne
  string
  Ignorowane; zapisywane jako BRAK.
  
  net_price
  opcjonalne
  integer
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
  vat_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
- number
  opcjonalne
  string
- invoice_date
  opcjonalne
  string
  Domyślnie dzisiaj.
  
  format: date
- notes
  opcjonalne
  string
}

Example request

{
  "internal_invoice": {
    "transaction_kind_symbol": "free_transfer_of_goods",
    "invoice_date": "2026-10-01",
    "notes": "Nieodpłatne przekazanie towaru",
    "services": [
      {
        "tax_symbol": "23",
        "net_price": 10000
      }
    ]
  }
}

Odpowiedzi

201

Utworzono

JSON

id
integer
wymagane
format: int64
uuid
string
wymagane
format: uuid
number
string
wymagane
kind
vat
or
proforma
or
margin
or
advance
or
correction
or
margin_correction
+5 more
wymagane
transaction_kind_symbol
string
wymagane
Zobacz GET /transaction_kinds.json.
invoice_date
string
wymagane
format: date
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
status
draft
or
sent
or
printed
or
unpaid
or
paid
or
scheduled
wymagane
notes
wymagane
One of the following:
string
null
}
services
array of
object
wymagane
- name
  string
  wymagane
  Zawsze BRAK.
- tax_symbol
  string
  wymagane
- net_price
  integer
  wymagane
  Kwota w groszach (1/100 PLN). 12300 oznacza 123,00 PLN.
  
  format: int64
- vat_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
}
ksef_data
wymagane
One of the following:
InvoiceKsefData
request_uuid
wymagane
null dla faktur odrzuconych przed wysyłką.

One of the following:
string
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
null
}
third_party_addresses
array of
object
wymagane
- id
  integer
  wymagane
  format: int64
- company_name
  wymagane
  One of the following:
  string
  null
- tax_id
  wymagane
  One of the following:
  string
  null
- street
  wymagane
  One of the following:
  string
  null
- building_number
  wymagane
  One of the following:
  string
  null
- door_number
  wymagane
  One of the following:
  string
  null
- post_code
  wymagane
  One of the following:
  string
  null
- city
  wymagane
  One of the following:
  string
  null
- country_code
  wymagane
  One of the following:
  CountryCode
  null
- role_code
  wymagane
  Kod roli podmiotu trzeciego w KSeF; zobacz ThirdPartyAddressInput.role_code.
  
  One of the following:
  string
  null
- internal_identifier
  wymagane
  One of the following:
  string
  null
}
related_exchange_differences_internal_evidences
array of
object
wymagane
- id
  integer
  wymagane
  format: int64
- number
  string
  wymagane
- uuid
  string
  wymagane
  format: uuid
}
parent_invoice_data
opcjonalne
null
Tylko w odpowiedzi get; zawsze 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_invoices.json \ --header 'Content-Type: application/json' \ --header 'X-inFakt-ApiKey: <X-inFakt-ApiKey>' \ --data ' { "internal_invoice": { "transaction_kind_symbol": "free_transfer_of_goods", "invoice_date": "2026-10-01", "notes": "Nieodpłatne przekazanie towaru", "services": [ { "tax_symbol": "23", "net_price": 10000 } ] } } '

{ "id": 3001, "uuid": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d", "number": "1/FW/10/2026", "kind": "internal", "transaction_kind_symbol": "free_transfer_of_goods", "invoice_date": "2026-10-01", "net_price": 0, "tax_price": 0, "gross_price": 12300, "status": "draft", "notes": "Nieodpłatne przekazanie towaru", "services": [ { "name": "BRAK", "tax_symbol": "23", "net_price": 10000, "vat_price": 2300, "gross_price": 12300 } ], "ksef_data": null, "third_party_addresses": [], "related_exchange_differences_internal_evidences": [] }