• 200 OK - pomyślnie przesłano dane w metodzie GET, POST
• 204 No Content - pomyślnie zakończono akcję w metodzie PUT, DELETE
• 400 Bad Request - błąd w treści żądanie
• 401 Unauthorized - brak uwierzytelniania
• 403 Forbidden - dostęp zablokowany
• 404 Not Found - nie znaleziono zasobu
• 405 Method Not Allowed - nieobsługiwana metoda
• 500 Internal Server Error - wewnętrzny błąd serwera

POBIERANIE PRODUKTÓW

[
    {
        "Name": "Klawiatura ergonomiczna",
        "Description": "",
        "ItemCode": "555",
        "ProductCode": "P/000001",
        "UnitOfMeasurment": "szt.",
        "Rate": 9,
        "SaleNetPrice": 81.30,
        "SaleGrossPrice": 100.00,
        "Quantity": 0.0,
        "ProductType": 0,
        "Id": 10906567
    },
    {
        "Name": "Mysz komputerowa",
        "Description": "",
        "ItemCode": "",
        "ProductCode": "P/000002",
        "UnitOfMeasurment": "szt.",
        "Rate": 9,
        "SaleNetPrice": 50.00,
        "SaleGrossPrice": 61.50,
        "Quantity": 0.0,
        "ProductType": 0,
        "Id": 10951199
    },
    {
        "Name": "Wymiana dysku",
        "Description": "",
        "ItemCode": "",
        "ProductCode": "P/000003",
        "UnitOfMeasurment": "szt.",
        "Rate": 9,
        "SaleNetPrice": 100.00,
        "SaleGrossPrice": 123.00,
        "Quantity": 0.0,
        "ProductType": 0,
        "Id": 10985424
    }
]

{
    "Name": "Mysz komputerowa",
    "Description": "",
    "ItemCode": "",
    "ProductCode": "P/000002",
    "UnitOfMeasurment": "szt.",
    "Rate": 9,
    "SaleNetPrice": 50.0,
    "SaleGrossPrice": 61.5,
    "Quantity": 0.0,
    "ProductType": 0,
    "Id": 10951199
}

• wg nazwy: [GET] https://app.erpxt.pl/api2/public/products/?$filter=Name eq {nazwa}
• wg kodu: [GET] https://app.erpxt.pl/api2/public/products/?$filter=ProductCode eq {kod_produktu}

DODAWANIE NOWEGO PRODUKTU

{
    "Name": "Mysz komputerowa bezprzewodowa",
    "Description": "",
    "ItemCode": "",
    "UnitOfMeasurment": "szt.",
    "Rate": 9,
    "SaleGrossPrice": 24.99,
}

EDYCJA KARTY PRODUKTU

{
    "Name": "Klawiatura ergonomiczna",
    "UnitOfMeasurment": "szt.",
    "Rate": 9,
    "SaleGrossPrice": 139.00,
    "Id": 12156943
}

USUWANIE PRODUKTU

WYDRUKI DOKUMENTÓW

1) Wydruk dokumentu z szablonem przypisanym do kontrahenta

2) Wydruk dokumentu z szablonem utworzonym przez użytkownika

[
    {
        "Name": "Faktura VAT - VIP",
        "Language": "pl",
        "Type": 0,
        "Id": 10183725
    },
    {
        "Name": "Faktura VAT - mój wzór",
        "Language": "pl",
        "Type": 0,
        "Id": 10183730
    },
    {
        "Name": "Proforma 2019",
        "Language": "pl",
        "Type": 7,
        "Id": 10183731
    }
]

POBIERANIE FAKTUR SPRZEDAŻY

{
    "NetTotal": 100.00,
    "CurrencyNetTotal": 100.00,
    "GrossTotal": 123.00,
    "CurrencyGrossTotal": 123.00,
    "VatTotal": 23.00,
    "CurrencyVatTotal": 23.00,
    "CurrencyCode": "PLN",
    "CurrencyRateType": 0,
    "CurrencyRateDate": "2023-04-04T00:00:00+02:00",
    "CurrencyConverter": 1.0,
    "CurrencyRate": 1.0,
    "PaymentStatus": 0,
    "OSSProcedureCountryCode": "",
    "IsOSSProcedure": false,
    "IsFinal": false,
    "PurchasingPartyId": 125822,
    "PurchasingParty": {
        "Name": "COMARCH SPÓŁKA AKCYJNA",
        "NipPrefix": "",
        "Nip": "6770065406",
        "Country": "Polska",
        "City": "Kraków",
        "Street": "Aleja Jana Pawła II",
        "BuildingNumber": "39A",
        "FlatNumber": "4b",
        "BankName": "Bank Polska Kasa Opieki S.A. XI O. w Krakowie",
        "BankAccountNumber": "08 1240 4722 1111 0000 4851 1368",
        "CustomerType": 1
    },
    "ReceivingPartyId": null,
    "ReceivingParty": null,
    "PaymentTypeId": 4471,
    "PaymentType": 0,
    "PaymentDeadline": "2023-04-05T00:00:00+02:00",
    "BankAccountId": null,
    "BankAccountNumber": null,
    "SalesDate": "2023-04-05T00:00:00+02:00",
    "InvoiceType": 0,
    "DocumentCreatedByTaxPayer": true,
    "Items": [
        {
            "ProductId": 130753,
            "Quantity": 1.0000,
            "ProductCurrencyPrice": 100.00,
            "ProductPrice": 100.00,
            "ProductName": "Mysz komputerowa przewodowa",
            "ProductDescription": "",
            "UnitOfMeasurement": "szt.",
            "VatRateId": 9,
            "Id": 375493
        }
    ],
    "Description": null,
    "IssueDate": "2023-04-05T00:00:00+02:00",
    "Number": "FS/23/4/5",
    "Status": 1,
    "Id": 278251
}

DODAWANIE NOWEGO DOKUMENTU FAKTURY SPRZEDAŻY

{
    "PurchasingPartyId": 14458134,
    "PaymentTypeId": 10260089,
    "Items": [
         {
            "ProductId": 11521520,
            "Quantity": 10,
            "ProductCurrencyPrice": 249.90
        }
    ]
}

EDYCJA FAKTURY SPRZEDAŻY

