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.

License

Warunki użytkowania programów w chmurze

https://materialy.symfonia.pl/publiczne/8d0b44?_gl=1*1mwyxw6*_ga*NTYzODY5NDI4LjE2ODA3NzQzNTM.*_ga_G3P4SPM583*MTcwMzc2MjU3Ny43OS4wLjE3MDM3NjI1NzcuNjAuMC4w

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

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": "19b4bde2-9046-4bce-849c-934d6b46b6b0",
  "order": ItemsOrderInput
}

Response

{
  "data": {
    "CompanyStatistics": {
      "TenantAssignments": [TenantAssignmentViewModel],
      "TotalTenantsCount": {},
      "TotalCompanysCount": {}
    }
  }
}

Queries

`GetCurrentSchemaVersion`

Description

Zwraca listę aktualnych wersji schematu faktury Symfonia KSeF.

EnvironmentId: COMPANY

Response

Returns a GetCurrentSchemaVersionResponse!

Example

Query

query GetCurrentSchemaVersion {
  GetCurrentSchemaVersion {
    SchemaVersion
  }
}

Response

{"data": {"GetCurrentSchemaVersion": {"SchemaVersion": ["V12648"]}}}

Queries

`GetEArchiveNotifications`

Description

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

EnvironmentId: COMPANY

Response

Returns a GetEArchiveNotificationsResponse!

Example

Query

query GetEArchiveNotifications {
  GetEArchiveNotifications {
    Notifications
  }
}

Response

{"data": {"GetEArchiveNotifications": {"Notifications": ["NONE"]}}}

Queries

`GetInvoiceFileContentActionGroup`

Description

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

EnvironmentId: COMPANY

Response

Returns a GetInvoiceFileContentActionGroupType!

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": [
    "19b4bde2-9046-4bce-849c-934d6b46b6b0"
  ],
  "Token": "abc123"
}

Response

{
  "data": {
    "GetInvoiceFileContentActionGroup": {
      "ZipName": "xyz789",
      "ZipContent": "abc123",
      "MimeType": "abc123"
    }
  }
}

Queries

`GetInvoiceFileContentSingle`

Description

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

EnvironmentId: COMPANY

Response

Returns a GetInvoiceFileContentSingleType!

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": "19b4bde2-9046-4bce-849c-934d6b46b6b0",
  "Token": "xyz789"
}

Response

{
  "data": {
    "GetInvoiceFileContentSingle": {
      "PdfName": "abc123",
      "PdfContent": "xyz789",
      "HtmlContent": "xyz789",
      "MimeType": "abc123"
    }
  }
}

Queries

`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": "xyz789",
  "take": {},
  "skip": {},
  "order": ItemsOrderInput
}

Response

{
  "data": {
    "GetInvoices": {
      "Items": [InvoiceDto],
      "TotalCount": {},
      "FilteredCount": {}
    }
  }
}

Queries

`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": {}
    }
  }
}

Queries

`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": "19b4bde2-9046-4bce-849c-934d6b46b6b0"
}

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
    }
  }
}

Queries

`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": "19b4bde2-9046-4bce-849c-934d6b46b6b0"
}

Response

{
  "data": {
    "GetKSeFInvoiceDTOV2": {
      "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
    }
  }
}

Queries

`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
  }
}

Variables

{
  "InvoiceId": "19b4bde2-9046-4bce-849c-934d6b46b6b0"
}

Response

{
  "data": {
    "GetKSeFInvoiceXML": {
      "Content": "xyz789"
    }
  }
}

Queries

`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]}}}

Queries

`GetMissedWebsocketSubscriptions`

Description

Uruchamia ponowne wysłanie nieprzeczytanych notyfikacji websocket-owych.

EnvironmentId: COMPANY

Response

Returns a GetMissedWebsocketSubscriptionsResponse!

Example

Query

query GetMissedWebsocketSubscriptions {
  GetMissedWebsocketSubscriptions {
    Success
  }
}

Response

