Dokumentacja obiektów GraphQL Symfonia KSeF API

W związku z wprowadzeniem przez Ministerstwo Finansów Krajowego Systemu e-Faktur (KSeF), umożliwiającego m.in. wystawianie i udostępnianie faktur ustrukturyzowanych w formacie xml, firma Symfonia Sp. Z o.o. udostępnia podmiotom zewnętrznym API pozwalające na komunikację z Ministerstwem Finansów. Cała komunikacja z systemem, od wysyłki wsadowej do operacji interaktywnych opiera się o kontekst podatnika. Poniższa dokumentacja zawiera poszczególne elementy struktury API wraz z wyjaśnieniem ich znaczenia.

API Endpoints
# Staging:
https://app.demo.symfonia.pl/graphql2
# Produkcja:
https://app.symfonia.pl/graphql2
Headers
# Klucz API wygenerowany w aplikacji z uprawnieniami nadanymi dla danej firmy
Symfonia-Api-Key: <KLUCZ_API>
# Email użytkownika używany do weryfikacji uprawnień i wykonania operacji
Symfonia-Api-Email: <EMAIL_UŻYTKOWNIKA>
# Kontekst zapytania. Wartość należy ustalić oparciu o query MyEnvironments
environmentId: COMPANY_ID lub TENANT_ID
Version

2

Wersjonowanie API

Nowa wersja obiektu przyjmowanego, bądź zwracanego, może zostać dodana w przypadku konieczności obsługi dodatkowych pól obowiązkowych. Dodanie nowych pól nieobowiązkowych może nie powodować konieczności powstania nowej wersji obiektu. Jedna wersja mutacji lub query może obsługiwać więcej niż jedną wersję schemy KSeF Ministerstwa Finansów, jeśli przekazywane dane pozwolą na prawidłowe przetworzenie żądania.

Kontakt z API Support

Prosimy o posłużenie się formularzem na stronie https://ebok.symfonia.pl/Home/Login

Graph QL dokumentacja

API stosuje język zapytań GraphQL. Szczegółowa dokumentacja znajduje się pod adresem GraphQL.org

Przykłady w formacie kolekcji PostMan dostępne są do pobrania pod linkiem: Kolekcja przykładów PostMan

Środowiska KSeF

Firma wewnątrz organizacji może zostać oznaczona jako DEMO. To oznaczenie wpływa na rodzaj połączenia Symfonia KSeF z KSeF Ministerstwa finansów.

Dla środowiska Staging znaczenie jest następujące:

DEMO - nawiązuje połączenie do ksef-test.mf.gov.pl

PROD - nawiązuje połączenie do ksef-demo.mf.gov.pl

Dla środowiska Produkcyjnego znaczenie jest następujące:

DEMO - nawiązuje połączenie do ksef-demo.mf.gov.pl

PROD - nawiązuje połączenie do ksef.mf.gov.pl

Kontekst pracy

API wymaga podania kontekstu pracy w nagłówku każdego żądania. Kontekst organizacji pozwala na operacje na poziomie organizacji, np. listowanie firm wewnątrz organizacji, sprawdzanie statystyk organizacji. Kontekst firmy pozwala wykonywać operacje w kontekście firmy np. listowanie faktur, dodawanie faktur, wysyłka faktur.

Wartość EnvironmentId należy uzyskać z query MyEnvironments.

Przykład wywołania query MyEnvironments

query MyEnvironments {
              MyEnvironments {
                Environments {
                  ...EnvironmentViewModelFragment
                }
              }
            }

            fragment EnvironmentViewModelFragment on EnvironmentViewModel{
              EnvironmentId
              Type
              Status 
              Company {
                TenantId
                Identifier
                IdentifierType 
                IsDemo
                }
            }
            

Przykład odpowiedzi:

{
  "data": {
    "MyEnvironments": {
      "Environments": [
        {
          "EnvironmentId": "cb8bb1ff-a47e-476c-bb11-9f89e9901c2d",
          "Type": "COMPANY",
          "Status": "ACTIVE",
          "Company": {
            "TenantId": "a3d1070d-f5d6-4cf7-a401-4e168755e17e",
            "Identifier": "1111111111",
            "IdentifierType": "NIP",
            "IsDemo": true
          }
        },
        {
          "EnvironmentId": "a3d1070d-f5d6-4cf7-a401-4e168755e17e",
          "Type": "TENANT",
          "Status": "ACTIVE",
          "Company": null
        }
      ]
    }
  }
}

Queries

CompanyStatistics

Description

Zwraca statystyki faktur we wszystkich firmach w organizacji.

EnvironmentId: COMPANY

Response

Returns a GetCompanyStatisticsResponse!

Arguments
Name Description
SearchText - String Szukany tekst
take - Long Liczba rekordów do pobrania
skip - Long Liczba rekordów od początku, która ma zostać pominięta
TenantIdFilter - UUID ID organizacji
order - ItemsOrderInput Kolejność

Example

Query
query CompanyStatistics(
  $SearchText: String,
  $take: Long,
  $skip: Long,
  $TenantIdFilter: UUID,
  $order: ItemsOrderInput
) {
  CompanyStatistics(
    SearchText: $SearchText,
    take: $take,
    skip: $skip,
    TenantIdFilter: $TenantIdFilter,
    order: $order
  ) {
    TenantAssignments {
      ...TenantAssignmentViewModelFragment
    }
    TotalTenantsCount
    TotalCompanysCount
  }
}
Variables
{
  "SearchText": "abc123",
  "take": {},
  "skip": {},
  "TenantIdFilter": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "order": ItemsOrderInput
}
Response
{
  "data": {
    "CompanyStatistics": {
      "TenantAssignments": [TenantAssignmentViewModel],
      "TotalTenantsCount": {},
      "TotalCompanysCount": {}
    }
  }
}

GetCurrentSchemaVersion

Description

Zwraca listę aktualnych wersji schematu faktury Symfonia KSeF.

EnvironmentId: COMPANY

Example

Query
query GetCurrentSchemaVersion {
  GetCurrentSchemaVersion {
    SchemaVersion
  }
}
Response
{"data": {"GetCurrentSchemaVersion": {"SchemaVersion": ["V12648"]}}}

GetEArchiveNotifications

Description

Zwraca listę włączonych notyfikacji e-mailowych dla użytkownika.

EnvironmentId: COMPANY

Example

Query
query GetEArchiveNotifications {
  GetEArchiveNotifications {
    Notifications
  }
}
Response
{"data": {"GetEArchiveNotifications": {"Notifications": ["NONE"]}}}

GetInvoiceFileContentActionGroup

Description

Zwraca zbiorczy dokument ZIP z fakturami PDF, zgodnymi ze schematem obowiązującym w KSeF Ministerstwa Finansów.

EnvironmentId: COMPANY

Arguments
Name Description
InvoiceIds - [UUID!]! Kolekcja identyfikatorów faktur
Token - String JWT Token (wartość opcjonalna)

Example

Query
query GetInvoiceFileContentActionGroup(
  $InvoiceIds: [UUID!]!,
  $Token: String
) {
  GetInvoiceFileContentActionGroup(
    InvoiceIds: $InvoiceIds,
    Token: $Token
  ) {
    ZipName
    ZipContent
    MimeType
  }
}
Variables
{
  "InvoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "Token": "xyz789"
}
Response
{
  "data": {
    "GetInvoiceFileContentActionGroup": {
      "ZipName": "abc123",
      "ZipContent": "abc123",
      "MimeType": "abc123"
    }
  }
}

GetInvoiceFileContentSingle

Description

Zwraca dokument PDF faktury zgodny ze schematem obowiązującym w KSeF Ministerstwa Finansów.

EnvironmentId: COMPANY

Arguments
Name Description
InvoiceId - UUID! Id faktury
Token - String JWT Token (wartość opcjonalna)

Example

Query
query GetInvoiceFileContentSingle(
  $InvoiceId: UUID!,
  $Token: String
) {
  GetInvoiceFileContentSingle(
    InvoiceId: $InvoiceId,
    Token: $Token
  ) {
    PdfName
    PdfContent
    HtmlContent
    MimeType
  }
}
Variables
{
  "InvoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Token": "abc123"
}
Response
{
  "data": {
    "GetInvoiceFileContentSingle": {
      "PdfName": "xyz789",
      "PdfContent": "abc123",
      "HtmlContent": "xyz789",
      "MimeType": "abc123"
    }
  }
}

GetInvoices

Description

Pobiera listę faktur z Symfonia KSeF wg zadanych filtrów.

EnvironmentId: COMPANY

Response

Returns a GetInvoicesSegment!

Arguments
Name Description
FiltersFields - FiltersFieldsInput! Filtry
SearchText - String Szukany tekst
take - Long! Liczba rekordów do pobrania
skip - Long! Liczba rekordów od początku, która ma zostać pominięta
order - ItemsOrderInput Kolejność

Example

Query
query GetInvoices(
  $FiltersFields: FiltersFieldsInput!,
  $SearchText: String,
  $take: Long!,
  $skip: Long!,
  $order: ItemsOrderInput
) {
  GetInvoices(
    FiltersFields: $FiltersFields,
    SearchText: $SearchText,
    take: $take,
    skip: $skip,
    order: $order
  ) {
    Items {
      ...InvoiceDtoFragment
    }
    TotalCount
    FilteredCount
  }
}
Variables
{
  "FiltersFields": FiltersFieldsInput,
  "SearchText": "abc123",
  "take": {},
  "skip": {},
  "order": ItemsOrderInput
}
Response
{
  "data": {
    "GetInvoices": {
      "Items": [InvoiceDto],
      "TotalCount": {},
      "FilteredCount": {}
    }
  }
}

GetInvoicesExtended

Description

Pobiera listę faktur z Symfonia KSeF wg zadanych filtrów

EnvironmentId: COMPANY

Response

Returns a GetInvoicesExtendedSegment!

Arguments
Name Description
FiltersFields - ExtendedFiltersFieldsInput! Filtry
take - Long! Liczba rekordów do pobrania
skip - Long! Liczba rekordów od początku, która ma zostać pominięta
order - ItemsOrderInput Kolejność

Example

Query
query GetInvoicesExtended(
  $FiltersFields: ExtendedFiltersFieldsInput!,
  $take: Long!,
  $skip: Long!,
  $order: ItemsOrderInput
) {
  GetInvoicesExtended(
    FiltersFields: $FiltersFields,
    take: $take,
    skip: $skip,
    order: $order
  ) {
    Items {
      ...InvoiceDtoFragment
    }
    TotalCount
    FilteredCount
  }
}
Variables
{
  "FiltersFields": ExtendedFiltersFieldsInput,
  "take": {},
  "skip": {},
  "order": ItemsOrderInput
}
Response
{
  "data": {
    "GetInvoicesExtended": {
      "Items": [InvoiceDto],
      "TotalCount": {},
      "FilteredCount": {}
    }
  }
}

GetKSeFInvoiceDTO

Dotyczy nieobowiązującej wersji schemy FA(1)
Description

Zwraca obiekt faktury w wersji domenowej Symfonii.

EnvironmentId: COMPANY

Response

Returns a Faktura!

Arguments
Name Description
InvoiceId - UUID! Id faktury

Example

Query
query GetKSeFInvoiceDTO($InvoiceId: UUID!) {
  GetKSeFInvoiceDTO(InvoiceId: $InvoiceId) {
    WersjaDTO
    Sprzedawca {
      ...PodmiotFragment
    }
    Nabywca {
      ...PodmiotFragment
    }
    TrzeciPodmiot {
      ...TrzeciPodmiotFragment
    }
    PodmiotUpowazniony {
      ...PodmiotUpowaznionyFragment
    }
    Naglowek {
      ...NaglowekFragment
    }
    Adnotacje {
      ...AdnotacjeFragment
    }
    Korekta {
      ...KorektaFragment
    }
    PodsumowanieVat {
      ...PodsumowanieVatFragment
    }
    Wiersze {
      ...WierszFragment
    }
    Rozliczenie {
      ...RozliczenieFragment
    }
    Platnosc {
      ...PlatnoscFragment
    }
    WarunkiTransakcji {
      ...WarunkiTransakcjiFragment
    }
    Zamowienie {
      ...ZamowienieFragment
    }
    Stopka {
      ...StopkaFragment
    }
  }
}
Variables
{
  "InvoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}
Response
{
  "data": {
    "GetKSeFInvoiceDTO": {
      "WersjaDTO": "abc123",
      "Sprzedawca": Podmiot,
      "Nabywca": Podmiot,
      "TrzeciPodmiot": [TrzeciPodmiot],
      "PodmiotUpowazniony": PodmiotUpowazniony,
      "Naglowek": Naglowek,
      "Adnotacje": Adnotacje,
      "Korekta": Korekta,
      "PodsumowanieVat": [PodsumowanieVat],
      "Wiersze": [Wiersz],
      "Rozliczenie": Rozliczenie,
      "Platnosc": Platnosc,
      "WarunkiTransakcji": WarunkiTransakcji,
      "Zamowienie": Zamowienie,
      "Stopka": Stopka
    }
  }
}

GetKSeFInvoiceDTOV2

Description

Zwraca obiekt faktury V2 w wersji domenowej Symfonii.

EnvironmentId: COMPANY

Response

Returns a FakturaV2!

Arguments
Name Description
InvoiceId - UUID! Id faktury

Example

Query
query GetKSeFInvoiceDTOV2($InvoiceId: UUID!) {
  GetKSeFInvoiceDTOV2(InvoiceId: $InvoiceId) {
    WersjaDTO
    Sprzedawca {
      ...PodmiotV2Fragment
    }
    Nabywca {
      ...PodmiotV2Fragment
    }
    TrzeciPodmiot {
      ...TrzeciPodmiotV2Fragment
    }
    PodmiotUpowazniony {
      ...PodmiotUpowaznionyV2Fragment
    }
    Naglowek {
      ...NaglowekV2Fragment
    }
    Adnotacje {
      ...AdnotacjeV2Fragment
    }
    Korekta {
      ...KorektaV2Fragment
    }
    PodsumowanieVat {
      ...PodsumowanieVatFragment
    }
    Wiersze {
      ...WierszV2Fragment
    }
    Rozliczenie {
      ...RozliczenieFragment
    }
    Platnosc {
      ...PlatnoscV2Fragment
    }
    WarunkiTransakcji {
      ...WarunkiTransakcjiV2Fragment
    }
    Zamowienie {
      ...ZamowienieV2Fragment
    }
    Stopka {
      ...StopkaV2Fragment
    }
  }
}
Variables
{
  "InvoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}
Response
{
  "data": {
    "GetKSeFInvoiceDTOV2": {
      "WersjaDTO": "xyz789",
      "Sprzedawca": PodmiotV2,
      "Nabywca": PodmiotV2,
      "TrzeciPodmiot": [TrzeciPodmiotV2],
      "PodmiotUpowazniony": PodmiotUpowaznionyV2,
      "Naglowek": NaglowekV2,
      "Adnotacje": AdnotacjeV2,
      "Korekta": KorektaV2,
      "PodsumowanieVat": [PodsumowanieVat],
      "Wiersze": [WierszV2],
      "Rozliczenie": Rozliczenie,
      "Platnosc": PlatnoscV2,
      "WarunkiTransakcji": WarunkiTransakcjiV2,
      "Zamowienie": ZamowienieV2,
      "Stopka": StopkaV2
    }
  }
}

GetKSeFInvoiceXML

Description

Zwraca dokument XML faktury zgodny ze schematem obowiązującym w KSeF Ministerstwa Finansów.

EnvironmentId: COMPANY

Response

Returns an KSeFInvoiceXMLType!

Arguments
Name Description
InvoiceId - UUID! Id faktury

Example

Query
query GetKSeFInvoiceXML($InvoiceId: UUID!) {
  GetKSeFInvoiceXML(InvoiceId: $InvoiceId) {
    Content
    FileName
  }
}
Variables
{
  "InvoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}
Response
{
  "data": {
    "GetKSeFInvoiceXML": {
      "Content": "xyz789",
      "FileName": "abc123"
    }
  }
}

GetListInvoices

Description

Pobiera listę faktur wg kryteriów zadanych w filtrze.

EnvironmentId: COMPANY

Response

Returns a ListInvoicesResponseType!

Arguments
Name Description
FiltersFields - FilterFieldsInput! Filtry

Example

Query
query GetListInvoices($FiltersFields: FilterFieldsInput!) {
  GetListInvoices(FiltersFields: $FiltersFields) {
    Items {
      ...InvoiceFragment
    }
  }
}
Variables
{"FiltersFields": FilterFieldsInput}
Response
{"data": {"GetListInvoices": {"Items": [Invoice]}}}

GetMissedWebsocketSubscriptions

Description

Uruchamia ponowne wysłanie nieprzeczytanych notyfikacji websocket-owych.

EnvironmentId: COMPANY

Example

Query
query GetMissedWebsocketSubscriptions {
  GetMissedWebsocketSubscriptions {
    Success
  }
}
Response
{"data": {"GetMissedWebsocketSubscriptions": {"Success": true}}}

GetPackageStatistic

Description

Zwraca informacje o wykorzystaniu pakietu dla organizacji.

EnvironmentId: COMPANY / TENANT / ADMIN

Response

Returns a GetPackageStatisticSegment!

Arguments
Name Description
TenantId - UUID! Id organizacji

Example

Query
query GetPackageStatistic($TenantId: UUID!) {
  GetPackageStatistic(TenantId: $TenantId) {
    Items {
      ...PackageFragment
    }
    Status
    CurrentInvoicesCount
    CurrentStorageCount
    SerialNumber
    SubscriptionNumber
    CustomerNumber
    Email
    DateTo
  }
}
Variables
{
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}
Response
{
  "data": {
    "GetPackageStatistic": {
      "Items": [Package],
      "Status": "INACTIVE",
      "CurrentInvoicesCount": 987,
      "CurrentStorageCount": Decimal,
      "SerialNumber": "xyz789",
      "SubscriptionNumber": "xyz789",
      "CustomerNumber": "abc123",
      "Email": "xyz789",
      "DateTo": "2007-12-03"
    }
  }
}

GetPermissionsKSeF

Description

Zwraca informacje o uprawnieniach bieżącego użytkownika w KSeF Ministerstwa Finansów. Jeżeli połączenie z KSeF Ministerstwa Finansów zakończy się niepowodzeniem, zwracane są ostatnie zapisane w systemie uprawnienia dla tego użytkownika, a flaga FromKSeF przyjmuje wartość false.

EnvironmentId: COMPANY

Response

Returns an GetPermissionsKSeFResponseType!

Arguments
Name Description
SearchText - String Szukany tekst
take - Long Liczba rekordów do pobrania
skip - Long Liczba rekordów od początku, która ma zostać pominięta
order - ItemsOrderInput Kolejność
CredentialFiltersFields - CredentialFiltersFieldsInput Filtr uprawnień
fromKSeF - Boolean Określa czy dane mają być pobrane z KSeF Ministerstwa Finansów, czy z cache

Example

Query
query GetPermissionsKSeF(
  $SearchText: String,
  $take: Long,
  $skip: Long,
  $order: ItemsOrderInput,
  $CredentialFiltersFields: CredentialFiltersFieldsInput,
  $fromKSeF: Boolean
) {
  GetPermissionsKSeF(
    SearchText: $SearchText,
    take: $take,
    skip: $skip,
    order: $order,
    CredentialFiltersFields: $CredentialFiltersFields,
    fromKSeF: $fromKSeF
  ) {
    FromKsef
    LastUpdated
    Credentials {
      ...CredentialFragment
    }
    TotalCount
    FilteredCount
  }
}
Variables
{
  "SearchText": "abc123",
  "take": {},
  "skip": {},
  "order": ItemsOrderInput,
  "CredentialFiltersFields": CredentialFiltersFieldsInput,
  "fromKSeF": false
}
Response
{
  "data": {
    "GetPermissionsKSeF": {
      "FromKsef": true,
      "LastUpdated": "2007-12-03T10:15:30Z",
      "Credentials": [Credential],
      "TotalCount": {},
      "FilteredCount": {}
    }
  }
}

GetUPO

Description

Pobiera Urzędowe Potwierdzenie Odbioru dla podanej listy faktur w formacie PDF lub XML. Pobieranie może nastąpić tylko wtedy, kiedy sesja z KSeF Ministerstwa Finansów jest zamknięta, podczas otwartej sesji nie można pobrać UPO.

EnvironmentId: COMPANY

Response

Returns an UPOType!

Arguments
Name Description
InvoiceIds - [UUID!]! Lista Id faktur
UpoFileType - UpoFileType! Format pliku

Example

Query
query GetUPO(
  $InvoiceIds: [UUID!]!,
  $UpoFileType: UpoFileType!
) {
  GetUPO(
    InvoiceIds: $InvoiceIds,
    UpoFileType: $UpoFileType
  ) {
    FileName
    FileContent
    MimeType
    MissingInvoices {
      ...MissedInvoiceFragment
    }
    RequestedInvoices
    ReturnedInvoices
  }
}
Variables
{
  "InvoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "UpoFileType": "PDF"
}
Response
{
  "data": {
    "GetUPO": {
      "FileName": "abc123",
      "FileContent": "abc123",
      "MimeType": "xyz789",
      "MissingInvoices": [MissedInvoice],
      "RequestedInvoices": [
        "ce164f8f-a876-437c-a391-7fbb0e829ec4"
      ],
      "ReturnedInvoices": [
        "ce164f8f-a876-437c-a391-7fbb0e829ec4"
      ]
    }
  }
}

GetUserKSeFRequestForCredentials

Description

Zwraca informacje o procesowaniu uprawnień bieżącego użytkownika w KSeF Ministerstwa Finansów.

EnvironmentId: COMPANY

Arguments
Name Description
SearchText - String Szukany tekst
take - Long Liczba rekordów do pobrania
skip - Long Liczba rekordów od początku, która ma zostać pominięta
order - ItemsOrderInput Kolejność
CredentialFiltersFields - RequestedCredentialFiltersFieldsInput Filtr uprawnień

Example

Query
query GetUserKSeFRequestForCredentials(
  $SearchText: String,
  $take: Long,
  $skip: Long,
  $order: ItemsOrderInput,
  $CredentialFiltersFields: RequestedCredentialFiltersFieldsInput
) {
  GetUserKSeFRequestForCredentials(
    SearchText: $SearchText,
    take: $take,
    skip: $skip,
    order: $order,
    CredentialFiltersFields: $CredentialFiltersFields
  ) {
    RequestedCredentials {
      ...RequestedCredentialFragment
    }
    TotalCount
    FilteredCount
  }
}
Variables
{
  "SearchText": "xyz789",
  "take": {},
  "skip": {},
  "order": ItemsOrderInput,
  "CredentialFiltersFields": RequestedCredentialFiltersFieldsInput
}
Response
{
  "data": {
    "GetUserKSeFRequestForCredentials": {
      "RequestedCredentials": [RequestedCredential],
      "TotalCount": {},
      "FilteredCount": {}
    }
  }
}

GetWebsocketNotificationModel

Description

Zwraca wynik operacji dla konkretnej notyfikacji WebSocket-owej. Wymaga podania ID notyfikacji.

EnvironmentId: COMPANY

Arguments
Name Description
notificationId - UUID! Id notyfikacji

Example

Query
query GetWebsocketNotificationModel($notificationId: UUID!) {
  GetWebsocketNotificationModel(notificationId: $notificationId) {
    UserId
    CompanyId
    ErrorType
    ErrorContent {
      ...KeyValuePairOfStringAndStringFragment
    }
    Message
    Type
    NotificationId
    Timestamp
    Visited
    HasDownloadableContent
    ResponseJson
    State
    SimultaneousRunType
  }
}
Variables
{
  "notificationId": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}
Response
{
  "data": {
    "GetWebsocketNotificationModel": {
      "UserId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
      "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
      "ErrorType": "SYSTEM",
      "ErrorContent": [KeyValuePairOfStringAndString],
      "Message": "abc123",
      "Type": "AUTHORIZE_IN_KSEF",
      "NotificationId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
      "Timestamp": "2007-12-03T10:15:30Z",
      "Visited": true,
      "HasDownloadableContent": false,
      "ResponseJson": "xyz789",
      "State": "ENQUEUED",
      "SimultaneousRunType": "SEQUENTIAL"
    }
  }
}

GetWebsocketNotificationModelExtended

Description

Zwraca wynik operacji dla konkretnej notyfikacji WebSocket-owej. Wymaga podania ID notyfikacji.

EnvironmentId: COMPANY

Arguments
Name Description
notificationId - UUID! Id notyfikacji

Example

Query
query GetWebsocketNotificationModelExtended($notificationId: UUID!) {
  GetWebsocketNotificationModelExtended(notificationId: $notificationId) {
    UserId
    CompanyId
    ErrorType
    ErrorContent {
      ...KeyValuePairOfStringAndStringFragment
    }
    Message
    Type
    NotificationId
    Timestamp
    Visited
    HasDownloadableContent
    ResponseJson
    ResponseModel {
      ...ResponseModelFragment
    }
    State
    SimultaneousRunType
  }
}
Variables
{
  "notificationId": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}
Response
{
  "data": {
    "GetWebsocketNotificationModelExtended": {
      "UserId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
      "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
      "ErrorType": "SYSTEM",
      "ErrorContent": [KeyValuePairOfStringAndString],
      "Message": "abc123",
      "Type": "AUTHORIZE_IN_KSEF",
      "NotificationId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
      "Timestamp": "2007-12-03T10:15:30Z",
      "Visited": false,
      "HasDownloadableContent": false,
      "ResponseJson": "abc123",
      "ResponseModel": ResponseModel,
      "State": "ENQUEUED",
      "SimultaneousRunType": "SEQUENTIAL"
    }
  }
}

GetWebsocketNotificationsList

Description

Zwraca listę notyfikacji WebSocket-owych o podanym statusie.

EnvironmentId: COMPANY

Arguments
Name Description
notificationStateType - WebsocketNotificationStateType! Status subskrypcji

Example

Query
query GetWebsocketNotificationsList($notificationStateType: WebsocketNotificationStateType!) {
  GetWebsocketNotificationsList(notificationStateType: $notificationStateType) {
    WebsocketNotification {
      ...WebsocketNotificationModelFragment
    }
  }
}
Variables
{"notificationStateType": "ALL"}
Response
{
  "data": {
    "GetWebsocketNotificationsList": {
      "WebsocketNotification": [
        WebsocketNotificationModel
      ]
    }
  }
}

KSeFSessionInfo

Description

Zwraca informację o aktualnym stanie sesji w KSeF.

EnvironmentId: COMPANY

Response

Returns an KSeFSessionStatusResponseType!

Example

Query
query KSeFSessionInfo {
  KSeFSessionInfo {
    Active
    ExpirationTime
  }
}
Response
{
  "data": {
    "KSeFSessionInfo": {
      "Active": false,
      "ExpirationTime": "2007-12-03T10:15:30Z"
    }
  }
}

MyEnvironments

Description

Pobiera listę wszystkich dostępnych środowisk dla bieżącego użytkownika.

EnvironmentId: NONE - nagłówek EnvironmentId nie jest wymagany

Example

Query
query MyEnvironments {
  MyEnvironments {
    Environments {
      ...EnvironmentViewModelFragment
    }
  }
}
Response
{
  "data": {
    "MyEnvironments": {
      "Environments": [EnvironmentViewModel]
    }
  }
}

SubscribeDownloadInvoicesFromKSeF

Description

Zlecenie pobrania faktur z KSeF poprzez subskrypcję WebSocket. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Arguments
Name Description
internalEnabled - Boolean! Pobieranie faktur sprzedażowych
internal - DateTimeRangeInput Daty wystawienia w KSeF dla faktur sprzedażowych
externalEnabled - Boolean! Pobieranie faktur zakupowych
external - DateTimeRangeInput Daty wystawienia w KSeF dla faktur zakupowych

Example

Query
query SubscribeDownloadInvoicesFromKSeF(
  $internalEnabled: Boolean!,
  $internal: DateTimeRangeInput,
  $externalEnabled: Boolean!,
  $external: DateTimeRangeInput
) {
  SubscribeDownloadInvoicesFromKSeF(
    internalEnabled: $internalEnabled,
    internal: $internal,
    externalEnabled: $externalEnabled,
    external: $external
  ) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{
  "internalEnabled": true,
  "internal": DateTimeRangeInput,
  "externalEnabled": false,
  "external": DateTimeRangeInput
}
Response
{
  "data": {
    "SubscribeDownloadInvoicesFromKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

SubscribeGetUpo

Description

Zlecenie pobrania UPO z KSeF. Pobiera Urzędowe Potwierdzenie Odbioru dla podanej listy faktur w formacie PDF lub XML. Pobieranie może nastąpić tylko wtedy, kiedy sesja z KSeF jest zamknięta. Po zleceniu pobrania UPO system zaczeka na zakończenie działań w bieżącej sesji KSeF i pobierze UPO. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Response

Returns a SubscribeGetUpoResponse!

Arguments
Name Description
InvoiceIds - [UUID!]! Lista Id faktur
UpoFileType - UpoFileType! Format pliku

Example

Query
query SubscribeGetUpo(
  $InvoiceIds: [UUID!]!,
  $UpoFileType: UpoFileType!
) {
  SubscribeGetUpo(
    InvoiceIds: $InvoiceIds,
    UpoFileType: $UpoFileType
  ) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{
  "InvoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "UpoFileType": "PDF"
}
Response
{
  "data": {
    "SubscribeGetUpo": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

Mutations

AuthorizeInKSeF

Description

Uwierzytelnienie bieżącego użytkownika w KSeF Ministerstwa Finansów za pomocą podpisu w serwisie KSeF Ministerstwa Finansów. Akceptuje podpisane żądanie uzyskane z metody GenerateInitRequestToLogin. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Response

Returns a StandardWebsocketResponse!

Arguments
Name Description
InitSessionRequestSigned - String! Numer inicjalizacji sesji interaktywnej

Example

Query
mutation AuthorizeInKSeF($InitSessionRequestSigned: String!) {
  AuthorizeInKSeF(InitSessionRequestSigned: $InitSessionRequestSigned) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{"InitSessionRequestSigned": "xyz789"}
Response
{
  "data": {
    "AuthorizeInKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

AuthorizeInKSeFWithToken

Description

Uwierzytelnienie bieżącego użytkownika w KSeF Ministerstwa Finansów za pomocą tokena wygenerowanego w serwisie KSeF Ministerstwa Finansów. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Response

Returns an AuthorizeInKSeFWithTokenResponse!

Arguments
Name Description
Token - String! Token wygenerowany w KSeF

Example

Query
mutation AuthorizeInKSeFWithToken($Token: String!) {
  AuthorizeInKSeFWithToken(Token: $Token) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{"Token": "abc123"}
Response
{
  "data": {
    "AuthorizeInKSeFWithToken": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

DeleteInvoices

Description

Metoda służąca do usuwania faktur z Symfonia KSeF. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Response

Returns a DeleteInvoicesResponse!

Arguments
Name Description
invoiceIds - [UUID!]! Lista ID faktur

Example

Query
mutation DeleteInvoices($invoiceIds: [UUID!]!) {
  DeleteInvoices(invoiceIds: $invoiceIds) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{
  "invoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ]
}
Response
{
  "data": {
    "DeleteInvoices": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

GenerateInitRequestToLogin

Description

Metoda służąca do wygenerowania żądania InitSessionRequest.

EnvironmentId: NONE

Response

Returns a String!

Example

Query
mutation GenerateInitRequestToLogin {
  GenerateInitRequestToLogin
}
Response
{
  "data": {
    "GenerateInitRequestToLogin": "xyz789"
  }
}

KSeFAutoFetchingInvoices

Description

Inicjuje serwis automatycznego pobierania faktur z KSeF Ministerstwa Finansów w kontekście firmy. Serwis pracuje w nocy, jest uruchamiany raz dziennie.

EnvironmentId: COMPANY

Arguments
Name Description
Status - CompanyKsefServicesStatusEnum! Ustawienie statusu serwisu
InternalEnabled - Boolean! Pobieranie faktur sprzedażowych
ExternalEnabled - Boolean! Pobieranie faktur zakupowych
Type - KSeFAutomaticOperationType! Tryb działania serwisu (określona godzina lub interwał)
Minutes - Int! Wartość w minutach
DownloadLimitDate - DateTime Faktury wcześniejsze niż ustawiona data nie będą pobierane

Example

Query
mutation KSeFAutoFetchingInvoices(
  $Status: CompanyKsefServicesStatusEnum!,
  $InternalEnabled: Boolean!,
  $ExternalEnabled: Boolean!,
  $Type: KSeFAutomaticOperationType!,
  $Minutes: Int!,
  $DownloadLimitDate: DateTime
) {
  KSeFAutoFetchingInvoices(
    Status: $Status,
    InternalEnabled: $InternalEnabled,
    ExternalEnabled: $ExternalEnabled,
    Type: $Type,
    Minutes: $Minutes,
    DownloadLimitDate: $DownloadLimitDate
  ) {
    Success
  }
}
Variables
{
  "Status": "INACTIVE",
  "InternalEnabled": true,
  "ExternalEnabled": false,
  "Type": "TIME",
  "Minutes": 987,
  "DownloadLimitDate": "2007-12-03T10:15:30Z"
}
Response
{"data": {"KSeFAutoFetchingInvoices": {"Success": true}}}

KSeFAutoSendingInvoices

Description

Inicjuje serwis automatycznego wysyłania faktur do KSeF Ministerstwa Finansów w kontekście firmy.

EnvironmentId: COMPANY

Arguments
Name Description
Status - CompanyKsefServicesStatusEnum! Ustawienie statusu serwisu
type - KSeFAutomaticOperationType! Tryb działania serwisu (określona godzina lub interwał)
minutes - Int! Wartość w minutach

Example

Query
mutation KSeFAutoSendingInvoices(
  $Status: CompanyKsefServicesStatusEnum!,
  $type: KSeFAutomaticOperationType!,
  $minutes: Int!
) {
  KSeFAutoSendingInvoices(
    Status: $Status,
    type: $type,
    minutes: $minutes
  ) {
    Success
  }
}
Variables
{"Status": "INACTIVE", "type": "TIME", "minutes": 123}
Response
{"data": {"KSeFAutoSendingInvoices": {"Success": true}}}

MultipleSendToKSeF

Description

Zlecenie wysłania istniejących w Symfonia KSeF faktur do KSeF Ministerstwa Finansów. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Response

Returns an MultipleSendToKSeFResponseType!

Arguments
Name Description
InvoiceIds - [UUID!]! Id faktury

Example

Query
mutation MultipleSendToKSeF($InvoiceIds: [UUID!]!) {
  MultipleSendToKSeF(InvoiceIds: $InvoiceIds) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{
  "InvoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ]
}
Response
{
  "data": {
    "MultipleSendToKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

PublishInvoices

Description

Wysłanie wybranych faktur do Symfonia Finanse i Księgowość za pomocą szyny danych.

EnvironmentId: COMPANY

Response

Returns a PublishInvoicesResponse!

Arguments
Name Description
InvoiceIds - [UUID!]! List Id faktur

Example

Query
mutation PublishInvoices($InvoiceIds: [UUID!]!) {
  PublishInvoices(InvoiceIds: $InvoiceIds) {
    Sent
    Failed
  }
}
Variables
{
  "InvoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ]
}
Response
{"data": {"PublishInvoices": {"Sent": 987, "Failed": 987}}}

RemoveAuthorizationInKSeF

Description

Usuwa uwierzytelnienie w KSeF Ministerstwa Finansów uprzednio dokonane za pomocą sesji interaktywnej (Szafir). Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Response

Returns a StandardWebsocketResponse!

Arguments
Name Description
InitSessionRequestSigned - String! Numer inicjalizacji sesji interaktywnej

Example

Query
mutation RemoveAuthorizationInKSeF($InitSessionRequestSigned: String!) {
  RemoveAuthorizationInKSeF(InitSessionRequestSigned: $InitSessionRequestSigned) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{"InitSessionRequestSigned": "abc123"}
Response
{
  "data": {
    "RemoveAuthorizationInKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

RemoveAuthorizationWithExternalTokenInKSeF

Description

Usuwa uwierzytelnienie w KSeF Ministerstwa Finansów uprzednio dokonane za pomocą zewnętrznego tokena (AuthorizeInKSeFWithToken). Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Example

Query
mutation RemoveAuthorizationWithExternalTokenInKSeF {
  RemoveAuthorizationWithExternalTokenInKSeF {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Response
{
  "data": {
    "RemoveAuthorizationWithExternalTokenInKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

RemoveEArchiveNotifications

Description

Wyłączanie notyfikacji e-mail dla użytkownika w firmie.

EnvironmentId: COMPANY

Arguments
Name Description
EArchiveNotificationType - EArchiveNotificationType! Typ notyfikacji

Example

Query
mutation RemoveEArchiveNotifications($EArchiveNotificationType: EArchiveNotificationType!) {
  RemoveEArchiveNotifications(EArchiveNotificationType: $EArchiveNotificationType) {
    Success
  }
}
Variables
{"EArchiveNotificationType": "AUTHORIZATION_OF_COMPANY_SUCCEEDED"}
Response
{"data": {"RemoveEArchiveNotifications": {"Success": true}}}

SendToEArchive

Dotyczy nieobowiązującej wersji schemy FA(1). Należy używać mutacji SendToEArchiveV2
Description

Wysłanie faktury do systemu Symfonia KSeF oraz jeżeli parametr WyslijDoKsef ma wartość true, do KSeF Ministerstwa Finansów.

EnvironmentId: COMPANY

Response

Returns a SendToEArchiveResponseType!

Arguments
Name Description
Faktura - FakturaInput! Obiekt Faktura
WyslijDoKsef - Boolean! Zlecenie wysłania faktury do KSeF

Example

Query
mutation SendToEArchive(
  $Faktura: FakturaInput!,
  $WyslijDoKsef: Boolean!
) {
  SendToEArchive(
    Faktura: $Faktura,
    WyslijDoKsef: $WyslijDoKsef
  ) {
    Numer
  }
}
Variables
{"Faktura": FakturaInput, "WyslijDoKsef": false}
Response
{
  "data": {
    "SendToEArchive": {
      "Numer": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
    }
  }
}

SendToEArchiveBatchV2

Description

Wysłanie listy faktur w wersji V2 do systemu Symfonia KSeF oraz jeżeli parametr WyslijDoKsef ma wartość true, do KSeF Ministerstwa Finansów.

EnvironmentId: COMPANY

Arguments
Name Description
Faktury - [FakturaV2Input!]! Obiekt listy faktur
WyslijDoKsef - Boolean! Zlecenie wysłania listy faktur do KSeF

Example

Query
mutation SendToEArchiveBatchV2(
  $Faktury: [FakturaV2Input!]!,
  $WyslijDoKsef: Boolean!
) {
  SendToEArchiveBatchV2(
    Faktury: $Faktury,
    WyslijDoKsef: $WyslijDoKsef
  ) {
    SuccessItems {
      ...BatchResponseItemFragment
    }
    ErrorItems {
      ...BatchResponseItemFragment
    }
  }
}
Variables
{"Faktury": [FakturaV2Input], "WyslijDoKsef": true}
Response
{
  "data": {
    "SendToEArchiveBatchV2": {
      "SuccessItems": [BatchResponseItem],
      "ErrorItems": [BatchResponseItem]
    }
  }
}

SendToEArchiveV2

Description

Wysłanie faktury w wersji V2 do systemu Symfonia KSeF oraz jeżeli parametr WyslijDoKsef ma wartość true, do KSeF Ministerstwa Finansów.

EnvironmentId: COMPANY

Response

Returns a SendToEArchiveV2ResponseType!

Arguments
Name Description
Faktura - FakturaV2Input! Obiekt Faktura
WyslijDoKsef - Boolean! Zlecenie wysłania faktury do KSeF

Example

Query
mutation SendToEArchiveV2(
  $Faktura: FakturaV2Input!,
  $WyslijDoKsef: Boolean!
) {
  SendToEArchiveV2(
    Faktura: $Faktura,
    WyslijDoKsef: $WyslijDoKsef
  ) {
    Numer
  }
}
Variables
{"Faktura": FakturaV2Input, "WyslijDoKsef": true}
Response
{
  "data": {
    "SendToEArchiveV2": {
      "Numer": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
    }
  }
}

SetEArchiveNotifications

Description

Włączanie notyfikacji e-mail dla użytkownika w firmie.

EnvironmentId: COMPANY

Arguments
Name Description
EArchiveNotificationType - EArchiveNotificationType! Typ notyfikacji

Example

Query
mutation SetEArchiveNotifications($EArchiveNotificationType: EArchiveNotificationType!) {
  SetEArchiveNotifications(EArchiveNotificationType: $EArchiveNotificationType) {
    Success
  }
}
Variables
{"EArchiveNotificationType": "NONE"}
Response
{"data": {"SetEArchiveNotifications": {"Success": false}}}

SetWebsocketNotificationAcknowledge

Description

Oznacza podane notyfikacje WebSocket-owe jako przeczytane.

EnvironmentId: COMPANY

Arguments
Name Description
NotificationIds - [UUID!]! Lista identyfikatorów wiadomości

Example

Query
mutation SetWebsocketNotificationAcknowledge($NotificationIds: [UUID!]!) {
  SetWebsocketNotificationAcknowledge(NotificationIds: $NotificationIds) {
    Success
  }
}
Variables
{
  "NotificationIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ]
}
Response
{"data": {"SetWebsocketNotificationAcknowledge": {"Success": false}}}

SubscribeGrantPermissionsInKSeF

Description

Nadaje uprawnienia w KSeF Ministerstwa Finansów dla podanego identyfikatora. Aby nadać uprawnienia w KSeF Ministerstwa Finansów, użytkownik musi być uwierzytelniony w KSeF Ministerstwa Finansów oraz posiadać uprawnienia do zarządzania uprawnieniami. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Arguments
Name Description
IsNew - Boolean! Określa, czy są to nowo nadawane uprawnienia czy aktualizacja istniejących
Name - String Nazwa uprawnień w KSeF Ministerstwa Finansów
Identifier - String Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierType! Typ numeru identyfikacyjnego
CredentialsInvoiceRead - Boolean! Uprawnienie do pobierania faktur z KSeF Ministerstwa Finansów
CredentialsInvoiceWrite - Boolean! Uprawnienie do wysyłania faktur do KSeF Ministerstwa Finansów
CredentialsRead - Boolean! Uprawnienie do odczytu uprawnień z KSeF Ministerstwa Finansów
CredentialsManage - Boolean! Uprawnienie do zarządzania uprawnieniami w KSeF Ministerstwa Finansów
CredentialsSelfInvoicing - Boolean! Uprawnienie do samofakturowania w KSeF Ministerstwa Finansów
NipType - KSeFIdentifierType Typ identyfikatora NIP

Example

Query
mutation SubscribeGrantPermissionsInKSeF(
  $IsNew: Boolean!,
  $Name: String,
  $Identifier: String,
  $IdentifierType: IdentifierType!,
  $CredentialsInvoiceRead: Boolean!,
  $CredentialsInvoiceWrite: Boolean!,
  $CredentialsRead: Boolean!,
  $CredentialsManage: Boolean!,
  $CredentialsSelfInvoicing: Boolean!,
  $NipType: KSeFIdentifierType
) {
  SubscribeGrantPermissionsInKSeF(
    IsNew: $IsNew,
    Name: $Name,
    Identifier: $Identifier,
    IdentifierType: $IdentifierType,
    CredentialsInvoiceRead: $CredentialsInvoiceRead,
    CredentialsInvoiceWrite: $CredentialsInvoiceWrite,
    CredentialsRead: $CredentialsRead,
    CredentialsManage: $CredentialsManage,
    CredentialsSelfInvoicing: $CredentialsSelfInvoicing,
    NipType: $NipType
  ) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{
  "IsNew": false,
  "Name": "xyz789",
  "Identifier": "xyz789",
  "IdentifierType": "NIP",
  "CredentialsInvoiceRead": true,
  "CredentialsInvoiceWrite": false,
  "CredentialsRead": true,
  "CredentialsManage": false,
  "CredentialsSelfInvoicing": true,
  "NipType": "INSTITUTIONAL_NIP"
}
Response
{
  "data": {
    "SubscribeGrantPermissionsInKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

TerminateKSeFSession

Description

Zamyka bieżącą sesję w KSeF Ministerstwa Finansów. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Response

Returns an TerminateKSeFSessionResponse!

Example

Query
mutation TerminateKSeFSession {
  TerminateKSeFSession {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Response
{
  "data": {
    "TerminateKSeFSession": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

UploadInvoices

Description

Wczytanie faktur w formacie XML do systemu Symfonia KSeF. Wynik zapytania należy sprawdzić poprzez query GetWebsocketNotificationModel.

EnvironmentId: COMPANY

Response

Returns an UploadInvoicesResponse!

Arguments
Name Description
invoices - [UploadItemInput!]! Lista faktur

Example

Query
mutation UploadInvoices($invoices: [UploadItemInput!]!) {
  UploadInvoices(invoices: $invoices) {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}
Variables
{"invoices": [UploadItemInput]}
Response
{
  "data": {
    "UploadInvoices": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

Types

Address

Description

Dane adresowe firmy

Fields
Field Name Description
AddressLine - String! Adres
ZipCode - String! Kod pocztowy
City - String! Miasto
State - String Województwo
Country - String Kraj
Example
{
  "AddressLine": "xyz789",
  "ZipCode": "xyz789",
  "City": "xyz789",
  "State": "xyz789",
  "Country": "abc123"
}

AddressFilterInput

Description

Dane adresowe firmy

Fields
Input Field Description
and - [AddressFilterInput!]
or - [AddressFilterInput!]
AddressLine - StringOperationFilterInput Adres
ZipCode - StringOperationFilterInput Kod pocztowy
City - StringOperationFilterInput Miasto
State - StringOperationFilterInput Województwo
Country - StringOperationFilterInput Kraj
Example
{
  "and": [AddressFilterInput],
  "or": [AddressFilterInput],
  "AddressLine": StringOperationFilterInput,
  "ZipCode": StringOperationFilterInput,
  "City": StringOperationFilterInput,
  "State": StringOperationFilterInput,
  "Country": StringOperationFilterInput
}

AddressInput

Description

Dane adresowe firmy

Fields
Input Field Description
AddressLine - String! Adres
ZipCode - String! Kod pocztowy
City - String! Miasto
State - String Województwo
Country - String Kraj
Example
{
  "AddressLine": "xyz789",
  "ZipCode": "xyz789",
  "City": "xyz789",
  "State": "xyz789",
  "Country": "xyz789"
}

Adnotacje

Description

Adnotacje do faktury

Fields
Field Name Description
MetodaKasowa - Boolean! W przypadku dostawy towarów lub świadczenia usług, w odniesieniu do których obowiązek podatkowy powstaje zgodnie z art. 19a ust. 5 pkt 1 lub art. 21 ust. 1 ustawy
Samofakturowanie - Boolean! W przypadku faktur, o których mowa w art. 106d ust. 1 ustawy
OdwrotneObciazenie - Boolean! Odwrotne obciążenie polega na przerzuceniu obowiązku rozliczania podatku VAT ze sprzedawcy na nabywcę. Listę towarów dla transakcji krajowych, co do których ma zastosowanie procedura odwrotnego obciążenia, zawiera załącznik nr 11 do ustawy o VAT. Natomiast lista usług objętych procedurą odwrotnego obciążenia została umieszczona w załączniku nr 14 do ustawy.
PodzielonaPlatnosc - Boolean! W przypadku faktur, w których kwota należności ogółem przekracza kwotę 15 000 zł lub jej równowartość wyrażoną w walucie obcej, obejmujących dokonaną na rzecz podatnika dostawę towarów lub świadczenie usług, o których mowa w załączniku nr 15 do ustawy - wyrazy "mechanizm podzielonej płatności", przy czym do przeliczania na PLN kwot wyrażonych w walucie obcej stosuje się zasady przeliczania kwot, stosowane w celu określenia podstawy opodatkowania
ZwolnieniaPodmiotowe - Boolean! W przypadku dostawy towarów lub świadczenia usług zwolnionych od podatku na podstawie art. 43 ust. 1, art. 113 ust. 1 i 9 albo przepisów wydanych na podstawie art. 82 ust. 3 ustawy lub na podstawie innych przepisów
PowodZwolnienia - TPowodZwolnienia Powód zwolnienia z podatku
SrodekTrwaly - Boolean! Czy jest to środek trwały
SrodekTrwalyInfo - TSrodekTrwaly Informacja o środku trwałym
ProceduraUproszczona - Boolean! W przypadku faktur wystawianych w procedurze uproszczonej przez drugiego w kolejności podatnika, o którym mowa w art. 135 ust. 1 pkt 4 lit. b i c oraz ust. 2, zawierającej adnotację, o której mowa w art. 136 ust. 1 pkt 1 i stwierdzenie, o którym mowa w art. 136 ust. 1 pkt 2 ustawy
ProceduraMarzy - Boolean! W przypadku wystąpienia procedur marży, o których mowa w art. 119 lub 120 ustawy
Marza - TMarza Procedura marży
Example
{
  "MetodaKasowa": true,
  "Samofakturowanie": false,
  "OdwrotneObciazenie": false,
  "PodzielonaPlatnosc": false,
  "ZwolnieniaPodmiotowe": false,
  "PowodZwolnienia": TPowodZwolnienia,
  "SrodekTrwaly": false,
  "SrodekTrwalyInfo": TSrodekTrwaly,
  "ProceduraUproszczona": true,
  "ProceduraMarzy": false,
  "Marza": TMarza
}

AdnotacjeInput

Description

Adnotacje do faktury

Fields
Input Field Description
MetodaKasowa - Boolean! W przypadku dostawy towarów lub świadczenia usług, w odniesieniu do których obowiązek podatkowy powstaje zgodnie z art. 19a ust. 5 pkt 1 lub art. 21 ust. 1 ustawy
Samofakturowanie - Boolean! W przypadku faktur, o których mowa w art. 106d ust. 1 ustawy
OdwrotneObciazenie - Boolean! Odwrotne obciążenie polega na przerzuceniu obowiązku rozliczania podatku VAT ze sprzedawcy na nabywcę. Listę towarów dla transakcji krajowych, co do których ma zastosowanie procedura odwrotnego obciążenia, zawiera załącznik nr 11 do ustawy o VAT. Natomiast lista usług objętych procedurą odwrotnego obciążenia została umieszczona w załączniku nr 14 do ustawy.
PodzielonaPlatnosc - Boolean! W przypadku faktur, w których kwota należności ogółem przekracza kwotę 15 000 zł lub jej równowartość wyrażoną w walucie obcej, obejmujących dokonaną na rzecz podatnika dostawę towarów lub świadczenie usług, o których mowa w załączniku nr 15 do ustawy - wyrazy "mechanizm podzielonej płatności", przy czym do przeliczania na PLN kwot wyrażonych w walucie obcej stosuje się zasady przeliczania kwot, stosowane w celu określenia podstawy opodatkowania
ZwolnieniaPodmiotowe - Boolean! W przypadku dostawy towarów lub świadczenia usług zwolnionych od podatku na podstawie art. 43 ust. 1, art. 113 ust. 1 i 9 albo przepisów wydanych na podstawie art. 82 ust. 3 ustawy lub na podstawie innych przepisów
PowodZwolnienia - TPowodZwolnieniaInput Powód zwolnienia z podatku
SrodekTrwaly - Boolean! Czy jest to środek trwały
SrodekTrwalyInfo - TSrodekTrwalyInput Informacja o środku trwałym
ProceduraUproszczona - Boolean! W przypadku faktur wystawianych w procedurze uproszczonej przez drugiego w kolejności podatnika, o którym mowa w art. 135 ust. 1 pkt 4 lit. b i c oraz ust. 2, zawierającej adnotację, o której mowa w art. 136 ust. 1 pkt 1 i stwierdzenie, o którym mowa w art. 136 ust. 1 pkt 2 ustawy
ProceduraMarzy - Boolean! W przypadku wystąpienia procedur marży, o których mowa w art. 119 lub 120 ustawy
Marza - TMarzaInput Procedura marży
Example
{
  "MetodaKasowa": true,
  "Samofakturowanie": false,
  "OdwrotneObciazenie": true,
  "PodzielonaPlatnosc": false,
  "ZwolnieniaPodmiotowe": false,
  "PowodZwolnienia": TPowodZwolnieniaInput,
  "SrodekTrwaly": false,
  "SrodekTrwalyInfo": TSrodekTrwalyInput,
  "ProceduraUproszczona": false,
  "ProceduraMarzy": false,
  "Marza": TMarzaInput
}

AdnotacjeV2

Description

Adnotacje do faktury

Fields
Field Name Description
MetodaKasowa - Boolean! W przypadku dostawy towarów lub świadczenia usług, w odniesieniu do których obowiązek podatkowy powstaje zgodnie z art. 19a ust. 5 pkt 1 lub art. 21 ust. 1 ustawy
Samofakturowanie - Boolean! W przypadku faktur, o których mowa w art. 106d ust. 1 ustawy
OdwrotneObciazenie - Boolean! Odwrotne obciążenie polega na przerzuceniu obowiązku rozliczania podatku VAT ze sprzedawcy na nabywcę. Listę towarów dla transakcji krajowych, co do których ma zastosowanie procedura odwrotnego obciążenia, zawiera załącznik nr 11 do ustawy o VAT. Natomiast lista usług objętych procedurą odwrotnego obciążenia została umieszczona w załączniku nr 14 do ustawy.
PodzielonaPlatnosc - Boolean! W przypadku faktur, w których kwota należności ogółem przekracza kwotę 15 000 zł lub jej równowartość wyrażoną w walucie obcej, obejmujących dokonaną na rzecz podatnika dostawę towarów lub świadczenie usług, o których mowa w załączniku nr 15 do ustawy - wyrazy "mechanizm podzielonej płatności", przy czym do przeliczania na PLN kwot wyrażonych w walucie obcej stosuje się zasady przeliczania kwot, stosowane w celu określenia podstawy opodatkowania
ZwolnieniaPodmiotowe - Boolean! W przypadku dostawy towarów lub świadczenia usług zwolnionych od podatku na podstawie art. 43 ust. 1, art. 113 ust. 1 i 9 albo przepisów wydanych na podstawie art. 82 ust. 3 ustawy lub na podstawie innych przepisów
PowodZwolnienia - TPowodZwolnieniaV2 Powód zwolnienia z podatku
NoweSrodkiTransportu - DostawaNowychSrodkowTransportuV2 Informacja o środku trwałym
ProceduraUproszczona - Boolean! W przypadku faktur wystawianych w procedurze uproszczonej przez drugiego w kolejności podatnika, o którym mowa w art. 135 ust. 1 pkt 4 lit. b i c oraz ust. 2, zawierającej adnotację, o której mowa w art. 136 ust. 1 pkt 1 i stwierdzenie, o którym mowa w art. 136 ust. 1 pkt 2 ustawy
ProceduraMarzy - Boolean! W przypadku wystąpienia procedur marży, o których mowa w art. 119 lub 120 ustawy
Marza - TMarzaV2 Procedura marży
Example
{
  "MetodaKasowa": false,
  "Samofakturowanie": true,
  "OdwrotneObciazenie": true,
  "PodzielonaPlatnosc": true,
  "ZwolnieniaPodmiotowe": false,
  "PowodZwolnienia": TPowodZwolnieniaV2,
  "NoweSrodkiTransportu": DostawaNowychSrodkowTransportuV2,
  "ProceduraUproszczona": false,
  "ProceduraMarzy": false,
  "Marza": TMarzaV2
}

AdnotacjeV2Input

Description

Adnotacje do faktury

Fields
Input Field Description
MetodaKasowa - Boolean! W przypadku dostawy towarów lub świadczenia usług, w odniesieniu do których obowiązek podatkowy powstaje zgodnie z art. 19a ust. 5 pkt 1 lub art. 21 ust. 1 ustawy
Samofakturowanie - Boolean! W przypadku faktur, o których mowa w art. 106d ust. 1 ustawy
OdwrotneObciazenie - Boolean! Odwrotne obciążenie polega na przerzuceniu obowiązku rozliczania podatku VAT ze sprzedawcy na nabywcę. Listę towarów dla transakcji krajowych, co do których ma zastosowanie procedura odwrotnego obciążenia, zawiera załącznik nr 11 do ustawy o VAT. Natomiast lista usług objętych procedurą odwrotnego obciążenia została umieszczona w załączniku nr 14 do ustawy.
PodzielonaPlatnosc - Boolean! W przypadku faktur, w których kwota należności ogółem przekracza kwotę 15 000 zł lub jej równowartość wyrażoną w walucie obcej, obejmujących dokonaną na rzecz podatnika dostawę towarów lub świadczenie usług, o których mowa w załączniku nr 15 do ustawy - wyrazy "mechanizm podzielonej płatności", przy czym do przeliczania na PLN kwot wyrażonych w walucie obcej stosuje się zasady przeliczania kwot, stosowane w celu określenia podstawy opodatkowania
ZwolnieniaPodmiotowe - Boolean! W przypadku dostawy towarów lub świadczenia usług zwolnionych od podatku na podstawie art. 43 ust. 1, art. 113 ust. 1 i 9 albo przepisów wydanych na podstawie art. 82 ust. 3 ustawy lub na podstawie innych przepisów
PowodZwolnienia - TPowodZwolnieniaV2Input Powód zwolnienia z podatku
NoweSrodkiTransportu - DostawaNowychSrodkowTransportuV2Input Informacja o środku trwałym
ProceduraUproszczona - Boolean! W przypadku faktur wystawianych w procedurze uproszczonej przez drugiego w kolejności podatnika, o którym mowa w art. 135 ust. 1 pkt 4 lit. b i c oraz ust. 2, zawierającej adnotację, o której mowa w art. 136 ust. 1 pkt 1 i stwierdzenie, o którym mowa w art. 136 ust. 1 pkt 2 ustawy
ProceduraMarzy - Boolean! W przypadku wystąpienia procedur marży, o których mowa w art. 119 lub 120 ustawy
Marza - TMarzaV2Input Procedura marży
Example
{
  "MetodaKasowa": true,
  "Samofakturowanie": true,
  "OdwrotneObciazenie": true,
  "PodzielonaPlatnosc": false,
  "ZwolnieniaPodmiotowe": false,
  "PowodZwolnienia": TPowodZwolnieniaV2Input,
  "NoweSrodkiTransportu": DostawaNowychSrodkowTransportuV2Input,
  "ProceduraUproszczona": false,
  "ProceduraMarzy": false,
  "Marza": TMarzaV2Input
}

Adres

Description

Dane adresowe podmiotów wyszczególnionych na fakturze

Fields
Field Name Description
KodKraju - KodKraju Kod kraju
Wojewodztwo - String Województwo
Powiat - String Powiat
Gmina - String Gmina
Ulica - String Ulica
NrDomu - String Numer domu
NrLokalu - String Numer lokalu
Miejscowosc - String Miejscowość
KodPocztowy - String Kod pocztowy
Poczta - String Poczta
GLN - String Globalny numer lokalizacyjny
Example
{
  "KodKraju": "PL",
  "Wojewodztwo": "abc123",
  "Powiat": "abc123",
  "Gmina": "xyz789",
  "Ulica": "xyz789",
  "NrDomu": "abc123",
  "NrLokalu": "xyz789",
  "Miejscowosc": "xyz789",
  "KodPocztowy": "abc123",
  "Poczta": "xyz789",
  "GLN": "xyz789"
}

AdresInput

Description

Dane adresowe podmiotów wyszczególnionych na fakturze

Fields
Input Field Description
KodKraju - KodKraju Kod kraju
Wojewodztwo - String Województwo
Powiat - String Powiat
Gmina - String Gmina
Ulica - String Ulica
NrDomu - String Numer domu
NrLokalu - String Numer lokalu
Miejscowosc - String Miejscowość
KodPocztowy - String Kod pocztowy
Poczta - String Poczta
GLN - String Globalny numer lokalizacyjny
Example
{
  "KodKraju": "PL",
  "Wojewodztwo": "xyz789",
  "Powiat": "abc123",
  "Gmina": "xyz789",
  "Ulica": "xyz789",
  "NrDomu": "abc123",
  "NrLokalu": "xyz789",
  "Miejscowosc": "abc123",
  "KodPocztowy": "xyz789",
  "Poczta": "xyz789",
  "GLN": "abc123"
}

AdresV2

Description

Dane adresowe podmiotów wyszczególnionych na fakturze

Fields
Field Name Description
KodKraju - KodKraju Kod kraju
AdresL1 - String Adres [Address]. Typ znakowy ograniczony do 512 znaków. Minimum length: 1. Maximum length: 512.
AdresL2 - String Adres [Address]. Typ znakowy ograniczony do 512 znaków. Minimum length: 1. Maximum length: 512.
GLN - String Globalny numer lokalizacyjny
Example
{
  "KodKraju": "PL",
  "AdresL1": "abc123",
  "AdresL2": "abc123",
  "GLN": "xyz789"
}

AdresV2Input

Description

Dane adresowe podmiotów wyszczególnionych na fakturze

Fields
Input Field Description
KodKraju - KodKraju Kod kraju
AdresL1 - String Adres [Address]. Typ znakowy ograniczony do 512 znaków. Minimum length: 1. Maximum length: 512.
AdresL2 - String Adres [Address]. Typ znakowy ograniczony do 512 znaków. Minimum length: 1. Maximum length: 512.
GLN - String Globalny numer lokalizacyjny
Example
{
  "KodKraju": "PL",
  "AdresL1": "abc123",
  "AdresL2": "xyz789",
  "GLN": "abc123"
}

AttachmentFilterInput

Description

Reprezentuje załącznik, czyli dokument przypisany do faktury z serwisu FileHub

Fields
Input Field Description
and - [AttachmentFilterInput!]
or - [AttachmentFilterInput!]
Id - UuidOperationFilterInput Id załącznika
CompanyId - UuidOperationFilterInput Id firmy
CreatedBy - UuidOperationFilterInput Guid użytkownika tworzącego załącznik
ModifiedBy - UuidOperationFilterInput Guid użytkownika ostatnio modyfikującego załącznik
FileName - StringOperationFilterInput Nazwa pliku
CreatedAt - DateTimeOperationFilterInput Data utworzenia
ModifiedAt - DateTimeOperationFilterInput Data modyfikacji
IsPublic - BooleanOperationFilterInput True - jeśli załącznik jest publiczny
Size - LongOperationFilterInput Rozmiar załącznika
InvoiceId - UuidOperationFilterInput ID faktury nadany przez Symfonia KSeF
Example
{
  "and": [AttachmentFilterInput],
  "or": [AttachmentFilterInput],
  "Id": UuidOperationFilterInput,
  "CompanyId": UuidOperationFilterInput,
  "CreatedBy": UuidOperationFilterInput,
  "ModifiedBy": UuidOperationFilterInput,
  "FileName": StringOperationFilterInput,
  "CreatedAt": DateTimeOperationFilterInput,
  "ModifiedAt": DateTimeOperationFilterInput,
  "IsPublic": BooleanOperationFilterInput,
  "Size": LongOperationFilterInput,
  "InvoiceId": UuidOperationFilterInput
}

AuthorizeInKSeFWithTokenResponse

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

BatchResponseItem

Description

Pojedynczy rekord faktury z pakietu

Fields
Field Name Description
InvoiceId - UUID ID faktury nadany przez Symfonia KSeF
InvoiceNumber - String Numer faktury
RecipientNip - String Nip nabywcy
InvoicingDate - DateTime! Data wystawienia
SentToKSeF - Boolean! True - jeżeli faktura została od razu wysłana do KSeF
Errors - [String] Lista błędów
Example
{
  "InvoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "InvoiceNumber": "abc123",
  "RecipientNip": "abc123",
  "InvoicingDate": "2007-12-03T10:15:30Z",
  "SentToKSeF": true,
  "Errors": ["abc123"]
}

Boolean

Description

The Boolean scalar type represents true or false.

BooleanOperationFilterInput

Fields
Input Field Description
eq - Boolean
neq - Boolean
Example
{"eq": false, "neq": true}

Company

Description

Firma zarządzana przez organizację

Fields
Field Name Description
Name - String! Nazwa firmy
Identifier - String Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierType! Typ numeru identyfikacyjnego
VatNumberUE - String Numer VAT UE
Tenant - TenantResponse Organizacja, do której należy firma
TenantId - UUID! Id organizacji, do której należy firma
RoleAssignments - [RoleAssignment] Lista ról przypisanych do firmy
IsDemo - Boolean! Określa czy firma działa w trybie Demo (połączenie z https://ksef-demo.mf.gov.pl/)
Address - Address Dane adresowe firmy
IsMainCompany - Boolean! Czy firma główna w organizacji
NIP - String To pole niedługo zostanie usunięte
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "Name": "xyz789",
  "Identifier": "abc123",
  "IdentifierType": "NIP",
  "VatNumberUE": "abc123",
  "Tenant": TenantResponse,
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "RoleAssignments": [RoleAssignment],
  "IsDemo": false,
  "Address": Address,
  "IsMainCompany": false,
  "NIP": "abc123",
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "abc123",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "abc123"
}

CompanyAssignmentViewModel

Description

Statystyka firmy

Fields
Field Name Description
CompanyId - UUID! Id firmy
CompanyName - String Nazwa firmy
RoleName - String Nazwa roli
PurchaseInvoicesCount - Long! Liczba faktur zakupowych
SalesInvoicesCount - Long! Liczba faktur sprzedażowych
Identifier - String Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierType! Typ numeru identyfikacyjnego
IsDemo - Boolean! Określa czy firma działa w trybie Demo (połączenie z https://ksef-demo.mf.gov.pl/)
Example
{
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CompanyName": "abc123",
  "RoleName": "xyz789",
  "PurchaseInvoicesCount": {},
  "SalesInvoicesCount": {},
  "Identifier": "abc123",
  "IdentifierType": "NIP",
  "IsDemo": true
}

CompanyFilterInput

Description

Firma zarządzana przez organizację

Fields
Input Field Description
and - [CompanyFilterInput!]
or - [CompanyFilterInput!]
Name - StringOperationFilterInput Nazwa firmy
Identifier - StringOperationFilterInput Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierTypeOperationFilterInput Typ numeru identyfikacyjnego
VatNumberUE - StringOperationFilterInput Numer VAT UE
Tenant - TenantFilterInput Organizacja, do której należy firma
TenantId - UuidOperationFilterInput Id organizacji, do której należy firma
RoleAssignments - ListFilterInputTypeOfRoleAssignmentFilterInput Lista ról przypisanych do firmy
IsDemo - BooleanOperationFilterInput Określa czy firma działa w trybie Demo (połączenie z https://ksef-demo.mf.gov.pl/)
Address - AddressFilterInput Dane adresowe firmy
IsMainCompany - BooleanOperationFilterInput Czy firma główna w organizacji
NIP - StringOperationFilterInput To pole niedługo zostanie usunięte
Id - UuidOperationFilterInput Unikalny Id rekordu
CreatedAt - DateTimeOperationFilterInput Data utworzenia rekordu
CreatedBy - StringOperationFilterInput E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTimeOperationFilterInput Data modyfikacji rekordu
ModifiedBy - StringOperationFilterInput E-mail użytkownika, który zmodyfikował rekord
Example
{
  "and": [CompanyFilterInput],
  "or": [CompanyFilterInput],
  "Name": StringOperationFilterInput,
  "Identifier": StringOperationFilterInput,
  "IdentifierType": IdentifierTypeOperationFilterInput,
  "VatNumberUE": StringOperationFilterInput,
  "Tenant": TenantFilterInput,
  "TenantId": UuidOperationFilterInput,
  "RoleAssignments": ListFilterInputTypeOfRoleAssignmentFilterInput,
  "IsDemo": BooleanOperationFilterInput,
  "Address": AddressFilterInput,
  "IsMainCompany": BooleanOperationFilterInput,
  "NIP": StringOperationFilterInput,
  "Id": UuidOperationFilterInput,
  "CreatedAt": DateTimeOperationFilterInput,
  "CreatedBy": StringOperationFilterInput,
  "ModifiedAt": DateTimeOperationFilterInput,
  "ModifiedBy": StringOperationFilterInput
}

CompanyInfo

Fields
Field Name Description
Id - UUID!
Name - String
Identifier - String
IdentifierType - IdentifierType!
IsDemo - Boolean!
Example
{
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Name": "xyz789",
  "Identifier": "xyz789",
  "IdentifierType": "NIP",
  "IsDemo": true
}

CompanyKsefServicesStatusEnum

Description

Stan serwisu realizującego zadania w KSeF

Values
Enum Value Description

INACTIVE

Nieaktywny

ACTIVE

Aktywny
Example
"INACTIVE"

CreateCompanyRequest

Description

Firma zarządzana przez organizację

Fields
Input Field Description
TenantId - UUID! Id organizacji, do której należy firma
Name - String! Nazwa firmy
Identifier - String Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierType! Typ numeru identyfikacyjnego
VatNumberUE - String Numer VAT UE
Tenant - TenantInput Organizacja, do której należy firma
RoleAssignments - [RoleAssignmentInput] Lista ról przypisanych do firmy
IsDemo - Boolean! Określa czy firma działa w trybie Demo (połączenie z https://ksef-demo.mf.gov.pl/)
Address - AddressInput Dane adresowe firmy
NIP - String To pole niedługo zostanie usunięte
Example
{
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Name": "xyz789",
  "Identifier": "xyz789",
  "IdentifierType": "NIP",
  "VatNumberUE": "abc123",
  "Tenant": TenantInput,
  "RoleAssignments": [RoleAssignmentInput],
  "IsDemo": true,
  "Address": AddressInput,
  "NIP": "abc123"
}

CreateRoleRequest

Description

Rola

Fields
Input Field Description
Name - String Nazwa roli
Example
{"Name": "abc123"}

CreateUserRequest

Description

Użytkownik organizacji

Fields
Input Field Description
Email - String! Adres email użytkownika
FirstName - String! Imię użytkownika
LastName - String! Nazwisko użytkownika
PhoneNumber - String Numer telefonu użytkownika
CloudConsent - Boolean Warunki użytkowania Programu w chmurze https://materialy.symfonia.pl/publiczne/a8ca55 (obowiązkowe)
PersonalDataConsent - Boolean Zgoda na przetwarzanie danych osobowych w celach marketingowych Symfonii. (obowiązkowe)
PrivacyPolicyConsent - Boolean Akceptacja polityki prywatności (obowiązkowe)
CompanyRepresentationConsent - Boolean Oświadczenie o upoważnienie do działania w imieniu reprezentowanego podmiotu: "Oświadczam, że jestem uprawniony/-a do działania w imieniu i ze skutkiem dla podmiotu, który reprezentuję." (obowiązkowe)
MarketingEndDeviceConsent - Boolean Zgoda na używanie telekomunikacyjnych urządzeń końcowych do kontaktów marketingowych
MarketingPhoneConsent - Boolean Zgoda na używanie telefonu do kontaktów marketingowych
NewsletterConsent - Boolean Zgoda na otrzymywanie newslettera
MarketingEmailConsent - Boolean Zgoda na wykorzystanie e-mail do celów marketingowych
PersonalDataForPartnersConsent - Boolean Zgoda na przetwarzanie danych osobowych w celach marketingowych przez Partnerów Symfonii.
Tenant - TenantInput Organizacja
TenantId - UUID! Id organizacji
RoleAssignments - [RoleAssignmentInput] Przypisane role
Example
{
  "Email": "xyz789",
  "FirstName": "abc123",
  "LastName": "abc123",
  "PhoneNumber": "abc123",
  "CloudConsent": true,
  "PersonalDataConsent": false,
  "PrivacyPolicyConsent": true,
  "CompanyRepresentationConsent": true,
  "MarketingEndDeviceConsent": true,
  "MarketingPhoneConsent": false,
  "NewsletterConsent": true,
  "MarketingEmailConsent": false,
  "PersonalDataForPartnersConsent": false,
  "Tenant": TenantInput,
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "RoleAssignments": [RoleAssignmentInput]
}

Credential

Description

Obiekt uprawnień w KSeF

Fields
Field Name Description
Identifier - String! Numer identyfikacji ewidencyjnej/podatkowej firmy, do której użytkownik ma uprawnienia w KSeF
IdentifierType - IdentifierType! Typ numeru identyfikacyjnego
CredentialsInvoiceRead - Boolean! Uprawnienie do odbierania faktur
CredentialsInvoiceWrite - Boolean! Uprawnienie do wysyłki faktur
CredentialsRead - Boolean! Uprawnienie do odczytu uprawnień
CredentialsManage - Boolean! Uprawnienie do nadawania uprawnień
CredentialsSelfInvoicing - Boolean! Uprawnienie do samofakturowania
Example
{
  "Identifier": "xyz789",
  "IdentifierType": "NIP",
  "CredentialsInvoiceRead": false,
  "CredentialsInvoiceWrite": true,
  "CredentialsRead": true,
  "CredentialsManage": true,
  "CredentialsSelfInvoicing": true
}

CredentialFiltersFieldsInput

Description

Filtr uprawnień

Fields
Input Field Description
Identifiers - [String!] Lista numerów identyfikacji ewidencyjnej/podatkowej
CredentialsInvoiceRead - Boolean Uprawnienie do odbierania faktur
CredentialsInvoiceWrite - Boolean Uprawnienie do wysyłki faktur
CredentialsRead - Boolean Uprawnienie do odczytu uprawnień
CredentialsManage - Boolean Uprawnienie do nadawania uprawnień
CredentialsSelfInvoicing - Boolean Uprawnienie do samofakturowania
Example
{
  "Identifiers": ["xyz789"],
  "CredentialsInvoiceRead": true,
  "CredentialsInvoiceWrite": true,
  "CredentialsRead": false,
  "CredentialsManage": true,
  "CredentialsSelfInvoicing": false
}

DaneFaKorygowanej

Description

Dane dotyczące faktury korygowanej

Fields
Field Name Description
DataWystFaKorygowanej - DateTime! Data wystawienia faktury, której dotyczy faktura korygująca
NrFaKorygowanej - String Numer faktury korygowanej
NrKSeFFaKorygowanej - String Numer identyfikujący fakturę korygowaną w Krajowym Systemie e-Faktur (KSeF)
Example
{
  "DataWystFaKorygowanej": "2007-12-03T10:15:30Z",
  "NrFaKorygowanej": "xyz789",
  "NrKSeFFaKorygowanej": "abc123"
}

DaneFaKorygowanejInput

Description

Dane dotyczące faktury korygowanej

Fields
Input Field Description
DataWystFaKorygowanej - DateTime! Data wystawienia faktury, której dotyczy faktura korygująca
NrFaKorygowanej - String Numer faktury korygowanej
NrKSeFFaKorygowanej - String Numer identyfikujący fakturę korygowaną w Krajowym Systemie e-Faktur (KSeF)
Example
{
  "DataWystFaKorygowanej": "2007-12-03T10:15:30Z",
  "NrFaKorygowanej": "abc123",
  "NrKSeFFaKorygowanej": "abc123"
}

Date

Description

The Date scalar represents an ISO-8601 compliant date type.

Example
"2007-12-03"

DateOperationFilterInput

Fields
Input Field Description
eq - Date
neq - Date
in - [Date]
nin - [Date]
gt - Date
ngt - Date
gte - Date
ngte - Date
lt - Date
nlt - Date
lte - Date
nlte - Date
Example
{
  "eq": "2007-12-03",
  "neq": "2007-12-03",
  "in": ["2007-12-03"],
  "nin": ["2007-12-03"],
  "gt": "2007-12-03",
  "ngt": "2007-12-03",
  "gte": "2007-12-03",
  "ngte": "2007-12-03",
  "lt": "2007-12-03",
  "nlt": "2007-12-03",
  "lte": "2007-12-03",
  "nlte": "2007-12-03"
}

DateRangeSchemaModelInput

Description

Zakres dat Od - Do

Fields
Input Field Description
DateFrom - Date Data Od
DateTo - Date Data Do
Example
{
  "DateFrom": "2007-12-03",
  "DateTo": "2007-12-03"
}

DateTime

Description

The DateTime scalar represents an ISO-8601 compliant date time type.

Example
"2007-12-03T10:15:30Z"

DateTimeOperationFilterInput

Fields
Input Field Description
eq - DateTime
neq - DateTime
in - [DateTime]
nin - [DateTime]
gt - DateTime
ngt - DateTime
gte - DateTime
ngte - DateTime
lt - DateTime
nlt - DateTime
lte - DateTime
nlte - DateTime
Example
{
  "eq": "2007-12-03T10:15:30Z",
  "neq": "2007-12-03T10:15:30Z",
  "in": ["2007-12-03T10:15:30Z"],
  "nin": ["2007-12-03T10:15:30Z"],
  "gt": "2007-12-03T10:15:30Z",
  "ngt": "2007-12-03T10:15:30Z",
  "gte": "2007-12-03T10:15:30Z",
  "ngte": "2007-12-03T10:15:30Z",
  "lt": "2007-12-03T10:15:30Z",
  "nlt": "2007-12-03T10:15:30Z",
  "lte": "2007-12-03T10:15:30Z",
  "nlte": "2007-12-03T10:15:30Z"
}

DateTimeRange

Description

Zakres dat

Fields
Field Name Description
DateFrom - DateTime Data od
DateTo - DateTime Data do
Example
{
  "DateFrom": "2007-12-03T10:15:30Z",
  "DateTo": "2007-12-03T10:15:30Z"
}

DateTimeRangeInput

Description

Zakres dat

Fields
Input Field Description
DateFrom - DateTime Data od
DateTo - DateTime Data do
Example
{
  "DateFrom": "2007-12-03T10:15:30Z",
  "DateTo": "2007-12-03T10:15:30Z"
}

Decimal

Description

The built-in Decimal scalar type.

Example
Decimal

DecimalOperationFilterInput

Fields
Input Field Description
eq - Decimal
neq - Decimal
in - [Decimal]
nin - [Decimal]
gt - Decimal
ngt - Decimal
gte - Decimal
ngte - Decimal
lt - Decimal
nlt - Decimal
lte - Decimal
nlte - Decimal
Example
{
  "eq": Decimal,
  "neq": Decimal,
  "in": [Decimal],
  "nin": [Decimal],
  "gt": Decimal,
  "ngt": Decimal,
  "gte": Decimal,
  "ngte": Decimal,
  "lt": Decimal,
  "nlt": Decimal,
  "lte": Decimal,
  "nlte": Decimal
}

DeleteInvoicesResponse

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

DesktopStatus

Description

Status połączenia między aplikacjami

Values
Enum Value Description

NOT_CONNECTED

Nie połączono

CREATING_INFRASTRUCTURE

Tworzona jest infrastruktura do komunikacji No longer supported

WAITING_FOR_CONNECTION

Oczekiwanie na podłączenie agenta

CONNECTED

Połączono
Example
"NOT_CONNECTED"

DesktopStatusOperationFilterInput

Fields
Input Field Description
eq - DesktopStatus
neq - DesktopStatus
in - [DesktopStatus!]
nin - [DesktopStatus!]
Example
{
  "eq": "NOT_CONNECTED",
  "neq": "NOT_CONNECTED",
  "in": ["NOT_CONNECTED"],
  "nin": ["NOT_CONNECTED"]
}

DodatkowyOpisPolaV2

Description

Pola przeznaczone dla wykazywania dodatkowych danych na fakturze, w tym wymaganych przepisami prawa, dla których nie przewidziano innych pól/elementów

Fields
Field Name Description
NrWiersza - String Numer wiersza podany w polu NrWierszaFa lub NrWierszaZam, jeśli informacja odnosi się wyłącznie do danej pozycji faktury. Liczby naturalne większe od zera. Minimum exclusive value: 0.
Klucz - String Klucz. Typ znakowy ograniczony do 256 znaków. Minimum length: 1. Maximum length: 256.
Wartosc - String Wartość. Typ znakowy ograniczony do 256 znaków. Minimum length: 1. Maximum length: 256.
Example
{
  "NrWiersza": "xyz789",
  "Klucz": "abc123",
  "Wartosc": "xyz789"
}

DodatkowyOpisPolaV2Input

Description

Pola przeznaczone dla wykazywania dodatkowych danych na fakturze, w tym wymaganych przepisami prawa, dla których nie przewidziano innych pól/elementów

Fields
Input Field Description
NrWiersza - String Numer wiersza podany w polu NrWierszaFa lub NrWierszaZam, jeśli informacja odnosi się wyłącznie do danej pozycji faktury. Liczby naturalne większe od zera. Minimum exclusive value: 0.
Klucz - String Klucz. Typ znakowy ograniczony do 256 znaków. Minimum length: 1. Maximum length: 256.
Wartosc - String Wartość. Typ znakowy ograniczony do 256 znaków. Minimum length: 1. Maximum length: 256.
Example
{
  "NrWiersza": "xyz789",
  "Klucz": "abc123",
  "Wartosc": "xyz789"
}

DostawaNowychSrodkowTransportuV2

Description

Środki trwałe - transport

Fields
Field Name Description
DostawaNowegoSrodkaTransportu - Boolean! Znacznik wewnątrzwspólnotowej dostawy nowych środków transportu
WywozNowegSrodkaTransportu - Boolean! Dotyczy dokumentu wywozu Nowego Środka Transportu z terytorium kraju. Jeśli występuje obowiązek, o którym mowa w art. 42 ust. 5 ustawy, należy podać wartość "1", w przeciwnym przypadku - wartość "2"
NoweSrodkiTransportu - [TNowySrodekTransportuV2!] Lista Nowych środków transportu
Example
{
  "DostawaNowegoSrodkaTransportu": true,
  "WywozNowegSrodkaTransportu": true,
  "NoweSrodkiTransportu": [TNowySrodekTransportuV2]
}

DostawaNowychSrodkowTransportuV2Input

Description

Środki trwałe - transport

Fields
Input Field Description
DostawaNowegoSrodkaTransportu - Boolean! Znacznik wewnątrzwspólnotowej dostawy nowych środków transportu
WywozNowegSrodkaTransportu - Boolean! Dotyczy dokumentu wywozu Nowego Środka Transportu z terytorium kraju. Jeśli występuje obowiązek, o którym mowa w art. 42 ust. 5 ustawy, należy podać wartość "1", w przeciwnym przypadku - wartość "2"
NoweSrodkiTransportu - [TNowySrodekTransportuV2Input!] Lista Nowych środków transportu
Example
{
  "DostawaNowegoSrodkaTransportu": false,
  "WywozNowegSrodkaTransportu": false,
  "NoweSrodkiTransportu": [TNowySrodekTransportuV2Input]
}

DownloadInvoiceItemMessage

Description

Informacja o fakturze

Fields
Field Name Description
kSeFNumber - String Numer faktury w KSeF
kSeFDate - DateTime! Data nadania numeru KSeF
errorMessage - String Opis błędu
invoiceBound - InvoiceBound Typ faktury
Example
{
  "kSeFNumber": "xyz789",
  "kSeFDate": "2007-12-03T10:15:30Z",
  "errorMessage": "xyz789",
  "invoiceBound": "INTERNAL"
}

DownloadStateUserMessage

Description

Stan procesu pobierania faktur

Values
Enum Value Description

PENDING

Oczekuje na możliwość wysłania zapytania do KSeF

DOWNLOADING

W trakcie pobierania faktur (xml)
Example
"PENDING"

EArchiveNotificationType

Description

Typ notyfikacji e-mail

Values
Enum Value Description

NONE

Wyłączone

AUTHORIZATION_OF_COMPANY_SUCCEEDED

Autoryzacja użytkownika w KSeF zakończone sukcesem

AUTHORIZATION_OF_COMPANY_FAILED

Autoryzacja użytkownika w KSeF zakończone błędem

DOWNLOAD_UPO_SUCCEEDED

Pomyślne pobranie UPO

DOWNLOAD_INVOICES_FROM_K_SE_F

Pomyślne pobranie faktury z KSeF

PERMISSIONS_EDITED

Edytowano uprawnienia w KSeF

SEND_INVOICES_TO_K_SE_F

Wysłano faktury do KSeF

INVOICES_NOT_FETCHED

Nieudane automatyczne pobranie faktur z KSeF

AUTO_UNAUTHORIZATION_USER_IN_K_SE_F

Automatyczne rozłączenie Użytkownika z KSeF
Example
"NONE"

EnvironmentStatus

Description

Status środowiska

Values
Enum Value Description

PENDING_APPROVAL

Oczekujący na zatwierdzenie

INACTIVE

Nieaktywny

ACTIVE

Aktywny

REMOVED

Usunięty

TO_DELETE

Do usunięcia Do usunięcia
Example
"PENDING_APPROVAL"

EnvironmentType

Description

Typ środowiska

Values
Enum Value Description

NONE

Niewymagane środowisko

ADMIN

Admin / BOK

TENANT

Organizacja

COMPANY

Firma
Example
COMPANY

EnvironmentViewModel

Description

Właściwości środowiska

Fields
Field Name Description
EnvironmentId - UUID! Id środowiska
Name - String Nazwa środowiska
Type - EnvironmentType! Typ środowiska
Status - EnvironmentStatus! Status
Tenant - TenantResponse Organizacja
IsDemo - Boolean! Określa, czy instancja środowiska jest wersją Demo
Company - Company Firma
Example
{
  "EnvironmentId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Name": "abc123",
  "Type": "COMPANY",
  "Status": "PENDING_APPROVAL",
  "Tenant": TenantResponse,
  "IsDemo": false,
  "Company": Company
}

EnvironmentWithUser

Description

Środowisko wraz z danymi użytkownika

Fields
Field Name Description
User - UserInfo Informacje dot. użytkownika
Id - UUID! Id środowiska
IsActive - Boolean! Czy środowisko jest aktywne
Type - EnvironmentType! Typ środowiska
Company - CompanyInfo Informacje dot. firmy
Tenant - TenantInfo Informacje dot. organizacji
Example
{
  "User": UserInfo,
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "IsActive": true,
  "Type": "COMPANY",
  "Company": CompanyInfo,
  "Tenant": TenantInfo
}

ExtendedFiltersFieldsInput

Fields
Input Field Description
CreatedAfterInvoiceId - UUID Filtrowanie od daty utworzenia id faktury
CreatedAfter - DateTime Filtrowanie od daty utworzenia faktury
ModifiedAfter - DateTime Filtrowanie od daty modyfikacji faktury
Foreign - Boolean Tylko faktury zakupowe
Downloaded - Boolean Tylko faktury, które mają status "Pobrane z KSeF"
ToDownload - Boolean Tylko faktury, które mają status "Do pobrania z KSeF"
Own - Boolean Tylko faktury sprzedażowe
Sent - Boolean Tylko faktury, które mają status "Wysłane do KSeF"
ToSend - Boolean Tylko faktury, które mają status "Do wysłania do KSeF"
ReadyForPosting - Boolean Tylko faktury w statusie "Do dekretacji"
ToAccept - Boolean Tylko faktury z dekretami w statusie "Do akceptacji"
Numbers - [String!] Filtrowanie po numerach faktur
DownloadedBy - [SymfoniaSystem!] Filtrowanie po systemach, które pobrały fakturę
DocumentTypes - [RodzajFaktury!] Filtrowanie po rodzajach faktur
IssuerNames - [String!] Filtrowanie po nazwach sprzedawców
IssuerNips - [String!] Filtrowanie po numerach NIP sprzedawców
RecipientNames - [String!] Filtrowanie po nazwach odbiorców
RecipientNips - [String!] Filtrowanie po numerach NIP odbiorców
GrossValue - NumberRangeSchemaModelOfDecimalInput Zakres kwoty brutto faktur
NetValue - NumberRangeSchemaModelOfDecimalInput Zakres kwoty netto faktur
VatValue - NumberRangeSchemaModelOfDecimalInput Zakres kwoty podatku vat faktur
DateOfIssue - DateRangeSchemaModelInput Zakres dat wystawienia faktur
KsefDate - DateRangeSchemaModelInput Zakres dat faktur wysłanych do KSeF
KsefNumbers - [String!] Filtrowanie po liście numerów nadanych fakturom w KSeF
KSeFStatuses - [KSeFStatus!] Filtrowanie po statusach faktur w KSeF
InvoicePostingStatuses - [InvoicePostingStatus!] Filtrowanie po statusach dekretacji
RegistrationNumbers - [String!] Filtrowanie po numerach ewidencyjnych
InvoiceIds - [UUID!] Filtrowanie po liście id faktur w Symfonia KSeF
Example
{
  "CreatedAfterInvoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAfter": "2007-12-03T10:15:30Z",
  "ModifiedAfter": "2007-12-03T10:15:30Z",
  "Foreign": false,
  "Downloaded": false,
  "ToDownload": false,
  "Own": false,
  "Sent": true,
  "ToSend": false,
  "ReadyForPosting": false,
  "ToAccept": true,
  "Numbers": ["xyz789"],
  "DownloadedBy": ["UNDEFINED"],
  "DocumentTypes": ["VAT"],
  "IssuerNames": ["xyz789"],
  "IssuerNips": ["xyz789"],
  "RecipientNames": ["xyz789"],
  "RecipientNips": ["xyz789"],
  "GrossValue": NumberRangeSchemaModelOfDecimalInput,
  "NetValue": NumberRangeSchemaModelOfDecimalInput,
  "VatValue": NumberRangeSchemaModelOfDecimalInput,
  "DateOfIssue": DateRangeSchemaModelInput,
  "KsefDate": DateRangeSchemaModelInput,
  "KsefNumbers": ["abc123"],
  "KSeFStatuses": ["NOT_SENT"],
  "InvoicePostingStatuses": ["DECREE_SENT"],
  "RegistrationNumbers": ["abc123"],
  "InvoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ]
}

Faktura

Description

Obiekt faktury w wersji domenowej Symfonii dla schematu V11089

Fields
Field Name Description
WersjaDTO - String Wykorzystana wersja DTO Nazewnictwo zgodnie ze standardem : V1, V2, V3, itd.
Sprzedawca - Podmiot! Sprzedawca
Nabywca - Podmiot! Nabywca
TrzeciPodmiot - [TrzeciPodmiot!] Lista podmiotów trzecich (nieobowiązkowe)
PodmiotUpowazniony - PodmiotUpowazniony Podmiot upoważniony (nieobowiązkowe)
Naglowek - Naglowek! Nagłówek
Adnotacje - Adnotacje! Inne adnotacje na fakturze
Korekta - Korekta Korekta, obowiązkowa, gdy typ faktury to: KOR, KOR_ZAL lub KOR_ROZ
PodsumowanieVat - [PodsumowanieVat!]! Podsumowanie VAT
Wiersze - [Wiersz!]! Lista wierszy faktury
Rozliczenie - Rozliczenie Dodatkowe rozliczenia na fakturze (nieobowiązkowe)
Platnosc - Platnosc Płatność (nieobowiązkowe)
WarunkiTransakcji - WarunkiTransakcji Warunki transakcji (nieobowiązkowe)
Zamowienie - Zamowienie Zamówienie lub umowa, o których mowa w art. 106f ust. 1 pkt 4 ustawy (dla faktur zaliczkowych) w walucie, w której wystawiono fakturę zaliczkową. W przypadku faktury korygującej fakturę zaliczkową należy prezentować różnice wynikające z korekty poszczególnych pozycji zamówienia lub umowy lub storna poszczególnych korygowanych pozycji zamówienia lub umowy i prawidłowe wartości korygowanych pozycji jako osobne wiersze, jeśli korekta dotyczy wartości zamówienia. W przypadku faktur korygujących faktury zaliczkowe, jeśli korekta nie dotyczy wartości zamówienia i jednocześnie zmienia wysokość podstawy opodatkowania lub podatku, należy wprowadzić zapis stornujący dany wiersz wg stanu przed korektą i zapis przywracający wartość zamówienia w celu potwierdzenia braku zmiany jego wartości
Stopka - Stopka Numery podmiotu lub grupy podmiotów w innych rejestrach i bazach danych (nieobowiązkowe)
Example
{
  "WersjaDTO": "xyz789",
  "Sprzedawca": Podmiot,
  "Nabywca": Podmiot,
  "TrzeciPodmiot": [TrzeciPodmiot],
  "PodmiotUpowazniony": PodmiotUpowazniony,
  "Naglowek": Naglowek,
  "Adnotacje": Adnotacje,
  "Korekta": Korekta,
  "PodsumowanieVat": [PodsumowanieVat],
  "Wiersze": [Wiersz],
  "Rozliczenie": Rozliczenie,
  "Platnosc": Platnosc,
  "WarunkiTransakcji": WarunkiTransakcji,
  "Zamowienie": Zamowienie,
  "Stopka": Stopka
}

FakturaInput

Description

Obiekt faktury w wersji domenowej Symfonii dla schematu V11089

Fields
Input Field Description
WersjaDTO - String Wykorzystana wersja DTO Nazewnictwo zgodnie ze standardem : V1, V2, V3, itd.
Sprzedawca - PodmiotInput! Sprzedawca
Nabywca - PodmiotInput! Nabywca
TrzeciPodmiot - [TrzeciPodmiotInput!] Lista podmiotów trzecich (nieobowiązkowe)
PodmiotUpowazniony - PodmiotUpowaznionyInput Podmiot upoważniony (nieobowiązkowe)
Naglowek - NaglowekInput! Nagłówek
Adnotacje - AdnotacjeInput! Inne adnotacje na fakturze
Korekta - KorektaInput Korekta, obowiązkowa, gdy typ faktury to: KOR, KOR_ZAL lub KOR_ROZ
PodsumowanieVat - [PodsumowanieVatInput!]! Podsumowanie VAT
Wiersze - [WierszInput!]! Lista wierszy faktury
Rozliczenie - RozliczenieInput Dodatkowe rozliczenia na fakturze (nieobowiązkowe)
Platnosc - PlatnoscInput Płatność (nieobowiązkowe)
WarunkiTransakcji - WarunkiTransakcjiInput Warunki transakcji (nieobowiązkowe)
Zamowienie - ZamowienieInput Zamówienie lub umowa, o których mowa w art. 106f ust. 1 pkt 4 ustawy (dla faktur zaliczkowych) w walucie, w której wystawiono fakturę zaliczkową. W przypadku faktury korygującej fakturę zaliczkową należy prezentować różnice wynikające z korekty poszczególnych pozycji zamówienia lub umowy lub storna poszczególnych korygowanych pozycji zamówienia lub umowy i prawidłowe wartości korygowanych pozycji jako osobne wiersze, jeśli korekta dotyczy wartości zamówienia. W przypadku faktur korygujących faktury zaliczkowe, jeśli korekta nie dotyczy wartości zamówienia i jednocześnie zmienia wysokość podstawy opodatkowania lub podatku, należy wprowadzić zapis stornujący dany wiersz wg stanu przed korektą i zapis przywracający wartość zamówienia w celu potwierdzenia braku zmiany jego wartości
Stopka - StopkaInput Numery podmiotu lub grupy podmiotów w innych rejestrach i bazach danych (nieobowiązkowe)
Example
{
  "WersjaDTO": "xyz789",
  "Sprzedawca": PodmiotInput,
  "Nabywca": PodmiotInput,
  "TrzeciPodmiot": [TrzeciPodmiotInput],
  "PodmiotUpowazniony": PodmiotUpowaznionyInput,
  "Naglowek": NaglowekInput,
  "Adnotacje": AdnotacjeInput,
  "Korekta": KorektaInput,
  "PodsumowanieVat": [PodsumowanieVatInput],
  "Wiersze": [WierszInput],
  "Rozliczenie": RozliczenieInput,
  "Platnosc": PlatnoscInput,
  "WarunkiTransakcji": WarunkiTransakcjiInput,
  "Zamowienie": ZamowienieInput,
  "Stopka": StopkaInput
}

FakturaV2

Description

Obiekt faktury w wersji domenowej Symfonii dla schematu V12648

Fields
Field Name Description
WersjaDTO - String Wykorzystana wersja DTO Nazewnictwo zgodnie ze standardem : V1, V2, V3, itd.
Sprzedawca - PodmiotV2! Sprzedawca
Nabywca - PodmiotV2! Nabywca
TrzeciPodmiot - [TrzeciPodmiotV2!] Lista podmiotów trzecich (nieobowiązkowe)
PodmiotUpowazniony - PodmiotUpowaznionyV2 Podmiot upoważniony (nieobowiązkowe)
Naglowek - NaglowekV2! Nagłówek
Adnotacje - AdnotacjeV2! Inne adnotacje na fakturze
Korekta - KorektaV2 Korekta, obowiązkowa gdy typ faktury to: KOR, KOR_ZAL lub KOR_ROZ
PodsumowanieVat - [PodsumowanieVat!]! Podsumowanie VAT
Wiersze - [WierszV2!]! Lista wierszy faktury
Rozliczenie - Rozliczenie Dodatkowe rozliczenia na fakturze (nieobowiązkowe)
Platnosc - PlatnoscV2 Płatność (nieobowiązkowe)
WarunkiTransakcji - WarunkiTransakcjiV2 Warunki transakcji (nieobowiązkowe)
Zamowienie - ZamowienieV2 Zamówienie lub umowa, o których mowa w art. 106f ust. 1 pkt 4 ustawy (dla faktur zaliczkowych) w walucie, w której wystawiono fakturę zaliczkową. W przypadku faktury korygującej fakturę zaliczkową należy prezentować różnice wynikające z korekty poszczególnych pozycji zamówienia lub umowy lub storna poszczególnych korygowanych pozycji zamówienia lub umowy i prawidłowe wartości korygowanych pozycji jako osobne wiersze jeśli korekta dotyczy wartości zamówienia. W przypadku faktur korygujących faktury zaliczkowe, jeśli korekta nie dotyczy wartości zamówienia i jednocześnie zmienia wysokość podstawy opodatkowania lub podatku, należy wprowadzić zapis stornujący dany wiersz wg stanu przed korektą i zapis przywracający wartość zamówienia w celu potwierdzenia braku zmiany jego wartości
Stopka - StopkaV2 Numery podmiotu lub grupy podmiotów w innych rejestrach i bazach danych (nieobowiązkowe)
Example
{
  "WersjaDTO": "abc123",
  "Sprzedawca": PodmiotV2,
  "Nabywca": PodmiotV2,
  "TrzeciPodmiot": [TrzeciPodmiotV2],
  "PodmiotUpowazniony": PodmiotUpowaznionyV2,
  "Naglowek": NaglowekV2,
  "Adnotacje": AdnotacjeV2,
  "Korekta": KorektaV2,
  "PodsumowanieVat": [PodsumowanieVat],
  "Wiersze": [WierszV2],
  "Rozliczenie": Rozliczenie,
  "Platnosc": PlatnoscV2,
  "WarunkiTransakcji": WarunkiTransakcjiV2,
  "Zamowienie": ZamowienieV2,
  "Stopka": StopkaV2
}

FakturaV2Input

Description

Obiekt faktury w wersji domenowej Symfonii dla schematu V12648

Fields
Input Field Description
WersjaDTO - String Wykorzystana wersja DTO Nazewnictwo zgodnie ze standardem : V1, V2, V3, itd.
Sprzedawca - PodmiotV2Input! Sprzedawca
Nabywca - PodmiotV2Input! Nabywca
TrzeciPodmiot - [TrzeciPodmiotV2Input!] Lista podmiotów trzecich (nieobowiązkowe)
PodmiotUpowazniony - PodmiotUpowaznionyV2Input Podmiot upoważniony (nieobowiązkowe)
Naglowek - NaglowekV2Input! Nagłówek
Adnotacje - AdnotacjeV2Input! Inne adnotacje na fakturze
Korekta - KorektaV2Input Korekta, obowiązkowa gdy typ faktury to: KOR, KOR_ZAL lub KOR_ROZ
PodsumowanieVat - [PodsumowanieVatInput!]! Podsumowanie VAT
Wiersze - [WierszV2Input!]! Lista wierszy faktury
Rozliczenie - RozliczenieInput Dodatkowe rozliczenia na fakturze (nieobowiązkowe)
Platnosc - PlatnoscV2Input Płatność (nieobowiązkowe)
WarunkiTransakcji - WarunkiTransakcjiV2Input Warunki transakcji (nieobowiązkowe)
Zamowienie - ZamowienieV2Input Zamówienie lub umowa, o których mowa w art. 106f ust. 1 pkt 4 ustawy (dla faktur zaliczkowych) w walucie, w której wystawiono fakturę zaliczkową. W przypadku faktury korygującej fakturę zaliczkową należy prezentować różnice wynikające z korekty poszczególnych pozycji zamówienia lub umowy lub storna poszczególnych korygowanych pozycji zamówienia lub umowy i prawidłowe wartości korygowanych pozycji jako osobne wiersze jeśli korekta dotyczy wartości zamówienia. W przypadku faktur korygujących faktury zaliczkowe, jeśli korekta nie dotyczy wartości zamówienia i jednocześnie zmienia wysokość podstawy opodatkowania lub podatku, należy wprowadzić zapis stornujący dany wiersz wg stanu przed korektą i zapis przywracający wartość zamówienia w celu potwierdzenia braku zmiany jego wartości
Stopka - StopkaV2Input Numery podmiotu lub grupy podmiotów w innych rejestrach i bazach danych (nieobowiązkowe)
Example
{
  "WersjaDTO": "xyz789",
  "Sprzedawca": PodmiotV2Input,
  "Nabywca": PodmiotV2Input,
  "TrzeciPodmiot": [TrzeciPodmiotV2Input],
  "PodmiotUpowazniony": PodmiotUpowaznionyV2Input,
  "Naglowek": NaglowekV2Input,
  "Adnotacje": AdnotacjeV2Input,
  "Korekta": KorektaV2Input,
  "PodsumowanieVat": [PodsumowanieVatInput],
  "Wiersze": [WierszV2Input],
  "Rozliczenie": RozliczenieInput,
  "Platnosc": PlatnoscV2Input,
  "WarunkiTransakcji": WarunkiTransakcjiV2Input,
  "Zamowienie": ZamowienieV2Input,
  "Stopka": StopkaV2Input
}

FakturaZaliczkowaV2

Description

Element Faktura zaliczkowa

Fields
Field Name Description
NrKSeFZN - Boolean Znacznik faktury zaliczkowej wystawionej poza KSeF
NrFaZaliczkowej - String Numer faktury zaliczkowej wystawionej poza KSeF. Pole obowiązkowe dla faktury wystawianej po wydaniu towaru lub wykonaniu usługi, o której mowa w art. 106f ust. 3 ustawy i ostatniej z faktur, o której mowa w art. 106f ust. 4 ustawy. Typ znakowy ograniczony do 256 znaków. Minimum length: 1. Maximum length: 256.
NrKSeFFaZaliczkowej - String Numer identyfikujący fakturę zaliczkową w KSeF. Pole obowiązkowe w przypadku, gdy faktura zaliczkowa była wystawiona za pomocą KSeF. Numer identyfikujący fakturę w Krajowym Systemie e-Faktur (KSeF). Pattern: (1-9\d{7}|M\d{9}|[A-Z]{3}\d{7})-(20[2-9][0-9]|2[1-9][0-9]{2}|[3-9][0-9]{3})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])-([0-9A-F]{6})-?([0-9A-F]{6})-([0-9A-F]{2}).
Example
{
  "NrKSeFZN": true,
  "NrFaZaliczkowej": "abc123",
  "NrKSeFFaZaliczkowej": "abc123"
}

FakturaZaliczkowaV2Input

Description

Element Faktura zaliczkowa

Fields
Input Field Description
NrKSeFZN - Boolean Znacznik faktury zaliczkowej wystawionej poza KSeF
NrFaZaliczkowej - String Numer faktury zaliczkowej wystawionej poza KSeF. Pole obowiązkowe dla faktury wystawianej po wydaniu towaru lub wykonaniu usługi, o której mowa w art. 106f ust. 3 ustawy i ostatniej z faktur, o której mowa w art. 106f ust. 4 ustawy. Typ znakowy ograniczony do 256 znaków. Minimum length: 1. Maximum length: 256.
NrKSeFFaZaliczkowej - String Numer identyfikujący fakturę zaliczkową w KSeF. Pole obowiązkowe w przypadku, gdy faktura zaliczkowa była wystawiona za pomocą KSeF. Numer identyfikujący fakturę w Krajowym Systemie e-Faktur (KSeF). Pattern: (1-9\d{7}|M\d{9}|[A-Z]{3}\d{7})-(20[2-9][0-9]|2[1-9][0-9]{2}|[3-9][0-9]{3})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])-([0-9A-F]{6})-?([0-9A-F]{6})-([0-9A-F]{2}).
Example
{
  "NrKSeFZN": false,
  "NrFaZaliczkowej": "xyz789",
  "NrKSeFFaZaliczkowej": "abc123"
}

FilterFieldsInput

Description

Filtr faktur

Fields
Input Field Description
CompanyId - UUID Id firmy
Number - String Numer faktury
DocumentType - RodzajFaktury Rodzaj faktury
DateOfIssue - DateRangeSchemaModelInput Data wystawienia faktury
DestinationSystem - String System docelowy
FileName - String Nazwa pliku XML faktury
InvoiceBound - InvoiceBound Rodzaj faktury powiązanej
IssuerName - String Nazwa sprzedawcy
IssuerNip - String Numer NIP sprzedawcy
RecipientName - String Nazwa nabywcy
RecipientNip - String Numer NIP nabywcy
GrossValue - Decimal Wartość faktury brutto
KsefDate - DateRangeSchemaModelInput Data wysłania do KSeF
KsefNumber - String Numer nadany fakturze przez KSeF
KSeFSessionReferenceNumber - String Numer referencyjny sesji w KSeF podczas wysyłania faktury
KSeFElementReferenceNumber - String Numer referencyjny elementu w KSeF podczas wysyłania faktury
Downloaded - SymfoniaSystem Kod systemu Symfonii, który pobrał fakturę z Symfonia KSeF
KSeFStatus - KSeFStatus Status dokumentu w systemie KSeF
KSeFStatusErrorDescription - String Opis błędu nadany przez system KSeF, o ile wystąpił
Owner - String Adres email użytkownika, który zlecił wysyłkę faktury do KSeF
Example
{
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Number": "xyz789",
  "DocumentType": "VAT",
  "DateOfIssue": DateRangeSchemaModelInput,
  "DestinationSystem": "abc123",
  "FileName": "xyz789",
  "InvoiceBound": "INTERNAL",
  "IssuerName": "abc123",
  "IssuerNip": "abc123",
  "RecipientName": "abc123",
  "RecipientNip": "abc123",
  "GrossValue": Decimal,
  "KsefDate": DateRangeSchemaModelInput,
  "KsefNumber": "abc123",
  "KSeFSessionReferenceNumber": "abc123",
  "KSeFElementReferenceNumber": "abc123",
  "Downloaded": "UNDEFINED",
  "KSeFStatus": "NOT_SENT",
  "KSeFStatusErrorDescription": "abc123",
  "Owner": "xyz789"
}

FiltersFieldsInput

Fields
Input Field Description
Foreign - Boolean! Tylko faktury zakupowe
Downloaded - Boolean! Tylko faktury, które mają status "Pobrane z KSeF"
ToDownload - Boolean! Tylko faktury, które mają status "Do pobrania z KSeF"
Own - Boolean! Tylko faktury sprzedażowe
Sent - Boolean! Tylko faktury, które mają status "Wysłane do KSeF"
ToSend - Boolean! Tylko faktury, które mają status "Do wysłania do KSeF"
Numbers - [String!] Filtrowanie po numerach faktur
DownloadedBy - [SymfoniaSystem!] Filtrowanie po systemach, które pobrały fakturę
DocumentTypes - [RodzajFaktury!] Filtrowanie po rodzajach faktur
IssuerNames - [String!] Filtrowanie po nazwach sprzedawców
IssuerNips - [String!] Filtrowanie po numerach NIP sprzedawców
RecipientNames - [String!] Filtrowanie po nazwach odbiorców
RecipientNips - [String!] Filtrowanie po numerach NIP odbiorców
GrossValue - NumberRangeSchemaModelOfDecimalInput Zakres kwoty brutto faktur
NetValue - NumberRangeSchemaModelOfDecimalInput Zakres kwoty netto faktur
VatValue - NumberRangeSchemaModelOfDecimalInput Zakres kwoty podatku vat faktur
DateOfIssue - DateRangeSchemaModelInput Zakres dat wystawienia faktur
KsefDate - DateRangeSchemaModelInput Zakres dat faktur wysłanych do KSeF
KsefNumbers - [String!] Filtrowanie po liście numerów nadanych fakturom w KSeF
KSeFStatuses - [KSeFStatus!] Filtrowanie po statusach faktur w KSeF
ReadyForPosting - Boolean! Tylko faktury w statusie "Do dekretacji"
ToAccept - Boolean! Tylko faktury z dekretami w statusie "Do akceptacji"
InvoicePostingStatuses - [InvoicePostingStatus!] Filtrowanie po statusach dekretacji
RegistrationNumbers - [String!] Filtrowanie po numerach ewidencyjnych
InvoiceIds - [UUID!] Filtrowanie po liście id faktur w Symfonia KSeF
Example
{
  "Foreign": true,
  "Downloaded": false,
  "ToDownload": false,
  "Own": true,
  "Sent": true,
  "ToSend": false,
  "Numbers": ["xyz789"],
  "DownloadedBy": ["UNDEFINED"],
  "DocumentTypes": ["VAT"],
  "IssuerNames": ["abc123"],
  "IssuerNips": ["abc123"],
  "RecipientNames": ["xyz789"],
  "RecipientNips": ["abc123"],
  "GrossValue": NumberRangeSchemaModelOfDecimalInput,
  "NetValue": NumberRangeSchemaModelOfDecimalInput,
  "VatValue": NumberRangeSchemaModelOfDecimalInput,
  "DateOfIssue": DateRangeSchemaModelInput,
  "KsefDate": DateRangeSchemaModelInput,
  "KsefNumbers": ["xyz789"],
  "KSeFStatuses": ["NOT_SENT"],
  "ReadyForPosting": true,
  "ToAccept": false,
  "InvoicePostingStatuses": ["DECREE_SENT"],
  "RegistrationNumbers": ["xyz789"],
  "InvoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ]
}

FormaPlatnosci

Description

Formy płatności na fakturze

Values
Enum Value Description

GOTOWKA

gotówka

KARTA

karta

BON

bon

CZEK

czek

KREDYT

kredyt

PRZELEW

przelew

MOBILNA

mobilna
Example
"GOTOWKA"

GTU

Description

Kody GTU

Values
Enum Value Description

GTU_01

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. a rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_02

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. b rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_03

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. c rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_04

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. d rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_05

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. e rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_06

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. f rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_07

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. g rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_08

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. h rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_09

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. i rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_10

Dostawa towarów, o których mowa w § 10 ust. 3 pkt 1 lit. j rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_11

Świadczenie usług, o których mowa w § 10 ust. 3 pkt 2 lit. a rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_12

Świadczenie usług, o których mowa w § 10 ust. 3 pkt 2 lit. b rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

GTU_13

Świadczenie usług, o których mowa w § 10 ust. 3 pkt 2 lit. c rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług
Example
"GTU_01"

GetCompanyStatisticsResponse

Description

Dane zawierające statystyki faktur we wszystkich firmach w organizacji

Fields
Field Name Description
TenantAssignments - [TenantAssignmentViewModel] Organizacje
TotalTenantsCount - Long! Liczba organizacji do których przypisany jest bieżący użytkownik
TotalCompanysCount - Long! Liczba firm w bieżącej organizacji
Example
{
  "TenantAssignments": [TenantAssignmentViewModel],
  "TotalTenantsCount": {},
  "TotalCompanysCount": {}
}

GetCurrentSchemaVersionResponse

Description

Wynik operacji pobrania aktualnych wersji schemy faktury KSeF Ministerstwa Finansów

Fields
Field Name Description
SchemaVersion - [KsefXsdVersion!] Lista aktualnych wersji schemy KSeF
Example
{"SchemaVersion": ["V12648"]}

GetEArchiveNotificationsResponse

Description

Wynik operacji pobrania listy obsługiwanych typów notyfikacji e-mailowych

Fields
Field Name Description
Notifications - [EArchiveNotificationType!] Lista typów notyfikacji e-mailowych
Example
{"Notifications": ["NONE"]}

GetInvoiceFileContentActionGroupType

Description

Faktury zbiorcze PDF w archiwum ZIP.

Fields
Field Name Description
ZipName - String Nazwa archiwum ZIP
ZipContent - String Tablica bajtów Archiwum ZIP
MimeType - String Typ pliku
Example
{
  "ZipName": "xyz789",
  "ZipContent": "abc123",
  "MimeType": "xyz789"
}

GetInvoiceFileContentSingleType

Description

Faktura w formacie HTML oraz PDF

Fields
Field Name Description
PdfName - String! Nazwa pliku pdf
PdfContent - String! Tablica bajtów pliku pdf
HtmlContent - String! Widok HTML faktury
MimeType - String! Typ pliku
Example
{
  "PdfName": "xyz789",
  "PdfContent": "xyz789",
  "HtmlContent": "xyz789",
  "MimeType": "xyz789"
}

GetInvoicesExtendedSegment

Fields
Field Name Description
Items - [InvoiceDto!] Lista znalezionych obiektów faktur
TotalCount - Long Ilość znalezionych obiektów faktur z podziałem na zakupowe / sprzedażowe oraz wysłane / do wysłania
FilteredCount - Long Ilość znalezionych obiektów faktów wg. zadanych filtrów z puli TotalCount
Example
{
  "Items": [InvoiceDto],
  "TotalCount": {},
  "FilteredCount": {}
}

GetInvoicesSegment

Fields
Field Name Description
Items - [InvoiceDto!] Lista znalezionych obiektów faktur
TotalCount - Long Ilość znalezionych obiektów faktur z podziałem na zakupowe / sprzedażowe oraz wysłane / do wysłania
FilteredCount - Long Ilość znalezionych obiektów faktur wg zadanych filtrów z puli TotalCount
Example
{
  "Items": [InvoiceDto],
  "TotalCount": {},
  "FilteredCount": {}
}

GetMissedWebsocketSubscriptionsResponse

Description

Status operacji

Fields
Field Name Description
Success - Boolean! true - jeżeli proces uruchomiono pomyślnie
Example
{"Success": true}

GetPackageStatisticSegment

Description

Dane zawierające statystyki pakietów w organizacji

Fields
Field Name Description
Items - [Package!]! Lista pakietów w ramach subskrypcji
Status - SubscriptionStatus Status subskrypcji
CurrentInvoicesCount - Int Liczba wykonanych operacji na fakturach w organizacji
CurrentStorageCount - Decimal Ilość zajętego miejsca przez faktury w organizacji
SerialNumber - String Numer seryjny subskrypcji
SubscriptionNumber - String Numer subskrypcji
CustomerNumber - String Numer klienta
Email - String Adres email administratora zamawiającego subskrypcję
DateTo - Date! Data obowiązywania subskrypcji
Example
{
  "Items": [Package],
  "Status": "INACTIVE",
  "CurrentInvoicesCount": 123,
  "CurrentStorageCount": Decimal,
  "SerialNumber": "xyz789",
  "SubscriptionNumber": "abc123",
  "CustomerNumber": "abc123",
  "Email": "abc123",
  "DateTo": "2007-12-03"
}

GetPermissionsKSeFResponseType

Fields
Field Name Description
FromKsef - Boolean! True - dane pobrane z KSeF, false - dane z cache
LastUpdated - DateTime Ostatnia aktualizacja danych z cache
Credentials - [Credential!]! Lista uprawnień
TotalCount - Long! Suma rekordów
FilteredCount - Long! Liczba pobranych rekordów
Example
{
  "FromKsef": true,
  "LastUpdated": "2007-12-03T10:15:30Z",
  "Credentials": [Credential],
  "TotalCount": {},
  "FilteredCount": {}
}

GetUserKSeFRequestForCredentialsResponseType

Fields
Field Name Description
RequestedCredentials - [RequestedCredential!]! Lista procesowanych uprawnień
TotalCount - Long! Suma rekordów
FilteredCount - Long! Liczba pobranych rekordów
Example
{
  "RequestedCredentials": [RequestedCredential],
  "TotalCount": {},
  "FilteredCount": {}
}

GetWebsocketNotificationModelExtendedResponse

Description

Model odpowiedzi WebSocket

Fields
Field Name Description
UserId - UUID! Identyfikator użytkownika
CompanyId - UUID! Id firmy której notyfikacja dotyczy
ErrorType - WebsocketErrorType Typ błędu
ErrorContent - [KeyValuePairOfStringAndString!] Detale błędu
Message - String Treść wiadomości
Type - WebsocketNotificationType! Typ notyfikacji
NotificationId - UUID! Id notyfikacji
Timestamp - DateTime! Znacznik czasu notyfikacji
Visited - Boolean! Znacznik odczytania notyfikacji
HasDownloadableContent - Boolean! Czy notyfikacja zawiera treść do pobrania
ResponseJson - String Obiekt odpowiedzi w formacie JSON
ResponseModel - ResponseModel Obiekt odpowiedzi
State - SubscriptionStateEnum! Status notyfikacji
SimultaneousRunType - WebsocketSimultaneousRunType! Typ uruchomienia zadania
Example
{
  "UserId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "ErrorType": "SYSTEM",
  "ErrorContent": [KeyValuePairOfStringAndString],
  "Message": "abc123",
  "Type": "AUTHORIZE_IN_KSEF",
  "NotificationId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Timestamp": "2007-12-03T10:15:30Z",
  "Visited": false,
  "HasDownloadableContent": true,
  "ResponseJson": "xyz789",
  "ResponseModel": ResponseModel,
  "State": "ENQUEUED",
  "SimultaneousRunType": "SEQUENTIAL"
}

GetWebsocketNotificationModelResponse

Description

Model odpowiedzi WebSocket

Fields
Field Name Description
UserId - UUID! Identyfikator użytkownika
CompanyId - UUID! Id firmy której notyfikacja dotyczy
ErrorType - WebsocketErrorType Typ błędu
ErrorContent - [KeyValuePairOfStringAndString!] Detale błędu
Message - String Treść wiadomości
Type - WebsocketNotificationType! Typ notyfikacji
NotificationId - UUID! Id notyfikacji
Timestamp - DateTime! Znacznik czasu notyfikacji
Visited - Boolean! Znacznik odczytania notyfikacji
HasDownloadableContent - Boolean! Czy notyfikacja zawiera treść do pobrania
ResponseJson - String Obiekt odpowiedzi w formacie JSON
State - SubscriptionStateEnum! Status notyfikacji
SimultaneousRunType - WebsocketSimultaneousRunType! Typ uruchomienia zadania
Example
{
  "UserId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "ErrorType": "SYSTEM",
  "ErrorContent": [KeyValuePairOfStringAndString],
  "Message": "xyz789",
  "Type": "AUTHORIZE_IN_KSEF",
  "NotificationId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Timestamp": "2007-12-03T10:15:30Z",
  "Visited": false,
  "HasDownloadableContent": true,
  "ResponseJson": "abc123",
  "State": "ENQUEUED",
  "SimultaneousRunType": "SEQUENTIAL"
}

GetWebsocketNotificationResponse

Description

Status operacji

Fields
Field Name Description
WebsocketNotification - [WebsocketNotificationModel] Lista powiadomień zadanego typu
Example
{"WebsocketNotification": [WebsocketNotificationModel]}

IdentifierType

Description

Numer identyfikacji ewidencyjnej/podatkowej

Values
Enum Value Description

NIP

Numer NIP

PESEL

Numer PESEL
Example
"NIP"

IdentifierTypeOperationFilterInput

Fields
Input Field Description
eq - IdentifierType
neq - IdentifierType
in - [IdentifierType!]
nin - [IdentifierType!]
Example
{"eq": "NIP", "neq": "NIP", "in": ["NIP"], "nin": ["NIP"]}

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example
987

IntOperationFilterInput

Fields
Input Field Description
eq - Int
neq - Int
in - [Int]
nin - [Int]
gt - Int
ngt - Int
gte - Int
ngte - Int
lt - Int
nlt - Int
lte - Int
nlte - Int
Example
{
  "eq": 987,
  "neq": 123,
  "in": [987],
  "nin": [987],
  "gt": 987,
  "ngt": 123,
  "gte": 123,
  "ngte": 987,
  "lt": 123,
  "nlt": 123,
  "lte": 987,
  "nlte": 987
}

Invoice

Description

Rekord faktury

Fields
Field Name Description
CompanyId - UUID! Id firmy
Number - String Numer faktury
DocumentType - RodzajFaktury! Rodzaj faktury
DateOfIssue - DateTime! Data wystawienia
ShortDateOfIssue - Date! Skrócona data wystawienia
DestinationSystem - String System docelowy
FileName - String Nazwa pliku XML zawierająca fakturę w schemacie obsługiwanym przez KSeF
FileSize - Long! Rozmiar pliku XML w bajtach
InvoiceBound - InvoiceBound! Rodzaj faktury powiązanej
IssuerName - String Nazwa sprzedawcy
IssuerNip - String Numer NIP sprzedawcy
RecipientName - String Nazwa nabywcy
RecipientNip - String Numer NIP nabywcy
NetValue - Decimal Wartość faktury netto
VatValue - Decimal Wartość VAT faktury
GrossValue - Decimal! Wartość faktury brutto
KsefDate - DateTime Data wysłania do KSeF
ShortKsefDate - Date Skrócona data wysłania do KSeF
KsefNumber - String Numer nadany fakturze przez KSeF
KSeFSessionReferenceNumber - String Numer referencyjny sesji w KSeF podczas wysyłania faktury
KSeFElementReferenceNumber - String Numer referencyjny elementu w KSeF podczas wysyłania faktury
Downloaded - SymfoniaSystem Kod systemu Symfonii, który pobrał fakturę z Symfonia KSeF
KSeFStatus - KSeFStatus! Status dokumentu w systemie KSeF
KSeFStatusErrorDescription - String Opis błędu nadany przez system KSeF, o ile wystąpił
Owner - String Adres e-mail użytkownika, który zlecił wysyłkę faktury do KSeF
KSeFAuthUser - String W przypadku, kiedy Owner w momencie wysyłania faktury nie jest autoryzowany w KSeF, zostanie podjęta próba wysłania faktury za pomocą autoryzacji innego użytkownika, który posiada odpowiednie uprawnienia w KSeF do obsługi danej firmy, o ile taki użytkownik istnieje
InvoicePostingStatus - InvoicePostingStatus! Status dekretacji faktury.
RegistrationNumber - String Numer ewidencyjny faktury. Otrzymywany po wysłaniu faktury do Systemu Symfonia FK
SchemaVersion - KsefXsdVersion! Wersja schematu faktury KSeF
PageCount - Int! Liczba stron faktury OCR, w pozostałych przypadkach: 1
IsDecreeAccepted - Boolean! Czy dekret faktury jest zaakceptowany
AttachmentsCount - Int! Liczba załączników podpiętych pod fakturę
AttachmentsSize - Long! Rozmiar załączników w bajtach
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Number": "abc123",
  "DocumentType": "VAT",
  "DateOfIssue": "2007-12-03T10:15:30Z",
  "ShortDateOfIssue": "2007-12-03",
  "DestinationSystem": "abc123",
  "FileName": "xyz789",
  "FileSize": {},
  "InvoiceBound": "INTERNAL",
  "IssuerName": "abc123",
  "IssuerNip": "xyz789",
  "RecipientName": "xyz789",
  "RecipientNip": "abc123",
  "NetValue": Decimal,
  "VatValue": Decimal,
  "GrossValue": Decimal,
  "KsefDate": "2007-12-03T10:15:30Z",
  "ShortKsefDate": "2007-12-03",
  "KsefNumber": "xyz789",
  "KSeFSessionReferenceNumber": "xyz789",
  "KSeFElementReferenceNumber": "abc123",
  "Downloaded": "UNDEFINED",
  "KSeFStatus": "NOT_SENT",
  "KSeFStatusErrorDescription": "xyz789",
  "Owner": "abc123",
  "KSeFAuthUser": "xyz789",
  "InvoicePostingStatus": "DECREE_SENT",
  "RegistrationNumber": "xyz789",
  "SchemaVersion": "V12648",
  "PageCount": 123,
  "IsDecreeAccepted": false,
  "AttachmentsCount": 987,
  "AttachmentsSize": {},
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "abc123",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "abc123"
}

InvoiceBound

Description

Rodzaj faktury powiązanej

Values
Enum Value Description

INTERNAL

Faktura sprzedażowa

EXTERNAL

Faktura zakupowa
Example
"INTERNAL"

InvoiceBoundOperationFilterInput

Fields
Input Field Description
eq - InvoiceBound
neq - InvoiceBound
in - [InvoiceBound!]
nin - [InvoiceBound!]
Example
{"eq": "INTERNAL", "neq": "INTERNAL", "in": ["INTERNAL"], "nin": ["INTERNAL"]}

InvoiceDto

Fields
Field Name Description
CompanyId - UUID! Id firmy
Number - String Numer faktury
DocumentType - RodzajFaktury! Rodzaj faktury
DateOfIssue - DateTime! Data wystawienia
DestinationSystem - String System docelowy
FileName - String Nazwa pliku XML zawierająca fakturę w schemacie obsługiwanym przez KSeF
InvoiceBound - InvoiceBound! Rodzaj faktury powiązanej
IssuerName - String Nazwa sprzedawcy
IssuerNip - String Numer NIP sprzedawcy
RecipientName - String Nazwa nabywcy
RecipientNip - String Numer NIP nabywcy
GrossValue - Decimal! Wartość faktury brutto
NetValue - Decimal! Wartość faktury netto
VatValue - Decimal! Wartość podatku vat
KsefDate - DateTime Data wysłania do KSeF
KsefNumber - String Numer nadany fakturze przez KSeF
Downloaded - SymfoniaSystem Kod systemu Symfonii, który pobrał fakturę z Symfonia KSeF
KSeFStatus - KSeFStatus! Status dokumentu w systemie KSeF
KSeFStatusErrorDescription - String Opis błędu nadany przez system KSeF, o ile wystąpił
InvoicePostingStatus - InvoicePostingStatus! Status dekretacji faktury
IsDecreeAccepted - Boolean! Informacja na temat akceptacji dekretacji faktury
AttachmentsCount - Int! Liczba załączników dla faktury
RegistrationNumber - String Numer ewidencyjny faktury. Otrzymywany po wysłaniu faktury do Systemu Symfonia FK
CanDownloadUpo - Boolean! Określa czy dla tej faktury można pobrać UPO
SchemaVersion - KsefXsdVersion! Wersja schematu faktury KSeF
WhiteListStatus - WhiteListStatusDtoModel Wynik sprawdzenia rachunków bankowych kontrahenta na białej liście
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String Email użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String Email użytkownika, który zmodyfikował rekord
Example
{
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Number": "xyz789",
  "DocumentType": "VAT",
  "DateOfIssue": "2007-12-03T10:15:30Z",
  "DestinationSystem": "xyz789",
  "FileName": "xyz789",
  "InvoiceBound": "INTERNAL",
  "IssuerName": "abc123",
  "IssuerNip": "xyz789",
  "RecipientName": "abc123",
  "RecipientNip": "xyz789",
  "GrossValue": Decimal,
  "NetValue": Decimal,
  "VatValue": Decimal,
  "KsefDate": "2007-12-03T10:15:30Z",
  "KsefNumber": "xyz789",
  "Downloaded": "UNDEFINED",
  "KSeFStatus": "NOT_SENT",
  "KSeFStatusErrorDescription": "xyz789",
  "InvoicePostingStatus": "DECREE_SENT",
  "IsDecreeAccepted": true,
  "AttachmentsCount": 123,
  "RegistrationNumber": "abc123",
  "CanDownloadUpo": false,
  "SchemaVersion": "V12648",
  "WhiteListStatus": WhiteListStatusDtoModel,
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "xyz789",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "abc123"
}

InvoiceFilterInput

Description

Rekord faktury

Fields
Input Field Description
and - [InvoiceFilterInput!]
or - [InvoiceFilterInput!]
CompanyId - UuidOperationFilterInput Id firmy
Number - StringOperationFilterInput Numer faktury
DocumentType - RodzajFakturyOperationFilterInput Rodzaj faktury
DateOfIssue - DateTimeOperationFilterInput Data wystawienia
ShortDateOfIssue - DateOperationFilterInput Skrócona data wystawienia
DestinationSystem - StringOperationFilterInput System docelowy
FileName - StringOperationFilterInput Nazwa pliku XML zawierająca fakturę w schemacie obsługiwanym przez KSeF
FileSize - LongOperationFilterInput Rozmiar pliku XML w bajtach
InvoiceBound - InvoiceBoundOperationFilterInput Rodzaj faktury powiązanej
IssuerName - StringOperationFilterInput Nazwa sprzedawcy
IssuerNip - StringOperationFilterInput Numer NIP sprzedawcy
RecipientName - StringOperationFilterInput Nazwa nabywcy
RecipientNip - StringOperationFilterInput Numer NIP nabywcy
NetValue - DecimalOperationFilterInput Wartość faktury netto
VatValue - DecimalOperationFilterInput Wartość VAT faktury
GrossValue - DecimalOperationFilterInput Wartość faktury brutto
KsefDate - DateTimeOperationFilterInput Data wysłania do KSeF
ShortKsefDate - DateOperationFilterInput Skrócona data wysłania do KSeF
KsefNumber - StringOperationFilterInput Numer nadany fakturze przez KSeF
KSeFSessionReferenceNumber - StringOperationFilterInput Numer referencyjny sesji w KSeF podczas wysyłania faktury
KSeFElementReferenceNumber - StringOperationFilterInput Numer referencyjny elementu w KSeF podczas wysyłania faktury
Downloaded - NullableOfSymfoniaSystemOperationFilterInput Kod systemu Symfonii, który pobrał fakturę z Symfonia KSeF
KSeFStatus - KSeFStatusOperationFilterInput Status dokumentu w systemie KSeF
KSeFStatusErrorDescription - StringOperationFilterInput Opis błędu nadany przez system KSeF, o ile wystąpił
Owner - StringOperationFilterInput Adres e-mail użytkownika, który zlecił wysyłkę faktury do KSeF
KSeFAuthUser - StringOperationFilterInput W przypadku, kiedy Owner w momencie wysyłania faktury nie jest autoryzowany w KSeF, zostanie podjęta próba wysłania faktury za pomocą autoryzacji innego użytkownika, który posiada odpowiednie uprawnienia w KSeF do obsługi danej firmy, o ile taki użytkownik istnieje
RegistrationNumber - StringOperationFilterInput Numer ewidencyjny faktury. Otrzymywany po wysłaniu faktury do Systemu Symfonia FK
SchemaVersion - KsefXsdVersionOperationFilterInput Wersja schematu faktury KSeF
PageCount - IntOperationFilterInput Liczba stron faktury OCR, w pozostałych przypadkach: 1
IsDecreeAccepted - BooleanOperationFilterInput Czy dekret faktury jest zaakceptowany
AttachmentsCount - IntOperationFilterInput Liczba załączników podpiętych pod fakturę
AttachmentsSize - LongOperationFilterInput Rozmiar załączników w bajtach
Id - UuidOperationFilterInput Unikalny Id rekordu
CreatedAt - DateTimeOperationFilterInput Data utworzenia rekordu
CreatedBy - StringOperationFilterInput E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTimeOperationFilterInput Data modyfikacji rekordu
ModifiedBy - StringOperationFilterInput E-mail użytkownika, który zmodyfikował rekord
Example
{
  "and": [InvoiceFilterInput],
  "or": [InvoiceFilterInput],
  "CompanyId": UuidOperationFilterInput,
  "Number": StringOperationFilterInput,
  "DocumentType": RodzajFakturyOperationFilterInput,
  "DateOfIssue": DateTimeOperationFilterInput,
  "ShortDateOfIssue": DateOperationFilterInput,
  "DestinationSystem": StringOperationFilterInput,
  "FileName": StringOperationFilterInput,
  "FileSize": LongOperationFilterInput,
  "InvoiceBound": InvoiceBoundOperationFilterInput,
  "IssuerName": StringOperationFilterInput,
  "IssuerNip": StringOperationFilterInput,
  "RecipientName": StringOperationFilterInput,
  "RecipientNip": StringOperationFilterInput,
  "NetValue": DecimalOperationFilterInput,
  "VatValue": DecimalOperationFilterInput,
  "GrossValue": DecimalOperationFilterInput,
  "KsefDate": DateTimeOperationFilterInput,
  "ShortKsefDate": DateOperationFilterInput,
  "KsefNumber": StringOperationFilterInput,
  "KSeFSessionReferenceNumber": StringOperationFilterInput,
  "KSeFElementReferenceNumber": StringOperationFilterInput,
  "Downloaded": NullableOfSymfoniaSystemOperationFilterInput,
  "KSeFStatus": KSeFStatusOperationFilterInput,
  "KSeFStatusErrorDescription": StringOperationFilterInput,
  "Owner": StringOperationFilterInput,
  "KSeFAuthUser": StringOperationFilterInput,
  "RegistrationNumber": StringOperationFilterInput,
  "SchemaVersion": KsefXsdVersionOperationFilterInput,
  "PageCount": IntOperationFilterInput,
  "IsDecreeAccepted": BooleanOperationFilterInput,
  "AttachmentsCount": IntOperationFilterInput,
  "AttachmentsSize": LongOperationFilterInput,
  "Id": UuidOperationFilterInput,
  "CreatedAt": DateTimeOperationFilterInput,
  "CreatedBy": StringOperationFilterInput,
  "ModifiedAt": DateTimeOperationFilterInput,
  "ModifiedBy": StringOperationFilterInput
}

InvoiceNonRemovableReason

Description

Powód, dla którego faktura nie może zostać usunięta.

Values
Enum Value Description

NONE

Wartość domyślna.

NOT_OWNER

Dokument nie jest dodany przez aktualnego użytkownika.

WRONG_TYPE

Dokument nie jest plikiem typu: OCR.

WRONG_STATUS

Dokument posiada status w KSeF wykluczający usunięcie.

ALREADY_EXPORTED

Dokument został przesłany do systemów zewnętrznych.

SERVER_ERROR

Błąd podczas usuwania dokumentu.

NOT_FOUND

Dokument o podanym GUID nie został odnaleziony.
Example
"NONE"

InvoicePostingStatus

Description

Status zadekretowania faktury

Values
Enum Value Description

UNDEFINED

Wartość techniczna, nieprzeznaczona do użytku

READY_FOR_POSTING

Do dekretacji

POSTING

W trakcie

POSTED

Zadekretowano

DECREE_SENT

Wysyłanie do FK

DECREE_DOWNLOADED

Pobrano do FK

POSTING_INCOMPLETE

Częściowa dekretacja

POSTING_FAILED

Do ponownej dekretacji

NOT_ALLOWED

Brak
Example
DECREE_SENT

ItemsOrderInput

Description

Kolejność wyświetlania

Fields
Input Field Description
FieldName - String Nazwa pola
Direction - OrderDirection Kolejność
Example
{"FieldName": "abc123", "Direction": "ASC"}

KSeFAuthResult

Description

Status autoryzacji użytkownika w KSeF

Values
Enum Value Description

NOT_AUTHORIZED

Brak autoryzacji

AUTHORIZED

Użytkownik zautoryzowany (Szafir)

AUTHORIZED_WITH_EXTERNAL_TOKEN

Użytkownik zautoryzowany zewnętrznym tokenem

IN_PROGRESS

Rozpoczęty proces autoryzacji
Example
"NOT_AUTHORIZED"

KSeFAutoFetchingInvoicesResponseType

Description

Wynik operacji

Fields
Field Name Description
Success - Boolean! true - serwis aktywny
Example
{"Success": true}

KSeFAutoSendingInvoicesResponseType

Description

Wynik operacji

Fields
Field Name Description
Success - Boolean! true - serwis aktywny
Example
{"Success": false}

KSeFAutomaticOperationType

Description

Typ automatycznego wysyłania faktur

Values
Enum Value Description

TIME

Określona godzina

INTERVAL

Interwał czasowy
Example
"TIME"

KSeFCredentialState

Fields
Field Name Description
HasAny - Boolean!
HasInvoiceRead - Boolean!
HasInvoiceWrite - Boolean!
HasCredentialsRead - Boolean!
HasCredentialsManage - Boolean!
Example
{
  "HasAny": true,
  "HasInvoiceRead": false,
  "HasInvoiceWrite": false,
  "HasCredentialsRead": false,
  "HasCredentialsManage": true
}

KSeFIdentifierType

Description

Typ identyfikatora podmiotu w KSeF Ministerstwa Finans�w

Values
Enum Value Description

INSTITUTIONAL_NIP

Identyfikator instytucjonalny NIP (onip)

INDIVIDUAL_NIP

Identyfikator indywidualny NIP (nip)

PESEL

Identyfikator indywidualny PESEL (pesel)

CERTIFICATE_FINGERPRINT

Odcisk palca certyfikatu (fingerprint)

SYSTEM

Identyfikator instytucjonalny wewn�trzny (int)

AUTHORIZATION_TOKEN

Token autoryzacyjny
Example
"INSTITUTIONAL_NIP"

KSeFInvoiceXMLType

Description

Faktura w formacie XML

Fields
Field Name Description
Content - String Faktura XML
FileName - String Nazwa pliku XML
Example
{
  "Content": "abc123",
  "FileName": "abc123"
}

KSeFRequestForCredentialResultType

Description

Wynik operacji modyfikacji uprawnień

Values
Enum Value Description

NONE

Nie wykonano żadnej operacji

REVOKE

Odebranie uprawnień

GRANT

Nadanir uprawnień

EDIT

Edycja uprawnień
Example
"NONE"

KSeFRequestForCredentialType

Description

Typ żądania dotyczącego uprawnień

Values
Enum Value Description

UNDEFINED

Wartość serwisowa

REVOKE

Odwołanie uprawnienia

GRANT

Nadanie uprawnienia
Example
GRANT

KSeFRequestForCredentialsProcessingStatus

Description

Etapy procesu przetwarzania poświadczeń

Values
Enum Value Description

SANITY_CHECK

Weryfikacja poprawności i spójności danych

FINISHED

Poprawne zakończenie procesu

AUTHORISE

Autoryzacja procesu

SECURITY

Weryfikacja wyników podprocesu uwierzytelniania

PROCESS

Przetwarzanie poświadczeń

FINALIZE

Finalizacja i zakończenie procesu

ERROR1

Błąd weryfikacji poprawności i spójności danych

ERROR2

Błąd Autoryzacja procesu

ERROR3

Błąd weryfikacji wyników podprocesu uwierzytelniania

ERROR4

Błąd weryfikacji wyników podprocesu uwierzytelniania

ERROR5

Błąd przetwarzania poświadczeń

ERROR6

Błąd finalizacja i zakończenia procesu
Example
"SANITY_CHECK"

KSeFSessionStatusResponseType

Description

Informacja o aktualnym stanie sesji w KSeF

Fields
Field Name Description
Active - Boolean! Znacznik aktywnej sesji
ExpirationTime - DateTime Termin wygaśnięcia sesji
Example
{
  "Active": false,
  "ExpirationTime": "2007-12-03T10:15:30Z"
}

KSeFSignedType

Description

Sposób autoryzacji w KSeF MF

Values
Enum Value Description

SESSION_SIGNED

Autoryzacja podpisem

EXTERNAL_TOKEN

Autoryzacja tokenem
Example
"SESSION_SIGNED"

KSeFStatus

Description

Status faktur w KSeF

Values
Enum Value Description

NOT_SENT

Nie wysłana

SENDING

W trakcie wysyłki

PENDING

Przetwarzana

APPROVED

Zaakceptowana

REJECTED

Odrzucona

ERROR

Błąd

OCR

Faktura OCR, nie podlega wysyłce do KSeF

INTERRUPTED_PENDING

Przerwane sprawdzanie statusu faktur (brak autoryzacji)

INTERRUPTED_SENDING

Przerwane wysyłanie faktur (brak autoryzacji)
Example
"NOT_SENT"

KSeFStatusOperationFilterInput

Fields
Input Field Description
eq - KSeFStatus
neq - KSeFStatus
in - [KSeFStatus!]
nin - [KSeFStatus!]
Example
{"eq": "NOT_SENT", "neq": "NOT_SENT", "in": ["NOT_SENT"], "nin": ["NOT_SENT"]}

KeyValuePairOfStringAndString

Fields
Field Name Description
Key - String!
Value - String!
Example
{
  "Key": "xyz789",
  "Value": "abc123"
}

KeyValuePairOfStringAndStringInput

Fields
Input Field Description
Key - String!
Value - String!
Example
{
  "Key": "xyz789",
  "Value": "xyz789"
}

KodKraju

Description

Kody krajów używane w danych adresowych podmiotu na fakturze

Values
Enum Value Description

AF

AFGANISTAN

AX

ALAND ISLANDS

AL

ALBANIA

DZ

ALGIERIA

AD

ANDORA

AO

ANGOLA

AI

ANGUILLA

AQ

ANTARKTYDA

AG

ANTIGUA I BARBUDA

AN

ANTYLE HOLENDERSKIE

SA

ARABIA SAUDYJSKA

AR

ARGENTYNA

AM

ARMENIA

AW

ARUBA

AU

AUSTRALIA

AT

AUSTRIA

AZ

AZERBEJDŻAN

BS

BAHAMY

BH

BAHRAJN

BD

BANGLADESZ

BB

BARBADOS

BE

BELGIA

BZ

BELIZE

BJ

BENIN

BM

BERMUDY

BT

BHUTAN

BY

BIAŁORUŚ

BO

BOLIWIA

BQ

BONAIRE, SINT EUSTATIUS I SABA

BA

BOŚNIA I HERCEGOWINA

BW

BOTSWANA

BR

BRAZYLIA

BN

BRUNEI DARUSSALAM

IO

BRYTYJSKIE TERYTORIUM OCEANU INDYJSKIEGO

BG

BUŁGARIA

BF

BURKINA FASO

BI

BURUNDI

XC

CEUTA

CL

CHILE

CN

CHINY

HR

CHORWACJA

CW

CURAÇAO

CY

CYPR

TD

CZAD

ME

CZARNOGÓRA

DK

DANIA

DM

DOMINIKA

DO

DOMINIKANA

DJ

DŻIBUTI

EG

EGIPT

EC

EKWADOR

ER

ERYTREA

EE

ESTONIA

ET

ETIOPIA

FK

FALKLANDY

FJ

FIDŻI REPUBLIKA

PH

FILIPINY

FI

FINLANDIA

FR

FRANCJA

TF

FRANCUSKIE TERYTORIUM POŁUDNIOWE

GA

GABON

GM

GAMBIA

GH

GHANA

GI

GIBRALTAR

GR

GRECJA

GD

GRENADA

GL

GRENLANDIA

GE

GRUZJA

GU

GUAM

GG

GUERNSEY

GY

GUJANA

GF

GUJANA FRANCUSKA

GP

GWADELUPA

GT

GWATEMALA

GN

GWINEA

GQ

GWINEA RÓWNIKOWA

GW

GWINEA-BISSAU

HT

HAITI

ES

HISZPANIA

HN

HONDURAS

HK

HONGKONG

IN

INDIE

ID

INDONEZJA

IQ

IRAK

IR

IRAN

IE

IRLANDIA

IS

ISLANDIA

IL

IZRAEL

JM

JAMAJKA

JP

JAPONIA

YE

JEMEN

JE

JERSEY

JO

JORDANIA

KY

KAJMANY

KH

KAMBODŻA

CM

KAMERUN

CA

KANADA

QA

KATAR

KZ

KAZACHSTAN

KE

KENIA

KG

KIRGISTAN

KI

KIRIBATI

CO

KOLUMBIA

KM

KOMORY

CG

KONGO

CD

KONGO, REPUBLIKA DEMOKRATYCZNA

KP

KOREAŃSKA REPUBLIKA LUDOWO-DEMOKRATYCZNA

XK

KOSOWO

CR

KOSTARYKA

CU

KUBA

KW

KUWEJT

LA

LAOS

LS

LESOTHO

LB

LIBAN

LR

LIBERIA

LY

LIBIA

LI

LIECHTENSTEIN

LT

LITWA

LV

ŁOTWA

LU

LUKSEMBURG

MK

MACEDONIA

MG

MADAGASKAR

YT

MAJOTTA

MO

MAKAU

MW

MALAWI

MV

MALEDIWY

MY

MALEZJA

ML

MALI

MT

MALTA

MP

MARIANY PÓŁNOCNE

MA

MAROKO

MQ

MARTYNIKA

MR

MAURETANIA

MU

MAURITIUS

MX

MEKSYK

XL

MELILLA

FM

MIKRONEZJA

UM

MINOR

MD

MOŁDOWA

MC

MONAKO

MN

MONGOLIA

MS

MONTSERRAT

MZ

MOZAMBIK

MM

MYANMAR (BURMA)

NA

NAMIBIA

NR

NAURU

NP

NEPAL

NL

NIDERLANDY (HOLANDIA)

DE

NIEMCY

NE

NIGER

NG

NIGERIA

NI

NIKARAGUA

NU

NIUE

NF

NORFOLK

NO

NORWEGIA

NC

NOWA KALEDONIA

NZ

NOWA ZELANDIA

PS

OKUPOWANE TERYTORIUM PALESTYNY

OM

OMAN

PK

PAKISTAN

PW

PALAU

PA

PANAMA

PG

PAPUA NOWA GWINEA

PY

PARAGWAJ

PE

PERU

PN

PITCAIRN

PF

POLINEZJA FRANCUSKA

PL

POLSKA

GS

POŁUDNIOWA GEORGIA I POŁUD.WYSPY SANDWICH

PT

PORTUGALIA

PR

PORTORYKO

CF

REP.ŚRODKOWOAFRYKAŃSKA

CZ

REPUBLIKA CZESKA

KR

REPUBLIKA KOREI

ZA

REPUBLIKA POŁUDNIOWEJ AFRYKI

RE

REUNION

RU

ROSJA

RO

RUMUNIA

RW

RWANDA

EH

SAHARA ZACHODNIA

BL

SAINT BARTHELEMY

KN

SAINT KITTS I NEVIS

LC

SAINT LUCIA

MF

SAINT MARTIN

VC

SAINT VINCENT I GRENADYNY

SV

SALWADOR

WS

SAMOA

AS

SAMOA AMERYKAŃSKIE

SM

SAN MARINO

SN

SENEGAL

RS

SERBIA

SC

SESZELE

SL

SIERRA LEONE

SG

SINGAPUR

SK

SŁOWACJA

SI

SŁOWENIA

SO

SOMALIA

LK

SRI LANKA

PM

SAINT PIERRE I MIQUELON

US

STANY ZJEDNOCZONE AMERYKI

SZ

SUAZI

SD

SUDAN

SS

SUDAN POŁUDNIOWY

SR

SURINAM

SJ

SVALBARD I JAN MAYEN

SH

ŚWIĘTA HELENA

SY

SYRIA

CH

SZWAJCARIA

SE

SZWECJA

TJ

TADŻYKISTAN

TH

TAJLANDIA

TW

TAJWAN

TZ

TANZANIA

TG

TOGO

TK

TOKELAU

TO

TONGA

TT

TRYNIDAD I TOBAGO

TN

TUNEZJA

TR

TURCJA

TM

TURKMENISTAN

TV

TUVALU

UG

UGANDA

UA

UKRAINA

UY

URUGWAJ

UZ

UZBEKISTAN

VU

VANUATU

WF

WALLIS I FUTUNA

VA

WATYKAN

HU

WĘGRY

VE

WENEZUELA

GB

WIELKA BRYTANIA

VN

WIETNAM

IT

WŁOCHY

TL

WSCHODNI TIMOR

CI

WYBRZEŻE KOŚCI SŁONIOWEJ

BV

WYSPA BOUVETA

CX

WYSPA BOŻEGO NARODZENIA

IM

WYSPA MAN

SX

WYSPA SINT MAARTEN (CZĘŚĆ HOLENDERSKA WYSPY)

CK

WYSPY COOKA

VI

WYSPY DZIEWICZE-USA

VG

WYSPY DZIEWICZE-W.B.

HM

WYSPY HEARD I MCDONALD

CC

WYSPY KOKOSOWE (KEELINGA)

MH

WYSPY MARSHALLA

FO

WYSPY OWCZE

SB

WYSPY SALOMONA

ST

WYSPY ŚWIĘTEGO TOMASZA I KSIĄŻĘCA

TC

WYSPY TURKS I CAICOS

ZM

ZAMBIA

CV

ZIELONY PRZYLĄDEK

ZW

ZIMBABWE

AE

ZJEDNOCZONE EMIRATY ARABSKIE

XI

ZJEDNOCZONE KRÓLESTWO (IRLANDIA PÓŁNOCNA)
Example
PL

KodWaluty

Description

Słownik kodów krajów

Values
Enum Value Description

AED

DIRHAM ZEA

AFN

AFGANI

ALL

LEK

AMD

DRAM

ANG

GULDEN ANTYLI HOLENDERSKICH

AOA

KWANZA

ARS

PESO ARGENTYŃSKIE

AUD

DOLAR AUSTRALIJSKI

AWG

GULDEN ARUBAŃSKI

AZN

MANAT AZERBEJDŻAŃSKI

BAM

MARKA ZAMIENNA

BBD

DOLAR BARBADOSKI

BDT

TAKA

BGN

LEW

BHD

DINAR BAHRAJSKI

BIF

FRANK BURUNDYJSKI

BMD

DOLAR BERMUDZKI

BND

DOLAR BRUNEJSKI

BOB

BOLIWIANO

BOV

BOLIWIANO MVDOL

BRL

REAL

BSD

DOLAR BAHAMSKI

BTN

NGULTRUM

BWP

PULA

BYN

RUBEL BIAŁORUSKI

BZD

DOLAR BELIZEŃSKI

CAD

DOLAR KANADYJSKI

CDF

FRANK KONGIJSKI

CHE

FRANK SZWAJCARSKI VIR EURO

CHF

FRANK SZWAJCARSKI

CHW

FRANK SZWAJCARSKI VIR FRANK

CLF

JEDNOSTKA ROZLICZENIOWA CHILIJSKA

CLP

PESO CHILIJSKIE

CNY

YUAN RENMINBI

COP

PESO KOLUMBIJSKIE

COU

UNIDAD DE VALOR REAL KOLUMBILSKIE

CRC

COLON KOSTARYKAŃSKI

CUC

PESO WYMIENIALNE

CUP

PESO KUBAŃSKIE

CVE

ESCUDO REPUBLIKI ZIELONEGO PRZYLĄDKA

CZK

KORONA CZESKA

DJF

FRANK DŻIBUTI

DKK

KORONA DUŃSKA

DOP

PESO DOMINIKAŃSKIE

DZD

DINAR ALGIERSKI

EGP

FUNT EGIPSKI

ERN

NAKFA

ETB

BIRR

EUR

EURO

FJD

DOLAR FIDŻI

FKP

FUNT FALKLANDZKI

GBP

FUNT SZTERLING

GEL

LARI

GGP

FUNT GUERNSEY

GHS

GHANA CEDI

GIP

FUNT GIBRALTARSKI

GMD

DALASI

GNF

FRANK GWINEJSKI

GTQ

QUETZAL

GYD

DOLAR GUJAŃSKI

HKD

DOLAR HONGKONGU

HNL

LEMPIRA

HRK

KUNA

HTG

GOURDE

HUF

FORINT

IDR

RUPIA INDONEZYJSKA

ILS

SZEKEL

IMP

FUNT MANX

INR

RUPIA INDYJSKA

IQD

DINAR IRACKI

IRR

RIAL IRAŃSKI

ISK

KORONA ISLANDZKA

JEP

FUNT JERSEY

JMD

DOLAR JAMAJSKI

JOD

DINAR JORDAŃSKI

JPY

JEN

KES

SZYLING KENIJSKI

KGS

SOM

KHR

RIEL

KMF

FRANK KOMORÓW

KPW

WON PÓŁNOCNO­KOREAŃSKI

KRW

WON POŁUDNIOWO­KOREAŃSKI

KWD

DINAR KUWEJCKI

KYD

DOLAR KAJMAŃSKI

KZT

TENGE

LAK

KIP

LBP

FUNT LIBAŃSKI

LKR

RUPIA LANKIJSKA

LRD

DOLAR LIBERYJSKI

LSL

LOTI

LYD

DINAR LIBIJSKI

MAD

DIRHAM MAROKAŃSKI

MDL

LEJ MOŁDAWII

MGA

ARIARY

MKD

DENAR

MMK

KYAT

MNT

TUGRIK

MOP

PATACA

MRU

OUGUIYA

MUR

RUPIA MAURITIUSU

MVR

RUPIA MALEDIWSKA

MWK

KWACHA MALAWIJSKA

MXN

PESO MEKSYKAŃSKIE

MXV

UNIDAD DE INVERSION (UDI) MEKSYKAŃSKIE

MYR

RINGGIT

MZN

METICAL

NAD

DOLAR NAMIBIJSKI

NGN

NAIRA

NIO

CORDOBA ORO

NOK

KORONA NORWESKA

NPR

RUPIA NEPALSKA

NZD

DOLAR NOWOZELANDZKI

OMR

RIAL OMAŃSKI

PAB

BALBOA

PEN

SOL

PGK

KINA

PHP

PESO FILIPIŃSKIE

PKR

RUPIA PAKISTAŃSKA

PLN

ZŁOTY

PYG

GUARANI

QAR

RIAL KATARSKI

RON

LEJ RUMUŃSKI

RSD

DINAR SERBSKI

RUB

RUBEL ROSYJSKI

RWF

FRANK RWANDYJSKI

SAR

RIAL SAUDYJSKI

SBD

DOLAR WYSP SALOMONA

SCR

RUPIA SESZELSKA

SDG

FUNT SUDAŃSKI

SEK

KORONA SZWEDZKA

SGD

DOLAR SINGAPURSKI

SHP

FUNT ŚWIĘTEJ HELENY (ŚWIĘTA HELENA I WYSPA WNIEBOWSTĄPIENIA)

SLL

LEONE

SOS

SZYLING SOMALIJSKI

SRD

DOLAR SURINAMSKI

SSP

FUNT POŁUDNIOWOSUDAŃSKI

STN

DOBRA

SVC

COLON SALWADORSKI (SV1)

SYP

FUNT SYRYJSKI

SZL

LILANGENI

THB

BAT

TJS

SOMONI

TMT

MANAT TURKMEŃSKI

TND

DINAR TUNEZYJSKI

TOP

PAANGA

TRY

LIRA TURECKA

TTD

DOLAR TRYNIDADU I TOBAGO

TWD

NOWY DOLAR TAJWAŃSKI

TZS

SZYLING TANZAŃSKI

UAH

HRYWNA

UGX

SZYLING UGANDYJSKI

USD

DOLAR AMERYKAŃSKI

USN

DOLAR AMERYKAŃSKI (NEXT DAY)

UYI

PESO EN UNIDADES INDEXADAS URUGWAJSKIE

UYU

PESO URUGWAJSKIE

UYW

PESO EN UNIDADES INDEXADAS URUGWAJSKIE

UZS

SUM

VES

BOLIWAR SOBERANO

VND

DONG

VUV

VATU

WST

TALA

XAF

FRANK CFA (BEAC)

XAG

SREBRO

XAU

ZŁOTO

XBA

BOND MARKETS UNIT EUROPEAN COMPOSITE UNIT (EURCO)

XBB

BOND MARKETS UNIT EUROPEAN MONETARY UNIT (E.M.U.-6)

XBC

BOND MARKETS UNIT EUROPEAN UNIT OF ACCOUNT 9 (E.U.A.-9)

XBD

BOND MARKETS UNIT EUROPEAN UNIT OF ACCOUNT 17 (E.U.A.-17)

XCD

DOLAR WSCHODNIO­KARAIBSKI

XDR

SDR MIĘDZYNARODOWY FUNDUSZ WALUTOWY

XOF

FRANK CFA (BCEAO)

XPD

PALLAD

XPF

FRANK CFP

XPT

PLATYNA

XSU

SUCRE SISTEMA UNITARIO DE COMPENSACION REGIONAL DE PAGOS SUCRE

XUA

ADB UNIT OF ACCOUNT MEMBER COUNTRIES OF THE AFRICAN DEVELOPMENT BANK GROUP

XXX

BRAK WALUTY

YER

RIAL JEMEŃSKI

ZAR

RAND

ZMW

KWACHA ZAMBIJSKA

ZWL

DOLAR ZIMBABWE
Example
PLN

Korekta

Description

Korekta do faktury, obowiązkowa dla typów faktury KOR, KOR_ZAL lub KOR_ROZ

Fields
Field Name Description
PrzyczynaKorekty - String Przyczyna korekty dla faktur korygujących
TypKorekty - TypKorekty Typ skutku korekty w ewidencji
FaKorygowana - [DaneFaKorygowanej!]! Lista faktur korygowanych
OkresFaKorygowanej - String Dla faktury korygującej, o której mowa w art. 106j ust. 3 ustawy - okres, do którego odnosi się udzielany opust lub obniżka, w przypadku gdy podatnik udziela opustu lub obniżki ceny w odniesieniu do dostaw towarów lub usług dokonanych lub świadczonych na rzecz jednego odbiorcy w danym okresie
NrFaKorygowany - String Poprawny numer faktury korygowanej w przypadku, gdy przyczyną korekty jest błędny numer faktury korygowanej. W polu NrFaKorygowanej należy wówczas wskazać ten błędny numer
Sprzedawca - Podmiot Sprzedawca
Nabywca - Podmiot Nabywca
Example
{
  "PrzyczynaKorekty": "xyz789",
  "TypKorekty": "TYP1",
  "FaKorygowana": [DaneFaKorygowanej],
  "OkresFaKorygowanej": "abc123",
  "NrFaKorygowany": "xyz789",
  "Sprzedawca": Podmiot,
  "Nabywca": Podmiot
}

KorektaInput

Description

Korekta do faktury, obowiązkowa dla typów faktury KOR, KOR_ZAL lub KOR_ROZ

Fields
Input Field Description
PrzyczynaKorekty - String Przyczyna korekty dla faktur korygujących
TypKorekty - TypKorekty Typ skutku korekty w ewidencji
FaKorygowana - [DaneFaKorygowanejInput!]! Lista faktur korygowanych
OkresFaKorygowanej - String Dla faktury korygującej, o której mowa w art. 106j ust. 3 ustawy - okres, do którego odnosi się udzielany opust lub obniżka, w przypadku gdy podatnik udziela opustu lub obniżki ceny w odniesieniu do dostaw towarów lub usług dokonanych lub świadczonych na rzecz jednego odbiorcy w danym okresie
NrFaKorygowany - String Poprawny numer faktury korygowanej w przypadku, gdy przyczyną korekty jest błędny numer faktury korygowanej. W polu NrFaKorygowanej należy wówczas wskazać ten błędny numer
Sprzedawca - PodmiotInput Sprzedawca
Nabywca - PodmiotInput Nabywca
Example
{
  "PrzyczynaKorekty": "xyz789",
  "TypKorekty": "TYP1",
  "FaKorygowana": [DaneFaKorygowanejInput],
  "OkresFaKorygowanej": "xyz789",
  "NrFaKorygowany": "abc123",
  "Sprzedawca": PodmiotInput,
  "Nabywca": PodmiotInput
}

KorektaV2

Description

Obiekt Korekty

Fields
Field Name Description
Sprzedawca - PodmiotV2 Sprzedawca
Nabywca - PodmiotV2 Nabywca
KursWalutyKorektyFakturyZaliczkowej - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w Dziale VI ustawy przed korektą. Typ wykorzystywany do określenia ilości. Wartość numeryczna 22 znaki max, w tym 6 po przecinku. Total number of digits: 22. Total number of digits in fraction: 6. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,6})?.
KwotaPrzedKorektaFakturyZaliczkowej - Decimal W przypadku korekt faktur zaliczkowych, kwota zapłaty przed korektą. W przypadku korekt faktur, o których mowa w art. 106f ust. 3 ustawy, kwota pozostała do zapłaty przed korektą. Wartość numeryczna 18 znaków max, w tym 2 znaki po przecinku. Total number of digits: 18. Total number of digits in fraction: 2. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,2})?.
PrzyczynaKorekty - String Przyczyna korekty dla faktur korygujących
TypKorekty - TypKorekty Typ skutku korekty w ewidencji
FaKorygowana - [DaneFaKorygowanej!]! Lista faktur korygowanych
OkresFaKorygowanej - String Dla faktury korygującej, o której mowa w art. 106j ust. 3 ustawy - okres, do którego odnosi się udzielany opust lub obniżka, w przypadku gdy podatnik udziela opustu lub obniżki ceny w odniesieniu do dostaw towarów lub usług dokonanych lub świadczonych na rzecz jednego odbiorcy w danym okresie
NrFaKorygowany - String Poprawny numer faktury korygowanej w przypadku, gdy przyczyną korekty jest błędny numer faktury korygowanej. W polu NrFaKorygowanej należy wówczas wskazać ten błędny numer
Example
{
  "Sprzedawca": PodmiotV2,
  "Nabywca": PodmiotV2,
  "KursWalutyKorektyFakturyZaliczkowej": Decimal,
  "KwotaPrzedKorektaFakturyZaliczkowej": Decimal,
  "PrzyczynaKorekty": "abc123",
  "TypKorekty": "TYP1",
  "FaKorygowana": [DaneFaKorygowanej],
  "OkresFaKorygowanej": "xyz789",
  "NrFaKorygowany": "xyz789"
}

KorektaV2Input

Description

Obiekt Korekty

Fields
Input Field Description
Sprzedawca - PodmiotV2Input Sprzedawca
Nabywca - PodmiotV2Input Nabywca
KursWalutyKorektyFakturyZaliczkowej - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w Dziale VI ustawy przed korektą. Typ wykorzystywany do określenia ilości. Wartość numeryczna 22 znaki max, w tym 6 po przecinku. Total number of digits: 22. Total number of digits in fraction: 6. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,6})?.
KwotaPrzedKorektaFakturyZaliczkowej - Decimal W przypadku korekt faktur zaliczkowych, kwota zapłaty przed korektą. W przypadku korekt faktur, o których mowa w art. 106f ust. 3 ustawy, kwota pozostała do zapłaty przed korektą. Wartość numeryczna 18 znaków max, w tym 2 znaki po przecinku. Total number of digits: 18. Total number of digits in fraction: 2. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,2})?.
PrzyczynaKorekty - String Przyczyna korekty dla faktur korygujących
TypKorekty - TypKorekty Typ skutku korekty w ewidencji
FaKorygowana - [DaneFaKorygowanejInput!]! Lista faktur korygowanych
OkresFaKorygowanej - String Dla faktury korygującej, o której mowa w art. 106j ust. 3 ustawy - okres, do którego odnosi się udzielany opust lub obniżka, w przypadku gdy podatnik udziela opustu lub obniżki ceny w odniesieniu do dostaw towarów lub usług dokonanych lub świadczonych na rzecz jednego odbiorcy w danym okresie
NrFaKorygowany - String Poprawny numer faktury korygowanej w przypadku, gdy przyczyną korekty jest błędny numer faktury korygowanej. W polu NrFaKorygowanej należy wówczas wskazać ten błędny numer
Example
{
  "Sprzedawca": PodmiotV2Input,
  "Nabywca": PodmiotV2Input,
  "KursWalutyKorektyFakturyZaliczkowej": Decimal,
  "KwotaPrzedKorektaFakturyZaliczkowej": Decimal,
  "PrzyczynaKorekty": "xyz789",
  "TypKorekty": "TYP1",
  "FaKorygowana": [DaneFaKorygowanejInput],
  "OkresFaKorygowanej": "abc123",
  "NrFaKorygowany": "xyz789"
}

KsefXsdVersion

Description

Contains Ksef invoice versions.

Values
Enum Value Description

UNDEFINED

Wartość serwisowa

V11089

Wersja FA(1)

V12648

Wersja FA(2)
Example
V12648

KsefXsdVersionOperationFilterInput

Fields
Input Field Description
eq - KsefXsdVersion
neq - KsefXsdVersion
in - [KsefXsdVersion!]
nin - [KsefXsdVersion!]
Example
{"eq": "V12648", "neq": "V12648", "in": ["V12648"], "nin": ["V12648"]}

Ladunek

Description

Rodzaje ładunku

Values
Enum Value Description

BANKA

Bańka

BECZKA

Beczka

BUTLA

Butla

KARTON

Karton

KANISTER

Kanister

KLATKA

Klatka

KONTENER

Kontener

KOSZ

Kosz/koszyk

LUBIANKA

Łubianka

OPAKOWANIE_ZBIORCZE

Opakowanie zbiorcze

PACZKA

Paczka

PAKIET

Pakiet

PALETA

Paleta

POJEMNIK

Pojemnik

POJEMNIK_DO_LADUNKOW_STALYCH

Pojemnik do ładunków masowych stałych

POJEMNIK_DO_LADUNKOW_PLYNNYCH

Pojemnik do ładunków masowych w postaci płynnej

PUDELKO

Pudełko

PUSZKA

Puszka

SKRZYNIA

Skrzynia

WOREK

Worek
Example
"BANKA"

ListFilterInputTypeOfCompanyFilterInput

Fields
Input Field Description
all - CompanyFilterInput
none - CompanyFilterInput
some - CompanyFilterInput
any - Boolean
Example
{
  "all": CompanyFilterInput,
  "none": CompanyFilterInput,
  "some": CompanyFilterInput,
  "any": false
}

ListFilterInputTypeOfRoleAssignmentFilterInput

Fields
Input Field Description
all - RoleAssignmentFilterInput
none - RoleAssignmentFilterInput
some - RoleAssignmentFilterInput
any - Boolean
Example
{
  "all": RoleAssignmentFilterInput,
  "none": RoleAssignmentFilterInput,
  "some": RoleAssignmentFilterInput,
  "any": false
}

ListFilterInputTypeOfUserFilterInput

Fields
Input Field Description
all - UserFilterInput
none - UserFilterInput
some - UserFilterInput
any - Boolean
Example
{
  "all": UserFilterInput,
  "none": UserFilterInput,
  "some": UserFilterInput,
  "any": true
}

ListInvoicesResponseType

Description

Wynik operacji pobrania listy faktur

Fields
Field Name Description
Items - [Invoice!] Lista faktur
Example
{"Items": [Invoice]}

Long

Description

The Long scalar type represents non-fractional signed whole 64-bit numeric values. Long can represent values between -(2^63) and 2^63 - 1.

Example
{}

LongOperationFilterInput

Fields
Input Field Description
eq - Long
neq - Long
in - [Long]
nin - [Long]
gt - Long
ngt - Long
gte - Long
ngte - Long
lt - Long
nlt - Long
lte - Long
nlte - Long
Example
{
  "eq": {},
  "neq": {},
  "in": [{}],
  "nin": [{}],
  "gt": {},
  "ngt": {},
  "gte": {},
  "ngte": {},
  "lt": {},
  "nlt": {},
  "lte": {},
  "nlte": {}
}

MissedInvoice

Description

Informacja o brakującej fakturze

Fields
Field Name Description
InvoiceId - UUID! Id faktury
InvoiceNumber - String Numer faktury
Reason - UpoMissingInvoiceReason! Powód dla którego UPO nie zostało pobrane
Example
{
  "InvoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "InvoiceNumber": "abc123",
  "Reason": "NOT_EXISTS"
}

MissedInvoices

Description

Rekord brakującej faktury

Fields
Field Name Description
invoiceId - UUID! Id faktury
invoiceNumber - String Numer faktury
reason - UpoMissingInvoiceReason! Powód braku
Example
{
  "invoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "invoiceNumber": "xyz789",
  "reason": "NOT_EXISTS"
}

MultipleSendToKSeFResponseType

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

MyEnvironmentsViewModelResponse

Description

Właściwości środowisk dla bieżącego użytkownika

Fields
Field Name Description
Environments - [EnvironmentViewModel] Lista właściwości środowisk
Example
{"Environments": [EnvironmentViewModel]}

Naglowek

Description

Nagłówek faktury

Fields
Field Name Description
RodzajFaktury - RodzajFaktury Rodzaj faktury
DataWystawienia - DateTime! Data wystawienia, z zastrzeżeniem art. 106na ust. 1 ustawy
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się w przypadku, gdy dla wszystkich pozycji faktury data jest wspólna
KodWaluty - KodWaluty Trzyliterowy kod waluty (ISO-4217) w przypadkach, o których mowa w art. 31a ustawy
MiejsceWystaw - String Miejsce wystawienia faktury
Numer - String Kolejny numer faktury, nadany w ramach jednej lub więcej serii, który w sposób jednoznaczny identyfikuje fakturę
WZ - [String!] Numery dokumentów magazynowych WZ (wydanie na zewnątrz) związane z fakturą
KwotaBrutto - Decimal! Kwota należności ogółem. W przypadku faktur zaliczkowych kwota zapłaty dokumentowana fakturą. W przypadku faktur, o których mowa w art. 106f ust. 3 ustawy kwota pozostała do zapłaty. W przypadku faktur korygujących korekta kwoty wynikającej z faktury korygowanej. W przypadku, o którym mowa w art. 106j ust. 3 ustawy korekta kwot wynikających z faktur korygowanych.
FP - Boolean! Faktura do paragonu
TP - Boolean! Istniejące powiązania między nabywcą a dokonującym dostawy towarów lub usługodawcą
DodatkowyOpis - [KeyValuePairOfStringAndString!] Pola rezerwowe przeznaczone dla wykazywania dodatkowych informacji na fakturze, w tym wymaganych przepisami prawa, dla których nie przewidziano innych pól/elementów
NrFaZaliczkowej - [String!] Pole obowiązkowe dla faktury wystawianej po wydaniu towaru lub wykonaniu usługi, o której mowa w art. 106f ust. 3 i ostatniej z faktur, o której mowa w art. 106f ust. 4 ustawy
Example
{
  "RodzajFaktury": "VAT",
  "DataWystawienia": "2007-12-03T10:15:30Z",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "KodWaluty": "PLN",
  "MiejsceWystaw": "xyz789",
  "Numer": "xyz789",
  "WZ": ["xyz789"],
  "KwotaBrutto": Decimal,
  "FP": true,
  "TP": true,
  "DodatkowyOpis": [KeyValuePairOfStringAndString],
  "NrFaZaliczkowej": ["abc123"]
}

NaglowekInput

Description

Nagłówek faktury

Fields
Input Field Description
RodzajFaktury - RodzajFaktury Rodzaj faktury
DataWystawienia - DateTime! Data wystawienia, z zastrzeżeniem art. 106na ust. 1 ustawy
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się w przypadku, gdy dla wszystkich pozycji faktury data jest wspólna
KodWaluty - KodWaluty Trzyliterowy kod waluty (ISO-4217) w przypadkach, o których mowa w art. 31a ustawy
MiejsceWystaw - String Miejsce wystawienia faktury
Numer - String Kolejny numer faktury, nadany w ramach jednej lub więcej serii, który w sposób jednoznaczny identyfikuje fakturę
WZ - [String!] Numery dokumentów magazynowych WZ (wydanie na zewnątrz) związane z fakturą
KwotaBrutto - Decimal! Kwota należności ogółem. W przypadku faktur zaliczkowych kwota zapłaty dokumentowana fakturą. W przypadku faktur, o których mowa w art. 106f ust. 3 ustawy kwota pozostała do zapłaty. W przypadku faktur korygujących korekta kwoty wynikającej z faktury korygowanej. W przypadku, o którym mowa w art. 106j ust. 3 ustawy korekta kwot wynikających z faktur korygowanych.
FP - Boolean! Faktura do paragonu
TP - Boolean! Istniejące powiązania między nabywcą a dokonującym dostawy towarów lub usługodawcą
DodatkowyOpis - [KeyValuePairOfStringAndStringInput!] Pola rezerwowe przeznaczone dla wykazywania dodatkowych informacji na fakturze, w tym wymaganych przepisami prawa, dla których nie przewidziano innych pól/elementów
NrFaZaliczkowej - [String!] Pole obowiązkowe dla faktury wystawianej po wydaniu towaru lub wykonaniu usługi, o której mowa w art. 106f ust. 3 i ostatniej z faktur, o której mowa w art. 106f ust. 4 ustawy
Example
{
  "RodzajFaktury": "VAT",
  "DataWystawienia": "2007-12-03T10:15:30Z",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "KodWaluty": "PLN",
  "MiejsceWystaw": "abc123",
  "Numer": "xyz789",
  "WZ": ["abc123"],
  "KwotaBrutto": Decimal,
  "FP": true,
  "TP": true,
  "DodatkowyOpis": [KeyValuePairOfStringAndStringInput],
  "NrFaZaliczkowej": ["abc123"]
}

NaglowekV2

Description

Nagłówek faktury

Fields
Field Name Description
RodzajFaktury - RodzajFaktury Rodzaj faktury
DataWystawienia - DateTime! Data wystawienia, z zastrzeżeniem art. 106na ust. 1 ustawy
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się w przypadku, gdy dla wszystkich pozycji faktury data jest wspólna
KodWaluty - KodWaluty Trzyliterowy kod waluty (ISO-4217) w przypadkach, o których mowa w art. 31a ustawy
MiejsceWystaw - String Miejsce wystawienia faktury
Numer - String Kolejny numer faktury, nadany w ramach jednej lub więcej serii, który w sposób jednoznaczny identyfikuje fakturę
WZ - [String!] Numery dokumentów magazynowych WZ (wydanie na zewnątrz) związane z fakturą
KwotaBrutto - Decimal! Kwota należności ogółem. W przypadku faktur zaliczkowych kwota zapłaty dokumentowana fakturą. W przypadku faktur, o których mowa w art. 106f ust. 3 ustawy kwota pozostała do zapłaty. W przypadku faktur korygujących korekta kwoty wynikającej z faktury korygowanej. W przypadku, o którym mowa w art. 106j ust. 3 ustawy korekta kwot wynikających z faktur korygowanych.
KwotaNetto - Decimal Suma wartości sprzedaży netto ze stawką podstawową - aktualnie 23% albo 22%. W przypadku faktur zaliczkowych, kwota zaliczki netto. W przypadku faktur korygujących, kwota różnicy, o której mowa w art. 106j ust. 2 pkt 5 ustawy
KwotaVat - Decimal Kwota podatku od sumy wartości sprzedaży netto objętej stawką podstawową - aktualnie 23% albo 22%. W przypadku faktur zaliczkowych, kwota podatku wyliczona według wzoru, o którym mowa w art. 106f ust. 1 pkt 3 ustawy. W przypadku faktur korygujących, kwota różnicy, o której mowa w art. 106j ust. 2 pkt 5 ustawy
FP - Boolean! Faktura do paragonu
TP - Boolean! Istniejące powiązania między nabywcą a dokonującym dostawy towarów lub usługodawcą
DodatkowyOpis - [DodatkowyOpisPolaV2!] Pola rezerwowe przeznaczone dla wykazywania dodatkowych informacji na fakturze, w tym wymaganych przepisami prawa, dla których nie przewidziano innych pól/elementów
FakturaZaliczkowa - [FakturaZaliczkowaV2!] Numery faktur zaliczkowych lub ich numery KSeF, jeśli zostały wystawione z użyciem KSeF
KursWalutyZaliczka - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w przepisach Działu VI ustawy na fakturach, o których mowa w art. 106b ust. 1 pkt 4 ustawy Typ wykorzystywany do określenia ilości. Wartość numeryczna 22 znaki max, w tym 6 po przecinku Total number of digits: 22. Total number of digits in fraction: 6. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,6})?.
OkresFaktury - ZakresDatV2 Okres, którego dotyczy faktura w przypadkach, o których mowa w art. 19a ust. 3 zdanie pierwsze i ust. 4 oraz ust. 5 pkt 4 ustawy
ZwrotAkcyzy - Boolean Informacja dodatkowa niezbędna dla rolników ubiegających się o zwrot podatku akcyzowego zawartego w cenie oleju napędowego
ZaliczkaCzesciowa - [ZaliczkaCzesciowaV2!] Dane dla przypadków faktur dokumentujących otrzymanie więcej niż jednej płatności, o której mowa w art. 106b ust. 1 pkt 4 ustawy. W przypadku, gdy faktura, o której mowa w art. 106f ust. 3 ustawy dokumentuje jednocześnie otrzymanie części zapłaty przed dokonaniem czynności, różnica kwoty w polu P_15 i sumy poszczególnych pól P_15Z stanowi kwotę pozostałą ponad płatności otrzymane przed wykonaniem czynności udokumentowanej fakturą
Example
{
  "RodzajFaktury": "VAT",
  "DataWystawienia": "2007-12-03T10:15:30Z",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "KodWaluty": "PLN",
  "MiejsceWystaw": "xyz789",
  "Numer": "abc123",
  "WZ": ["abc123"],
  "KwotaBrutto": Decimal,
  "KwotaNetto": Decimal,
  "KwotaVat": Decimal,
  "FP": true,
  "TP": true,
  "DodatkowyOpis": [DodatkowyOpisPolaV2],
  "FakturaZaliczkowa": [FakturaZaliczkowaV2],
  "KursWalutyZaliczka": Decimal,
  "OkresFaktury": ZakresDatV2,
  "ZwrotAkcyzy": true,
  "ZaliczkaCzesciowa": [ZaliczkaCzesciowaV2]
}

NaglowekV2Input

Description

Nagłówek faktury

Fields
Input Field Description
RodzajFaktury - RodzajFaktury Rodzaj faktury
DataWystawienia - DateTime! Data wystawienia, z zastrzeżeniem art. 106na ust. 1 ustawy
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się w przypadku, gdy dla wszystkich pozycji faktury data jest wspólna
KodWaluty - KodWaluty Trzyliterowy kod waluty (ISO-4217) w przypadkach, o których mowa w art. 31a ustawy
MiejsceWystaw - String Miejsce wystawienia faktury
Numer - String Kolejny numer faktury, nadany w ramach jednej lub więcej serii, który w sposób jednoznaczny identyfikuje fakturę
WZ - [String!] Numery dokumentów magazynowych WZ (wydanie na zewnątrz) związane z fakturą
KwotaBrutto - Decimal! Kwota należności ogółem. W przypadku faktur zaliczkowych kwota zapłaty dokumentowana fakturą. W przypadku faktur, o których mowa w art. 106f ust. 3 ustawy kwota pozostała do zapłaty. W przypadku faktur korygujących korekta kwoty wynikającej z faktury korygowanej. W przypadku, o którym mowa w art. 106j ust. 3 ustawy korekta kwot wynikających z faktur korygowanych.
KwotaNetto - Decimal Suma wartości sprzedaży netto ze stawką podstawową - aktualnie 23% albo 22%. W przypadku faktur zaliczkowych, kwota zaliczki netto. W przypadku faktur korygujących, kwota różnicy, o której mowa w art. 106j ust. 2 pkt 5 ustawy
KwotaVat - Decimal Kwota podatku od sumy wartości sprzedaży netto objętej stawką podstawową - aktualnie 23% albo 22%. W przypadku faktur zaliczkowych, kwota podatku wyliczona według wzoru, o którym mowa w art. 106f ust. 1 pkt 3 ustawy. W przypadku faktur korygujących, kwota różnicy, o której mowa w art. 106j ust. 2 pkt 5 ustawy
FP - Boolean! Faktura do paragonu
TP - Boolean! Istniejące powiązania między nabywcą a dokonującym dostawy towarów lub usługodawcą
DodatkowyOpis - [DodatkowyOpisPolaV2Input!] Pola rezerwowe przeznaczone dla wykazywania dodatkowych informacji na fakturze, w tym wymaganych przepisami prawa, dla których nie przewidziano innych pól/elementów
FakturaZaliczkowa - [FakturaZaliczkowaV2Input!] Numery faktur zaliczkowych lub ich numery KSeF, jeśli zostały wystawione z użyciem KSeF
KursWalutyZaliczka - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w przepisach Działu VI ustawy na fakturach, o których mowa w art. 106b ust. 1 pkt 4 ustawy Typ wykorzystywany do określenia ilości. Wartość numeryczna 22 znaki max, w tym 6 po przecinku Total number of digits: 22. Total number of digits in fraction: 6. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,6})?.
OkresFaktury - ZakresDatV2Input Okres, którego dotyczy faktura w przypadkach, o których mowa w art. 19a ust. 3 zdanie pierwsze i ust. 4 oraz ust. 5 pkt 4 ustawy
ZwrotAkcyzy - Boolean Informacja dodatkowa niezbędna dla rolników ubiegających się o zwrot podatku akcyzowego zawartego w cenie oleju napędowego
ZaliczkaCzesciowa - [ZaliczkaCzesciowaV2Input!] Dane dla przypadków faktur dokumentujących otrzymanie więcej niż jednej płatności, o której mowa w art. 106b ust. 1 pkt 4 ustawy. W przypadku, gdy faktura, o której mowa w art. 106f ust. 3 ustawy dokumentuje jednocześnie otrzymanie części zapłaty przed dokonaniem czynności, różnica kwoty w polu P_15 i sumy poszczególnych pól P_15Z stanowi kwotę pozostałą ponad płatności otrzymane przed wykonaniem czynności udokumentowanej fakturą
Example
{
  "RodzajFaktury": "VAT",
  "DataWystawienia": "2007-12-03T10:15:30Z",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "KodWaluty": "PLN",
  "MiejsceWystaw": "xyz789",
  "Numer": "abc123",
  "WZ": ["abc123"],
  "KwotaBrutto": Decimal,
  "KwotaNetto": Decimal,
  "KwotaVat": Decimal,
  "FP": true,
  "TP": false,
  "DodatkowyOpis": [DodatkowyOpisPolaV2Input],
  "FakturaZaliczkowa": [FakturaZaliczkowaV2Input],
  "KursWalutyZaliczka": Decimal,
  "OkresFaktury": ZakresDatV2Input,
  "ZwrotAkcyzy": true,
  "ZaliczkaCzesciowa": [ZaliczkaCzesciowaV2Input]
}

NotEligibleDeleteInvoices

Fields
Field Name Description
invoiceId - UUID!
invoiceNumber - String
invoiceDate - DateTime
reason - InvoiceNonRemovableReason!
Example
{
  "invoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "invoiceNumber": "xyz789",
  "invoiceDate": "2007-12-03T10:15:30Z",
  "reason": "NONE"
}

NullableOfSymfoniaSystemOperationFilterInput

Fields
Input Field Description
eq - SymfoniaSystem
neq - SymfoniaSystem
in - [SymfoniaSystem]
nin - [SymfoniaSystem]
Example
{
  "eq": "UNDEFINED",
  "neq": "UNDEFINED",
  "in": ["UNDEFINED"],
  "nin": ["UNDEFINED"]
}

NumberRangeSchemaModelOfDecimalInput

Fields
Input Field Description
From - Decimal
To - Decimal
Example
{"From": Decimal, "To": Decimal}

Obciazenie

Description

Obciążenie na fakturze

Fields
Field Name Description
KwotaObciazenia - Decimal! Kwota doliczona do kwoty wykazanej w polu KwotaBrutto
PowodObciazenia - String Powód obciążenia
Example
{
  "KwotaObciazenia": Decimal,
  "PowodObciazenia": "xyz789"
}

ObciazenieInput

Description

Obciążenie na fakturze

Fields
Input Field Description
KwotaObciazenia - Decimal! Kwota doliczona do kwoty wykazanej w polu KwotaBrutto
PowodObciazenia - String Powód obciążenia
Example
{
  "KwotaObciazenia": Decimal,
  "PowodObciazenia": "xyz789"
}

Odliczenie

Description

Odliczenie na fakturze

Fields
Field Name Description
KwotaOdliczenia - Decimal! Kwota odliczona od kwoty wykazanej w polu KwotaBrutto
PowodOdliczenia - String Powód odliczenia
Example
{
  "KwotaOdliczenia": Decimal,
  "PowodOdliczenia": "abc123"
}

OdliczenieInput

Description

Odliczenie na fakturze

Fields
Input Field Description
KwotaOdliczenia - Decimal! Kwota odliczona od kwoty wykazanej w polu KwotaBrutto
PowodOdliczenia - String Powód odliczenia
Example
{
  "KwotaOdliczenia": Decimal,
  "PowodOdliczenia": "xyz789"
}

OnAuthorizedInKSeFResultUserMessage

Description

Wynik próby autoryzacji w KSeF

Fields
Field Name Description
result - KSeFAuthResult! Obecny status autoryzacji
Example
{"result": "NOT_AUTHORIZED"}

OnCredentialOperationResultUserMessage

Description

Operacja nadania/usunięcia uprawnienia

Fields
Field Name Description
referenceNumber - String Numer referencyjny nadany przez KSeF
requestType - KSeFRequestForCredentialType! Typ pojedynczej operacji
success - Boolean! Wynik wykonania operacji nadania uprawnień w KSeF
status - KSeFRequestForCredentialsProcessingStatus! Status operacji w KSeF
description - String Opis wyniku operacji
Example
{
  "referenceNumber": "abc123",
  "requestType": "GRANT",
  "success": true,
  "status": "SANITY_CHECK",
  "description": "abc123"
}

OnDeleteInvoicesResultUserMessage

Fields
Field Name Description
deleted - Int! Liczba prawidłowo usuniętych faktur
errorItems - [NotEligibleDeleteInvoices] Lista faktur, które nie zostały usunięte.
invoicesId - [UUID!] Lista ID faktur, które zostały przekazane do usunięcia.
Example
{
  "deleted": 987,
  "errorItems": [NotEligibleDeleteInvoices],
  "invoicesId": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ]
}

OnDownloadInvoicesResultUserMessage

Description

Informacja o rezultacie operacji pobrania faktur z KSeF

Fields
Field Name Description
imported - Int! Liczba pobranych faktur
errorItems - [DownloadInvoiceItemMessage] Lista błędnych faktur
successItems - [DownloadInvoiceItemMessage] Lista prawidłowych faktur
internalEnabled - Boolean! Pobieranie faktur sprzedażowych
internal - DateTimeRange Zlecony zakres dat dla faktur sprzedażowych
externalEnabled - Boolean! Pobieranie faktur sprzedażowych
external - DateTimeRange Zlecony zakres dat dla faktur zakupowych
state - DownloadStateUserMessage! Stan procesu pobierania faktur
pendingTimeInSeconds - Int! Liczba sekund po którym skończy się state Pending
stateTime - DateTime! Czas ustawienia nowego stanu (state)
refreshNeeded - Boolean! Określa czy potrzebne jest odświeżenie widoku faktur
Example
{
  "imported": 987,
  "errorItems": [DownloadInvoiceItemMessage],
  "successItems": [DownloadInvoiceItemMessage],
  "internalEnabled": true,
  "internal": DateTimeRange,
  "externalEnabled": false,
  "external": DateTimeRange,
  "state": "PENDING",
  "pendingTimeInSeconds": 123,
  "stateTime": "2007-12-03T10:15:30Z",
  "refreshNeeded": false
}

OnGetUPOResultUserMessage

Description

Wynik pobrania UPO

Fields
Field Name Description
missingInvoices - [MissedInvoices] Lista brakujących faktur
fileName - String Nazwa pliku
fileContent - String Zawartość pliku
mimeType - String Typ MIME
requestedInvoices - [UUID!] Liczba wnioskowanych faktur
returnedInvoices - [UUID!] Liczba odebranych faktur
fileType - UpoFileType! Typ pliku
Example
{
  "missingInvoices": [MissedInvoices],
  "fileName": "abc123",
  "fileContent": "xyz789",
  "mimeType": "abc123",
  "requestedInvoices": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "returnedInvoices": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "fileType": "PDF"
}

OnGetWhiteListItemsStatusUserMessage

Description

Negatywny wynik dekretacji faktur

Fields
Field Name Description
invoiceIds - [UUID!] Lista Id faktur zleconych do sprawdzenia rechunków na białej liście
whiteListed - [WhiteListItem] Liczba sprawdzanych faktur
notWhiteListed - [WhiteListItem] Lista faktur nie będących na białej liście
errorItems - [WhiteListItem] Lista faktur których nie udało sie sprawdzić serwisie
date - DateTime! Zlecona data realizacji sprawdzenia statusów na białej liście
Example
{
  "invoiceIds": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "whiteListed": [WhiteListItem],
  "notWhiteListed": [WhiteListItem],
  "errorItems": [WhiteListItem],
  "date": "2007-12-03T10:15:30Z"
}

OnGrantKSeFPermissionsResultUserMessage

Description

Wynik operacji nadania/usunięcia uprawnień

Fields
Field Name Description
identifier - String Identyfikator podatkowy
identifierType - IdentifierType! Typ identyfikatora
completed - Boolean! True, kiedy wszystkie operacje w zestawie zostały ukończone
operationType - KSeFRequestForCredentialResultType! Typ operacji dla grupy uprawnień
permissionList - [OnCredentialOperationResultUserMessage!]! Lista operacji
Example
{
  "identifier": "xyz789",
  "identifierType": "NIP",
  "completed": true,
  "operationType": "NONE",
  "permissionList": [
    OnCredentialOperationResultUserMessage
  ]
}

OnOcrInvoiceImportedUserMessage

Description

Wynik zmiany statusu dekretacji faktur

Fields
Field Name Description
invoiceId - UUID! Numer faktury OCR
Example
{
  "invoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}

OnPostInvoicesFailedUserMessage

Description

Negatywny wynik dekretacji faktur

Fields
Field Name Description
invoiceNumbers - [String] Numery faktur
Example
{"invoiceNumbers": ["xyz789"]}

OnSendingInvoicesResultUserMessage

Description

Informacja o rezultacie operacji wysyłania faktur do KSeF

Fields
Field Name Description
invoices - [SendingInvoiceItemMessage] Lista faktur
Example
{"invoices": [SendingInvoiceItemMessage]}

OnTerminateKSeFSessionResultUserMessage

Description

Operacja rozłączenia sesji w KSeF

Fields
Field Name Description
result - Boolean! Wynik operacji rozłączenia sesji w KSeF
Example
{"result": true}

OnUnauthorizedKSeFResultUserMessage

Description

Informacja o statusie wyłączenia autoryzacji w KSeF

Fields
Field Name Description
authorizedUserFound - Boolean Flaga informująca o znalezieniu innego użytkownika z aktywną autoryzacją w kontekście firmy
interruptedPendingCount - Int! Liczba wstrzymanych faktur w statusie Oczekująca
interruptedSendingCount - Int! Liczba wstrzymanych faktur w statusie Do wysłania
env - EnvironmentWithUser Środowisko użytkownika
credentials - KSeFCredentialState Uprawnienia użytkownika
isUnauthorized - Boolean! Wynik wyłączenia autoryzacji w KSeF
signedType - KSeFSignedType! Sposób autoryzacji
Example
{
  "authorizedUserFound": false,
  "interruptedPendingCount": 123,
  "interruptedSendingCount": 987,
  "env": EnvironmentWithUser,
  "credentials": KSeFCredentialState,
  "isUnauthorized": false,
  "signedType": "SESSION_SIGNED"
}

OnUploadInvoicesResultUserMessage

Description

Operacja rozłączenia sesji w KSeF

Fields
Field Name Description
successItems - [UploadInvoicesResultItem] Lista elementów zakończonych powodzeniem
errorItems - [UploadInvoicesResultItem] Lista elementów zakończonych niepowodzeniem
Example
{
  "successItems": [UploadInvoicesResultItem],
  "errorItems": [UploadInvoicesResultItem]
}

OrderDirection

Description

Kolejność sortowania

Values
Enum Value Description

ASC

Rosnąco

DESC

Malejąco
Example
"ASC"

OznaczenieProcedury

Description

Oznaczenia dotyczące procedur dla faktur

Values
Enum Value Description

WSTO_EE

Oznaczenie dotyczące procedury, o której mowa § 10 ust. 4 pkt 2a rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

IED

Oznaczenie dotyczące procedury, o której mowa § 10 ust. 4 pkt 2b rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

TT_D

Oznaczenie dotyczące procedury, o której mowa § 10 ust. 4 pkt 5 rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

I_42

Oznaczenie dotyczące procedury, o której mowa § 10 ust. 4 pkt 8 rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

I_63

Oznaczenie dotyczące procedury, o której mowa § 10 ust. 4 pkt 9 rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

B_SPV

Oznaczenie dotyczące procedury, o której mowa § 10 ust. 4 pkt 10 rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

B_SPV_DOSTAWA

Oznaczenie dotyczące procedury, o której mowa § 10 ust. 4 pkt 11 rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług

B_MPV_PROWIZJA

Oznaczenie dotyczące procedury, o której mowa § 10 ust. 4 pkt 12 rozporządzenia w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług
Example
"WSTO_EE"

Package

Description

Pakiet subskrypcji

Fields
Field Name Description
PackageTypeEnum - PackageType! Typ pakietu
PackageValue - String! Wartość pakietu np.: liczba GB bądź liczba faktur lub inna usługa
PackageDescription - String Opis pakietu
Subscription - Subscription! Obiekt subskrypcji
SubscriptionId - UUID! Identyfikator subskrypcji
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "PackageTypeEnum": "STORAGE",
  "PackageValue": "abc123",
  "PackageDescription": "xyz789",
  "Subscription": Subscription,
  "SubscriptionId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "xyz789",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "xyz789"
}

PackageType

Description

Typ pakietu

Values
Enum Value Description

STORAGE

Limit miejsca

INVOICE

Limit faktur

SERVICE

Dodatkowe usługi
Example
"STORAGE"

Platnosc

Description

Dane płatności na fakturze

Fields
Field Name Description
Zaplacono - Boolean! Znacznik informujący, że kwota należności wynikająca z faktury została zapłacona
DataZaplaty - DateTime Data zapłaty, jeśli do wystawienia faktury płatność została dokonana
FormaPlatnosci - FormaPlatnosci Forma płatności
PlatnoscInna - Boolean! Znacznik innej formy płatności: inna forma płatności
OpisPlatnosci - String Doprecyzowanie innej formy płatności
ZaplataCzesciowa - [TZaplataCzesciowa!] Lista zapłat częściowych
RachunekBankowy - [TRachunekBankowy!] Lista numerów rachunków bankowych
RachunekBankowyFaktora - [TRachunekBankowy!] Lista numerów rachunków bankowych faktora
TerminPlatnosci - [TTerminPlatnosci!] Lista terminów płatności
Example
{
  "Zaplacono": true,
  "DataZaplaty": "2007-12-03T10:15:30Z",
  "FormaPlatnosci": "GOTOWKA",
  "PlatnoscInna": true,
  "OpisPlatnosci": "xyz789",
  "ZaplataCzesciowa": [TZaplataCzesciowa],
  "RachunekBankowy": [TRachunekBankowy],
  "RachunekBankowyFaktora": [TRachunekBankowy],
  "TerminPlatnosci": [TTerminPlatnosci]
}

PlatnoscInput

Description

Dane płatności na fakturze

Fields
Input Field Description
Zaplacono - Boolean! Znacznik informujący, że kwota należności wynikająca z faktury została zapłacona
DataZaplaty - DateTime Data zapłaty, jeśli do wystawienia faktury płatność została dokonana
FormaPlatnosci - FormaPlatnosci Forma płatności
PlatnoscInna - Boolean! Znacznik innej formy płatności: inna forma płatności
OpisPlatnosci - String Doprecyzowanie innej formy płatności
ZaplataCzesciowa - [TZaplataCzesciowaInput!] Lista zapłat częściowych
RachunekBankowy - [TRachunekBankowyInput!] Lista numerów rachunków bankowych
RachunekBankowyFaktora - [TRachunekBankowyInput!] Lista numerów rachunków bankowych faktora
TerminPlatnosci - [TTerminPlatnosciInput!] Lista terminów płatności
Example
{
  "Zaplacono": false,
  "DataZaplaty": "2007-12-03T10:15:30Z",
  "FormaPlatnosci": "GOTOWKA",
  "PlatnoscInna": true,
  "OpisPlatnosci": "xyz789",
  "ZaplataCzesciowa": [TZaplataCzesciowaInput],
  "RachunekBankowy": [TRachunekBankowyInput],
  "RachunekBankowyFaktora": [TRachunekBankowyInput],
  "TerminPlatnosci": [TTerminPlatnosciInput]
}

PlatnoscV2

Description

Element Płatność

Fields
Field Name Description
RachunekBankowy - [TRachunekBankowyV2!] Lista numerów rachunków bankowych
RachunekBankowyFaktora - [TRachunekBankowyV2!] Lista numerów rachunków bankowych faktora
Skonto - TSkontoV2 Skonto
ZnacznikZaplatyCzesciowej - Boolean! Znacznik informujący, że kwota należności wynikająca z faktury została zapłacona w części: 1 - zapłacono w części
Zaplacono - Boolean! Znacznik informujący, że kwota należności wynikająca z faktury została zapłacona
DataZaplaty - DateTime Data zapłaty, jeśli do wystawienia faktury płatność została dokonana
FormaPlatnosci - FormaPlatnosci Forma płatności
PlatnoscInna - Boolean! Znacznik innej formy płatności: inna forma płatności
OpisPlatnosci - String Doprecyzowanie innej formy płatności
ZaplataCzesciowa - [TZaplataCzesciowa!] Lista zapłat częściowych
TerminPlatnosci - [TTerminPlatnosci!] Lista terminów płatności
Example
{
  "RachunekBankowy": [TRachunekBankowyV2],
  "RachunekBankowyFaktora": [TRachunekBankowyV2],
  "Skonto": TSkontoV2,
  "ZnacznikZaplatyCzesciowej": true,
  "Zaplacono": true,
  "DataZaplaty": "2007-12-03T10:15:30Z",
  "FormaPlatnosci": "GOTOWKA",
  "PlatnoscInna": false,
  "OpisPlatnosci": "xyz789",
  "ZaplataCzesciowa": [TZaplataCzesciowa],
  "TerminPlatnosci": [TTerminPlatnosci]
}

PlatnoscV2Input

Description

Element Płatność

Fields
Input Field Description
RachunekBankowy - [TRachunekBankowyV2Input!] Lista numerów rachunków bankowych
RachunekBankowyFaktora - [TRachunekBankowyV2Input!] Lista numerów rachunków bankowych faktora
Skonto - TSkontoV2Input Skonto
ZnacznikZaplatyCzesciowej - Boolean! Znacznik informujący, że kwota należności wynikająca z faktury została zapłacona w części: 1 - zapłacono w części
Zaplacono - Boolean! Znacznik informujący, że kwota należności wynikająca z faktury została zapłacona
DataZaplaty - DateTime Data zapłaty, jeśli do wystawienia faktury płatność została dokonana
FormaPlatnosci - FormaPlatnosci Forma płatności
PlatnoscInna - Boolean! Znacznik innej formy płatności: inna forma płatności
OpisPlatnosci - String Doprecyzowanie innej formy płatności
ZaplataCzesciowa - [TZaplataCzesciowaInput!] Lista zapłat częściowych
TerminPlatnosci - [TTerminPlatnosciInput!] Lista terminów płatności
Example
{
  "RachunekBankowy": [TRachunekBankowyV2Input],
  "RachunekBankowyFaktora": [TRachunekBankowyV2Input],
  "Skonto": TSkontoV2Input,
  "ZnacznikZaplatyCzesciowej": true,
  "Zaplacono": false,
  "DataZaplaty": "2007-12-03T10:15:30Z",
  "FormaPlatnosci": "GOTOWKA",
  "PlatnoscInna": true,
  "OpisPlatnosci": "xyz789",
  "ZaplataCzesciowa": [TZaplataCzesciowaInput],
  "TerminPlatnosci": [TTerminPlatnosciInput]
}

Podmiot

Description

Dane teleadresowe podatnika

Fields
Field Name Description
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjne! Dane identyfikacyjne
Adres - Adres Adres
AdresKoresp - Adres Adres korespondencyjny
Email - String Adres email
Telefon - String Numer telefonu
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnika Status podatnika
Example
{
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjne,
  "Adres": Adres,
  "AdresKoresp": Adres,
  "Email": "abc123",
  "Telefon": "xyz789",
  "NrKlienta": "abc123",
  "StatusPodatnika": TStatusPodatnika
}

PodmiotInput

Description

Dane teleadresowe podatnika

Fields
Input Field Description
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjneInput! Dane identyfikacyjne
Adres - AdresInput Adres
AdresKoresp - AdresInput Adres korespondencyjny
Email - String Adres email
Telefon - String Numer telefonu
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaInput Status podatnika
Example
{
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneInput,
  "Adres": AdresInput,
  "AdresKoresp": AdresInput,
  "Email": "abc123",
  "Telefon": "abc123",
  "NrKlienta": "xyz789",
  "StatusPodatnika": TStatusPodatnikaInput
}

PodmiotUpowazniony

Description

Podmiot upoważniony widniejący na fakturze

Fields
Field Name Description
Rola - RolaPodmiotuUpowaznionego! Rola podmiotu
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjne! Dane identyfikacyjne
Adres - Adres Adres
AdresKoresp - Adres Adres korespondencyjny
Email - String Adres email
Telefon - String Numer telefonu
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnika Status podatnika
Example
{
  "Rola": "ITEM1",
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjne,
  "Adres": Adres,
  "AdresKoresp": Adres,
  "Email": "abc123",
  "Telefon": "xyz789",
  "NrKlienta": "abc123",
  "StatusPodatnika": TStatusPodatnika
}

PodmiotUpowaznionyInput

Description

Podmiot upoważniony widniejący na fakturze

Fields
Input Field Description
Rola - RolaPodmiotuUpowaznionego! Rola podmiotu
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjneInput! Dane identyfikacyjne
Adres - AdresInput Adres
AdresKoresp - AdresInput Adres korespondencyjny
Email - String Adres email
Telefon - String Numer telefonu
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaInput Status podatnika
Example
{
  "Rola": "ITEM1",
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneInput,
  "Adres": AdresInput,
  "AdresKoresp": AdresInput,
  "Email": "abc123",
  "Telefon": "abc123",
  "NrKlienta": "xyz789",
  "StatusPodatnika": TStatusPodatnikaInput
}

PodmiotUpowaznionyV2

Description

Podmiot upoważniony widniejący na fakturze

Fields
Field Name Description
Rola - RolaPodmiotuUpowaznionego! Rola podmiotu
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjneV2! Dane identyfikacyjne
Adres - AdresV2 Adres
AdresKoresp - AdresV2 Adres korespondencyjny
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaV2 Status podatnika
IDNabywcy - String Unikalny klucz powiązania danych nabywcy na fakturach korygujących, w przypadku gdy dane nabywcy na fakturze korygującej zmieniły się w stosunku do danych na fakturze korygowanej
DaneKontaktowe - [TDaneKontaktoweV2!] Dane kontaktowe
Example
{
  "Rola": "ITEM1",
  "PrefixPodatnika": "AT",
  "NrEORI": "abc123",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneV2,
  "Adres": AdresV2,
  "AdresKoresp": AdresV2,
  "NrKlienta": "abc123",
  "StatusPodatnika": TStatusPodatnikaV2,
  "IDNabywcy": "xyz789",
  "DaneKontaktowe": [TDaneKontaktoweV2]
}

PodmiotUpowaznionyV2Input

Description

Podmiot upoważniony widniejący na fakturze

Fields
Input Field Description
Rola - RolaPodmiotuUpowaznionego! Rola podmiotu
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjneV2Input! Dane identyfikacyjne
Adres - AdresV2Input Adres
AdresKoresp - AdresV2Input Adres korespondencyjny
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaV2Input Status podatnika
IDNabywcy - String Unikalny klucz powiązania danych nabywcy na fakturach korygujących, w przypadku gdy dane nabywcy na fakturze korygującej zmieniły się w stosunku do danych na fakturze korygowanej
DaneKontaktowe - [TDaneKontaktoweV2Input!] Dane kontaktowe
Example
{
  "Rola": "ITEM1",
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneV2Input,
  "Adres": AdresV2Input,
  "AdresKoresp": AdresV2Input,
  "NrKlienta": "xyz789",
  "StatusPodatnika": TStatusPodatnikaV2Input,
  "IDNabywcy": "abc123",
  "DaneKontaktowe": [TDaneKontaktoweV2Input]
}

PodmiotV2

Description

Dane teleadresowe podatnika

Fields
Field Name Description
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjneV2! Dane identyfikacyjne
Adres - AdresV2 Adres
AdresKoresp - AdresV2 Adres korespondencyjny
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaV2 Status podatnika
IDNabywcy - String Unikalny klucz powiązania danych nabywcy na fakturach korygujących, w przypadku gdy dane nabywcy na fakturze korygującej zmieniły się w stosunku do danych na fakturze korygowanej
DaneKontaktowe - [TDaneKontaktoweV2!] Dane kontaktowe
Example
{
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneV2,
  "Adres": AdresV2,
  "AdresKoresp": AdresV2,
  "NrKlienta": "abc123",
  "StatusPodatnika": TStatusPodatnikaV2,
  "IDNabywcy": "xyz789",
  "DaneKontaktowe": [TDaneKontaktoweV2]
}

PodmiotV2Input

Description

Dane teleadresowe podatnika

Fields
Input Field Description
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjneV2Input! Dane identyfikacyjne
Adres - AdresV2Input Adres
AdresKoresp - AdresV2Input Adres korespondencyjny
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaV2Input Status podatnika
IDNabywcy - String Unikalny klucz powiązania danych nabywcy na fakturach korygujących, w przypadku gdy dane nabywcy na fakturze korygującej zmieniły się w stosunku do danych na fakturze korygowanej
DaneKontaktowe - [TDaneKontaktoweV2Input!] Dane kontaktowe
Example
{
  "PrefixPodatnika": "AT",
  "NrEORI": "abc123",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneV2Input,
  "Adres": AdresV2Input,
  "AdresKoresp": AdresV2Input,
  "NrKlienta": "xyz789",
  "StatusPodatnika": TStatusPodatnikaV2Input,
  "IDNabywcy": "abc123",
  "DaneKontaktowe": [TDaneKontaktoweV2Input]
}

PodsumowanieVat

Description

Podsumowanie VAT pozycji

Fields
Field Name Description
StawkaPodatku - StawkaPodatku! Stawka podatku VAT
WartoscNetto - Decimal! Wartość netto
KwotaVat - Decimal! Kwota VAT
KwotaVatKurs - Decimal! W przypadku gdy faktura jest wystawiona w walucie obcej, kwota podatku VAT w PLN przeliczona według kursu
Example
{
  "StawkaPodatku": "VAT_23",
  "WartoscNetto": Decimal,
  "KwotaVat": Decimal,
  "KwotaVatKurs": Decimal
}

PodsumowanieVatInput

Description

Podsumowanie VAT pozycji

Fields
Input Field Description
StawkaPodatku - StawkaPodatku! Stawka podatku VAT
WartoscNetto - Decimal! Wartość netto
KwotaVat - Decimal! Kwota VAT
KwotaVatKurs - Decimal! W przypadku gdy faktura jest wystawiona w walucie obcej, kwota podatku VAT w PLN przeliczona według kursu
Example
{
  "StawkaPodatku": "VAT_23",
  "WartoscNetto": Decimal,
  "KwotaVat": Decimal,
  "KwotaVatKurs": Decimal
}

PrefixPodatnika

Description

Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy

Values
Enum Value Description

AT

Austria

BE

Belgia

BG

Bułgaria

CY

Cypr

CZ

Czechy

DK

Dania

EE

Estonia

FI

Finlandia

FR

Francja

DE

Niemcy

EL

Grecja

HR

Chorwacja

HU

Węgry

IE

Irlandia

IT

Włochy

LV

Łotwa

LT

Litwa

LU

Luksemburg

MT

Malta

NL

Holandia

PL

Polska

PT

Portugalia

RO

Rumunia

SK

Słowacja

SI

Słowenia

ES

Hiszpania

SE

Szwecja

XI

Irlandia Północna
Example
"AT"

ProceduraVat

Description

Procedura VAT dla wiersza faktury

Values
Enum Value Description

PROCEDURA1

Stawka 0% stosowana w ramach sprzedaży krajowej

PROCEDURA2

Stawka 0% - wewnątrzwspólnotowa dostawa towarów

PROCEDURA3

Stawka 0% - eksport towarów

PROCEDURA4

Dostawa towarów oraz świadczenie usług opodatkowane poza terytorium kraju

PROCEDURA5

Świadczenie usług z art. 100 ust. 1 pkt 4 ustawy

PROCEDURA6

Towar/usługa wymienione w załączniku 15

PROCEDURA7

Pozostała sprzedaż krajowa
Example
"PROCEDURA1"

PublishInvoicesResponse

Fields
Field Name Description
Sent - Int!
Failed - Int!
Example
{"Sent": 987, "Failed": 987}

RegistrationNumberCreated

Fields
Field Name Description
CompanyId - UUID!
InvoiceId - UUID!
RegistrationNumber - String
Example
{
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "InvoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "RegistrationNumber": "xyz789"
}

RemoveAuthorizationExternalResult

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

RemoveEArchiveNotificationsResponse

Description

Wynik operacji wyłączenia notyfikacji email dla użytkownika w firmie

Fields
Field Name Description
Success - Boolean! true - operacja zakończona powodzeniem
Example
{"Success": false}

RequestedCredential

Description

Obiekt procesowanych uprawnień w KSeF

Fields
Field Name Description
Identifier - String! Numer identyfikacji ewidencyjnej/podatkowej firmy dla której użytkownik wysłał procesowanie uprawnień do KSeF
CredentialsInvoiceRead - Boolean! Uprawnienie do odbierania faktur
CredentialsInvoiceWrite - Boolean! Uprawnienie do wysyłki faktur
CredentialsRead - Boolean! Uprawnienie do odczytu uprawnień
CredentialsManage - Boolean! Uprawnienie do nadawania uprawnień
CredentialsSelfInvoicing - Boolean! Uprawnienie do samofakturowania
ProcessingDescription - String Opis przetwarzania
CreatedAt - DateTime Data utworzenia
RequestType - KSeFRequestForCredentialType! Typ operacji
ProcessingStatus - KSeFRequestForCredentialsProcessingStatus! Status operacji
Example
{
  "Identifier": "xyz789",
  "CredentialsInvoiceRead": true,
  "CredentialsInvoiceWrite": true,
  "CredentialsRead": true,
  "CredentialsManage": true,
  "CredentialsSelfInvoicing": true,
  "ProcessingDescription": "xyz789",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "RequestType": "GRANT",
  "ProcessingStatus": "SANITY_CHECK"
}

RequestedCredentialFiltersFieldsInput

Description

Filtr uprawnień

Fields
Input Field Description
Identifiers - [String!] Lista numerów identyfikacji ewidencyjnej/podatkowej
CredentialsInvoiceRead - Boolean Uprawnienie do odbierania faktur
CredentialsInvoiceWrite - Boolean Uprawnienie do wysyłki faktur
CredentialsRead - Boolean Uprawnienie do odczytu uprawnień
CredentialsManage - Boolean Uprawnienie do nadawania uprawnień
CredentialsSelfInvoicing - Boolean Uprawnienie do samofakturowania
Example
{
  "Identifiers": ["xyz789"],
  "CredentialsInvoiceRead": true,
  "CredentialsInvoiceWrite": true,
  "CredentialsRead": true,
  "CredentialsManage": true,
  "CredentialsSelfInvoicing": true
}

ResponseFilterInput

Fields
Input Field Description
and - [ResponseFilterInput!]
or - [ResponseFilterInput!]
Attachment - AttachmentFilterInput
Example
{
  "and": [ResponseFilterInput],
  "or": [ResponseFilterInput],
  "Attachment": AttachmentFilterInput
}

ResponseModel

Description

Obiekt odpowiedzi notyfikacji

Fields
Field Name Description
AuthorizedInKSeF - OnAuthorizedInKSeFResultUserMessage Treść notyfikacji zakończenia żądania autoryzacji w KSeF MF
UnauthorizedInKsef - OnUnauthorizedKSeFResultUserMessage Treść notyfikacji zakończenia żądania rozłączenia z KSeF MF
DownloadInvoices - OnDownloadInvoicesResultUserMessage Treść notyfikacji zakończenia żądania pobierania faktur
GetUPO - OnGetUPOResultUserMessage Treść notyfikacji zakończenia żądania pobierania UPO
TerminateSession - OnTerminateKSeFSessionResultUserMessage Treść notyfikacji zakończenia żądania zakończenia sesji KSeF MF
GrantPermission - OnGrantKSeFPermissionsResultUserMessage Treść notyfikacji zakończenia żądania nadania uprawnień
SendingInvoices - OnSendingInvoicesResultUserMessage Treść notyfikacji zakończenia żądania wysyłki faktur
RegistrationNumberCreated - RegistrationNumberCreated Treść notyfikacji zakończenia żądania nadania numeru ewidencyjnego
UploadInvoices - OnUploadInvoicesResultUserMessage Treść notyfikacji zakończenia żądania importu XML
OcrInvoiceImported - OnOcrInvoiceImportedUserMessage Treść notyfikacji zakończenia przetwarzania OCR
DeleteInvoices - OnDeleteInvoicesResultUserMessage Treść notyfikacji zakończenia usuwania faktur
PostInvoicesFailed - OnPostInvoicesFailedUserMessage Treść notyfikacji zakończenia wysylki dekretacji - zakończonej błędem
WhiteListValidation - OnGetWhiteListItemsStatusUserMessage Treść notyfikacji zakończenia walidacji kontrachentów na białej liście
Example
{
  "AuthorizedInKSeF": OnAuthorizedInKSeFResultUserMessage,
  "UnauthorizedInKsef": OnUnauthorizedKSeFResultUserMessage,
  "DownloadInvoices": OnDownloadInvoicesResultUserMessage,
  "GetUPO": OnGetUPOResultUserMessage,
  "TerminateSession": OnTerminateKSeFSessionResultUserMessage,
  "GrantPermission": OnGrantKSeFPermissionsResultUserMessage,
  "SendingInvoices": OnSendingInvoicesResultUserMessage,
  "RegistrationNumberCreated": RegistrationNumberCreated,
  "UploadInvoices": OnUploadInvoicesResultUserMessage,
  "OcrInvoiceImported": OnOcrInvoiceImportedUserMessage,
  "DeleteInvoices": OnDeleteInvoicesResultUserMessage,
  "PostInvoicesFailed": OnPostInvoicesFailedUserMessage,
  "WhiteListValidation": OnGetWhiteListItemsStatusUserMessage
}

RodzajFaktury

Description

Rodzaj faktury określony przez Ministerstwo Finansów

Values
Enum Value Description

VAT

Faktura podstawowa

KOR

Faktura korygująca

ZAL

Faktura dokumentująca otrzymanie zapłaty lub jej części przed dokonaniem czynności oraz faktura wystawiona w związku z art. 106f ust. 4 ustawy

ROZ

Faktura wystawiona w związku z art. 106f ust. 3 ustawy

UPR

Faktura, o której mowa w art. 106e ust. 5 pkt 3 ustawy

KOR_ZAL

Faktura korygująca fakturę dokumentującą otrzymanie zapłaty lub jej części przed dokonaniem czynności oraz fakturę wystawioną w związku z art. 106f ust. 4 ustawy

KOR_ROZ

Faktura korygująca fakturę wystawioną w związku z art. 106f ust. 3 ustawy
Example
"VAT"

RodzajFakturyOperationFilterInput

Fields
Input Field Description
eq - RodzajFaktury
neq - RodzajFaktury
in - [RodzajFaktury!]
nin - [RodzajFaktury!]
Example
{"eq": "VAT", "neq": "VAT", "in": ["VAT"], "nin": ["VAT"]}

RodzajTransportu

Description

Rodzaj zastosowanego transportu w przypadku dokonanej dostawy towarów

Values
Enum Value Description

MORSKI

Transport morski

KOLEJOWY

Transport kolejowy

DROGOWY

Transport drogowy

LOTNICZY

Transport lotniczy

PRZESYLKA_POCZTOWA

Przesyłka pocztowa

INSTALACJE_PRZESYLOWE

Stałe instalacje przesyłowe

ZEGLUGA_SRODLADOWA

Żegluga śródlądowa
Example
"MORSKI"

RolaPodmiotu3

Description

Rola podmiotu trzeciego

Values
Enum Value Description

FAKTOR

Faktor - w przypadku, gdy w fakturze występują dane faktora

ODBIORCA

Odbiorca - w przypadku, gdy w fakturze występują dane jednostek wewnętrznych, oddziałów, jednostek budżetowych wyodrębnionych w ramach nabywcy, które same nie stanowią nabywcy w rozumieniu ustawy

PODMIOT_PIERWOTNY

Podmiot pierwotny - w przypadku, gdy w fakturze występują dane podmiotu będącego w stosunku do podatnika podmiotem przejętym lub przekształconym, który świadczył usługę lub dokonywał dostawy. Z wyłączeniem przypadków, o których mowa w art. 106j ust.2 pkt 3 ustawy, gdy dane te prezentowane są w sekcji Podmiot1K

DODATKOWY_NABYWCA

Dodatkowy nabywca - w przypadku, gdy w fakturze występują dane kolejnych (innych niż wymieniony w sekcji Podmiot2) nabywców

WYSTAWCA_FAKTURY

Wystawca faktury - w przypadku, gdy w fakturze występują dane podmiotu wystawiającego fakturę w imieniu podatnika. Nie dotyczy przypadku, gdy wystawcą faktury jest nabywca

PLATNIK

Dokonujący płatności - w przypadku, gdy w fakturze występują dane podmiotu regulującego zobowiązanie w miejsce nabywcy
Example
"FAKTOR"

RolaPodmiotuUpowaznionego

Description

Rola podmiotu upoważnionego

Values
Enum Value Description

ITEM1

Organ egzekucyjny - w przypadku, o którym mowa w art. 106c pkt 1 ustawy

ITEM2

Komornik sądowy - w przypadku, o którym mowa w art. 106c pkt 2 ustawy

ITEM3

Przedstawiciel podatkowy - w przypadku, gdy w fakturze występują dane przedstawiciela podatkowego, o którym mowa w przepisach art. 18a - 18d ustawy
Example
"ITEM1"

Role

Description

Rola

Fields
Field Name Description
Name - String Nazwa roli
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "Name": "xyz789",
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "abc123",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "abc123"
}

RoleAssignment

Description

Przypisanie roli

Fields
Field Name Description
User - User Użytkownik
UserId - UUID! Id Użytkownika
Tenant - TenantResponse Organizacja
TenantId - UUID! Id organizacji
Role - Role Rola
Company - Company Obiekt Company
CompanyId - UUID Id firmy
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "User": User,
  "UserId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Tenant": TenantResponse,
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Role": Role,
  "Company": Company,
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "xyz789",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "abc123"
}

RoleAssignmentFilterInput

Description

Przypisanie roli

Fields
Input Field Description
and - [RoleAssignmentFilterInput!]
or - [RoleAssignmentFilterInput!]
User - UserFilterInput Użytkownik
UserId - UuidOperationFilterInput Id Użytkownika
Tenant - TenantFilterInput Organizacja
TenantId - UuidOperationFilterInput Id organizacji
Role - RoleFilterInput Rola
Company - CompanyFilterInput Obiekt Company
CompanyId - UuidOperationFilterInput Id firmy
Id - UuidOperationFilterInput Unikalny Id rekordu
CreatedAt - DateTimeOperationFilterInput Data utworzenia rekordu
CreatedBy - StringOperationFilterInput E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTimeOperationFilterInput Data modyfikacji rekordu
ModifiedBy - StringOperationFilterInput E-mail użytkownika, który zmodyfikował rekord
Example
{
  "and": [RoleAssignmentFilterInput],
  "or": [RoleAssignmentFilterInput],
  "User": UserFilterInput,
  "UserId": UuidOperationFilterInput,
  "Tenant": TenantFilterInput,
  "TenantId": UuidOperationFilterInput,
  "Role": RoleFilterInput,
  "Company": CompanyFilterInput,
  "CompanyId": UuidOperationFilterInput,
  "Id": UuidOperationFilterInput,
  "CreatedAt": DateTimeOperationFilterInput,
  "CreatedBy": StringOperationFilterInput,
  "ModifiedAt": DateTimeOperationFilterInput,
  "ModifiedBy": StringOperationFilterInput
}

RoleAssignmentInput

Description

Przypisanie roli

Fields
Input Field Description
User - CreateUserRequest Użytkownik
UserId - UUID! Id Użytkownika
Tenant - TenantInput Organizacja
TenantId - UUID! Id organizacji
Role - CreateRoleRequest Rola
Company - CreateCompanyRequest Obiekt Company
CompanyId - UUID Id firmy
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "User": CreateUserRequest,
  "UserId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Tenant": TenantInput,
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Role": CreateRoleRequest,
  "Company": CreateCompanyRequest,
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "abc123",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "xyz789"
}

RoleFilterInput

Description

Rola

Fields
Input Field Description
and - [RoleFilterInput!]
or - [RoleFilterInput!]
Name - StringOperationFilterInput Nazwa roli
Id - UuidOperationFilterInput Unikalny Id rekordu
CreatedAt - DateTimeOperationFilterInput Data utworzenia rekordu
CreatedBy - StringOperationFilterInput E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTimeOperationFilterInput Data modyfikacji rekordu
ModifiedBy - StringOperationFilterInput E-mail użytkownika, który zmodyfikował rekord
Example
{
  "and": [RoleFilterInput],
  "or": [RoleFilterInput],
  "Name": StringOperationFilterInput,
  "Id": UuidOperationFilterInput,
  "CreatedAt": DateTimeOperationFilterInput,
  "CreatedBy": StringOperationFilterInput,
  "ModifiedAt": DateTimeOperationFilterInput,
  "ModifiedBy": StringOperationFilterInput
}

Rozliczenie

Description

Rozliczenie na fakturze

Fields
Field Name Description
Odliczenia - [Odliczenie] Odliczenia ujęte na fakturze
Obciazenia - [Obciazenie] Obciążenia ujęte na fakturze
Example
{
  "Odliczenia": [Odliczenie],
  "Obciazenia": [Obciazenie]
}

RozliczenieInput

Description

Rozliczenie na fakturze

Fields
Input Field Description
Odliczenia - [OdliczenieInput] Odliczenia ujęte na fakturze
Obciazenia - [ObciazenieInput] Obciążenia ujęte na fakturze
Example
{
  "Odliczenia": [OdliczenieInput],
  "Obciazenia": [ObciazenieInput]
}

SendToEArchiveBatchV2ResponseType

Description

Wynik operacji wysłania pakietu faktur do Symfonia KSeF

Fields
Field Name Description
SuccessItems - [BatchResponseItem] Lista faktur, która została zapisana w EArchiwum
ErrorItems - [BatchResponseItem] Lista faktur, których nie udało się zapisać w EArchiwum
Example
{
  "SuccessItems": [BatchResponseItem],
  "ErrorItems": [BatchResponseItem]
}

SendToEArchiveResponseType

Description

Wynik operacji wysłania faktury do Symfonia KSeF

Fields
Field Name Description
Numer - UUID! Nadany unikalny numer faktury
Example
{
  "Numer": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}

SendToEArchiveV2ResponseType

Description

Wynik operacji wysłania faktury do Symfonia KSeF

Fields
Field Name Description
Numer - UUID! Nadany unikalny numer faktury
Example
{
  "Numer": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}

SendingInvoiceItemMessage

Description

Informacja o fakturze

Fields
Field Name Description
invoiceId - UUID! Id faktury
kSeFStatus - KSeFStatus! Status w KSeF
kSeFDate - DateTime Data faktury w KSeF
kSeFNumber - String Numer faktury w KSeF
kSeFStatusErrorDescription - String Opis błędu nadany przez system KSeF, o ile wystąpił
Example
{
  "invoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "kSeFStatus": "NOT_SENT",
  "kSeFDate": "2007-12-03T10:15:30Z",
  "kSeFNumber": "abc123",
  "kSeFStatusErrorDescription": "xyz789"
}

SetEArchiveNotificationsResponse

Description

Wynik operacji włączania notyfikacji email dla użytkownika w firmie

Fields
Field Name Description
Success - Boolean! true - operacja zakończona powodzeniem
Example
{"Success": true}

SetWebsocketNotificationAcknowledgeType

Description

Wynik operacji oznaczenia notyfikacji WebSocket-owej jako przeczytana

Fields
Field Name Description
Success - Boolean! true - operacja zakończona powodzeniem
Example
{"Success": true}

SourceServiceEnum

Description

Serwis tworzący organizację

Values
Enum Value Description

ADMIN

Symfonia KSeF

EBIURO

eBiuro
Example
"ADMIN"

SourceServiceEnumOperationFilterInput

Fields
Input Field Description
eq - SourceServiceEnum
neq - SourceServiceEnum
in - [SourceServiceEnum!]
nin - [SourceServiceEnum!]
Example
{"eq": "ADMIN", "neq": "ADMIN", "in": ["ADMIN"], "nin": ["ADMIN"]}

StandardWebsocketResponse

Description

Odpowiedź informująca, czy zasubskrybowana operacja została rozpoczęta

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Obiekt notyfikacji websocket
Result - SubscriptionStateEnum! Status zasubskrybowanej operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

StawkaPodatku

Description

Stawki podatku wg. ustawy o VAT

Values
Enum Value Description

VAT_23

Stawka VAT 23%

VAT_22

Stawka VAT 22%

VAT_8

Stawka VAT 8%

VAT_7

Stawka VAT 7%

VAT_5

Stawka VAT 5%

VAT_4

Stawka VAT 4%

VAT_3

Stawka VAT 3%

VAT_0

Stawka VAT 0%

VAT_ZW

Zwolnione z opodatkowania

VAT_OO

Odwrotne obciążenie

VAT_NP

Niepodlegające opodatkowaniu-transakcje dostawy towarów oraz świadczenia usług poza terytorium kraju

VAT_OSS

Stawka podatku od wartości dodanej w przypadku, o którym mowa w dziale XII w rozdziale 6a ustawy
Example
"VAT_23"

Stopka

Description

Numery podmiotu lub grupy podmiotów w innych rejestrach i bazach danych

Fields
Field Name Description
Informacje - [String] Informacje
PelnaNazwa - String Pełna nazwa
KRS - String Numer Krajowego Rejestru Sądowego
REGON - String REGON
BDO - String Numer w Bazie Danych o Odpadach
Example
{
  "Informacje": ["xyz789"],
  "PelnaNazwa": "xyz789",
  "KRS": "abc123",
  "REGON": "xyz789",
  "BDO": "abc123"
}

StopkaInput

Description

Numery podmiotu lub grupy podmiotów w innych rejestrach i bazach danych

Fields
Input Field Description
Informacje - [String] Informacje
PelnaNazwa - String Pełna nazwa
KRS - String Numer Krajowego Rejestru Sądowego
REGON - String REGON
BDO - String Numer w Bazie Danych o Odpadach
Example
{
  "Informacje": ["xyz789"],
  "PelnaNazwa": "abc123",
  "KRS": "xyz789",
  "REGON": "abc123",
  "BDO": "abc123"
}

StopkaRejestrV2

Description

Element Rejestr

Fields
Field Name Description
PelnaNazwa - String Pełna nazwa
KRS - String Numer Krajowego Rejestru Sądowego
REGON - String REGON
BDO - String Numer w Bazie Danych o Odpadach
Example
{
  "PelnaNazwa": "abc123",
  "KRS": "abc123",
  "REGON": "abc123",
  "BDO": "abc123"
}

StopkaRejestrV2Input

Description

Element Rejestr

Fields
Input Field Description
PelnaNazwa - String Pełna nazwa
KRS - String Numer Krajowego Rejestru Sądowego
REGON - String REGON
BDO - String Numer w Bazie Danych o Odpadach
Example
{
  "PelnaNazwa": "abc123",
  "KRS": "xyz789",
  "REGON": "abc123",
  "BDO": "abc123"
}

StopkaV2

Description

Element Stopka

Fields
Field Name Description
Informacje - [String] Informacje
Rejestry - [StopkaRejestrV2] Lista rejestrów
Example
{
  "Informacje": ["abc123"],
  "Rejestry": [StopkaRejestrV2]
}

StopkaV2Input

Description

Element Stopka

Fields
Input Field Description
Informacje - [String] Informacje
Rejestry - [StopkaRejestrV2Input] Lista rejestrów
Example
{
  "Informacje": ["abc123"],
  "Rejestry": [StopkaRejestrV2Input]
}

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example
"abc123"

StringOperationFilterInput

Fields
Input Field Description
and - [StringOperationFilterInput!]
or - [StringOperationFilterInput!]
eq - String
neq - String
contains - String
ncontains - String
in - [String]
nin - [String]
startsWith - String
nstartsWith - String
endsWith - String
nendsWith - String
Example
{
  "and": [StringOperationFilterInput],
  "or": [StringOperationFilterInput],
  "eq": "xyz789",
  "neq": "xyz789",
  "contains": "abc123",
  "ncontains": "abc123",
  "in": ["abc123"],
  "nin": ["xyz789"],
  "startsWith": "xyz789",
  "nstartsWith": "xyz789",
  "endsWith": "xyz789",
  "nendsWith": "abc123"
}

SubscribeDownloadInvoicesFromKSeFResponse

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

SubscribeGetUpoResponse

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

SubscribeGrantPermissionsInKSeFResponse

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

Subscription

Description

Wykupiona subskrypcja przez organizację

Fields
Field Name Description
TenantId - UUID Id Organizacji
SerialNumber - String Numer seryjny
SubscriptionNumber - String Numer subskrypcji
CustomerNumber - String Numer klienta
Email - String Adres e-mail administratora organizacji
DateTo - Date! Data ważności subskrypcji
Status - SubscriptionStatus! Status subskrypcji
Identifier - String Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierType! Typ numeru identyfikacyjnego
UniqueSubscriptionId - UUID! Unikalny identyfikator pakietu
SubscriptionType - SubscriptionType! Rodzaj subskrypcji
DateFrom - Date! Data rozpoczęcia subskrypcji
Packages - [Package] Lista pakietów zawartych w subskrypcji
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "SerialNumber": "abc123",
  "SubscriptionNumber": "xyz789",
  "CustomerNumber": "abc123",
  "Email": "abc123",
  "DateTo": "2007-12-03",
  "Status": "INACTIVE",
  "Identifier": "abc123",
  "IdentifierType": "NIP",
  "UniqueSubscriptionId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "SubscriptionType": "FREEMIUM",
  "DateFrom": "2007-12-03",
  "Packages": [Package],
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "xyz789",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "xyz789"
}

SubscriptionStateEnum

Description

Stan uruchomienia zasubskrybowanej operacji

Values
Enum Value Description

NONE

Domyślny

ENQUEUED

Oczekująca

PROCESSING

W toku

FINISHED

Ukończona

BLOCKED

Zablokowana do czasu ukończenia innych, zależnych operacji

CANCELLATION_IN_PROGRESS

W trakcie anulowania operacji zleconej przez użytkownika

CANCELLED

Operacja anulowana przez użytkownika
Example
ENQUEUED

SubscriptionStatus

Description

Status subskrypcji

Values
Enum Value Description

INACTIVE

Nieaktywny

ACTIVE

Aktywny

SUSPENDED

Zawieszony
Example
"INACTIVE"

SubscriptionType

Description

Typ subskrypcji

Values
Enum Value Description

FREEMIUM

Pakiet darmowy

PAID

Pakiet płatny

PREPAID

Pakiet z przedpłatą
Example
"FREEMIUM"

SymfoniaSystem

Description

Systemy Symfonii, które mają dostęp do faktur w Symfonia KSeF

Values
Enum Value Description

UNDEFINED

Wartość domyślna

HAN

Handel

FK

Księgowość

HANFK

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

SOD

SOD

HANSOD

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

HANeBiuro

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

FKSOD

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

eBiuro

eBiuro

FKeBiuro

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

SODeBiuro

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

HANFKSOD

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

HANFKeBiuro

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

HANSODeBiuro

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

FKSODeBiuro

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie

HANFKSODeBiuro

Wartość serwisowa, nieprzeznaczona do użytku bezpośrednio w kodzie
Example
"UNDEFINED"

TDaneIdentyfikacyjne

Description

Dane identyfikacyjne podatnika

Fields
Field Name Description
NIP - String Numer NIP
Pesel - String Numer PESEL
ImiePierwsze - String Pierwsze imię
Nazwisko - String Nazwisko
PelnaNazwa - String Pełna nazwa
Example
{
  "NIP": "xyz789",
  "Pesel": "abc123",
  "ImiePierwsze": "abc123",
  "Nazwisko": "xyz789",
  "PelnaNazwa": "abc123"
}

TDaneIdentyfikacyjneInput

Description

Dane identyfikacyjne podatnika

Fields
Input Field Description
NIP - String Numer NIP
Pesel - String Numer PESEL
ImiePierwsze - String Pierwsze imię
Nazwisko - String Nazwisko
PelnaNazwa - String Pełna nazwa
Example
{
  "NIP": "xyz789",
  "Pesel": "abc123",
  "ImiePierwsze": "xyz789",
  "Nazwisko": "xyz789",
  "PelnaNazwa": "abc123"
}

TDaneIdentyfikacyjneTrzeciPodmiotV2

Description

Element Dane identyfikacyjne podmiotu trzeciego

Fields
Field Name Description
IDWew - String Identyfikator wewnętrzny z NIP
NIP - String Numer NIP
PelnaNazwa - String Imię i nazwisko lub nazwa Typ znakowy ograniczony do 512 znaków Minimum length: 1. Maximum length: 512.
KodUE - PrefixPodatnika Kod (prefiks) nabywcy VAT UE, o którym mowa w art. 106e ust. 1 pkt 24 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 4 ustawy
NrVatUE - String Numer Identyfikacyjny VAT kontrahenta UE Pattern: (\d|[A-Z]|+|*){1,12}.
KodKraju - KodKraju Kod kraju nadania identyfikatora podatkowego
NrID - String Identyfikator podatkowy inny Pattern: [a-zA-Z0-9]{1,50}.
BrakID - Boolean Podmiot nie posiada identyfikatora podatkowego lub identyfikator nie występuje na fakturze: 1- tak
Example
{
  "IDWew": "xyz789",
  "NIP": "xyz789",
  "PelnaNazwa": "xyz789",
  "KodUE": "AT",
  "NrVatUE": "xyz789",
  "KodKraju": "PL",
  "NrID": "abc123",
  "BrakID": true
}

TDaneIdentyfikacyjneTrzeciPodmiotV2Input

Description

Element Dane identyfikacyjne podmiotu trzeciego

Fields
Input Field Description
IDWew - String Identyfikator wewnętrzny z NIP
NIP - String Numer NIP
PelnaNazwa - String Imię i nazwisko lub nazwa Typ znakowy ograniczony do 512 znaków Minimum length: 1. Maximum length: 512.
KodUE - PrefixPodatnika Kod (prefiks) nabywcy VAT UE, o którym mowa w art. 106e ust. 1 pkt 24 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 4 ustawy
NrVatUE - String Numer Identyfikacyjny VAT kontrahenta UE Pattern: (\d|[A-Z]|+|*){1,12}.
KodKraju - KodKraju Kod kraju nadania identyfikatora podatkowego
NrID - String Identyfikator podatkowy inny Pattern: [a-zA-Z0-9]{1,50}.
BrakID - Boolean Podmiot nie posiada identyfikatora podatkowego lub identyfikator nie występuje na fakturze: 1- tak
Example
{
  "IDWew": "abc123",
  "NIP": "abc123",
  "PelnaNazwa": "xyz789",
  "KodUE": "AT",
  "NrVatUE": "abc123",
  "KodKraju": "PL",
  "NrID": "abc123",
  "BrakID": false
}

TDaneIdentyfikacyjneV2

Description

Dane identyfikacyjne podatnika

Fields
Field Name Description
NIP - String Numer NIP
PelnaNazwa - String Imię i nazwisko lub nazwa Typ znakowy ograniczony do 512 znaków Minimum length: 1. Maximum length: 512.
KodUE - PrefixPodatnika Kod (prefiks) nabywcy VAT UE, o którym mowa w art. 106e ust. 1 pkt 24 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 4 ustawy
NrVatUE - String Numer Identyfikacyjny VAT kontrahenta UE Pattern: (\d|[A-Z]|+|*){1,12}.
KodKraju - KodKraju Kod kraju nadania identyfikatora podatkowego
NrID - String Identyfikator podatkowy inny Pattern: [a-zA-Z0-9]{1,50}.
BrakID - Boolean Podmiot nie posiada identyfikatora podatkowego lub identyfikator nie występuje na fakturze: 1- tak
Example
{
  "NIP": "xyz789",
  "PelnaNazwa": "abc123",
  "KodUE": "AT",
  "NrVatUE": "xyz789",
  "KodKraju": "PL",
  "NrID": "xyz789",
  "BrakID": true
}

TDaneIdentyfikacyjneV2Input

Description

Dane identyfikacyjne podatnika

Fields
Input Field Description
NIP - String Numer NIP
PelnaNazwa - String Imię i nazwisko lub nazwa Typ znakowy ograniczony do 512 znaków Minimum length: 1. Maximum length: 512.
KodUE - PrefixPodatnika Kod (prefiks) nabywcy VAT UE, o którym mowa w art. 106e ust. 1 pkt 24 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 4 ustawy
NrVatUE - String Numer Identyfikacyjny VAT kontrahenta UE Pattern: (\d|[A-Z]|+|*){1,12}.
KodKraju - KodKraju Kod kraju nadania identyfikatora podatkowego
NrID - String Identyfikator podatkowy inny Pattern: [a-zA-Z0-9]{1,50}.
BrakID - Boolean Podmiot nie posiada identyfikatora podatkowego lub identyfikator nie występuje na fakturze: 1- tak
Example
{
  "NIP": "abc123",
  "PelnaNazwa": "abc123",
  "KodUE": "AT",
  "NrVatUE": "abc123",
  "KodKraju": "PL",
  "NrID": "abc123",
  "BrakID": false
}

TDaneKontaktoweV2

Description

Element Dane Kontaktowe

Fields
Field Name Description
Email - String Adres e-mail Minimum length: 3. Maximum length: 255. Pattern: (.)+@(.)+.
Telefon - String Numer telefonu Maximum length: 16.
Example
{
  "Email": "abc123",
  "Telefon": "xyz789"
}

TDaneKontaktoweV2Input

Description

Element Dane Kontaktowe

Fields
Input Field Description
Email - String Adres e-mail Minimum length: 3. Maximum length: 255. Pattern: (.)+@(.)+.
Telefon - String Numer telefonu Maximum length: 16.
Example
{
  "Email": "xyz789",
  "Telefon": "abc123"
}

TMarza

Description

Procedura marży

Fields
Field Name Description
BiuroPodrozy - Boolean! W przypadku świadczenia usług turystyki, dla których podstawę opodatkowania stanowi marża, zgodnie z art. 119 ust. 1 ustawy, a faktura dokumentująca świadczenie zawiera wyrazy procedura marży dla biur podróży
TowarUzywany - Boolean! W przypadku dostawy towarów używanych dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - towary używane
DzieloSztuki - Boolean! W przypadku dostawy dzieł sztuki dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - dzieła sztuki
Antyki - Boolean! W przypadku dostawy przedmiotów kolekcjonerskich i antyków, dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - przedmioty kolekcjonerskie i antyki
Example
{
  "BiuroPodrozy": true,
  "TowarUzywany": true,
  "DzieloSztuki": true,
  "Antyki": true
}

TMarzaInput

Description

Procedura marży

Fields
Input Field Description
BiuroPodrozy - Boolean! W przypadku świadczenia usług turystyki, dla których podstawę opodatkowania stanowi marża, zgodnie z art. 119 ust. 1 ustawy, a faktura dokumentująca świadczenie zawiera wyrazy procedura marży dla biur podróży
TowarUzywany - Boolean! W przypadku dostawy towarów używanych dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - towary używane
DzieloSztuki - Boolean! W przypadku dostawy dzieł sztuki dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - dzieła sztuki
Antyki - Boolean! W przypadku dostawy przedmiotów kolekcjonerskich i antyków, dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - przedmioty kolekcjonerskie i antyki
Example
{
  "BiuroPodrozy": true,
  "TowarUzywany": false,
  "DzieloSztuki": true,
  "Antyki": false
}

TMarzaV2

Description

Procedura marży

Fields
Field Name Description
BiuroPodrozy - Boolean! W przypadku świadczenia usług turystyki, dla których podstawę opodatkowania stanowi marża, zgodnie z art. 119 ust. 1 ustawy, a faktura dokumentująca świadczenie zawiera wyrazy procedura marży dla biur podróży
TowarUzywany - Boolean! W przypadku dostawy towarów używanych dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - towary używane
DzieloSztuki - Boolean! W przypadku dostawy dzieł sztuki dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - dzieła sztuki
Antyki - Boolean! W przypadku dostawy przedmiotów kolekcjonerskich i antyków, dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - przedmioty kolekcjonerskie i antyki
Example
{
  "BiuroPodrozy": false,
  "TowarUzywany": false,
  "DzieloSztuki": true,
  "Antyki": true
}

TMarzaV2Input

Description

Procedura marży

Fields
Input Field Description
BiuroPodrozy - Boolean! W przypadku świadczenia usług turystyki, dla których podstawę opodatkowania stanowi marża, zgodnie z art. 119 ust. 1 ustawy, a faktura dokumentująca świadczenie zawiera wyrazy procedura marży dla biur podróży
TowarUzywany - Boolean! W przypadku dostawy towarów używanych dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - towary używane
DzieloSztuki - Boolean! W przypadku dostawy dzieł sztuki dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - dzieła sztuki
Antyki - Boolean! W przypadku dostawy przedmiotów kolekcjonerskich i antyków, dla których podstawę opodatkowania stanowi marża, zgodnie z art. 120 ustawy, a faktura dokumentująca dostawę zawiera wyrazy procedura marży - przedmioty kolekcjonerskie i antyki
Example
{
  "BiuroPodrozy": false,
  "TowarUzywany": true,
  "DzieloSztuki": true,
  "Antyki": true
}

TNowySrodekTransportuV2

Description

Środek trwały

Fields
Field Name Description
DataDopuszczenia - DateTime Należy podać datę dopuszczenia nowego środka do użytku
PojazdLadowyPrzebieg - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - należy podać przebieg pojazdu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyNumerVIN - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać numer VIN Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyNumerNadwozia - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać numer nadwozia Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyNumerPodwozia - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać numer podwozia Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyNumerRamy - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać numer ramy Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyTyp - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać typ nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuKolor - String Kolor nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuModel - String Model nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuMarka - String Marka nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuNumerRejestracyjny - String Numer rejestracyjny nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuRokProdukcji - String Rok produkcji nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
JednostkaPlywajacaLiczbaUzytychGodzinRoboczych - String Jeśli dostawa dotyczy jednostek pływających, o których mowa w art. 2 pkt 10 lit. b ustawy, należy podać liczbę godzin roboczych używania nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
JednostkaPlywajacaNumerKadluba - String Jeśli dostawa dotyczy jednostek pływających, o których mowa w art. 2 pkt 10 lit. b ustawy, można podać numer kadłuba nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
StatekPowietrznyLiczbaUzytychGodzinRoboczych - String Jeśli dostawa dotyczy statków powietrznych, o których mowa w art. 2 pkt 10 lit. c ustawy, należy podać liczbę godzin roboczych używania nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
StatekPowietrznyNumerFabryczny - String Jeśli dostawa dotyczy statków powietrznych, o których mowa w art. 2 pkt 10 lit. c ustawy, można podać numer fabryczny nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NumerWierszaFaktury - String Numer wiersza faktury, w którym wykazano dostawę nowego środka transportu Liczby naturalne większe od zera Minimum exclusive value: 0.
Example
{
  "DataDopuszczenia": "2007-12-03T10:15:30Z",
  "PojazdLadowyPrzebieg": "abc123",
  "PojazdLadowyNumerVIN": "xyz789",
  "PojazdLadowyNumerNadwozia": "abc123",
  "PojazdLadowyNumerPodwozia": "abc123",
  "PojazdLadowyNumerRamy": "xyz789",
  "PojazdLadowyTyp": "abc123",
  "NowySrodekTransportuKolor": "abc123",
  "NowySrodekTransportuModel": "abc123",
  "NowySrodekTransportuMarka": "abc123",
  "NowySrodekTransportuNumerRejestracyjny": "abc123",
  "NowySrodekTransportuRokProdukcji": "abc123",
  "JednostkaPlywajacaLiczbaUzytychGodzinRoboczych": "abc123",
  "JednostkaPlywajacaNumerKadluba": "xyz789",
  "StatekPowietrznyLiczbaUzytychGodzinRoboczych": "xyz789",
  "StatekPowietrznyNumerFabryczny": "xyz789",
  "NumerWierszaFaktury": "abc123"
}

TNowySrodekTransportuV2Input

Description

Środek trwały

Fields
Input Field Description
DataDopuszczenia - DateTime Należy podać datę dopuszczenia nowego środka do użytku
PojazdLadowyPrzebieg - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - należy podać przebieg pojazdu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyNumerVIN - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać numer VIN Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyNumerNadwozia - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać numer nadwozia Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyNumerPodwozia - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać numer podwozia Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyNumerRamy - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać numer ramy Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PojazdLadowyTyp - String Jeśli dostawa dotyczy pojazdów lądowych, o których mowa w art. 2 pkt 10 lit. a ustawy - można podać typ nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuKolor - String Kolor nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuModel - String Model nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuMarka - String Marka nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuNumerRejestracyjny - String Numer rejestracyjny nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NowySrodekTransportuRokProdukcji - String Rok produkcji nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
JednostkaPlywajacaLiczbaUzytychGodzinRoboczych - String Jeśli dostawa dotyczy jednostek pływających, o których mowa w art. 2 pkt 10 lit. b ustawy, należy podać liczbę godzin roboczych używania nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
JednostkaPlywajacaNumerKadluba - String Jeśli dostawa dotyczy jednostek pływających, o których mowa w art. 2 pkt 10 lit. b ustawy, można podać numer kadłuba nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
StatekPowietrznyLiczbaUzytychGodzinRoboczych - String Jeśli dostawa dotyczy statków powietrznych, o których mowa w art. 2 pkt 10 lit. c ustawy, należy podać liczbę godzin roboczych używania nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
StatekPowietrznyNumerFabryczny - String Jeśli dostawa dotyczy statków powietrznych, o których mowa w art. 2 pkt 10 lit. c ustawy, można podać numer fabryczny nowego środka transportu Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
NumerWierszaFaktury - String Numer wiersza faktury, w którym wykazano dostawę nowego środka transportu Liczby naturalne większe od zera Minimum exclusive value: 0.
Example
{
  "DataDopuszczenia": "2007-12-03T10:15:30Z",
  "PojazdLadowyPrzebieg": "abc123",
  "PojazdLadowyNumerVIN": "xyz789",
  "PojazdLadowyNumerNadwozia": "abc123",
  "PojazdLadowyNumerPodwozia": "xyz789",
  "PojazdLadowyNumerRamy": "abc123",
  "PojazdLadowyTyp": "abc123",
  "NowySrodekTransportuKolor": "xyz789",
  "NowySrodekTransportuModel": "xyz789",
  "NowySrodekTransportuMarka": "xyz789",
  "NowySrodekTransportuNumerRejestracyjny": "abc123",
  "NowySrodekTransportuRokProdukcji": "abc123",
  "JednostkaPlywajacaLiczbaUzytychGodzinRoboczych": "xyz789",
  "JednostkaPlywajacaNumerKadluba": "abc123",
  "StatekPowietrznyLiczbaUzytychGodzinRoboczych": "xyz789",
  "StatekPowietrznyNumerFabryczny": "xyz789",
  "NumerWierszaFaktury": "xyz789"
}

TPowodZwolnienia

Description

Zwolnienie z podatku

Fields
Field Name Description
PodstawaZwolnienia - String Należy wskazać przepis ustawy albo aktu wydanego na podstawie ustawy, na podstawie którego podatnik stosuje zwolnienie od podatku
Dyrektywa - String Należy wskazać przepis dyrektywy 2006/112/WE, który zwalnia od podatku taką dostawę towarów lub takie świadczenie usług
PodstawaPrawna - String Należy wskazać inną podstawę prawną wskazującą na to, że dostawa towarów lub świadczenie usług korzysta ze zwolnienia
Example
{
  "PodstawaZwolnienia": "abc123",
  "Dyrektywa": "abc123",
  "PodstawaPrawna": "abc123"
}

TPowodZwolnieniaInput

Description

Zwolnienie z podatku

Fields
Input Field Description
PodstawaZwolnienia - String Należy wskazać przepis ustawy albo aktu wydanego na podstawie ustawy, na podstawie którego podatnik stosuje zwolnienie od podatku
Dyrektywa - String Należy wskazać przepis dyrektywy 2006/112/WE, który zwalnia od podatku taką dostawę towarów lub takie świadczenie usług
PodstawaPrawna - String Należy wskazać inną podstawę prawną wskazującą na to, że dostawa towarów lub świadczenie usług korzysta ze zwolnienia
Example
{
  "PodstawaZwolnienia": "xyz789",
  "Dyrektywa": "abc123",
  "PodstawaPrawna": "abc123"
}

TPowodZwolnieniaV2

Description

Zwolnienie z podatku

Fields
Field Name Description
PodstawaZwolnienia - String Należy wskazać przepis ustawy albo aktu wydanego na podstawie ustawy, na podstawie którego podatnik stosuje zwolnienie od podatku
Dyrektywa - String Należy wskazać przepis dyrektywy 2006/112/WE, który zwalnia od podatku taką dostawę towarów lub takie świadczenie usług
PodstawaPrawna - String Należy wskazać inną podstawę prawną wskazującą na to, że dostawa towarów lub świadczenie usług korzysta ze zwolnienia
Example
{
  "PodstawaZwolnienia": "abc123",
  "Dyrektywa": "xyz789",
  "PodstawaPrawna": "xyz789"
}

TPowodZwolnieniaV2Input

Description

Zwolnienie z podatku

Fields
Input Field Description
PodstawaZwolnienia - String Należy wskazać przepis ustawy albo aktu wydanego na podstawie ustawy, na podstawie którego podatnik stosuje zwolnienie od podatku
Dyrektywa - String Należy wskazać przepis dyrektywy 2006/112/WE, który zwalnia od podatku taką dostawę towarów lub takie świadczenie usług
PodstawaPrawna - String Należy wskazać inną podstawę prawną wskazującą na to, że dostawa towarów lub świadczenie usług korzysta ze zwolnienia
Example
{
  "PodstawaZwolnienia": "xyz789",
  "Dyrektywa": "xyz789",
  "PodstawaPrawna": "xyz789"
}

TRachunekBankowy

Description

Dane dotyczące rachunku bankowego

Fields
Field Name Description
NrRBPL - String Pełny numer rachunku w standardzie NRB
NrRBZagr - String Pełny numer rachunku zagranicznego
SWIFT - String Kod SWIFT banku
NazwaBanku - String Nazwa banku
Example
{
  "NrRBPL": "xyz789",
  "NrRBZagr": "xyz789",
  "SWIFT": "xyz789",
  "NazwaBanku": "xyz789"
}

TRachunekBankowyInput

Description

Dane dotyczące rachunku bankowego

Fields
Input Field Description
NrRBPL - String Pełny numer rachunku w standardzie NRB
NrRBZagr - String Pełny numer rachunku zagranicznego
SWIFT - String Kod SWIFT banku
NazwaBanku - String Nazwa banku
Example
{
  "NrRBPL": "abc123",
  "NrRBZagr": "abc123",
  "SWIFT": "xyz789",
  "NazwaBanku": "xyz789"
}

TRachunekBankowyV2

Description

Element Rachunek bankowy

Fields
Field Name Description
RachunekWlasnyBanku - Int Typy rachunków własnych 0 - Rachunek banku lub rachunek spółdzielczej kasy oszczędnościowo-kredytowej służący do dokonywania rozliczeń z tytułu nabywanych przez ten bank lub tę kasę wierzytelności pieniężnych 1 - Rachunek banku lub rachunek spółdzielczej kasy oszczędnościowo-kredytowej wykorzystywany przez ten bank lub tę kasę do pobrania należności od nabywcy towarów lub usługobiorcy za dostawę towarów lub świadczenie usług, potwierdzone fakturą, i przekazania jej w całości albo części dostawcy towarów lub usługodawcy 2 - Rachunek banku lub rachunek spółdzielczej kasy oszczędnościowo-kredytowej prowadzony przez ten bank lub tę kasę w ramach gospodarki własnej, niebędący rachunkiem rozliczeniowym
OpisRachunku - String Opis rachunku
NrRBPL - String Pełny numer rachunku w standardzie NRB
NrRBZagr - String Pełny numer rachunku zagranicznego
SWIFT - String Kod SWIFT banku
NazwaBanku - String Nazwa banku
Example
{
  "RachunekWlasnyBanku": 987,
  "OpisRachunku": "abc123",
  "NrRBPL": "abc123",
  "NrRBZagr": "abc123",
  "SWIFT": "abc123",
  "NazwaBanku": "abc123"
}

TRachunekBankowyV2Input

Description

Element Rachunek bankowy

Fields
Input Field Description
RachunekWlasnyBanku - Int Typy rachunków własnych 0 - Rachunek banku lub rachunek spółdzielczej kasy oszczędnościowo-kredytowej służący do dokonywania rozliczeń z tytułu nabywanych przez ten bank lub tę kasę wierzytelności pieniężnych 1 - Rachunek banku lub rachunek spółdzielczej kasy oszczędnościowo-kredytowej wykorzystywany przez ten bank lub tę kasę do pobrania należności od nabywcy towarów lub usługobiorcy za dostawę towarów lub świadczenie usług, potwierdzone fakturą, i przekazania jej w całości albo części dostawcy towarów lub usługodawcy 2 - Rachunek banku lub rachunek spółdzielczej kasy oszczędnościowo-kredytowej prowadzony przez ten bank lub tę kasę w ramach gospodarki własnej, niebędący rachunkiem rozliczeniowym
OpisRachunku - String Opis rachunku
NrRBPL - String Pełny numer rachunku w standardzie NRB
NrRBZagr - String Pełny numer rachunku zagranicznego
SWIFT - String Kod SWIFT banku
NazwaBanku - String Nazwa banku
Example
{
  "RachunekWlasnyBanku": 123,
  "OpisRachunku": "xyz789",
  "NrRBPL": "xyz789",
  "NrRBZagr": "xyz789",
  "SWIFT": "abc123",
  "NazwaBanku": "abc123"
}

TSkontoV2

Description

Element Skonto

Fields
Field Name Description
WarunkiSkonta - String Warunki, które nabywca powinien spełnić, aby skorzystać ze skonta Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
WysokoscSkonta - String Wysokość skonta Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
Example
{
  "WarunkiSkonta": "abc123",
  "WysokoscSkonta": "abc123"
}

TSkontoV2Input

Description

Element Skonto

Fields
Input Field Description
WarunkiSkonta - String Warunki, które nabywca powinien spełnić, aby skorzystać ze skonta Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
WysokoscSkonta - String Wysokość skonta Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
Example
{
  "WarunkiSkonta": "xyz789",
  "WysokoscSkonta": "xyz789"
}

TSrodekTrwaly

Description

Środek trwały

Fields
Field Name Description
DataDopuszczenia - DateTime Należy podać datę dopuszczenia nowego środka do użytku
Example
{"DataDopuszczenia": "2007-12-03T10:15:30Z"}

TSrodekTrwalyInput

Description

Środek trwały

Fields
Input Field Description
DataDopuszczenia - DateTime Należy podać datę dopuszczenia nowego środka do użytku
Example
{"DataDopuszczenia": "2007-12-03T10:15:30Z"}

TStatusPodatnika

Description

Status prawny podatnika

Fields
Field Name Description
WLikwidcji - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika znajdującego się w stanie likwidacji
WPostepowaniuRestr - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika, który jest w trakcie postępowania restrukturyzacyjnego
WUpdalosci - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika znajdującego się w stanie upadłości
WSpadku - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez przedsiębiorstwo w spadku
Example
{
  "WLikwidcji": true,
  "WPostepowaniuRestr": false,
  "WUpdalosci": false,
  "WSpadku": true
}

TStatusPodatnikaInput

Description

Status prawny podatnika

Fields
Input Field Description
WLikwidcji - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika znajdującego się w stanie likwidacji
WPostepowaniuRestr - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika, który jest w trakcie postępowania restrukturyzacyjnego
WUpdalosci - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika znajdującego się w stanie upadłości
WSpadku - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez przedsiębiorstwo w spadku
Example
{
  "WLikwidcji": false,
  "WPostepowaniuRestr": true,
  "WUpdalosci": true,
  "WSpadku": true
}

TStatusPodatnikaV2

Description

Status prawny podatnika

Fields
Field Name Description
WLikwidcji - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika znajdującego się w stanie likwidacji
WPostepowaniuRestr - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika, który jest w trakcie postępowania restrukturyzacyjnego
WUpdalosci - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika znajdującego się w stanie upadłości
WSpadku - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez przedsiębiorstwo w spadku
Example
{
  "WLikwidcji": false,
  "WPostepowaniuRestr": true,
  "WUpdalosci": true,
  "WSpadku": false
}

TStatusPodatnikaV2Input

Description

Status prawny podatnika

Fields
Input Field Description
WLikwidcji - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika znajdującego się w stanie likwidacji
WPostepowaniuRestr - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika, który jest w trakcie postępowania restrukturyzacyjnego
WUpdalosci - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez podatnika znajdującego się w stanie upadłości
WSpadku - Boolean! Faktura dokumentująca sprzedaż dokonywaną przez przedsiębiorstwo w spadku
Example
{
  "WLikwidcji": true,
  "WPostepowaniuRestr": true,
  "WUpdalosci": false,
  "WSpadku": true
}

TTerminPlatnosci

Description

Termin płatności

Fields
Field Name Description
TerminPlatnosci - DateTime! Termin płatności
TerminPlatnosciOpis - String Opis terminu płatności
Example
{
  "TerminPlatnosci": "2007-12-03T10:15:30Z",
  "TerminPlatnosciOpis": "abc123"
}

TTerminPlatnosciInput

Description

Termin płatności

Fields
Input Field Description
TerminPlatnosci - DateTime! Termin płatności
TerminPlatnosciOpis - String Opis terminu płatności
Example
{
  "TerminPlatnosci": "2007-12-03T10:15:30Z",
  "TerminPlatnosciOpis": "abc123"
}

TTransport

Description

Zdarzenie transportowe do faktury

Fields
Field Name Description
RodzajTransportu - RodzajTransportu Rodzaj zastosowanego transportu w przypadku dokonanej dostawy towarów
TransportInny - Boolean! Inny rodzaj transportu
OpisInnegoTransportu - String Opis innego rodzaju transportu
Przewoznik - Podmiot Podmiot realizujący zdarzenie transportowe
NrZleceniaTransportu - String Numer zlecenia transportu
OpisLadunku - Ladunek Opis ładunku
JednostkaOpakowania - String Jednostka opakowania
LadunekInny - Boolean! Inny rodzaj ładunku
OpisInnegoLadunku - String Opis innego rodzaju ładunku
DataGodzRozpTransportu - DateTime Data i godzina rozpoczęcia transportu
DataGodzZakTransportu - DateTime Data i godzina zakończenia transportu
WysylkaZ - Adres Wysyłka towaru z lokalizacji
WysylkaPrzez - Adres Wysyłka towaru przez lokalizację
WysylkaDo - Adres Wysyłka towaru do lokalizacji
Example
{
  "RodzajTransportu": "MORSKI",
  "TransportInny": true,
  "OpisInnegoTransportu": "xyz789",
  "Przewoznik": Podmiot,
  "NrZleceniaTransportu": "xyz789",
  "OpisLadunku": "BANKA",
  "JednostkaOpakowania": "xyz789",
  "LadunekInny": false,
  "OpisInnegoLadunku": "xyz789",
  "DataGodzRozpTransportu": "2007-12-03T10:15:30Z",
  "DataGodzZakTransportu": "2007-12-03T10:15:30Z",
  "WysylkaZ": Adres,
  "WysylkaPrzez": Adres,
  "WysylkaDo": Adres
}

TTransportInput

Description

Zdarzenie transportowe do faktury

Fields
Input Field Description
RodzajTransportu - RodzajTransportu Rodzaj zastosowanego transportu w przypadku dokonanej dostawy towarów
TransportInny - Boolean! Inny rodzaj transportu
OpisInnegoTransportu - String Opis innego rodzaju transportu
Przewoznik - PodmiotInput Podmiot realizujący zdarzenie transportowe
NrZleceniaTransportu - String Numer zlecenia transportu
OpisLadunku - Ladunek Opis ładunku
JednostkaOpakowania - String Jednostka opakowania
LadunekInny - Boolean! Inny rodzaj ładunku
OpisInnegoLadunku - String Opis innego rodzaju ładunku
DataGodzRozpTransportu - DateTime Data i godzina rozpoczęcia transportu
DataGodzZakTransportu - DateTime Data i godzina zakończenia transportu
WysylkaZ - AdresInput Wysyłka towaru z lokalizacji
WysylkaPrzez - AdresInput Wysyłka towaru przez lokalizację
WysylkaDo - AdresInput Wysyłka towaru do lokalizacji
Example
{
  "RodzajTransportu": "MORSKI",
  "TransportInny": true,
  "OpisInnegoTransportu": "xyz789",
  "Przewoznik": PodmiotInput,
  "NrZleceniaTransportu": "xyz789",
  "OpisLadunku": "BANKA",
  "JednostkaOpakowania": "xyz789",
  "LadunekInny": false,
  "OpisInnegoLadunku": "xyz789",
  "DataGodzRozpTransportu": "2007-12-03T10:15:30Z",
  "DataGodzZakTransportu": "2007-12-03T10:15:30Z",
  "WysylkaZ": AdresInput,
  "WysylkaPrzez": AdresInput,
  "WysylkaDo": AdresInput
}

TTransportV2

Description

Element transport

Fields
Field Name Description
Przewoznik - PodmiotV2 Podmiot realizujący zdarzenie transportowe
WysylkaZ - AdresV2 Wysyłka towaru z loklalizacji
WysylkaPrzez - [AdresV2!] Wysyłka towaru przez lokalizację
WysylkaDo - AdresV2 Wysyłka towaru do lokalizacji
RodzajTransportu - RodzajTransportu Rodzaj zastosowanego transportu w przypadku dokonanej dostawy towarów
TransportInny - Boolean! Inny rodzaj transportu
OpisInnegoTransportu - String Opis innego rodzaju transportu
NrZleceniaTransportu - String Numer zlecenia transportu
OpisLadunku - Ladunek Opis ładunku
JednostkaOpakowania - String Jednostka opakowania
LadunekInny - Boolean! Inny rodzaj ładunku
OpisInnegoLadunku - String Opis innego rodzaju ładunku
DataGodzRozpTransportu - DateTime Data i godzina rozpoczęcia transportu
DataGodzZakTransportu - DateTime Data i godzina zakończenia transportu
Example
{
  "Przewoznik": PodmiotV2,
  "WysylkaZ": AdresV2,
  "WysylkaPrzez": [AdresV2],
  "WysylkaDo": AdresV2,
  "RodzajTransportu": "MORSKI",
  "TransportInny": false,
  "OpisInnegoTransportu": "xyz789",
  "NrZleceniaTransportu": "xyz789",
  "OpisLadunku": "BANKA",
  "JednostkaOpakowania": "xyz789",
  "LadunekInny": false,
  "OpisInnegoLadunku": "xyz789",
  "DataGodzRozpTransportu": "2007-12-03T10:15:30Z",
  "DataGodzZakTransportu": "2007-12-03T10:15:30Z"
}

TTransportV2Input

Description

Element transport

Fields
Input Field Description
Przewoznik - PodmiotV2Input Podmiot realizujący zdarzenie transportowe
WysylkaZ - AdresV2Input Wysyłka towaru z loklalizacji
WysylkaPrzez - [AdresV2Input!] Wysyłka towaru przez lokalizację
WysylkaDo - AdresV2Input Wysyłka towaru do lokalizacji
RodzajTransportu - RodzajTransportu Rodzaj zastosowanego transportu w przypadku dokonanej dostawy towarów
TransportInny - Boolean! Inny rodzaj transportu
OpisInnegoTransportu - String Opis innego rodzaju transportu
NrZleceniaTransportu - String Numer zlecenia transportu
OpisLadunku - Ladunek Opis ładunku
JednostkaOpakowania - String Jednostka opakowania
LadunekInny - Boolean! Inny rodzaj ładunku
OpisInnegoLadunku - String Opis innego rodzaju ładunku
DataGodzRozpTransportu - DateTime Data i godzina rozpoczęcia transportu
DataGodzZakTransportu - DateTime Data i godzina zakończenia transportu
Example
{
  "Przewoznik": PodmiotV2Input,
  "WysylkaZ": AdresV2Input,
  "WysylkaPrzez": [AdresV2Input],
  "WysylkaDo": AdresV2Input,
  "RodzajTransportu": "MORSKI",
  "TransportInny": false,
  "OpisInnegoTransportu": "xyz789",
  "NrZleceniaTransportu": "xyz789",
  "OpisLadunku": "BANKA",
  "JednostkaOpakowania": "xyz789",
  "LadunekInny": true,
  "OpisInnegoLadunku": "xyz789",
  "DataGodzRozpTransportu": "2007-12-03T10:15:30Z",
  "DataGodzZakTransportu": "2007-12-03T10:15:30Z"
}

TUmowa

Description

Umowa transakcji do faktury

Fields
Field Name Description
DataUmowy - DateTime Data umowy
NrUmowy - String Numer umowy
Example
{
  "DataUmowy": "2007-12-03T10:15:30Z",
  "NrUmowy": "abc123"
}

TUmowaInput

Description

Umowa transakcji do faktury

Fields
Input Field Description
DataUmowy - DateTime Data umowy
NrUmowy - String Numer umowy
Example
{
  "DataUmowy": "2007-12-03T10:15:30Z",
  "NrUmowy": "abc123"
}

TZamowienie

Description

Zamówienie dotyczące warunków transakcji

Fields
Field Name Description
DataZamowienia - DateTime Data zamówienia
NrZamowienia - String Numer zamówienia
Example
{
  "DataZamowienia": "2007-12-03T10:15:30Z",
  "NrZamowienia": "xyz789"
}

TZamowienieInput

Description

Zamówienie dotyczące warunków transakcji

Fields
Input Field Description
DataZamowienia - DateTime Data zamówienia
NrZamowienia - String Numer zamówienia
Example
{
  "DataZamowienia": "2007-12-03T10:15:30Z",
  "NrZamowienia": "xyz789"
}

TZaplataCzesciowa

Description

Możliwość wystąpienia więcej niż jednej zapłaty częściowej w fakturze może wystąpić wyłącznie w przypadku płatności dokonywanych po dostawie towarów lub wykonaniu usług, a przed wystawieniem faktury, z wyjątkiem przypadków, gdy otrzymanie płatności nie skutkuje obowiązkiem wystawienia faktury

Fields
Field Name Description
Data - DateTime! Data zapłaty częściowej, jeśli do wystawienia faktury płatność częściowa została dokonana
Kwota - Decimal! Kwota zapłaty częściowej
Example
{
  "Data": "2007-12-03T10:15:30Z",
  "Kwota": Decimal
}

TZaplataCzesciowaInput

Description

Możliwość wystąpienia więcej niż jednej zapłaty częściowej w fakturze może wystąpić wyłącznie w przypadku płatności dokonywanych po dostawie towarów lub wykonaniu usług, a przed wystawieniem faktury, z wyjątkiem przypadków, gdy otrzymanie płatności nie skutkuje obowiązkiem wystawienia faktury

Fields
Input Field Description
Data - DateTime! Data zapłaty częściowej, jeśli do wystawienia faktury płatność częściowa została dokonana
Kwota - Decimal! Kwota zapłaty częściowej
Example
{
  "Data": "2007-12-03T10:15:30Z",
  "Kwota": Decimal
}

TenantAssignmentViewModel

Description

Statystyka dla organizacji

Fields
Field Name Description
TenantId - UUID! Id organizacji
TenantName - String Nazwa organizacji
RoleName - String Nazwa roli
Status - TenantStatus! Status organizacji
CompanyAssignments - [CompanyAssignmentViewModel] Lista firm organizacji
Example
{
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "TenantName": "xyz789",
  "RoleName": "abc123",
  "Status": "PENDING_APPROVAL",
  "CompanyAssignments": [CompanyAssignmentViewModel]
}

TenantFilterInput

Description

Organizacja

Fields
Input Field Description
and - [TenantFilterInput!]
or - [TenantFilterInput!]
Name - StringOperationFilterInput Nazwa organizacji
SubscriptionNumber - StringOperationFilterInput Numer subskrypcji
Status - TenantStatusOperationFilterInput Status organizacji
Identifier - StringOperationFilterInput Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierTypeOperationFilterInput Typ numeru identyfikacyjnego
VatNumberUE - StringOperationFilterInput Numer VAT UE
Companys - ListFilterInputTypeOfCompanyFilterInput Lista firm organizacji
Users - ListFilterInputTypeOfUserFilterInput Lista użytkowników organizacji
DecisionReason - StringOperationFilterInput Powód odrzucenia akceptacji organizacji
DecisionDate - DateTimeOperationFilterInput Data odrzucenia akceptacji organizacji
SourceService - SourceServiceEnumOperationFilterInput Serwis tworzący organizację
DesktopStatus - DesktopStatusOperationFilterInput Status połączenia między aplikacjami
Address - AddressFilterInput Dane adresowe organizacji
AccountOffice - BooleanOperationFilterInput Organizacja jest biurem rachunkowym
Id - UuidOperationFilterInput Unikalny Id rekordu
CreatedAt - DateTimeOperationFilterInput Data utworzenia rekordu
CreatedBy - StringOperationFilterInput E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTimeOperationFilterInput Data modyfikacji rekordu
ModifiedBy - StringOperationFilterInput E-mail użytkownika, który zmodyfikował rekord
Example
{
  "and": [TenantFilterInput],
  "or": [TenantFilterInput],
  "Name": StringOperationFilterInput,
  "SubscriptionNumber": StringOperationFilterInput,
  "Status": TenantStatusOperationFilterInput,
  "Identifier": StringOperationFilterInput,
  "IdentifierType": IdentifierTypeOperationFilterInput,
  "VatNumberUE": StringOperationFilterInput,
  "Companys": ListFilterInputTypeOfCompanyFilterInput,
  "Users": ListFilterInputTypeOfUserFilterInput,
  "DecisionReason": StringOperationFilterInput,
  "DecisionDate": DateTimeOperationFilterInput,
  "SourceService": SourceServiceEnumOperationFilterInput,
  "DesktopStatus": DesktopStatusOperationFilterInput,
  "Address": AddressFilterInput,
  "AccountOffice": BooleanOperationFilterInput,
  "Id": UuidOperationFilterInput,
  "CreatedAt": DateTimeOperationFilterInput,
  "CreatedBy": StringOperationFilterInput,
  "ModifiedAt": DateTimeOperationFilterInput,
  "ModifiedBy": StringOperationFilterInput
}

TenantInfo

Fields
Field Name Description
Id - UUID!
Name - String
Identifier - String
IdentifierType - IdentifierType!
SubscriptionNumber - String
SourceService - SourceServiceEnum!
Example
{
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Name": "abc123",
  "Identifier": "xyz789",
  "IdentifierType": "NIP",
  "SubscriptionNumber": "abc123",
  "SourceService": "ADMIN"
}

TenantInput

Description

Organizacja

Fields
Input Field Description
Name - String Nazwa organizacji
SubscriptionNumber - String Numer subskrypcji
Status - TenantStatus! Status organizacji
Identifier - String Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierType! Typ numeru identyfikacyjnego
VatNumberUE - String Numer VAT UE
Companys - [CreateCompanyRequest] Lista firm organizacji
Users - [CreateUserRequest] Lista użytkowników organizacji
DecisionReason - String Powód odrzucenia akceptacji organizacji
DecisionDate - DateTime Data odrzucenia akceptacji organizacji
SourceService - SourceServiceEnum! Serwis tworzący organizację
DesktopStatus - DesktopStatus! Status połączenia między aplikacjami
Address - AddressInput Dane adresowe organizacji
AccountOffice - Boolean! Organizacja jest biurem rachunkowym
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "Name": "xyz789",
  "SubscriptionNumber": "xyz789",
  "Status": "PENDING_APPROVAL",
  "Identifier": "abc123",
  "IdentifierType": "NIP",
  "VatNumberUE": "abc123",
  "Companys": [CreateCompanyRequest],
  "Users": [CreateUserRequest],
  "DecisionReason": "xyz789",
  "DecisionDate": "2007-12-03T10:15:30Z",
  "SourceService": "ADMIN",
  "DesktopStatus": "NOT_CONNECTED",
  "Address": AddressInput,
  "AccountOffice": false,
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "xyz789",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "abc123"
}

TenantResponse

Description

Organizacja

Fields
Field Name Description
Name - String Nazwa organizacji
SubscriptionNumber - String Numer subskrypcji
Status - TenantStatus! Status organizacji
Identifier - String Numer identyfikacji ewidencyjnej/podatkowej
IdentifierType - IdentifierType! Typ numeru identyfikacyjnego
VatNumberUE - String Numer VAT UE
Companys - [Company] Lista firm organizacji
Users - [User] Lista użytkowników organizacji
DecisionReason - String Powód odrzucenia akceptacji organizacji
DecisionDate - DateTime Data odrzucenia akceptacji organizacji
SourceService - SourceServiceEnum! Serwis tworzący organizację
DesktopStatus - DesktopStatus! Status połączenia między aplikacjami
Address - Address Dane adresowe organizacji
AccountOffice - Boolean! Organizacja jest biurem rachunkowym
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "Name": "xyz789",
  "SubscriptionNumber": "abc123",
  "Status": "PENDING_APPROVAL",
  "Identifier": "xyz789",
  "IdentifierType": "NIP",
  "VatNumberUE": "abc123",
  "Companys": [Company],
  "Users": [User],
  "DecisionReason": "abc123",
  "DecisionDate": "2007-12-03T10:15:30Z",
  "SourceService": "ADMIN",
  "DesktopStatus": "NOT_CONNECTED",
  "Address": Address,
  "AccountOffice": true,
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "abc123",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "abc123"
}

TenantStatus

Description

Status organizacji

Values
Enum Value Description

PENDING_APPROVAL

Oczekuje na akceptację

REJECTED

Odrzucona

ACTIVE

Aktywna

DEACTIVATED

Nieaktywna

TO_DELETE

Do usunięcia
Example
"PENDING_APPROVAL"

TenantStatusOperationFilterInput

Fields
Input Field Description
eq - TenantStatus
neq - TenantStatus
in - [TenantStatus!]
nin - [TenantStatus!]
Example
{
  "eq": "PENDING_APPROVAL",
  "neq": "PENDING_APPROVAL",
  "in": ["PENDING_APPROVAL"],
  "nin": ["PENDING_APPROVAL"]
}

TerminateKSeFSessionResponse

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

TrzeciPodmiot

Description

Podmiot trzeci widniejący na fakturze

Fields
Field Name Description
Rola - RolaPodmiotu3! Rola podmiotu trzeciego
ProcentowyUdzial - Decimal Procentowy udział dodatkowego nabywcy. Udziałem nabywcy wymienionego w sekcji Podmiot2 jest wówczas dopełnienie do 100% sumy udziałów dodatkowych nabywców. W przypadku niewypełnienia pola przyjmuje się, że udziały występujących w fakturze nabywców są równe
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjne! Dane identyfikacyjne
Adres - Adres Adres
AdresKoresp - Adres Adres korespondencyjny
Email - String Adres email
Telefon - String Numer telefonu
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnika Status podatnika
Example
{
  "Rola": "FAKTOR",
  "ProcentowyUdzial": Decimal,
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjne,
  "Adres": Adres,
  "AdresKoresp": Adres,
  "Email": "xyz789",
  "Telefon": "xyz789",
  "NrKlienta": "xyz789",
  "StatusPodatnika": TStatusPodatnika
}

TrzeciPodmiotInput

Description

Podmiot trzeci widniejący na fakturze

Fields
Input Field Description
Rola - RolaPodmiotu3! Rola podmiotu trzeciego
ProcentowyUdzial - Decimal Procentowy udział dodatkowego nabywcy. Udziałem nabywcy wymienionego w sekcji Podmiot2 jest wówczas dopełnienie do 100% sumy udziałów dodatkowych nabywców. W przypadku niewypełnienia pola przyjmuje się, że udziały występujących w fakturze nabywców są równe
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
DaneIdentyfikacyjne - TDaneIdentyfikacyjneInput! Dane identyfikacyjne
Adres - AdresInput Adres
AdresKoresp - AdresInput Adres korespondencyjny
Email - String Adres email
Telefon - String Numer telefonu
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaInput Status podatnika
Example
{
  "Rola": "FAKTOR",
  "ProcentowyUdzial": Decimal,
  "PrefixPodatnika": "AT",
  "NrEORI": "abc123",
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneInput,
  "Adres": AdresInput,
  "AdresKoresp": AdresInput,
  "Email": "xyz789",
  "Telefon": "abc123",
  "NrKlienta": "xyz789",
  "StatusPodatnika": TStatusPodatnikaInput
}

TrzeciPodmiotV2

Description

Element Podmiot trzeci

Fields
Field Name Description
Rola - RolaPodmiotu3 Rola podmiotu trzeciego
ProcentowyUdzial - Decimal Procentowy udział dodatkowego nabywcy. Udziałem nabywcy wymienionego w sekcji Podmiot2 jest wówczas dopełnienie do 100% sumy udziałów dodatkowych nabywców. W przypadku niewypełnienia pola przyjmuje się, że udziały występujących w fakturze nabywców są równe
DaneIdentyfikacyjne - TDaneIdentyfikacyjneTrzeciPodmiotV2! Dane identyfikacyjne podmiotu trzeciego
OpisRoliInnej - String Opis roli podmiotu - w przypadku wyboru roli jako Inny podmiot Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
Adres - AdresV2 Adres
AdresKoresp - AdresV2 Adres korespondencyjny
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaV2 Status podatnika
IDNabywcy - String Unikalny klucz powiązania danych nabywcy na fakturach korygujących, w przypadku gdy dane nabywcy na fakturze korygującej zmieniły się w stosunku do danych na fakturze korygowanej
DaneKontaktowe - [TDaneKontaktoweV2!] Dane kontaktowe
Example
{
  "Rola": "FAKTOR",
  "ProcentowyUdzial": Decimal,
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneTrzeciPodmiotV2,
  "OpisRoliInnej": "xyz789",
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "Adres": AdresV2,
  "AdresKoresp": AdresV2,
  "NrKlienta": "xyz789",
  "StatusPodatnika": TStatusPodatnikaV2,
  "IDNabywcy": "abc123",
  "DaneKontaktowe": [TDaneKontaktoweV2]
}

TrzeciPodmiotV2Input

Description

Element Podmiot trzeci

Fields
Input Field Description
Rola - RolaPodmiotu3 Rola podmiotu trzeciego
ProcentowyUdzial - Decimal Procentowy udział dodatkowego nabywcy. Udziałem nabywcy wymienionego w sekcji Podmiot2 jest wówczas dopełnienie do 100% sumy udziałów dodatkowych nabywców. W przypadku niewypełnienia pola przyjmuje się, że udziały występujących w fakturze nabywców są równe
DaneIdentyfikacyjne - TDaneIdentyfikacyjneTrzeciPodmiotV2Input! Dane identyfikacyjne podmiotu trzeciego
OpisRoliInnej - String Opis roli podmiotu - w przypadku wyboru roli jako Inny podmiot Typ znakowy ograniczony do 256 znaków Minimum length: 1. Maximum length: 256.
PrefixPodatnika - PrefixPodatnika Kod (prefiks) podatnika VAT UE dla przypadków określonych w art. 97 ust. 10 pkt 2 i 3 ustawy oraz w przypadku, o którym mowa w art. 136 ust. 1 pkt 3 ustawy
NrEORI - String Numer EORI podatnika towarów
Adres - AdresV2Input Adres
AdresKoresp - AdresV2Input Adres korespondencyjny
NrKlienta - String Numer klienta dla przypadków, w których podmiot wymieniony jako podmiot trzeci posługuje się nim w umowie lub zamówieniu
StatusPodatnika - TStatusPodatnikaV2Input Status podatnika
IDNabywcy - String Unikalny klucz powiązania danych nabywcy na fakturach korygujących, w przypadku gdy dane nabywcy na fakturze korygującej zmieniły się w stosunku do danych na fakturze korygowanej
DaneKontaktowe - [TDaneKontaktoweV2Input!] Dane kontaktowe
Example
{
  "Rola": "FAKTOR",
  "ProcentowyUdzial": Decimal,
  "DaneIdentyfikacyjne": TDaneIdentyfikacyjneTrzeciPodmiotV2Input,
  "OpisRoliInnej": "abc123",
  "PrefixPodatnika": "AT",
  "NrEORI": "xyz789",
  "Adres": AdresV2Input,
  "AdresKoresp": AdresV2Input,
  "NrKlienta": "abc123",
  "StatusPodatnika": TStatusPodatnikaV2Input,
  "IDNabywcy": "xyz789",
  "DaneKontaktowe": [TDaneKontaktoweV2Input]
}

TypKorekty

Description

Typ skutku korekty w ewidencji

Values
Enum Value Description

TYP1

Korekta skutkująca w dacie ujęcia faktury pierwotnej

TYP2

Korekta skutkująca w dacie wystawienia faktury korygującej

TYP3

Korekta skutkująca w dacie innej, w tym gdy dla różnych pozycji faktury korygującej daty te są różne
Example
"TYP1"

UPOType

Description

Wynik zlecenia UPO

Fields
Field Name Description
FileName - String Nazwa pliku
FileContent - String Dane zakodowane w Base64
MimeType - String Typ Mime pliku
MissingInvoices - [MissedInvoice] Liczba brakujących faktur
RequestedInvoices - [UUID!] Liczba oczekiwanych faktur
ReturnedInvoices - [UUID!] Liczba uwzględnionych faktur
Example
{
  "FileName": "xyz789",
  "FileContent": "xyz789",
  "MimeType": "xyz789",
  "MissingInvoices": [MissedInvoice],
  "RequestedInvoices": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "ReturnedInvoices": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ]
}

UUID

Example
"ce164f8f-a876-437c-a391-7fbb0e829ec4"

UploadInvoicesResponse

Fields
Field Name Description
NotificationModel - WebsocketNotificationModel Treść notyfikacji
Result - SubscriptionStateEnum! Stan operacji
Example
{
  "NotificationModel": WebsocketNotificationModel,
  "Result": "ENQUEUED"
}

UploadInvoicesResultItem

Description

Obiekt opisujący status importu XML

Fields
Field Name Description
FileName - String Nazwa importowanego pliku
errorMessage - String Treść komunikatu błędu
Example
{
  "FileName": "xyz789",
  "errorMessage": "xyz789"
}

UploadItemInput

Description

Rekord wgrywanej faktury

Fields
Input Field Description
FileContent - String Faktura xml zakodowana base64
FileName - String Nazwa pliku
Example
{
  "FileContent": "abc123",
  "FileName": "xyz789"
}

UpoFileType

Description

Format pliku UPO

Values
Enum Value Description

PDF

PDF generowany przez KSeF

XML

XML generowany przez KSeF
Example
"PDF"

UpoMissingInvoiceReason

Description

Powód, dla którego faktura została uznana za brakującą

Values
Enum Value Description

NOT_EXISTS

Nie istnieje

NOT_SENT

Nie została wysłana

PROCESSING

W trakcie procesowania

UPO_NOT_GENERATED

UPO nie zostało wygenerowane

VALIDATION_ERROR

Błąd walidacji

ERROR

Inny błąd

INTERRUPTED_SENDING

Posiada status przerwanej wysyłki

INTERRUPTED_PENDING

Posiada status przerwanej weryfikacji

OCR

Faktura OCR

SCHEMA_ERROR

UPO nie zostało wygenerowane, błąd schemy
Example
"NOT_EXISTS"

User

Description

Użytkownik organizacji

Fields
Field Name Description
Email - String! Adres email użytkownika
FirstName - String! Imię użytkownika
LastName - String! Nazwisko użytkownika
PhoneNumber - String Numer telefonu użytkownika
CloudConsent - Boolean Warunki użytkowania Programu w chmurze https://materialy.symfonia.pl/publiczne/a8ca55 (obowiązkowe)
PersonalDataConsent - Boolean Zgoda na przetwarzanie danych osobowych w celach marketingowych Symfonii. (obowiązkowe)
PrivacyPolicyConsent - Boolean Akceptacja polityki prywatności (obowiązkowe)
CompanyRepresentationConsent - Boolean Oświadczenie o upoważnienie do działania w imieniu reprezentowanego podmiotu: "Oświadczam, że jestem uprawniony/-a do działania w imieniu i ze skutkiem dla podmiotu, który reprezentuję." (obowiązkowe)
MarketingEndDeviceConsent - Boolean Zgoda na używanie telekomunikacyjnych urządzeń końcowych do kontaktów marketingowych
MarketingPhoneConsent - Boolean Zgoda na używanie telefonu do kontaktów marketingowych
NewsletterConsent - Boolean Zgoda na otrzymywanie newslettera
MarketingEmailConsent - Boolean Zgoda na wykorzystanie e-mail do celów marketingowych
PersonalDataForPartnersConsent - Boolean Zgoda na przetwarzanie danych osobowych w celach marketingowych przez Partnerów Symfonii.
Tenant - TenantResponse Organizacja
TenantId - UUID! Id organizacji
RoleAssignments - [RoleAssignment] Przypisane role
Id - UUID! Unikalny Id rekordu
CreatedAt - DateTime Data utworzenia rekordu
CreatedBy - String E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTime Data modyfikacji rekordu
ModifiedBy - String E-mail użytkownika, który zmodyfikował rekord
Example
{
  "Email": "xyz789",
  "FirstName": "xyz789",
  "LastName": "abc123",
  "PhoneNumber": "abc123",
  "CloudConsent": true,
  "PersonalDataConsent": false,
  "PrivacyPolicyConsent": false,
  "CompanyRepresentationConsent": false,
  "MarketingEndDeviceConsent": false,
  "MarketingPhoneConsent": true,
  "NewsletterConsent": false,
  "MarketingEmailConsent": false,
  "PersonalDataForPartnersConsent": true,
  "Tenant": TenantResponse,
  "TenantId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "RoleAssignments": [RoleAssignment],
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CreatedAt": "2007-12-03T10:15:30Z",
  "CreatedBy": "abc123",
  "ModifiedAt": "2007-12-03T10:15:30Z",
  "ModifiedBy": "abc123"
}

UserFilterInput

Description

Użytkownik organizacji

Fields
Input Field Description
and - [UserFilterInput!]
or - [UserFilterInput!]
Email - StringOperationFilterInput Adres email użytkownika
FirstName - StringOperationFilterInput Imię użytkownika
LastName - StringOperationFilterInput Nazwisko użytkownika
PhoneNumber - StringOperationFilterInput Numer telefonu użytkownika
CloudConsent - BooleanOperationFilterInput Warunki użytkowania Programu w chmurze https://materialy.symfonia.pl/publiczne/a8ca55 (obowiązkowe)
PersonalDataConsent - BooleanOperationFilterInput Zgoda na przetwarzanie danych osobowych w celach marketingowych Symfonii. (obowiązkowe)
PrivacyPolicyConsent - BooleanOperationFilterInput Akceptacja polityki prywatności (obowiązkowe)
CompanyRepresentationConsent - BooleanOperationFilterInput Oświadczenie o upoważnienie do działania w imieniu reprezentowanego podmiotu: "Oświadczam, że jestem uprawniony/-a do działania w imieniu i ze skutkiem dla podmiotu, który reprezentuję." (obowiązkowe)
MarketingEndDeviceConsent - BooleanOperationFilterInput Zgoda na używanie telekomunikacyjnych urządzeń końcowych do kontaktów marketingowych
MarketingPhoneConsent - BooleanOperationFilterInput Zgoda na używanie telefonu do kontaktów marketingowych
NewsletterConsent - BooleanOperationFilterInput Zgoda na otrzymywanie newslettera
MarketingEmailConsent - BooleanOperationFilterInput Zgoda na wykorzystanie e-mail do celów marketingowych
PersonalDataForPartnersConsent - BooleanOperationFilterInput Zgoda na przetwarzanie danych osobowych w celach marketingowych przez Partnerów Symfonii.
Tenant - TenantFilterInput Organizacja
TenantId - UuidOperationFilterInput Id organizacji
RoleAssignments - ListFilterInputTypeOfRoleAssignmentFilterInput Przypisane role
Id - UuidOperationFilterInput Unikalny Id rekordu
CreatedAt - DateTimeOperationFilterInput Data utworzenia rekordu
CreatedBy - StringOperationFilterInput E-mail użytkownika, który utworzył rekord
ModifiedAt - DateTimeOperationFilterInput Data modyfikacji rekordu
ModifiedBy - StringOperationFilterInput E-mail użytkownika, który zmodyfikował rekord
Example
{
  "and": [UserFilterInput],
  "or": [UserFilterInput],
  "Email": StringOperationFilterInput,
  "FirstName": StringOperationFilterInput,
  "LastName": StringOperationFilterInput,
  "PhoneNumber": StringOperationFilterInput,
  "CloudConsent": BooleanOperationFilterInput,
  "PersonalDataConsent": BooleanOperationFilterInput,
  "PrivacyPolicyConsent": BooleanOperationFilterInput,
  "CompanyRepresentationConsent": BooleanOperationFilterInput,
  "MarketingEndDeviceConsent": BooleanOperationFilterInput,
  "MarketingPhoneConsent": BooleanOperationFilterInput,
  "NewsletterConsent": BooleanOperationFilterInput,
  "MarketingEmailConsent": BooleanOperationFilterInput,
  "PersonalDataForPartnersConsent": BooleanOperationFilterInput,
  "Tenant": TenantFilterInput,
  "TenantId": UuidOperationFilterInput,
  "RoleAssignments": ListFilterInputTypeOfRoleAssignmentFilterInput,
  "Id": UuidOperationFilterInput,
  "CreatedAt": DateTimeOperationFilterInput,
  "CreatedBy": StringOperationFilterInput,
  "ModifiedAt": DateTimeOperationFilterInput,
  "ModifiedBy": StringOperationFilterInput
}

UserInfo

Description

Informacje dot. uzytkownika

Fields
Field Name Description
Id - UUID! Id użytkownika
Email - String Email użytkownika
FirstName - String Imię użytkownika
LastName - String Nazwisko użytkownika
Roles - [String] Role przypisane do użytkownika
FullName - String Imię i nazwisko użytkownika
Example
{
  "Id": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Email": "xyz789",
  "FirstName": "xyz789",
  "LastName": "abc123",
  "Roles": ["abc123"],
  "FullName": "abc123"
}

UuidOperationFilterInput

Fields
Input Field Description
eq - UUID
neq - UUID
in - [UUID]
nin - [UUID]
gt - UUID
ngt - UUID
gte - UUID
ngte - UUID
lt - UUID
nlt - UUID
lte - UUID
nlte - UUID
Example
{
  "eq": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "neq": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "in": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "nin": [
    "ce164f8f-a876-437c-a391-7fbb0e829ec4"
  ],
  "gt": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "ngt": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "gte": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "ngte": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "lt": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "nlt": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "lte": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "nlte": "ce164f8f-a876-437c-a391-7fbb0e829ec4"
}

WarunkiTransakcji

Description

Parametry warunki transakcji

Fields
Field Name Description
Umowy - [TUmowa!] Lista umów
Zamowienia - [TZamowienie!] Lista zamówień
NrPartiiTowaru - [String!] Numery partii towaru
WarunkiDostawy - String Warunki dostawy towaru lub usługi
Transport - [TTransport!] Lista zdarzeń transportowych
Example
{
  "Umowy": [TUmowa],
  "Zamowienia": [TZamowienie],
  "NrPartiiTowaru": ["abc123"],
  "WarunkiDostawy": "abc123",
  "Transport": [TTransport]
}

WarunkiTransakcjiInput

Description

Parametry warunki transakcji

Fields
Input Field Description
Umowy - [TUmowaInput!] Lista umów
Zamowienia - [TZamowienieInput!] Lista zamówień
NrPartiiTowaru - [String!] Numery partii towaru
WarunkiDostawy - String Warunki dostawy towaru lub usługi
Transport - [TTransportInput!] Lista zdarzeń transportowych
Example
{
  "Umowy": [TUmowaInput],
  "Zamowienia": [TZamowienieInput],
  "NrPartiiTowaru": ["xyz789"],
  "WarunkiDostawy": "abc123",
  "Transport": [TTransportInput]
}

WarunkiTransakcjiV2

Description

Warunki transakcji

Fields
Field Name Description
Transport - [TTransportV2!] Lista zdarzeń transportowych
KursUmowny - Decimal Kurs umowny - w przypadkach, gdy na fakturze znajduje się informacja o kursie, po którym zostały przeliczone kwoty wykazane na fakturze w PLN. Nie dotyczy przypadków, o których mowa w Dziale VI ustawy. Typ wykorzystywany do określenia ilości. Wartość numeryczna 22 znaki max, w tym 6 po przecinku. Total number of digits: 22. Total number of digits in fraction: 6. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,6})?.
PodmiotPosredniczacy - Boolean Wartość "1" oznacza dostawę dokonaną przez podmiot, o którym mowa w art. 22 ust. 2d ustawy. Pole dotyczy przypadku, w którym podmiot uczestniczy w transakcji łańcuchowej innej niż procedura trójstronna uproszczona, o której mowa w art. 135 ust. 1 pkt 4 ustawy
WalutaUmowna - KodWaluty Waluta umowna - trzyliterowy kod waluty (ISO-4217) w przypadkach, gdy na fakturze znajduje się informacja o kursie, po którym zostały przeliczone kwoty wykazane na fakturze w złotych. Nie dotyczy przypadków, o których mowa w Dziale VI ustawy
Umowy - [TUmowa!] Lista umów
Zamowienia - [TZamowienie!] Lista zamówień
NrPartiiTowaru - [String!] Numery partii towaru
WarunkiDostawy - String Warunki dostawy towaru lub usługi
Example
{
  "Transport": [TTransportV2],
  "KursUmowny": Decimal,
  "PodmiotPosredniczacy": true,
  "WalutaUmowna": "PLN",
  "Umowy": [TUmowa],
  "Zamowienia": [TZamowienie],
  "NrPartiiTowaru": ["xyz789"],
  "WarunkiDostawy": "xyz789"
}

WarunkiTransakcjiV2Input

Description

Warunki transakcji

Fields
Input Field Description
Transport - [TTransportV2Input!] Lista zdarzeń transportowych
KursUmowny - Decimal Kurs umowny - w przypadkach, gdy na fakturze znajduje się informacja o kursie, po którym zostały przeliczone kwoty wykazane na fakturze w PLN. Nie dotyczy przypadków, o których mowa w Dziale VI ustawy. Typ wykorzystywany do określenia ilości. Wartość numeryczna 22 znaki max, w tym 6 po przecinku. Total number of digits: 22. Total number of digits in fraction: 6. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,6})?.
PodmiotPosredniczacy - Boolean Wartość "1" oznacza dostawę dokonaną przez podmiot, o którym mowa w art. 22 ust. 2d ustawy. Pole dotyczy przypadku, w którym podmiot uczestniczy w transakcji łańcuchowej innej niż procedura trójstronna uproszczona, o której mowa w art. 135 ust. 1 pkt 4 ustawy
WalutaUmowna - KodWaluty Waluta umowna - trzyliterowy kod waluty (ISO-4217) w przypadkach, gdy na fakturze znajduje się informacja o kursie, po którym zostały przeliczone kwoty wykazane na fakturze w złotych. Nie dotyczy przypadków, o których mowa w Dziale VI ustawy
Umowy - [TUmowaInput!] Lista umów
Zamowienia - [TZamowienieInput!] Lista zamówień
NrPartiiTowaru - [String!] Numery partii towaru
WarunkiDostawy - String Warunki dostawy towaru lub usługi
Example
{
  "Transport": [TTransportV2Input],
  "KursUmowny": Decimal,
  "PodmiotPosredniczacy": true,
  "WalutaUmowna": "PLN",
  "Umowy": [TUmowaInput],
  "Zamowienia": [TZamowienieInput],
  "NrPartiiTowaru": ["xyz789"],
  "WarunkiDostawy": "abc123"
}

WebsocketErrorType

Description

Typy błędów subskrypcji websocket

Values
Enum Value Description

SYSTEM

Błąd systemowy

VALIDATION

Błąd walidacji

KSEF_AUTHORIZATION

Błąd autoryzacji w KSeF

KSEF_LIMIT

Błąd limitu zapytań do KSeF

KSEF_ERROR

Błąd wygenerowany przez KSeF

KSEF_CONNECTION

Błąd połączenia z serwerem KSeF
Example
"SYSTEM"

WebsocketNotificationModel

Description

Obiekt notyfikacji websocket

Fields
Field Name Description
UserId - UUID! Id użytkownika
CompanyId - UUID! Id firmy
ErrorType - WebsocketErrorType Typ błędu
ErrorContent - [KeyValuePairOfStringAndString!] Dane szczegółowe błędu
Message - String Informacja o operacji
Type - WebsocketNotificationType! Typ notyfikacji
NotificationId - UUID! Id notyfikacji
Timestamp - DateTime! Data utworzenia
Visited - Boolean! Flaga informująca, czy użytkownik zapoznał się w notyfikacją
HasDownloadableContent - Boolean! Flaga informująca, czy wynik operacji stanowi zawartość do pobrania
ResponseJson - String Dane wyniku operacji w formacie JSON
State - SubscriptionStateEnum! Status notyfikacji
SimultaneousRunType - WebsocketSimultaneousRunType! Typ uruchomienia notyfikacji
JobId - String Id joba w systemie kolejkowym
Example
{
  "UserId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "CompanyId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "ErrorType": "SYSTEM",
  "ErrorContent": [KeyValuePairOfStringAndString],
  "Message": "xyz789",
  "Type": "AUTHORIZE_IN_KSEF",
  "NotificationId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "Timestamp": "2007-12-03T10:15:30Z",
  "Visited": false,
  "HasDownloadableContent": true,
  "ResponseJson": "abc123",
  "State": "ENQUEUED",
  "SimultaneousRunType": "SEQUENTIAL",
  "JobId": "xyz789"
}

WebsocketNotificationStateType

Description

Grupy notyfikacji WebSocket-owych dla statusów SubscriptionStateEnum

Values
Enum Value Description

ALL

Wszystkie statusy

ACTIVE

Tylko zakolejkowane i trwające

ARCHIVED

Tylko archiwalne
Example
"ALL"

WebsocketNotificationType

Description

Typy subskrypcji websocket

Values
Enum Value Description

AUTHORIZE_IN_KSEF

Autoryzacja podpisem

AUTHORIZE_IN_KSEF_EXTERNAL_TOKEN

Autoryzacja zewnętrznym tokenem

UNAUTHORIZED_IN_KSEF

Usunięcie autoryzacji podpisem

UNAUTHORIZED_IN_KSEF_EXTERNAL_TOKEN

Usunięcie autoryzacji zewnętrznym tokenem

DOWNLOAD_INVOICES

Pobieranie faktur

GET_UPO

Pobieranie UPO

TERMINATE_SESSION

Kasowanie sesji

GRANT_PERMISSION

Nadawanie uprawnień

AUTO_FETCHING_INVOICES

Automatyczne pobieranie faktur

SENDING_INVOICES

Wysyłanie faktur

AUTO_SENDING_INVOICES

Automatyczne wysyłanie faktur

AUTO_UNAUTHORIZED_IN_KSE_F_EXTERNAL_TOKEN

Automatyczne usunięcie autoryzacji zewnętrznym tokenem po otrzymaniu z KSeF błędu autoryzacji

REGISTRATION_NUMBER_CREATED

Przypisanie numeru ewidencyjnego do faktury po zaksięgowaniu dekretu

INVOICE_POSTING_STATUS_CHANGED

Zmiana statusu dekretacji faktury

UPLOAD_INVOICES

Wgrywanie faktur z dysku

OCR_INVOICE_IMPORTED

Informacja, że faktura z OCR została zaakceptowana i zaimportowana do Symfonia KSeF

DELETE_INVOICES

Usuwanie faktur wybranych przez użytkownika. Usuwa dokument z bazy danych aplikacji.

POST_INVOICES_FAILED

Błąd dekretacji faktury

WHITE_LIST_VALIDATION

Walidacja numeru rachunku bankowego kontrahenta na białej liście
Example
"AUTHORIZE_IN_KSEF"

WebsocketSimultaneousRunType

Values
Enum Value Description

SEQUENTIAL

Operacje, które muszą czekać na zakończenie poprzedniej operacji

PARALLEL

Operacje, które mogą się wykonać równolegle i nie muszą czekać na zakończenie poprzedniej operacji

PARALLEL_WITH_DIFFERENT_INPUTS

Operacje, które mogą się wykonać równolegle ale posiadające inne parametry wejściowe
Example
"SEQUENTIAL"

WhiteListItem

Fields
Field Name Description
invoiceId - UUID!
identifier - String
issuerName - String
whiteListResult - [WhiteListServiceResult] Key pair value of account number and white list status
Example
{
  "invoiceId": "ce164f8f-a876-437c-a391-7fbb0e829ec4",
  "identifier": "abc123",
  "issuerName": "abc123",
  "whiteListResult": [WhiteListServiceResult]
}

WhiteListServiceResult

Description

Model walidacji konta na białej liście

Fields
Field Name Description
Account - String Numer konta
IsWhiteListed - Boolean! Czy numer konta jest na białej liście
Date - DateTime! Data sprawdzenia
ErrorMessage - String Opis błędu
Example
{
  "Account": "xyz789",
  "IsWhiteListed": false,
  "Date": "2007-12-03T10:15:30Z",
  "ErrorMessage": "xyz789"
}

WhiteListStatusDtoModel

Description

Model sprawdzenia kont bankowych kontrahenta na białej liście

Fields
Field Name Description
IsValidated - Boolean! Sprawdzone na białej liście
Accounts - [WhiteListServiceResult] Lista kont bankowych kontrahenta zawarte na fakturze
Example
{
  "IsValidated": true,
  "Accounts": [WhiteListServiceResult]
}

Wiersz

Description

Wiersz pozycji na fakturze

Fields
Field Name Description
UnikalnyNumer - String Uniwersalny unikalny numer wiersza faktury
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się dla przypadku, gdy dla poszczególnych pozycji faktury występują różne daty
Nazwa - String Nazwa (rodzaj) towaru lub usługi. Pole opcjonalne wyłącznie dla przypadku określonego w art 106j ust. 3 pkt 2 ustawy (faktura korekta)
GTIN - String Globalny numer jednostki handlowej
PKWIU - String Symbol Polskiej Klasyfikacji Wyrobów i Usług
CN - String Symbol Nomenklatury Scalonej
PKOB - String Symbol Polskiej Klasyfikacji Obiektów Budowlanych
GTU - GTU Oznaczenie dotyczące dostawy towarów i świadczenia usług
DodatkoweInfo - String Pole przeznaczone do wpisania przez sprzedawcę dodatkowych danych, które nie zostały uwzględnione w elementach struktury i nie są wymagane przepisami, a które mogą znaleźć się na fakturze
JM - String Miara dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
Ilosc - Decimal Ilość (liczba) dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
CenaNetto - Decimal Cena jednostkowa towaru lub usługi bez kwoty podatku (cena jednostkowa netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
CenaBrutto - Decimal Cena wraz z kwotą podatku (cena jednostkowa brutto), w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
KwotaOpustu - Decimal Kwoty wszelkich opustów lub obniżek cen, w tym w formie rabatu z tytułu wcześniejszej zapłaty, o ile nie zostały one uwzględnione w cenie jednostkowej netto. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 1 ustawy
WartoscNetto - Decimal Wartość dostarczonych towarów lub wykonanych usług, objętych transakcją, bez podatku (wartość sprzedaży netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
WartoscBrutto - Decimal Wartość sprzedaży brutto, w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
StawkaPodatku - StawkaPodatku Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
ProceduraVat - ProceduraVat Wskazanie procedury dla wiersza faktury
KwotaAkcyzy - Decimal Kwota podatku akcyzowego zawarta w cenie towaru
KursWaluty - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w art. 31a ustawy
Procedura - OznaczenieProcedury Oznaczenia dotyczące procedur dla faktur
StawkaOSS - Decimal Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
LP - Long Kolejny numer wiersza faktury
Example
{
  "UnikalnyNumer": "xyz789",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "Nazwa": "xyz789",
  "GTIN": "abc123",
  "PKWIU": "xyz789",
  "CN": "abc123",
  "PKOB": "xyz789",
  "GTU": "GTU_01",
  "DodatkoweInfo": "xyz789",
  "JM": "xyz789",
  "Ilosc": Decimal,
  "CenaNetto": Decimal,
  "CenaBrutto": Decimal,
  "KwotaOpustu": Decimal,
  "WartoscNetto": Decimal,
  "WartoscBrutto": Decimal,
  "StawkaPodatku": "VAT_23",
  "ProceduraVat": "PROCEDURA1",
  "KwotaAkcyzy": Decimal,
  "KursWaluty": Decimal,
  "Procedura": "WSTO_EE",
  "StawkaOSS": Decimal,
  "LP": {}
}

WierszInput

Description

Wiersz pozycji na fakturze

Fields
Input Field Description
UnikalnyNumer - String Uniwersalny unikalny numer wiersza faktury
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się dla przypadku, gdy dla poszczególnych pozycji faktury występują różne daty
Nazwa - String Nazwa (rodzaj) towaru lub usługi. Pole opcjonalne wyłącznie dla przypadku określonego w art 106j ust. 3 pkt 2 ustawy (faktura korekta)
GTIN - String Globalny numer jednostki handlowej
PKWIU - String Symbol Polskiej Klasyfikacji Wyrobów i Usług
CN - String Symbol Nomenklatury Scalonej
PKOB - String Symbol Polskiej Klasyfikacji Obiektów Budowlanych
GTU - GTU Oznaczenie dotyczące dostawy towarów i świadczenia usług
DodatkoweInfo - String Pole przeznaczone do wpisania przez sprzedawcę dodatkowych danych, które nie zostały uwzględnione w elementach struktury i nie są wymagane przepisami, a które mogą znaleźć się na fakturze
JM - String Miara dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
Ilosc - Decimal Ilość (liczba) dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
CenaNetto - Decimal Cena jednostkowa towaru lub usługi bez kwoty podatku (cena jednostkowa netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
CenaBrutto - Decimal Cena wraz z kwotą podatku (cena jednostkowa brutto), w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
KwotaOpustu - Decimal Kwoty wszelkich opustów lub obniżek cen, w tym w formie rabatu z tytułu wcześniejszej zapłaty, o ile nie zostały one uwzględnione w cenie jednostkowej netto. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 1 ustawy
WartoscNetto - Decimal Wartość dostarczonych towarów lub wykonanych usług, objętych transakcją, bez podatku (wartość sprzedaży netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
WartoscBrutto - Decimal Wartość sprzedaży brutto, w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
StawkaPodatku - StawkaPodatku Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
ProceduraVat - ProceduraVat Wskazanie procedury dla wiersza faktury
KwotaAkcyzy - Decimal Kwota podatku akcyzowego zawarta w cenie towaru
KursWaluty - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w art. 31a ustawy
Procedura - OznaczenieProcedury Oznaczenia dotyczące procedur dla faktur
StawkaOSS - Decimal Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
LP - Long Kolejny numer wiersza faktury
Example
{
  "UnikalnyNumer": "abc123",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "Nazwa": "xyz789",
  "GTIN": "xyz789",
  "PKWIU": "xyz789",
  "CN": "xyz789",
  "PKOB": "abc123",
  "GTU": "GTU_01",
  "DodatkoweInfo": "abc123",
  "JM": "abc123",
  "Ilosc": Decimal,
  "CenaNetto": Decimal,
  "CenaBrutto": Decimal,
  "KwotaOpustu": Decimal,
  "WartoscNetto": Decimal,
  "WartoscBrutto": Decimal,
  "StawkaPodatku": "VAT_23",
  "ProceduraVat": "PROCEDURA1",
  "KwotaAkcyzy": Decimal,
  "KursWaluty": Decimal,
  "Procedura": "WSTO_EE",
  "StawkaOSS": Decimal,
  "LP": {}
}

WierszV2

Description

Wiersz pozycji na fakturze

Fields
Field Name Description
StanPrzed - Boolean Znacznik stanu przed korektą w przypadku faktury korygującej lub faktury korygującej fakturę wystawioną w związku z art. 106f ust. 3 ustawy, w przypadku gdy korekta dotyczy danych wykazanych w pozycjach faktury i jest dokonywana w sposób polegający na wykazaniu danych przed korektą i po korekcie jako osobnych wierszy z odrębną numeracją oraz w przypadku potwierdzania braku zmiany wartości danej pozycji
WartoscVat - Decimal Kwota podatku w przypadku, o którym mowa w art. 106e ust. 10 ustawy
ZnacznikTowaruLubUslugi - Boolean Znacznik dla towaru lub usługi wymienionych w załączniku nr 15 do ustawy - wartość "1"
UnikalnyNumer - String Uniwersalny unikalny numer wiersza faktury
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się dla przypadku, gdy dla poszczególnych pozycji faktury występują różne daty
Nazwa - String Nazwa (rodzaj) towaru lub usługi. Pole opcjonalne wyłącznie dla przypadku określonego w art 106j ust. 3 pkt 2 ustawy (faktura korekta)
GTIN - String Globalny numer jednostki handlowej
PKWIU - String Symbol Polskiej Klasyfikacji Wyrobów i Usług
CN - String Symbol Nomenklatury Scalonej
PKOB - String Symbol Polskiej Klasyfikacji Obiektów Budowlanych
GTU - GTU Oznaczenie dotyczące dostawy towarów i świadczenia usług
DodatkoweInfo - String Pole przeznaczone do wpisania przez sprzedawcę dodatkowych danych, które nie zostały uwzględnione w elementach struktury i nie są wymagane przepisami, a które mogą znaleźć się na fakturze
JM - String Miara dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
Ilosc - Decimal Ilość (liczba) dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
CenaNetto - Decimal Cena jednostkowa towaru lub usługi bez kwoty podatku (cena jednostkowa netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
CenaBrutto - Decimal Cena wraz z kwotą podatku (cena jednostkowa brutto), w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
KwotaOpustu - Decimal Kwoty wszelkich opustów lub obniżek cen, w tym w formie rabatu z tytułu wcześniejszej zapłaty, o ile nie zostały one uwzględnione w cenie jednostkowej netto. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 1 ustawy
WartoscNetto - Decimal Wartość dostarczonych towarów lub wykonanych usług, objętych transakcją, bez podatku (wartość sprzedaży netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
WartoscBrutto - Decimal Wartość sprzedaży brutto, w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
StawkaPodatku - StawkaPodatku Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
ProceduraVat - ProceduraVat Wskazanie procedury dla wiersza faktury
KwotaAkcyzy - Decimal Kwota podatku akcyzowego zawarta w cenie towaru
KursWaluty - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w art. 31a ustawy
Procedura - OznaczenieProcedury Oznaczenia dotyczące procedur dla faktur
StawkaOSS - Decimal Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
LP - Long Kolejny numer wiersza faktury
Example
{
  "StanPrzed": false,
  "WartoscVat": Decimal,
  "ZnacznikTowaruLubUslugi": false,
  "UnikalnyNumer": "abc123",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "Nazwa": "xyz789",
  "GTIN": "xyz789",
  "PKWIU": "xyz789",
  "CN": "xyz789",
  "PKOB": "xyz789",
  "GTU": "GTU_01",
  "DodatkoweInfo": "abc123",
  "JM": "abc123",
  "Ilosc": Decimal,
  "CenaNetto": Decimal,
  "CenaBrutto": Decimal,
  "KwotaOpustu": Decimal,
  "WartoscNetto": Decimal,
  "WartoscBrutto": Decimal,
  "StawkaPodatku": "VAT_23",
  "ProceduraVat": "PROCEDURA1",
  "KwotaAkcyzy": Decimal,
  "KursWaluty": Decimal,
  "Procedura": "WSTO_EE",
  "StawkaOSS": Decimal,
  "LP": {}
}

WierszV2Input

Description

Wiersz pozycji na fakturze

Fields
Input Field Description
StanPrzed - Boolean Znacznik stanu przed korektą w przypadku faktury korygującej lub faktury korygującej fakturę wystawioną w związku z art. 106f ust. 3 ustawy, w przypadku gdy korekta dotyczy danych wykazanych w pozycjach faktury i jest dokonywana w sposób polegający na wykazaniu danych przed korektą i po korekcie jako osobnych wierszy z odrębną numeracją oraz w przypadku potwierdzania braku zmiany wartości danej pozycji
WartoscVat - Decimal Kwota podatku w przypadku, o którym mowa w art. 106e ust. 10 ustawy
ZnacznikTowaruLubUslugi - Boolean Znacznik dla towaru lub usługi wymienionych w załączniku nr 15 do ustawy - wartość "1"
UnikalnyNumer - String Uniwersalny unikalny numer wiersza faktury
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się dla przypadku, gdy dla poszczególnych pozycji faktury występują różne daty
Nazwa - String Nazwa (rodzaj) towaru lub usługi. Pole opcjonalne wyłącznie dla przypadku określonego w art 106j ust. 3 pkt 2 ustawy (faktura korekta)
GTIN - String Globalny numer jednostki handlowej
PKWIU - String Symbol Polskiej Klasyfikacji Wyrobów i Usług
CN - String Symbol Nomenklatury Scalonej
PKOB - String Symbol Polskiej Klasyfikacji Obiektów Budowlanych
GTU - GTU Oznaczenie dotyczące dostawy towarów i świadczenia usług
DodatkoweInfo - String Pole przeznaczone do wpisania przez sprzedawcę dodatkowych danych, które nie zostały uwzględnione w elementach struktury i nie są wymagane przepisami, a które mogą znaleźć się na fakturze
JM - String Miara dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
Ilosc - Decimal Ilość (liczba) dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
CenaNetto - Decimal Cena jednostkowa towaru lub usługi bez kwoty podatku (cena jednostkowa netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
CenaBrutto - Decimal Cena wraz z kwotą podatku (cena jednostkowa brutto), w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
KwotaOpustu - Decimal Kwoty wszelkich opustów lub obniżek cen, w tym w formie rabatu z tytułu wcześniejszej zapłaty, o ile nie zostały one uwzględnione w cenie jednostkowej netto. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 1 ustawy
WartoscNetto - Decimal Wartość dostarczonych towarów lub wykonanych usług, objętych transakcją, bez podatku (wartość sprzedaży netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
WartoscBrutto - Decimal Wartość sprzedaży brutto, w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
StawkaPodatku - StawkaPodatku Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
ProceduraVat - ProceduraVat Wskazanie procedury dla wiersza faktury
KwotaAkcyzy - Decimal Kwota podatku akcyzowego zawarta w cenie towaru
KursWaluty - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w art. 31a ustawy
Procedura - OznaczenieProcedury Oznaczenia dotyczące procedur dla faktur
StawkaOSS - Decimal Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
LP - Long Kolejny numer wiersza faktury
Example
{
  "StanPrzed": true,
  "WartoscVat": Decimal,
  "ZnacznikTowaruLubUslugi": false,
  "UnikalnyNumer": "abc123",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "Nazwa": "xyz789",
  "GTIN": "xyz789",
  "PKWIU": "abc123",
  "CN": "xyz789",
  "PKOB": "xyz789",
  "GTU": "GTU_01",
  "DodatkoweInfo": "xyz789",
  "JM": "abc123",
  "Ilosc": Decimal,
  "CenaNetto": Decimal,
  "CenaBrutto": Decimal,
  "KwotaOpustu": Decimal,
  "WartoscNetto": Decimal,
  "WartoscBrutto": Decimal,
  "StawkaPodatku": "VAT_23",
  "ProceduraVat": "PROCEDURA1",
  "KwotaAkcyzy": Decimal,
  "KursWaluty": Decimal,
  "Procedura": "WSTO_EE",
  "StawkaOSS": Decimal,
  "LP": {}
}

ZakresDatV2

Description

Uniwersalny element służący do przechowywania zakresu dat

Fields
Field Name Description
DataOd - DateTime! Data od
DataDo - DateTime! Data do
Example
{
  "DataOd": "2007-12-03T10:15:30Z",
  "DataDo": "2007-12-03T10:15:30Z"
}

ZakresDatV2Input

Description

Uniwersalny element służący do przechowywania zakresu dat

Fields
Input Field Description
DataOd - DateTime! Data od
DataDo - DateTime! Data do
Example
{
  "DataOd": "2007-12-03T10:15:30Z",
  "DataDo": "2007-12-03T10:15:30Z"
}

ZaliczkaCzesciowaV2

Description

Element zaliczka częściowa

Fields
Field Name Description
DataPlatnosci - DateTime! Data otrzymania płatności, o której mowa w art. 106b ust. 1 pkt 4 ustawy Data zdarzenia w okresie od 2006-01-01 do 2050-01-01 Minimum inclusive value: 2006-01-01. Maximum inclusive value: 2050-01-01.
KwotaPlatnosci - Decimal! Kwota płatności, o której mowa w art. 106b ust. 1 pkt 4 ustawy, składająca się na kwotę w polu P_15. W przypadku faktur korygujących korekta kwoty wynikającej z faktury korygowanej Wartość numeryczna 18 znaków max, w tym 2 znaki po przecinku Total number of digits: 18. Total number of digits in fraction: 2. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,2})?.
KursWaluty - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w Dziale VI ustawy Typ wykorzystywany do określenia ilości. Wartość numeryczna 22 znaki max, w tym 6 po przecinku Total number of digits: 22. Total number of digits in fraction: 6. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,6})?.
Example
{
  "DataPlatnosci": "2007-12-03T10:15:30Z",
  "KwotaPlatnosci": Decimal,
  "KursWaluty": Decimal
}

ZaliczkaCzesciowaV2Input

Description

Element zaliczka częściowa

Fields
Input Field Description
DataPlatnosci - DateTime! Data otrzymania płatności, o której mowa w art. 106b ust. 1 pkt 4 ustawy Data zdarzenia w okresie od 2006-01-01 do 2050-01-01 Minimum inclusive value: 2006-01-01. Maximum inclusive value: 2050-01-01.
KwotaPlatnosci - Decimal! Kwota płatności, o której mowa w art. 106b ust. 1 pkt 4 ustawy, składająca się na kwotę w polu P_15. W przypadku faktur korygujących korekta kwoty wynikającej z faktury korygowanej Wartość numeryczna 18 znaków max, w tym 2 znaki po przecinku Total number of digits: 18. Total number of digits in fraction: 2. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,2})?.
KursWaluty - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w Dziale VI ustawy Typ wykorzystywany do określenia ilości. Wartość numeryczna 22 znaki max, w tym 6 po przecinku Total number of digits: 22. Total number of digits in fraction: 6. Pattern: -?([1-9]\d{0,15}|0)(.\d{1,6})?.
Example
{
  "DataPlatnosci": "2007-12-03T10:15:30Z",
  "KwotaPlatnosci": Decimal,
  "KursWaluty": Decimal
}

Zamowienie

Description

Zamówienie do faktury

Fields
Field Name Description
Wartosc - Decimal! Wartość zamówienia
Wiersze - [Wiersz] Lista wierszy zamówienia
Example
{
  "Wartosc": Decimal,
  "Wiersze": [Wiersz]
}

ZamowienieInput

Description

Zamówienie do faktury

Fields
Input Field Description
Wartosc - Decimal! Wartość zamówienia
Wiersze - [WierszInput] Lista wierszy zamówienia
Example
{
  "Wartosc": Decimal,
  "Wiersze": [WierszInput]
}

ZamowienieV2

Description

Element Zamówienie

Fields
Field Name Description
Wiersze - [ZamowienieWierszV2] Lista wierszy zamówienia
Wartosc - Decimal! Wartość zamówienia
Example
{
  "Wiersze": [ZamowienieWierszV2],
  "Wartosc": Decimal
}

ZamowienieV2Input

Description

Element Zamówienie

Fields
Input Field Description
Wiersze - [ZamowienieWierszV2Input] Lista wierszy zamówienia
Wartosc - Decimal! Wartość zamówienia
Example
{
  "Wiersze": [ZamowienieWierszV2Input],
  "Wartosc": Decimal
}

ZamowienieWierszV2

Description

Element Wiersz zamówienia

Fields
Field Name Description
PodatekVatTaxFree - Decimal Stawka podatku od wartości dodanej w przypadku, o którym mowa w dziale XII w rozdziale 6a ustawy Wartość procentowa z dokładnością do 6 miejsc po przecinku Total number of digits: 9. Total number of digits in fraction: 6. Minimum inclusive value: 0. Maximum inclusive value: 100.
ZnacznikZamowieniaTowaruLubUslugi - Boolean Znacznik dla towaru lub usługi wymienionych w załączniku nr 15 do ustawy - wartość "1"
StanPrzed - Boolean Znacznik stanu przed korektą w przypadku faktury korygującej lub faktury korygującej fakturę wystawioną w związku z art. 106f ust. 3 ustawy, w przypadku gdy korekta dotyczy danych wykazanych w pozycjach faktury i jest dokonywana w sposób polegający na wykazaniu danych przed korektą i po korekcie jako osobnych wierszy z odrębną numeracją oraz w przypadku potwierdzania braku zmiany wartości danej pozycji
WartoscVat - Decimal Kwota podatku w przypadku, o którym mowa w art. 106e ust. 10 ustawy
ZnacznikTowaruLubUslugi - Boolean Znacznik dla towaru lub usługi wymienionych w załączniku nr 15 do ustawy - wartość "1"
UnikalnyNumer - String Uniwersalny unikalny numer wiersza faktury
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się dla przypadku, gdy dla poszczególnych pozycji faktury występują różne daty
Nazwa - String Nazwa (rodzaj) towaru lub usługi. Pole opcjonalne wyłącznie dla przypadku określonego w art 106j ust. 3 pkt 2 ustawy (faktura korekta)
GTIN - String Globalny numer jednostki handlowej
PKWIU - String Symbol Polskiej Klasyfikacji Wyrobów i Usług
CN - String Symbol Nomenklatury Scalonej
PKOB - String Symbol Polskiej Klasyfikacji Obiektów Budowlanych
GTU - GTU Oznaczenie dotyczące dostawy towarów i świadczenia usług
DodatkoweInfo - String Pole przeznaczone do wpisania przez sprzedawcę dodatkowych danych, które nie zostały uwzględnione w elementach struktury i nie są wymagane przepisami, a które mogą znaleźć się na fakturze
JM - String Miara dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
Ilosc - Decimal Ilość (liczba) dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
CenaNetto - Decimal Cena jednostkowa towaru lub usługi bez kwoty podatku (cena jednostkowa netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
CenaBrutto - Decimal Cena wraz z kwotą podatku (cena jednostkowa brutto), w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
KwotaOpustu - Decimal Kwoty wszelkich opustów lub obniżek cen, w tym w formie rabatu z tytułu wcześniejszej zapłaty, o ile nie zostały one uwzględnione w cenie jednostkowej netto. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 1 ustawy
WartoscNetto - Decimal Wartość dostarczonych towarów lub wykonanych usług, objętych transakcją, bez podatku (wartość sprzedaży netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
WartoscBrutto - Decimal Wartość sprzedaży brutto, w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
StawkaPodatku - StawkaPodatku Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
ProceduraVat - ProceduraVat Wskazanie procedury dla wiersza faktury
KwotaAkcyzy - Decimal Kwota podatku akcyzowego zawarta w cenie towaru
KursWaluty - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w art. 31a ustawy
Procedura - OznaczenieProcedury Oznaczenia dotyczące procedur dla faktur
StawkaOSS - Decimal Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
LP - Long Kolejny numer wiersza faktury
Example
{
  "PodatekVatTaxFree": Decimal,
  "ZnacznikZamowieniaTowaruLubUslugi": false,
  "StanPrzed": false,
  "WartoscVat": Decimal,
  "ZnacznikTowaruLubUslugi": false,
  "UnikalnyNumer": "xyz789",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "Nazwa": "abc123",
  "GTIN": "xyz789",
  "PKWIU": "abc123",
  "CN": "abc123",
  "PKOB": "xyz789",
  "GTU": "GTU_01",
  "DodatkoweInfo": "xyz789",
  "JM": "xyz789",
  "Ilosc": Decimal,
  "CenaNetto": Decimal,
  "CenaBrutto": Decimal,
  "KwotaOpustu": Decimal,
  "WartoscNetto": Decimal,
  "WartoscBrutto": Decimal,
  "StawkaPodatku": "VAT_23",
  "ProceduraVat": "PROCEDURA1",
  "KwotaAkcyzy": Decimal,
  "KursWaluty": Decimal,
  "Procedura": "WSTO_EE",
  "StawkaOSS": Decimal,
  "LP": {}
}

ZamowienieWierszV2Input

Description

Element Wiersz zamówienia

Fields
Input Field Description
PodatekVatTaxFree - Decimal Stawka podatku od wartości dodanej w przypadku, o którym mowa w dziale XII w rozdziale 6a ustawy Wartość procentowa z dokładnością do 6 miejsc po przecinku Total number of digits: 9. Total number of digits in fraction: 6. Minimum inclusive value: 0. Maximum inclusive value: 100.
ZnacznikZamowieniaTowaruLubUslugi - Boolean Znacznik dla towaru lub usługi wymienionych w załączniku nr 15 do ustawy - wartość "1"
StanPrzed - Boolean Znacznik stanu przed korektą w przypadku faktury korygującej lub faktury korygującej fakturę wystawioną w związku z art. 106f ust. 3 ustawy, w przypadku gdy korekta dotyczy danych wykazanych w pozycjach faktury i jest dokonywana w sposób polegający na wykazaniu danych przed korektą i po korekcie jako osobnych wierszy z odrębną numeracją oraz w przypadku potwierdzania braku zmiany wartości danej pozycji
WartoscVat - Decimal Kwota podatku w przypadku, o którym mowa w art. 106e ust. 10 ustawy
ZnacznikTowaruLubUslugi - Boolean Znacznik dla towaru lub usługi wymienionych w załączniku nr 15 do ustawy - wartość "1"
UnikalnyNumer - String Uniwersalny unikalny numer wiersza faktury
DataDostawy - DateTime Data dokonania lub zakończenia dostawy towarów lub wykonania usługi lub data otrzymania zapłaty, o której mowa w art. 106b ust. 1 pkt 4 ustawy, o ile taka data jest określona i różni się od daty wystawienia faktury. Pole wypełnia się dla przypadku, gdy dla poszczególnych pozycji faktury występują różne daty
Nazwa - String Nazwa (rodzaj) towaru lub usługi. Pole opcjonalne wyłącznie dla przypadku określonego w art 106j ust. 3 pkt 2 ustawy (faktura korekta)
GTIN - String Globalny numer jednostki handlowej
PKWIU - String Symbol Polskiej Klasyfikacji Wyrobów i Usług
CN - String Symbol Nomenklatury Scalonej
PKOB - String Symbol Polskiej Klasyfikacji Obiektów Budowlanych
GTU - GTU Oznaczenie dotyczące dostawy towarów i świadczenia usług
DodatkoweInfo - String Pole przeznaczone do wpisania przez sprzedawcę dodatkowych danych, które nie zostały uwzględnione w elementach struktury i nie są wymagane przepisami, a które mogą znaleźć się na fakturze
JM - String Miara dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
Ilosc - Decimal Ilość (liczba) dostarczonych towarów lub zakres wykonanych usług. Pole opcjonalne dla przypadku określonego w art. 106e ust. 5 pkt 3 ustawy
CenaNetto - Decimal Cena jednostkowa towaru lub usługi bez kwoty podatku (cena jednostkowa netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
CenaBrutto - Decimal Cena wraz z kwotą podatku (cena jednostkowa brutto), w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
KwotaOpustu - Decimal Kwoty wszelkich opustów lub obniżek cen, w tym w formie rabatu z tytułu wcześniejszej zapłaty, o ile nie zostały one uwzględnione w cenie jednostkowej netto. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 1 ustawy
WartoscNetto - Decimal Wartość dostarczonych towarów lub wykonanych usług, objętych transakcją, bez podatku (wartość sprzedaży netto). Pole opcjonalne dla przypadków określonych w art. 106e ust. 2 i 3 oraz ust. 5 pkt 3 ustawy
WartoscBrutto - Decimal Wartość sprzedaży brutto, w przypadku zastosowania art. 106e ust. 7 i 8 ustawy
StawkaPodatku - StawkaPodatku Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
ProceduraVat - ProceduraVat Wskazanie procedury dla wiersza faktury
KwotaAkcyzy - Decimal Kwota podatku akcyzowego zawarta w cenie towaru
KursWaluty - Decimal Kurs waluty stosowany do wyliczenia kwoty podatku w przypadkach, o których mowa w art. 31a ustawy
Procedura - OznaczenieProcedury Oznaczenia dotyczące procedur dla faktur
StawkaOSS - Decimal Stawka podatku. Pole opcjonalne dla przypadków określonych w art. 106e ust. 2, 3, 4 pkt 3 i ust. 5 pkt 3 ustawy
LP - Long Kolejny numer wiersza faktury
Example
{
  "PodatekVatTaxFree": Decimal,
  "ZnacznikZamowieniaTowaruLubUslugi": false,
  "StanPrzed": false,
  "WartoscVat": Decimal,
  "ZnacznikTowaruLubUslugi": true,
  "UnikalnyNumer": "abc123",
  "DataDostawy": "2007-12-03T10:15:30Z",
  "Nazwa": "abc123",
  "GTIN": "xyz789",
  "PKWIU": "xyz789",
  "CN": "xyz789",
  "PKOB": "abc123",
  "GTU": "GTU_01",
  "DodatkoweInfo": "abc123",
  "JM": "xyz789",
  "Ilosc": Decimal,
  "CenaNetto": Decimal,
  "CenaBrutto": Decimal,
  "KwotaOpustu": Decimal,
  "WartoscNetto": Decimal,
  "WartoscBrutto": Decimal,
  "StawkaPodatku": "VAT_23",
  "ProceduraVat": "PROCEDURA1",
  "KwotaAkcyzy": Decimal,
  "KursWaluty": Decimal,
  "Procedura": "WSTO_EE",
  "StawkaOSS": Decimal,
  "LP": {}
}