{
    "PurchasingPartyId": 14458134,
    "PaymentTypeId": 10260089,
    "Items": [
        {
            "ProductId": 11521520,
            "Quantity": 20.0000,
            "ProductCurrencyPrice": 200.00,
            "Id": 50081265
        }
    ],
    "Id": 28964885
}

ZATWIERDZANIE FAKTUR SPRZEDAŻY

{
    "IdCollection": [
        28965353, 28965354, 28965355
    ]
}

[
    {
        "Confirmed": true,
        "ErrorMessage": "",
        "ErrorCode": "",
        "DocumentNumber": "FS/24/6/1",
        "DocumentId": 28965353
    },
    {
        "Confirmed": true,
        "ErrorMessage": "",
        "ErrorCode": "",
        "DocumentNumber": "FS/24/6/2",
        "DocumentId": 28965354
    },
    {
        "Confirmed": true,
        "ErrorMessage": "",
        "ErrorCode": "",
        "DocumentNumber": "FS/24/6/3",
        "DocumentId": 28965355
    }
]

USUWANIE FAKTURY SPRZEDAŻY

POBIERANIE FORM PŁATNOŚCI

[
    {
        "Name": "Gotówka",
        "Primary": true,
        "Deadline": 0,
        "Type": 0,
        "Id": 10260089
    },
    {
        "Name": "Przelew",
        "Primary": false,
        "Deadline": 7,
        "Type": 1,
        "Id": 10260090
    },
    {
        "Name": "Karta",
        "Primary": false,
        "Deadline": 0,
        "Type": 2,
        "Id": 10260091
    }
]

{
    "Name": "Karta",
    "Primary": false,
    "Deadline": 0,
    "Type": 2,
    "Id": 10260091
}

DODAWANIE NOWEJ FORMY PŁATNOŚCI

{
    "Name": "Za pobraniem",
    "Primary": false,
    "Deadline": 21,
    "Type": 2
}

EDYCJA FORMY PŁATNOŚCI

{
    "Name": "Za pobraniem",
    "Primary": false,
    "Deadline": 21,
    "Type": 2,
    "Id": 29017
}

USUWANIE FORMY PŁATNOŚCI

• faktur sprzedaży (wersja 1.4),
• faktur zaliczkowych (wersja 1.4),
• faktur proforma (wersja 1.4),
• korekt (wersja 1.4).

• rozszerzono zakres danych pobieranych z dokumentu,
• dodano funkcję pobierania i edycji terminu płatności.

• Faktura sprzedaży wersja 1.2 - dodano metodę do zatwierdzania dokumentów będących w buforze
• Faktura zaliczkowa
• Przekształcanie faktur zaliczkowych

• Rachunki bankowe
• Formy płatności

• Kontrahenci wersja 1.2
• Faktura sprzedaży wersja 1.2
• Faktura proforma wersja 1.2

• 0 - usługa
• 1 - towar
• 2 - towar z kontrolą stanu

• Faktura proforma
• Faktura proforma wersja 1.1

• https://app.erpxt.pl/api2/public/v1.1/invoices
• https://app.erpxt.pl/api2/public/v1.1/proformas
• https://app.erpxt.pl/api2/public/v1.1/invoices/print/{id}
• https://app.erpxt.pl/api2/public/v1.1/proformas/print/{id}

• wskazać odbiorcę na dokumentach faktury sprzedaży i fakturach proforma (ReceivingPartyId)
• ustawić algorytm naliczania - od cen netto (InvoiceType=0) oraz od cen brutto (InvoiceType=1)
• dodać opis na dokument (Description)
• pobrać wydruk dokumentu wg domyślnego szablonu przypisanego do kontrahenta

• zapisać cenę sprzedaży produktu w kwotach brutto (ProductCurrencyPrice)
• pobrać informacje o stanie magazynowym towaru (Quantity)

• produkty
  • wg nazwy (.../products/?$filter=Name eq {nazwa})
  • wg kodu (.../products/?$filter=ProductCode eq {kod_produktu})
• kontrahenci
  • wg NIP (.../customers/nip/{nr_nip})
  • wg nazwy (.../customers/?$filter=Name eq {nazwa})
  • wg adresu e-mail (.../customers/?$filter=Mail eq {adres_email})
• dokumenty
  • wg numeru faktury sprzedaży (.../invoices/number/{nr_dokumentu})
  • wg numeru faktury proforma (.../proformas/number/{nr_dokumentu})

• pobieranie, dodawanie, modyfikowanie i usuwanie produktów
• pobieranie, dodawanie, modyfikowanie i usuwanie kontrahentów
• pobieranie form zapłaty,
• pobieranie rachunków bankowych,
• pobieranie faktur sprzedaży i faktur proforma
• dodawanie faktur sprzedaży i faktur proforma
• usuwanie faktur sprzedaży i faktur proforma
• pobieranie wydruku faktury sprzedaży i faktury proforma z możliwością wskazania szablonu

POBIERANIE RACHUNKÓW BANKOWYCH

[
    {
        "AccountNumber": "77812510180448594079740300",
        "BankName": "Bank Polskiej Spółdzielczości S.A.",
        "Symbol": "BPSSA",
        "ReportingPeriod": 3,
        "Primary": true,
        "Id": 8843
    },
    {
        "AccountNumber": "PL 21 2250 0001 5277 7281 8088 8086",
        "BankName": "Svenska Handelsbanken AB S.A. Oddział w Polsce Centrala",
        "Symbol": "SHBPL",
        "ReportingPeriod": 3,
        "Primary": false,
        "Id": 8844
    }
]

{
    "AccountNumber": "PL 21 2250 0001 5277 7281 8088 8086",
    "BankName": "Svenska Handelsbanken AB S.A. Oddział w Polsce Centrala",
    "Symbol": "SHBPL",
    "ReportingPeriod": 3,
    "Primary": false,
    "Id": 8844
}

DODAWANIE NOWEGO RACHUNKU BANKOWEGO

{
    "AccountNumber": "PL 21 2250 0001 5277 7281 8088 8086",
    "BankName": "Svenska Handelsbanken AB S.A. Oddział w Polsce Centrala",
    "Symbol": "SHBPL"",
    "ReportingPeriod": 3,
    "Primary": false
}

EDYCJA RACHUNKU BANKOWEGO