{"data": {"GetMissedWebsocketSubscriptions": {"Success": true}}}

Queries

`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": "19b4bde2-9046-4bce-849c-934d6b46b6b0"
}

Response

{
  "data": {
    "GetPackageStatistic": {
      "Items": [Package],
      "Status": "INACTIVE",
      "CurrentInvoicesCount": 123,
      "CurrentStorageCount": Decimal,
      "SerialNumber": "abc123",
      "SubscriptionNumber": "abc123",
      "CustomerNumber": "xyz789",
      "Email": "abc123",
      "DateTo": "2007-12-03"
    }
  }
}

Queries

`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": {}
    }
  }
}

Queries

`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": [
    "19b4bde2-9046-4bce-849c-934d6b46b6b0"
  ],
  "UpoFileType": "PDF"
}

Response

{
  "data": {
    "GetUPO": {
      "FileName": "abc123",
      "FileContent": "abc123",
      "MimeType": "abc123",
      "MissingInvoices": [MissedInvoice],
      "RequestedInvoices": [
        "19b4bde2-9046-4bce-849c-934d6b46b6b0"
      ],
      "ReturnedInvoices": [
        "19b4bde2-9046-4bce-849c-934d6b46b6b0"
      ]
    }
  }
}

Queries

`GetUserKSeFRequestForCredentials`

Description

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

EnvironmentId: COMPANY

Response

Returns an GetUserKSeFRequestForCredentialsResponseType!

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": {}
    }
  }
}

Queries

`GetWebsocketNotificationModel`

Description

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

EnvironmentId: COMPANY

Response

Returns a GetWebsocketNotificationModelResponse!

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": "19b4bde2-9046-4bce-849c-934d6b46b6b0"
}

Response

{
  "data": {
    "GetWebsocketNotificationModel": {
      "UserId": "19b4bde2-9046-4bce-849c-934d6b46b6b0",
      "CompanyId": "19b4bde2-9046-4bce-849c-934d6b46b6b0",
      "ErrorType": "SYSTEM",
      "ErrorContent": [KeyValuePairOfStringAndString],
      "Message": "abc123",
      "Type": "AUTHORIZE_IN_KSEF",
      "NotificationId": "19b4bde2-9046-4bce-849c-934d6b46b6b0",
      "Timestamp": "2007-12-03T10:15:30Z",
      "Visited": true,
      "HasDownloadableContent": true,
      "ResponseJson": "abc123",
      "State": "ENQUEUED",
      "SimultaneousRunType": "SEQUENTIAL"
    }
  }
}

Queries

`GetWebsocketNotificationModelExtended`

Description

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

EnvironmentId: COMPANY

Response

Returns a GetWebsocketNotificationModelExtendedResponse!

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": "19b4bde2-9046-4bce-849c-934d6b46b6b0"
}

Response

{
  "data": {
    "GetWebsocketNotificationModelExtended": {
      "UserId": "19b4bde2-9046-4bce-849c-934d6b46b6b0",
      "CompanyId": "19b4bde2-9046-4bce-849c-934d6b46b6b0",
      "ErrorType": "SYSTEM",
      "ErrorContent": [KeyValuePairOfStringAndString],
      "Message": "abc123",
      "Type": "AUTHORIZE_IN_KSEF",
      "NotificationId": "19b4bde2-9046-4bce-849c-934d6b46b6b0",
      "Timestamp": "2007-12-03T10:15:30Z",
      "Visited": true,
      "HasDownloadableContent": false,
      "ResponseJson": "abc123",
      "ResponseModel": ResponseModel,
      "State": "ENQUEUED",
      "SimultaneousRunType": "SEQUENTIAL"
    }
  }
}

Queries

`GetWebsocketNotificationsList`

Description

Zwraca listę notyfikacji WebSocket-owych o podanym statusie.

EnvironmentId: COMPANY

Response

Returns a GetWebsocketNotificationResponse!

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
      ]
    }
  }
}

Queries

`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"
    }
  }
}

Queries

