API – Kategorie

POBIERANIE KATEGORII ZAKUPU

Uwaga
Aby pobrać listę kategorii spełnione być muszą dwa warunki:
1. Połączenie IWD z Biurem Rachunkowym musi być skonfigurowane i aktywne.
2. W konfiguracji musi być włączona opcja korzystania z kategorii otrzymanych z Biura Rachunkowego.

Pobieranie kategorii zakupu z Biura Rachunkowego: [GET] https://app.comarchbetterfly.pl/api2/public/v1.8/categories

Opis struktury JSON odpowiedzi:

Parametr Opis
SourceId Unikalny identyfikator źródłowy, który pozwala powiązać kategorię z jej definicją pochodzenia
GeneralCode Kod kategorii ogólnej (nadrzędnej), która grupuje powiązane kategorie. Wiele kategorii szczegółowych może mieć ten sam kod ogólny co tworzy dwupoziomową hierarchię.
Code Kod konkretnej kategorii, unikalny w obrębie grupy ogólnej.
General Znacznik czy kategorie ogólna (true – nagłówek grupujący, false – kategoria ogólna).
Type Rodzaj: przychód czy koszt (0 – przychód, 1 – koszt). Ten endpoint zwraca tylko koszty, więc zawsze zwraca 1.
Description Opis kategorii tłumaczący jej zastosowanie.
Inactive Czy kategoria jest dezaktywowana (true – nieaktywna, false – aktywna). Nieaktywne są ukrywane z list wyboru, ale zachowane dla dokumentów historycznych, które już z nich korzystają.
Version Znacznik czasu ostanie modyfikacji, automatycznie aktualizowany przy każdym zapisie.
Id Unikalny numeryczny identyfikator, nadawany automatycznie przy pierwszym zapisie rekordu.
ExtendedPropertiesXml Mechanizm na rozszerzone pola, które następnie będą serializowane do XML (puste – brak takich właściwości).

Przykładowa odpowiedź JSON:

[
    {
        "SourceId": "445D50DD-626D-4B27-9D7A-7FF211D2EC05",
        "GeneralCode": "AMORTYZACJA",
        "Code": "AMORTYZACJA",
        "General": true,
        "Type": 1,
        "Description": "Amortyzacja",
        "Inactive": false,
        "Version": "2026-07-13T14:21:11.18+02:00",
        "Id": 51746,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "BEAB6478-4C60-4464-93E3-68B7C3F747F4",
        "GeneralCode": "AMORTYZACJA",
        "Code": "KUP",
        "General": false,
        "Type": 1,
        "Description": "Amortyzacja stanowiąca koszty uzyskania prz.",
        "Inactive": false,
        "Version": "2026-07-13T14:21:11.32+02:00",
        "Id": 51747,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "B9FB8498-2F9A-4495-86B1-151CF1814667",
        "GeneralCode": "AMORTYZACJA",
        "Code": "NKUP",
        "General": false,
        "Type": 1,
        "Description": "Amortyzacja niestanowiąca kosztów uzyskania prz.",
        "Inactive": false,
        "Version": "2026-07-13T14:21:11.44+02:00",
        "Id": 51748,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "B9232EA1-F8B1-4FE9-97D5-4B6D35EE3F40",
        "GeneralCode": "KOSZTY FINANSOWE",
        "Code": "KOSZTY FINANSOWE",
        "General": true,
        "Type": 1,
        "Description": "Koszty finansowe",
        "Inactive": false,
        "Version": "2026-07-13T14:21:11.57+02:00",
        "Id": 51749,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "872D242F-42BE-4707-85DB-6CCD7C25ECEC",
        "GeneralCode": "KOSZTY FINASOWE",
        "Code": "ODSETKI DLA KONTRAH.",
        "General": false,
        "Type": 1,
        "Description": "Odsetki dla kontrahentów",
        "Inactive": false,
        "Version": "2026-07-13T14:21:11.69+02:00",
        "Id": 51750,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "8C3B0BA6-C419-4F44-B654-8AAA966C292B",
        "GeneralCode": "KOSZTY FINASOWE",
        "Code": "ODSETKI DLA URZĘDÓW",
        "General": false,
        "Type": 1,
        "Description": "Odsetki dla urzędów",
        "Inactive": false,
        "Version": "2026-07-13T14:21:11.84+02:00",
        "Id": 51751,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "2D1C130B-A973-4B8C-AF98-373F622B0F9C",
        "GeneralCode": "KOSZTY FINASOWE",
        "Code": "ODSETKI OD KREDYTÓW",
        "General": false,
        "Type": 1,
        "Description": "Odsetki od kredytów",
        "Inactive": false,
        "Version": "2026-07-13T14:21:11.98+02:00",
        "Id": 51752,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "62CF49B5-0A07-4432-9BE5-A2EB06ADDBBD",
        "GeneralCode": "KOSZTY FINASOWE",
        "Code": "RÓŻNICE KURSOWE UJEM",
        "General": false,
        "Type": 1,
        "Description": "Ujemne różnice kursowe",
        "Inactive": false,
        "Version": "2026-07-13T14:21:12.54+02:00",
        "Id": 51753,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "5EA498EB-858C-4A16-ACB4-F10247D071AC",
        "GeneralCode": "KOSZTY INNE",
        "Code": "KOSZTY INNE",
        "General": true,
        "Type": 1,
        "Description": "Koszty inne",
        "Inactive": false,
        "Version": "2026-07-13T14:21:12.66+02:00",
        "Id": 51754,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "B273E84D-EDC5-4B7F-90E6-2029C081D443",
        "GeneralCode": "KOSZTY INNE",
        "Code": "EKSPLOATACJA SAM.",
        "General": false,
        "Type": 1,
        "Description": "Koszty eksploatacji samochodów",
        "Inactive": false,
        "Version": "2026-07-13T14:21:12.77+02:00",
        "Id": 51755,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "8D069E91-8CDC-4B12-BC64-2FFAA4E1B04D",
        "GeneralCode": "KOSZTY INNE",
        "Code": "ENERGIA",
        "General": false,
        "Type": 1,
        "Description": "Energia",
        "Inactive": false,
        "Version": "2026-07-13T14:21:12.9+02:00",
        "Id": 51756,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "5B621E44-EE83-4143-A827-D00535C8DE35",
        "GeneralCode": "KOSZTY INNE",
        "Code": "GAZ",
        "General": false,
        "Type": 1,
        "Description": "Gaz",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.02+02:00",
        "Id": 51757,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "F5AFA7A4-4468-4FC0-A4F0-DF8764FC1C8C",
        "GeneralCode": "KOSZTY INNE",
        "Code": "KOSZTY 75%",
        "General": false,
        "Type": 1,
        "Description": "Koszty eksploatacji samochodów",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.13+02:00",
        "Id": 51758,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "943FE608-9B65-401F-97FB-585E075966F9",
        "GeneralCode": "KOSZTY INNE",
        "Code": "PALIWO-SAM. CIĘŻAROW",
        "General": false,
        "Type": 1,
        "Description": "Paliwo do samochodów ciężarowych",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.24+02:00",
        "Id": 51759,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "475C4723-A572-4779-B93D-15F1707B1A2A",
        "GeneralCode": "KOSZTY INNE",
        "Code": "PALIWO-SAM. OSOBOWE",
        "General": false,
        "Type": 1,
        "Description": "Paliwo do samochodów osobowych",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.37+02:00",
        "Id": 51760,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "61184283-0312-400E-8652-A2C76D990D09",
        "GeneralCode": "MATERIAŁY",
        "Code": "MATERIAŁY",
        "General": true,
        "Type": 1,
        "Description": "Materiały",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.48+02:00",
        "Id": 51761,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "9E6A530F-7B1B-47E1-930E-44B7BBC2B25E",
        "GeneralCode": "MATERIAŁY",
        "Code": "MATERIAŁY BIUROWE",
        "General": false,
        "Type": 1,
        "Description": "Materiały biurowe",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.6+02:00",
        "Id": 51762,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "707073DB-965D-40B1-8ABD-87C067A5AD8D",
        "GeneralCode": "MATERIAŁY",
        "Code": "MATERIAŁY PODSTAWOWE",
        "General": false,
        "Type": 1,
        "Description": "Materiały podstawowe",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.73+02:00",
        "Id": 51763,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "603EFD4A-9C3B-4329-ABC2-67EE0DC161E6",
        "GeneralCode": "MATERIAŁY",
        "Code": "MATERIAŁY POZOSTAŁE",
        "General": false,
        "Type": 1,
        "Description": "Materiały pozostałe",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.85+02:00",
        "Id": 51764,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "971B349C-B3EA-4873-B361-55E901B67DEB",
        "GeneralCode": "MATERIAŁY",
        "Code": "ZUŻ. ENERGIA - NKUP",
        "General": false,
        "Type": 1,
        "Description": "Zużycie energii niestanowiące kosztów uz. prz.",
        "Inactive": false,
        "Version": "2026-07-13T14:21:13.98+02:00",
        "Id": 51765,
        "ExtendedPropertiesXml": ""
    },
    {
        "SourceId": "CFFD4997-BAE9-4EAC-B2CD-501CBE27BFE9",
        "GeneralCode": "MATERIAŁY",
        "Code": "ZUŻ. MATER. - NKUP",
        "General": false,
        "Type": 1,
        "Description": "Zużycie materiałów niestanowiące kosztów uz. prz.",
        "Inactive": false,
        "Version": "2026-07-13T14:21:14.1+02:00",
        "Id": 51766,
        "ExtendedPropertiesXml": ""
    }
]

 

Czy ten artykuł był pomocny?