{
    "AccountNumber": "PL 21 2250 0001 5277 7281 8088 8086",
    "BankName": "Svenska Handelsbanken AB S.A. Oddział w Polsce Centrala",
    "Symbol": "SHBPL"",
    "ReportingPeriod": 4,
    "Primary": false
    "Id": 8844
}

USUWANIE RACHUNKU BANKOWEGO

POBIERANIE KONTRAHENTÓW

[
    {
        "Name": "COMARCH SPÓŁKA AKCYJNA",
        "CountryCode": "",
        "CustomerTaxNumber": "6770065406",
        "CustomerCode": "K/000369",
        "Mail": "",
        "PhoneNumber": "",
        "CustomerType": 1,
        "Address": {
            "Street": "Aleja Jana Pawła II",
            "BuildingNumber": "39 A",
            "FlatNumber": "",
            "PostalCode": "31-864",
            "City": "Kraków",
            "Id": 529657
        },
        "CustomerStatus": 0,
        "RepresentativeFirstName": "Jan",
        "RepresentativeLastName": "Kowalski",
        "Id": 529611
    },
    {
        "Name": "COMARCH HEALTHCARE SPÓŁKA AKCYJNA",
        "CountryCode": "",
        "CustomerTaxNumber": "6751382502",
        "CustomerCode": "K/000371",
        "Mail": "",
        "PhoneNumber": "",
        "CustomerType": 1,
        "Address": {
            "Street": "Aleja Jana Pawła II",
            "BuildingNumber": "39A",
            "FlatNumber": "",
            "PostalCode": "31-864",
            "City": "Kraków",
            "Id": 529660
        },
        "CustomerStatus": 0,
        "RepresentativeFirstName": "Jan",
        "RepresentativeLastName": "Kowalski",
        "Id": 529614
    }
]

• wg nazwy: [GET] https://app.erpxt.pl/api2/public/v1.2/customers/?$filter=Name eq {nazwa}
• wg adresu e-mail: [GET] https://app.erpxt.pl/api2/public/v1.2/customers/?$filter=Mail eq {adres_email}

DODAWANIE NOWEGO KONTRAHENTA

{
    "Name": "COMARCH CLOUD SPÓŁKA AKCYJNA",
    "CustomerTaxNumber": "6751402274",
    "Mail": "erpxt@comarch.pl"
}

EDYCJA KONTRAHENTA

{
    "Name": "COMARCH CLOUD SPÓŁKA AKCYJNA",
    "CustomerTaxNumber": "6751402274",
    "Mail": "erpxt2@comarch.pl",
    "Id": 2
}

USUWANIE KARTY KONTRAHENTA

• filtrowanie - filter
• sortowanie - orderby
• stronicowanie - skip oraz top

• równość – eq
• nierówność – ne
• większe od – gt
• większe lub równe – ge
• mniejsze od – lt
• mniejsze lub równe – le

• koniunkcja - and
• alternatywa - or
• zaprzeczenie - not

PROCEDURA OSS

• wskazać na dokumencie kontrahenta ze statusem "Procedura OSS". Dodanie takiego kontrahenta jest możliwe także przez interfejs API – przy użyciu metody Kontrahenci w wersji 1.2
• określić czy do danej transakcji będą stosowane mechanizmy procedury OSS. W związku z tym w API zostały dodane dwie nowe metody: Faktura sprzedaży i Faktura proforma w wersji 1.2, zawierające nowe pola związane z OSS.
• podać kraj i stawkę VAT, wg której powinna być realizowana sprzedaż w procedurze OSS. Do tego celu można skorzystać z dodatkowych metod opisanych poniżej.

POBIERANIE KODÓW KRAJÓW UE

POBIERANIE ZAGRANICZNYCH STAWEK VAT

POBIERANIE FAKTUR ZAKUPU

{
    "SellingPartyId": 125819,
    "ReceivingPartyId": null,
    "PaymentTypeId": 4471,
    "PaymentType": 0,
    "PaymentDeadline": "2023-04-05T00:00:00+02:00",
    "PaymentStatus": 0,
    "BankAccountId": null,
    "BankAccountNumber": null,
    "SellingPartyBankAccountNumber": "",
    "SellingPartyBankAccountName": "",
    "PurchaseDate": "2023-04-05T00:00:00+02:00",
    "InvoiceType": 0,
    "NetTotal": 80.00,
    "CurrencyNetTotal": 80.00,
    "GrossTotal": 98.40,
    "CurrencyGrossTotal": 98.40,
    "VatTotal": 18.40,
    "CurrencyVatTotal": 18.40,
    "CurrencyCode": "PLN",
    "CurrencyRateType": 0,
    "CurrencyRateDate": "2023-04-04T00:00:00+02:00",
    "CurrencyConverter": 1.0,
    "CurrencyRate": 1.0,
    "ReceiptDate": "2023-04-05T00:00:00+02:00",
    "ReferenceNumber": "FA/1/2023",
    "Items": [
        {
            "ProductId": 129135,
            "Quantity": 1.0000,
            "ProductCurrencyPrice": 80.00,
            "ProductPrice": 80.00,
            "ProductName": "Mysz komputerowa",
            "ProductDescription": "",
            "UnitOfMeasurement": "szt.",
            "VatRateId": 9,
            "Id": 375481
        }
    ],
    "Description": "",
    "IssueDate": "2023-04-05T00:00:00+02:00",
    "Number": "FZ/23/4/1",
    "Status": 0,
    "Id": 278239
}

POBIERANIE FAKTUR PROFORMA