`MyEnvironments`

Description

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

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

Response

Returns a MyEnvironmentsViewModelResponse!

Example

Query

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

Response

{
  "data": {
    "MyEnvironments": {
      "Environments": [EnvironmentViewModel]
    }
  }
}

Queries

`SubscribeDownloadInvoicesFromKSeF`

Description

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

EnvironmentId: COMPANY

Response

Returns an SubscribeDownloadInvoicesFromKSeFResponse!

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": false,
  "internal": DateTimeRangeInput,
  "externalEnabled": false,
  "external": DateTimeRangeInput
}

Response

{
  "data": {
    "SubscribeDownloadInvoicesFromKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

Queries

`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": [
    "19b4bde2-9046-4bce-849c-934d6b46b6b0"
  ],
  "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"
    }
  }
}

Mutations

`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"
    }
  }
}

Mutations

`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": [
    "19b4bde2-9046-4bce-849c-934d6b46b6b0"
  ]
}

Response

{
  "data": {
    "DeleteInvoices": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

Mutations

`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"
  }
}

Mutations

`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

Response

Returns a KSeFAutoFetchingInvoicesResponseType!

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

Example

Query

mutation KSeFAutoFetchingInvoices(
  $Status: CompanyKsefServicesStatusEnum!,
  $InternalEnabled: Boolean!,
  $ExternalEnabled: Boolean!,
  $Type: KSeFAutomaticOperationType!,
  $Minutes: Int!
) {
  KSeFAutoFetchingInvoices(
    Status: $Status,
    InternalEnabled: $InternalEnabled,
    ExternalEnabled: $ExternalEnabled,
    Type: $Type,
    Minutes: $Minutes
  ) {
    Success
  }
}

Variables

{
  "Status": "INACTIVE",
  "InternalEnabled": false,
  "ExternalEnabled": false,
  "Type": "TIME",
  "Minutes": 987
}

Response

{"data": {"KSeFAutoFetchingInvoices": {"Success": true}}}

Mutations

`KSeFAutoSendingInvoices`

Description

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

EnvironmentId: COMPANY

Response

Returns a KSeFAutoSendingInvoicesResponseType!

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}}}

Mutations

`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": [
    "19b4bde2-9046-4bce-849c-934d6b46b6b0"
  ]
}

Response

{
  "data": {
    "MultipleSendToKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

Mutations

`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": [
    "19b4bde2-9046-4bce-849c-934d6b46b6b0"
  ]
}

Response

{"data": {"PublishInvoices": {"Sent": 123, "Failed": 987}}}

Mutations

`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"
    }
  }
}

Mutations

`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

Response

Returns a RemoveAuthorizationExternalResult!

Example

Query

mutation RemoveAuthorizationWithExternalTokenInKSeF {
  RemoveAuthorizationWithExternalTokenInKSeF {
    NotificationModel {
      ...WebsocketNotificationModelFragment
    }
    Result
  }
}

Response

{
  "data": {
    "RemoveAuthorizationWithExternalTokenInKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

Mutations

`RemoveEArchiveNotifications`

Description

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

EnvironmentId: COMPANY

Response

Returns a RemoveEArchiveNotificationsResponse!

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}}}

Mutations

`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": true}

Response

{
  "data": {
    "SendToEArchive": {
      "Numer": "19b4bde2-9046-4bce-849c-934d6b46b6b0"
    }
  }
}

Mutations

`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

Response

Returns a SendToEArchiveBatchV2ResponseType!

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": false}

Response

{
  "data": {
    "SendToEArchiveBatchV2": {
      "SuccessItems": [BatchResponseItem],
      "ErrorItems": [BatchResponseItem]
    }
  }
}

Mutations

`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": false}

Response

{
  "data": {
    "SendToEArchiveV2": {
      "Numer": "19b4bde2-9046-4bce-849c-934d6b46b6b0"
    }
  }
}

Mutations

`SetEArchiveNotifications`

Description

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

EnvironmentId: COMPANY

Response