{
    "PurchasingPartyId": 125822,
    "PurchasingParty": {
        "Name": "COMARCH SPÓŁKA AKCYJNA",
        "NipPrefix": "",
        "Nip": "6770065406",
        "Country": "Polska",
        "City": "Kraków",
        "Street": "Aleja Jana Pawła II",
        "BuildingNumber": "39A",
        "FlatNumber": "4b",
        "BankName": "Bank Polska Kasa Opieki S.A. XI O. w Krakowie",
        "BankAccountNumber": "08 1240 4722 1111 0000 4851 1368",
        "CustomerType": 1
    },
    "ReceivingPartyId": null,
    "ReceivingParty": null,
    "PaymentTypeId": 4471,
    "PaymentType": 0,
    "PaymentDeadline": "2023-04-05T00:00:00+02:00",
    "BankAccountId": null,
    "BankAccountNumber": null,
    "InvoiceType": 0,
    "OSSProcedureCountryCode": "",
    "IsOSSProcedure": false,
    "InvoiceDocIdNum": null,
    "CurrencyCode": "PLN",
    "CurrencyRateType": 0,
    "CurrencyRateDate": "2023-04-04T00:00:00+02:00",
    "CurrencyConverter": 1.0,
    "CurrencyRate": 1.0,
    "Items": [
        {
            "ProductId": 130753,
            "Quantity": 1.0000,
            "ProductCurrencyPrice": 100.00,
            "ProductPrice": 100.00,
            "ProductName": "Mysz komputerowa przewodowa",
            "ProductDescription": "",
            "UnitOfMeasurement": "szt.",
            "VatRateId": 9,
            "Id": 375496
        }
    ],
    "Description": "",
    "IssueDate": "2023-04-05T00:00:00+02:00",
    "Number": "PF/23/4/2",
    "Status": 0,
    "Id": 278254
}

DODAWANIE NOWEGO DOKUMENTU FAKTURY PROFORMA

{
    "PurchasingPartyId": 14458134,
    "PaymentTypeId": 10260089,
    "Items": [
         {
            "ProductId": 11521520,
            "Quantity": 10,
            "ProductCurrencyPrice": 100.00
        }
    ]
}

EDYCJA FAKTURY PROFORMA

{
    "PurchasingPartyId": 14458134,
    "PaymentTypeId": 10260089,
    "Items": [
        {
            "ProductId": 11521520,
            "Quantity": 20,
            "ProductCurrencyPrice": 120.00,
            "Id": 50081265
        }
    ],
    "Id": 28964885
}

USUWANIE FAKTURY PROFORMA

POBIERANIE FAKTUR KORYGUJĄCYCH

{
    "PurchasingPartyId": 125822,
    "PurchasingParty": {
        "Name": "COMARCH SPÓŁKA AKCYJNA",
        "NipPrefix": "",
        "Nip": "6770065406",
        "Country": "Polska",
        "City": "Kraków",
        "Street": "Aleja Jana Pawła II",
        "BuildingNumber": "39A",
        "FlatNumber": "4b",
        "BankName": "Bank Polska Kasa Opieki S.A. XI O. w Krakowie",
        "BankAccountNumber": "08 1240 4722 1111 0000 4851 1368",
        "CustomerType": 1
    },
    "ReceivingPartyId": null,
    "ReceivingParty": null,
    "PaymentTypeId": 4471,
    "PaymentType": 0,
    "PaymentDeadline": "2023-04-05T00:00:00+02:00",
    "BankAccountId": null,
    "BankAccountNumber": null,
    "SalesDate": "2023-04-05T00:00:00+02:00",
    "InvoiceType": 0,
    "PaymentStatus": 0,
    "OSSProcedureCountryCode": "",
    "IsOSSProcedure": false,
    "CorrectedId": 278251,
    "CorrectionReasonText": "Zwrot",
    "CurrencyCode": "PLN",
    "CurrencyRateType": 0,
    "CurrencyRateDate": "2023-04-04T00:00:00+02:00",
    "CurrencyConverter": 1.0,
    "CurrencyRate": 1.0,
    "DocumentCreatedByTaxPayer": true,
    "Items": [
        {
            "ProductId": 130753,
            "Quantity": 0.0,
            "ProductCurrencyPrice": 100.00,
            "ProductPrice": 100.00,
            "ProductName": "Mysz komputerowa przewodowa",
            "ProductDescription": "",
            "UnitOfMeasurement": "szt.",
            "VatRateId": 9,
            "CorrectedId": 375493,
            "Id": 375494
        }
    ],
    "Description": null,
    "IssueDate": "2023-04-05T00:00:00+02:00",
    "Number": "KOR/23/4/2",
    "Status": 1,
    "Id": 278252
}

DODAWANIE NOWEGO DOKUMENTU FAKTURY KORYGUJĄCEJ

EDYCJA FAKTURY KORYGUJĄCEJ

{
    "PaymentTypeId": 1509,
    "CorrectedId": 1686883,
    "CorrectionReasonText": "",
    "Items": [
        {
            "ProductId": 438092,
            "Quantity": 1.0000,
            "ProductCurrencyPrice": 100.00,
            "ProductDescription": "",
            "VatRateId": 9,
            "Id": 4534062
        }
    ],
    "Id": 23323962
}

ZATWIERDZANIE FAKTUR KORYGUJĄCYCH

{
    "IdCollection": [
        1686874, 1686871
    ]
}

[
    {
        "Confirmed": true,
        "ErrorMessage": "",
        "ErrorCode": "",
        "DocumentNumber": "KOR/23/12/1",
        "DocumentId": 1686871
    },
    {
        "Confirmed": true,
        "ErrorMessage": "",
        "ErrorCode": "",
        "DocumentNumber": "KOR/23/12/2",
        "DocumentId": 1686874
    }
]

USUWANIE FAKTURY KORYGUJĄCYCH

KOREKTY DO FAKTUR ZALICZKOWYCH

KOREKTY DO FAKTUR ZAKUPU

POBIERANIE FAKTUR ZALICZKOWYCH

{
    "NetTotal": 10.00,
    "CurrencyNetTotal": 10.00,
    "GrossTotal": 12.30,
    "CurrencyGrossTotal": 12.30,
    "VatTotal": 2.30,
    "CurrencyVatTotal": 2.30,
    "CurrencyCode": "PLN",
    "CurrencyRateType": 0,
    "CurrencyRateDate": "2023-04-04T00:00:00+02:00",
    "CurrencyConverter": 1.0,
    "CurrencyRate": 1.0,
    "PaymentStatus": 0,
    "OSSProcedureCountryCode": "",
    "IsOSSProcedure": false,
    "PurchasingPartyId": 125822,
    "PurchasingParty": {
        "Name": "COMARCH SPÓŁKA AKCYJNA",
        "NipPrefix": "",
        "Nip": "6770065406",
        "Country": "Polska",
        "City": "Kraków",
        "Street": "Aleja Jana Pawła II",
        "BuildingNumber": "39A",
        "FlatNumber": "4b",
        "BankName": "Bank Polska Kasa Opieki S.A. XI O. w Krakowie",
        "BankAccountNumber": "08 1240 4722 1111 0000 4851 1368",
        "CustomerType": 1
    },
    "ReceivingPartyId": null,
    "ReceivingParty": null,
    "PaymentTypeId": 4471,
    "PaymentType": 0,
    "PaymentDeadline": "2023-04-05T00:00:00+02:00",
    "BankAccountId": null,
    "BankAccountNumber": null,
    "SalesDate": "2023-04-05T00:00:00+02:00",
    "InvoiceType": 0,
    "Items": [
        {
            "CurrencyAdvance": 10.00,
            "ProductId": 130753,
            "Quantity": 1.0000,
            "ProductCurrencyPrice": 100.00,
            "ProductPrice": 100.00,
            "ProductName": "Mysz komputerowa przewodowa",
            "ProductDescription": "",
            "UnitOfMeasurement": "szt.",
            "VatRateId": 9,
            "Id": 375500
        }
    ],
    "Description": "",
    "IssueDate": "2023-04-05T00:00:00+02:00",
    "Number": "FAZAL/2023/4/1",
    "Status": 1,
    "Id": 278258
}

{
    "NetTotal": 50.00,
    "CurrencyNetTotal": 50.00,
    "GrossTotal": 59.50,
    "CurrencyGrossTotal": 59.50,
    "VatTotal": 9.50,
    "CurrencyVatTotal": 9.50,
    "CurrencyCode": "PLN",
    "CurrencyRateType": 0,
    "CurrencyRateDate": "2023-04-04T00:00:00+02:00",
    "CurrencyConverter": 1.0,
    "CurrencyRate": 1.0,
    "PaymentStatus": 0,
    "OSSProcedureCountryCode": "DE",
    "IsOSSProcedure": true,
    "PurchasingPartyId": 127870,
    "PurchasingParty": {
        "Name": "Musterfirma GmbH",
        "NipPrefix": "DE",
        "Nip": "78964867884",
        "Country": "",
        "City": "",
        "Street": "",
        "BuildingNumber": "",
        "FlatNumber": "",
        "BankName": "",
        "BankAccountNumber": "",
        "CustomerType": 1
    },
    "ReceivingPartyId": null,
    "ReceivingParty": null,
    "PaymentTypeId": 4471,
    "PaymentType": 0,
    "PaymentDeadline": "2023-04-05T00:00:00+02:00",
    "BankAccountId": null,
    "BankAccountNumber": null,
    "SalesDate": "2023-04-05T00:00:00+02:00",
    "InvoiceType": 0,
    "Items": [
        {
            "CurrencyAdvance": 50.00,
            "ProductId": 130753,
            "Quantity": 1.0000,
            "ProductCurrencyPrice": 100.00,
            "ProductPrice": 100.00,
            "ProductName": "Mysz komputerowa przewodowa",
            "ProductDescription": "",
            "UnitOfMeasurement": "szt.",
            "VatRateId": 74,
            "Id": 375502
        }
    ],
    "Description": "",
    "IssueDate": "2023-04-05T00:00:00+02:00",
    "Number": "FAZAL/2023/4/2",
    "Status": 1,
    "Id": 278260
}

DODAWANIE NOWEGO DOKUMENTU FAKTURY ZALICZKOWEJ

{
    "PurchasingPartyId": 529611,
    "PaymentTypeId": 1508,
    "Items": [
        {
            "ProductId": 2028,
            "Quantity": 1.0,
            "ProductCurrencyPrice": 81.30,
            "CurrencyAdvance": 10.00
        }
    ]
}

DODAWANIE POWIĄZANEJ FAKTURY ZALICZKOWEJ

{
    "Message": "Dla tego dokumentu nie można wystawić kolejnej powiązanej faktury zaliczkowej.",
    "Code": "DocumentException",
    "Data": {
        "ErrorCode": "5"
    }
}

EDYCJA FAKTURY ZALICZKOWEJ

{
    "PurchasingPartyId": 529611,
    "PaymentTypeId": 1508,
    "Items": [
        {
            "ProductId": 2028,
            "Quantity": 1.0,
            "ProductCurrencyPrice": 81.30,
            "CurrencyAdvance": 10.00
        }
    ],
    "Id": 2994705
}

ZATWIERDZANIE FAKTUR ZALICZKOWYCH

{
    "IdCollection": [
        1995472, 1995473
    ]
}

[
    {
        "Confirmed": true,
        "ErrorMessage": "",
        "ErrorCode": "",
        "DocumentNumber": "FS/24/6/8",
        "DocumentId": 1995472
    },
    {
        "Confirmed": true,
        "ErrorMessage": "",
        "ErrorCode": "",
        "DocumentNumber": "FS/24/6/9",
        "DocumentId": 1995473
    }
]

USUWANIE FAKTURY ZALICZKOWEJ

PRZEKSZTAŁCANIE FAKTUR ZALICZKOWYCH

• jedną fakturę zaliczkową i przekształcić ją do jednej faktury finalnej
• wiele powiązanych faktur zaliczkowych i przekształcić je do jednej faktury finalnej
• wiele powiązanych faktur zaliczkowych i przekształcić je do wielu faktur finalnych

{
    "PaymentStatus": 0,
    "OSSProcedureCountryCode": "",
    "IsOSSProcedure": false,
    "IsFinal": true,
    "PurchasingPartyId": 529611,
    "PurchasingParty": {
        "Name": "COMARCH SPÓŁKA AKCYJNA",
        "NipPrefix": "",
        "Nip": "6770065406",
        "Country": "",
        "City": "Kraków",
        "Street": "Aleja Jana Pawła II",
        "BuildingNumber": "39 A",
        "FlatNumber": "",
        "BankName": "",
        "BankAccountNumber": "",
        "CustomerType": 1
    },
    "ReceivingPartyId": null,
    "ReceivingParty": null,
    "PaymentTypeId": 1509,
    "PaymentType": 1,
    "BankAccountId": 113,
    "BankAccountNumber": "76906810134600238781879677",
    "SalesDate": "2024-06-05T00:00:00+02:00",
    "InvoiceType": 0,
    "NetTotal": 71.30,
    "GrossTotal": 87.70,
    "VatTotal": 16.40,
    "Items": [
        {
            "ProductId": 2028,
            "Quantity": 1.0000,
            "ProductCurrencyPrice": 81.30,
            "ProductName": "Produkt 1",
            "ProductDescription": "",
            "UnitOfMeasurement": "szt.",
            "VatRateId": 9,
            "Id": 5548500
        }
    ],
    "Description": null,
    "IssueDate": "2024-06-05T00:00:00+02:00",
    "Number": "FS/24/6/4",
    "Status": 0,
    "Id": 1995428
}