Returns a SetEArchiveNotificationsResponse!

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}}}

Mutations

`SetWebsocketNotificationAcknowledge`

Description

Oznacza podane notyfikacje WebSocket-owe jako przeczytane.

EnvironmentId: COMPANY

Response

Returns a SetWebsocketNotificationAcknowledgeType!

Arguments

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

Example

Query

mutation SetWebsocketNotificationAcknowledge($NotificationIds: [UUID!]!) {
  SetWebsocketNotificationAcknowledge(NotificationIds: $NotificationIds) {
    Success
  }
}

Variables

{
  "NotificationIds": [
    "19b4bde2-9046-4bce-849c-934d6b46b6b0"
  ]
}

Response

{"data": {"SetWebsocketNotificationAcknowledge": {"Success": false}}}

Mutations

`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

Response

Returns an SubscribeGrantPermissionsInKSeFResponse!

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": "abc123",
  "IdentifierType": "NIP",
  "CredentialsInvoiceRead": true,
  "CredentialsInvoiceWrite": true,
  "CredentialsRead": true,
  "CredentialsManage": true,
  "CredentialsSelfInvoicing": true,
  "NipType": "INSTITUTIONAL_NIP"
}

Response

{
  "data": {
    "SubscribeGrantPermissionsInKSeF": {
      "NotificationModel": WebsocketNotificationModel,
      "Result": "ENQUEUED"
    }
  }
}

Mutations

`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"
    }
  }
}

Mutations

`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": "abc123",
  "ZipCode": "abc123",
  "City": "xyz789",
  "State": "abc123",
  "Country": "xyz789"
}

Input Field	Description
`and` - `[AddressFilterInput!]`
`or` - `[AddressFilterInput!]`
`AddressLine` - `StringOperationFilterInput`	Adres
`ZipCode` - `StringOperationFilterInput`	Kod pocztowy
`City` - `StringOperationFilterInput`	Miasto
`State` - `StringOperationFilterInput`	Województwo
`Country` - `StringOperationFilterInput`	Kraj

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

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

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

Field Name	Description
`NotificationModel` - `WebsocketNotificationModel`	Treść notyfikacji
`Result` - `SubscriptionStateEnum!`	Stan operacji

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

Field Name	Description
`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
`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

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/)

Input Field	Description
`and` - `[CompanyFilterInput!]`
`or` - `[CompanyFilterInput!]`
`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
`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

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

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

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

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)

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`

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`

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`

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

Input Field	Description
`eq` - `DesktopStatus`
`neq` - `DesktopStatus`
`in` - `[DesktopStatus!]`
`nin` - `[DesktopStatus!]`

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.

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

Field Name	Description
`kSeFNumber` - `String`	Numer faktury w KSeF
`kSeFDate` - `DateTime!`	Data nadania numeru KSeF
`errorMessage` - `String`	Opis błędu
`invoiceBound` - `InvoiceBound`	Typ faktury

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

Enum Value	Description
`PENDING_APPROVAL`	Oczekujący na zatwierdzenie
`INACTIVE`	Nieaktywny
`ACTIVE`	Aktywny
`REMOVED`	Usunięty
`TO_DELETE`	Do usunięcia

Enum Value	Description
`NONE`	Niewymagane środowisko
`ADMIN`	Admin / BOK
`TENANT`	Organizacja
`COMPANY`	Firma

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

Field Name	Description
`User` - `UserInfo`
`Id` - `UUID!`
`IsActive` - `Boolean!`
`Type` - `EnvironmentType!`
`Company` - `CompanyInfo`
`Tenant` - `TenantInfo`

Input Field	Description
`CreatedAfterInvoiceId` - `UUID`	Filtrowanie od daty utworzenia id faktury
`InvoiceIds` - `[UUID!]`	Filtrowanie po liście id faktur w Symfonia KSeF. Użycie tego filtra spowoduje pominięcie pozostałych kryteriów nawet jeśli zostały dodatkowo podane
`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

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)

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)

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)