{
    "Message": "Tego dokumentu nie można przekształcić do faktury finalnej.",
    "Code": "DocumentException",
    "Data": {
        "ErrorCode": "5"
    }
}

POBIERANIE FAKTUR ZAKUPU Z REJESTRU VAT ZAKUPU

{
        "PaymentStatus": 0,
        "CustomerId": 11972967,
        "PaymentTypeId": 10260089,
        "PaymentType": 0,
        "PaymentDeadline": "2020-09-02T00:00:00+02:00",
        "CustomerBankAccountNumber": "",
        "CustomerBankAccountName": "",
        "BankAccountId": null,
        "BankAccountNumber": null,
        "PurchaseDate": "2020-09-02T00:00:00+02:00",
        "ReceiptDate": "2020-09-02T00:00:00+02:00",
        "NetTotal": 100.00,
        "CurrencyNetTotal": 100.00,
        "GrossTotal": 123.00,
        "CurrencyGrossTotal": 123.00,
        "VatTotal": 23.00,
        "CurrencyVatTotal": 23.00,
        "CurrencyCode": "PLN",
        "CurrencyRateType": 0,
        "CurrencyRateDate": "2020-09-01T00:00:00+02:00",
        "CurrencyConverter": 1.0,
        "CurrencyRate": 1.0,
        "Correction": false,
        "InternalDocument": false,
        "CorrectedDocumentNumber": "",
        "IncludedInJPKV7": true,
        "VATDeclarationDate": "2020-09",
        "IncludedInVATUE": false,
        "VATUEDeclarationDate": "2020-09",	
        "JpkProceduresSymbols": [
        	"B_SPV",
        	"MR_T"
    	],
        "Items": [
            {
                "VatRateId": 9,
                "ItemNetValue": 100.00,
                "ItemNetValueCurrency": 100.00,
                "ItemVATValue": 23.00,
                "ItemVATValueCurrency": 23.00,
                "ItemGrossValue": 123.00,
                "ItemGrossValueCurrency": 123.00,
                "FieldInJPKV7": 22,
                "FieldInVATUE": 0,
                "ItemType": 0,
                "VAT50deduction": 0,
                "PercentAsExpenses": 100.0,
                "AccountNumber": "",
                "Id": 15758450
            }
        ],
        "Description": "Zakup towarów",
        "IssueDate": "2020-09-02T00:00:00+02:00",
        "Number": "1716",
        "Id": 14785511
    }

POBIERANIE FAKTUR VAT MARŻA

{
    "PurchasingPartyId": 125822,
    "PurchasingParty": {
        "Name": "COMARCH SPÓŁKA AKCYJNA",
        "NipPrefix": "",
        "Nip": "6770065406",
        "Country": "Polska",
        "City": "Kraków",
        "Street": "Aleja Jana Pawła II",
        "BuildingNumber": "39A",
        "FlatNumber": "4b",
        "BankName": "Bank Polska Kasa Opieki S.A. XI O. w Krakowie",
        "BankAccountNumber": "08 1240 4722 1111 0000 4851 1368",
        "CustomerType": 1
    },
    "ReceivingPartyId": null,
    "ReceivingParty": null,
    "PaymentTypeId": 4471,
    "PaymentType": 0,
    "PaymentDeadline": "2023-04-05T00:00:00+02:00",
    "BankAccountId": null,
    "BankAccountNumber": null,
    "SalesDate": "2023-04-05T00:00:00+02:00",
    "InvoiceType": 1,
    "PaymentStatus": 0,
    "ProfitMarginInvoiceProcedureType": 1,
    "ProfitMarginTotal": 500.00,
    "GrossTotal": 6000.00,
    "CurrencyGrossTotal": 6000.00,
    "CurrencyCode": "PLN",
    "CurrencyRateType": 0,
    "CurrencyRateDate": "2023-04-04T00:00:00+02:00",
    "CurrencyConverter": 1.0,
    "CurrencyRate": 1.0,
    "Items": [
        {
            "ProductId": null,
            "Quantity": 1.0000,
            "ProductCurrencyPrice": 6000.00,
            "ProductPrice": 6000.00,
            "ProductName": "Wycieczka",
            "ProductDescription": "",
            "UnitOfMeasurement": "szt.",
            "VatRateId": 0,
            "ProductProfitMarginVatRateTypeId": 9,
            "ProductProfitMarginValue": 500.00,
            "Id": 375497
        }
    ],
    "Description": null,
    "IssueDate": "2023-04-05T00:00:00+02:00",
    "Number": "MAR/23/4/1",
    "Status": 1,
    "Id": 278255
}

POBIERANIE PŁATNOŚCI

{
    "PaymentId": "2692651",
    "PaymentType": "INCOME",
    "Amount": 400.00,
    "Payable": true,
    "VatAmount": 74.80,
    "DocumentId": "1996095",
    "DocumentNumber": "KOR/24/6/2",
    "DocumentType": "CorrectiveInvoice",
    "CorrectedDocumentId": "1996055",
    "CorrectedDocumentType": "Invoice",
    "CorrectionReason": "",
    "CreationDate": "2024-06-05T15:47:26",
    "UpdateDate": "2024-06-05T15:47:29",
    "IssueDate": "2024-06-05T00:00:00",
    "DueDate": "2024-06-05T00:00:00",
    "SenderTaxId": "6770065406",
    "SenderName": "COMARCH SPÓŁKA AKCYJNA",
    "SenderAddress": {
        "street": "Aleja Jana Pawła II",
        "zipCode": "31-864",
        "houseNumber": "39 A",
        "apartmentNumber": "",
        "city": "Kraków",
        "region": ""
    },
    "RecipientTaxId": "7571254424",
    "RecipientName": "Firma Demo",
    "RecipientAddress": {
        "street": "Testowa",
        "zipCode": "20-000",
        "houseNumber": "1a",
        "apartmentNumber": "2b",
        "city": "Lublin",
        "region": "lubelskie"
    },
    "RecipientAccountNumber": null,
    "SenderAccountNumber": null,
    "SplitPayment": false,
    "Currency": "PLN",
    "Balance": 380.00,
    "Title": [
        "Zapłata za KOR/24/6/2"
    ],
    "PaymentStatus": 2,
    "PaymentDirection": 0,
    "ExchangeRate": 1.0000,
    "ExportStatus": 0,
    "CashAccounting": false
}

{
    "PaymentId": "2692651",
    "PaymentType": "INCOME",
    "Amount": 400.00,
    "Payable": true,
    "VatAmount": 74.80,
    "DocumentId": "1996095",
    "DocumentNumber": "KOR/24/6/2",
    "DocumentType": "CorrectiveInvoice",
    "CorrectedDocumentId": "1996055",
    "CorrectedDocumentType": "Invoice",
    "CorrectionReason": "",
    "CreationDate": "2024-06-05T15:47:26",
    "UpdateDate": "2024-06-05T15:47:29",
    "IssueDate": "2024-06-05T00:00:00",
    "DueDate": "2024-06-05T00:00:00",
    "SenderTaxId": "6770065406",
    "SenderName": "COMARCH SPÓŁKA AKCYJNA",
    "SenderAddress": {
        "street": "Aleja Jana Pawła II",
        "zipCode": "31-864",
        "houseNumber": "39 A",
        "apartmentNumber": "",
        "city": "Kraków",
        "region": ""
    },
    "RecipientTaxId": "7571254424",
    "RecipientName": "Firma Demo",
    "RecipientAddress": {
        "street": "Testowa",
        "zipCode": "20-000",
        "houseNumber": "1a",
        "apartmentNumber": "2b",
        "city": "Lublin",
        "region": "lubelskie"
    },
    "RecipientAccountNumber": null,
    "SenderAccountNumber": null,
    "SplitPayment": false,
    "Currency": "PLN",
    "Balance": 380.00,
    "Title": [
        "Zapłata za KOR/24/6/2"
    ],
    "PaymentStatus": 2,
    "PaymentDirection": 0,
    "ExchangeRate": 1.0000,
    "ExportStatus": 0,
    "CashAccounting": false
}

POBIERANIE STATUSU PŁATNOŚCI

{
    "IdCollection": [
        2692559,
        2692567
    ]
}

[
    {
        "PaymentId": 2692559,
        "Amount": 100.00,
        "Balance": 100.00,
        "Currency": "PLN",
        "PaymentStatus": 0
    },
    {
        "PaymentId": 2692567,
        "Amount": 50.00,
        "Balance": 0.0,
        "Currency": "PLN",
        "PaymentStatus": 2
    }
]

{
    "PaymentId": 2692651,
    "Amount": 400.00,
    "Balance": 380.00,
    "Currency": "PLN",
    "PaymentStatus": 1
}

AKTUALIZACJA STATUSU PŁATNOŚCI

{
    "PaymentIds": [
        2692651,
        2691813
    ],
    "CustomerTIN" : "6770065406",
    "Cancelled" : false,
    "PaymentDate": "2024-01-15",
    "AmountPaid" : "450",
    "BankAccountNumber" : "76906810134600238781879677"
}

[
    {
        "Updated": true,
        "Message": "Płatność została zaktualizowana.",
        "PaymentId": 2692651
    },
    {
        "Updated": true,
        "Message": "Płatność została zaktualizowana.",
        "PaymentId": 2691813
    }
]

POBIERANIE FAKTUR SPRZEDAŻY

DODAWANIE NOWEGO DOKUMENTU FAKTURY SPRZEDAŻY

EDYCJA FAKTURY SPRZEDAŻY

Przykład

Usuwanie pozycji z faktury sprzedaży poprzez edycję dokumentu: [PUT] https://app.erpxt.pl/api2/public/invoices Przykładowe zapytanie: Przykładowa odpowiedź JSON – status 204 No Content - operacja zakończona powodzeniem:

USUWANIE FAKTURY SPRZEDAŻY

POBIERANIE KONTRAHENTÓW

• wg nazwy: [GET] https://app.erpxt.pl/api2/public/?$filter=Name eq {nazwa}
• wg adresu e-mail: [GET] https://app.erpxt.pl/api2/public/customers/?$filter=Mail eq {adres_email}

DODAWANIE NOWEGO KONTRAHENTA

EDYCJA KONTRAHENTA

USUWANIE KARTY KONTRAHENTA

POBIERANIE FAKTUR PROFORMA

DODAWANIE NOWEGO DOKUMENTU FAKTURY PROFORMA

EDYCJA FAKTURY PROFORMA

USUWANIE FAKTURY PROFORMA

POBIERANIE FAKTUR SPRZEDAŻY

DODAWANIE NOWEGO DOKUMENTU FAKTURY SPRZEDAŻY

EDYCJA FAKTURY SPRZEDAŻY

ZATWIERDZANIE FAKTUR SPRZEDAŻY

USUWANIE FAKTURY SPRZEDAŻY

POBIERANIE FAKTUR SPRZEDAŻY

DODAWANIE NOWEGO DOKUMENTU FAKTURY SPRZEDAŻY

EDYCJA FAKTURY SPRZEDAŻY

USUWANIE FAKTURY SPRZEDAŻY

POBIERANIE FAKTUR SPRZEDAŻY

DODAWANIE NOWEGO DOKUMENTU FAKTURY SPRZEDAŻY

EDYCJA FAKTURY SPRZEDAŻY

ZATWIERDZANIE FAKTUR SPRZEDAŻY

USUWANIE FAKTURY SPRZEDAŻY

POBIERANIE FAKTUR PROFORMA

DODAWANIE NOWEGO DOKUMENTU FAKTURY PROFORMA

EDYCJA FAKTURY PROFORMA

USUWANIE FAKTURY PROFORMA

POBIERANIE FAKTUR PROFORMA

DODAWANIE NOWEGO DOKUMENTU FAKTURY PROFORMA

EDYCJA FAKTURY PROFORMA

USUWANIE FAKTURY PROFORMA

POBIERANIE FAKTUR ZALICZKOWYCH

DODAWANIE NOWEGO DOKUMENTU FAKTURY ZALICZKOWEJ

DODAWANIE POWIĄZANEJ FAKTURY ZALICZKOWEJ

EDYCJA FAKTURY ZALICZKOWEJ

ZATWIERDZANIE FAKTUR ZALICZKOWYCH

USUWANIE FAKTURY ZALICZKOWEJ

POBIERANIE FAKTUR KORYGUJĄCYCH

DODAWANIE NOWEGO DOKUMENTU FAKTURY KORYGUJĄCEJ

EDYCJA FAKTURY KORYGUJĄCEJ

ZATWIERDZANIE FAKTUR KORYGUJĄCYCH

USUWANIE FAKTURY KORYGUJĄCYCH

KOREKTY DO FAKTUR ZALICZKOWYCH

POBIERANIE PŁATNOŚCI

[
    {
        "PaymentId": "2692559",
        "PaymentType": "INCOME",
        "Amount": 100.00,
        "Payable": true,
        "VatAmount": 18.70,
        "DocumentId": "1996055",
        "DocumentNumber": "FS/24/6/10",
        "DocumentType": "Invoice",
        "CreationDate": "2024-06-05T15:34:27",
        "UpdateDate": "2024-06-05T15:34:29",
        "IssueDate": "2024-06-05T00:00:00",
        "DueDate": "2024-06-05T00:00:00",
        "SenderTaxId": "6770065406",
        "SenderName": "COMARCH SPÓŁKA AKCYJNA",
        "SenderAddress": {
            "street": "Aleja Jana Pawła II",
            "zipCode": "31-864",
            "houseNumber": "39 A",
            "apartmentNumber": "",
            "city": "Kraków",
            "region": ""
        },
        "RecipientTaxId": "7571254424",
        "RecipientName": "Firma Demo",
        "RecipientAddress": {
            "street": "Testowa",
            "zipCode": "20-000",
            "houseNumber": "1a",
            "apartmentNumber": "2b",
            "city": "Lublin",
            "region": "lubelskie"
        },
        "RecipientAccountNumber": null,
        "SplitPayment": false,
        "Currency": "PLN",
        "Balance": 100.00,
        "Title": [
            "Zapłata za FS/24/6/10"
        ],
        "ExchangeRate": 1.0000
    },
    {
        "PaymentId": "2692567",
        "PaymentType": "OUTCOME",
        "Amount": -50.00,
        "Payable": true,
        "VatAmount": -9.35,
        "DocumentId": "1996061",
        "DocumentNumber": "FS/24/2000",
        "DocumentType": "PurchaseInvoice",
        "CreationDate": "2024-06-05T15:35:51",
        "UpdateDate": "2024-06-05T15:35:53",
        "IssueDate": "2024-06-05T00:00:00",
        "DueDate": "2024-06-05T00:00:00",
        "SenderTaxId": "7571254424",
        "SenderName": "Firma Demo",
        "SenderAddress": {
            "street": "Testowa",
            "zipCode": "20-000",
            "houseNumber": "1a",
            "apartmentNumber": "2b",
            "city": "Lublin",
            "region": "lubelskie"
        },
        "RecipientTaxId": "6751382502",
        "RecipientName": "COMARCH HEALTHCARE SPÓŁKA AKCYJNA",
        "RecipientAddress": {
            "street": "Aleja Jana Pawła II",
            "zipCode": "31-864",
            "houseNumber": "39A",
            "apartmentNumber": "",
            "city": "Kraków",
            "region": ""
        },
        "RecipientAccountNumber": null,
        "SplitPayment": false,
        "Currency": "PLN",
        "Balance": 0.0,
        "Title": [
            "Zapłata za FS/24/2000"
        ],
        "ExchangeRate": 1.0000
    }
]

{
    "PaymentId": "2692651",
    "PaymentType": "INCOME",
    "Amount": 400.00,
    "Payable": true,
    "VatAmount": 74.80,
    "DocumentId": "1996095",
    "DocumentNumber": "KOR/24/6/2",
    "DocumentType": "CorrectiveInvoice",
    "CorrectedDocumentId": "1996055",
    "CorrectedDocumentType": "Invoice",
    "CorrectionReason": "",
    "CreationDate": "2024-06-05T15:47:26",
    "UpdateDate": "2024-06-05T15:47:29",
    "IssueDate": "2024-06-05T00:00:00",
    "DueDate": "2024-06-05T00:00:00",
    "SenderTaxId": "6770065406",
    "SenderName": "COMARCH SPÓŁKA AKCYJNA",
    "SenderAddress": {
        "street": "Aleja Jana Pawła II",
        "zipCode": "31-864",
        "houseNumber": "39 A",
        "apartmentNumber": "",
        "city": "Kraków",
        "region": ""
    },
    "RecipientTaxId": "7571254424",
    "RecipientName": "Firma Demo",
    "RecipientAddress": {
        "street": "Testowa",
        "zipCode": "20-000",
        "houseNumber": "1a",
        "apartmentNumber": "2b",
        "city": "Lublin",
        "region": "lubelskie"
    },
    "RecipientAccountNumber": null,
    "SplitPayment": false,
    "Currency": "PLN",
    "Balance": 380.00,
    "Title": [
        "Zapłata za KOR/24/6/2"
    ],
    "ExchangeRate": 1.0000
}

POBIERANIE STATUSU PŁATNOŚCI

{
    "IdCollection": [
        2692559,
        2692567
    ]
}

[
    {
        "PaymentId": 2692559,
        "Amount": 100.00,
        "Balance": 100.00,
        "Currency": "PLN",
        "PaymentStatus": 0
    },
    {
        "PaymentId": 2692567,
        "Amount": 50.00,
        "Balance": 0.0,
        "Currency": "PLN",
        "PaymentStatus": 2
    }
]

{
    "PaymentId": 2692651,
    "Amount": 400.00,
    "Balance": 380.00,
    "Currency": "PLN",
    "PaymentStatus": 1
}

AKTUALIZACJA STATUSU PŁATNOŚCI

{
    "PaymentIds": [
        2692651,
        2691813
    ],
    "CustomerTIN" : "6770065406",
    "Cancelled" : false,
    "PaymentDate": "2024-01-15",
    "AmountPaid" : "450",
    "BankAccountNumber" : "76906810134600238781879677"
}

[
    {
        "Updated": true,
        "Message": "Płatność została zaktualizowana.",
        "PaymentId": 2692651
    },
    {
        "Updated": true,
        "Message": "Płatność została zaktualizowana.",
        "PaymentId": 2691813
    }
]