--- title: CAT LC – konfiguracja description: "## Informacje od przewoźnika Przed rozpoczęciem konfiguracji trzeba uzyskać od przewoźnika zgodę na wykorzystanie  API do tworzenia przesyłek. Jeżeli będzie to możliwe to od wsparcia firmy CAT LC uzyskasz: - Dokumentację API - Dane dostępowe do API (mogą być w…" url: "https://prostapaczka.pl/instrukcja/cat-lc-konfiguracja/" updated: "2025-05-28" category: Przewoźnicy / CAT LC --- # CAT LC – konfiguracja ## Informacje od przewoźnika Przed rozpoczęciem konfiguracji trzeba uzyskać od przewoźnika zgodę na wykorzystanie  API do tworzenia przesyłek. Jeżeli będzie to możliwe to od wsparcia firmy CAT LC uzyskasz: - Dokumentację API - Dane dostępowe do API (mogą być w dokumentacji) - Listę niezbędnych parametrów przesyłki (może być w dokumentacji) - należy zwrócić szczególną uwagę na porównanie potrzebnych atrybutów z listą pól udostępnianych przez ProstąPaczkę. Jeżeli potrzebne będą dodatkowe atrybuty, to konieczne będzie dostosowanie ProstejPaczki aby przesyłała odpowiedni zestaw danych. ### Dane dostępowe Do konfiguracji niezbędne jest: - Identyfikator organizacji - Identyfikator użytkownika do API - Hasło użytkownika  do API - Numer konta - Numer klienta Wszystkie te dane mogą być zawarte w udostępnionej przez CAT LC dokumentacji API. ### Ustalenie budowy numeru paczki Za generowanie etykiety dla przesyłek CAT LC odpowiedzialna jest ProstaPaczka.  Aby etykiety były poprawnie generowane trzeba ustalić z CAT LC w jaki sposób będzie tworzony numer paczki. Numer ten będzie wstawiany na etykietę w postaci kodu kreskowego i to po nim CAT LC będzie rozpoznawał do kogo należy przesyłka. ProstaPaczka aktualnie potrafi generować numer paczki według poniższego schematu. - WYROZNIK_KLIETNA + CYFRA_USLUGI + NUMER_KOLEJNY - Przykładowo: WYROZNIK_KLIETNA -  alfanumeryczny wyróżnik przydzielany przez CAT LC, który musi być taki sam dla każdej paczki - CYFRA_USLUGI - 1 znak  (1 cyfra) odpowiadająca usłudze zdefiniowanej w słowniku ProstejPaczkiNUMER_KOLEJNY - numer kolejny wyliczany przez ProstąPaczkę o stałej liczbie cyfr Przykładowo: - WYROZNIK_KLIETNA -  ABCDE - CYFRA_USLUGI - 2 lub 3 lub 4 (zależna od liczb nadanych przez CAT LC poszczególnym usługom) - NUMER_KOLEJNY - numer kolejny - ustalony na 7 cyft Przy takich ustaleniach ProstaPaczka będzie generować numery : od: ABCDE10000001 do: ABCDE19999999 Numer kolejny nie będzie się powtarzał dla poszczególnych usług. ### Lista usług Od firmy CAT LC trzeba uzyskać listę możliwych do użycia usług wraz z kodem (cyfrą) która będzie umieszczana w numerze paczki. Przykładowe wartości: - 2 DAY01 - 3 DAY02 - 4 RETURN - 5 RET03 Dane te będą musiały być wpisane do słownika ProstejPaczki. ![](https://prostapaczka.pl/wp-content/uploads/2024/11/image-47.png) ### Lista kodów opakowań Przewoźnik CAT LC musi także przekazać listę możliwych do użycia kodów opakowań (rodzajów paczki). Przykładowe wartości: - PLAH9 - PLAH10 ![](https://prostapaczka.pl/wp-content/uploads/2024/11/image-48.png) ### Baza routingu Na etykiecie musi być umieszczony kod routingu, który jest przypisywany do kodu pocztowego. CAT LC udostępnia arkusz kalkulacyjny w którym każdy kod pocztowy jest przypisany do kodu routingu. Przed rozpoczęciem integracji należy uzyskać od przewoźnika aktualny plik, który będzie można zaimportować do ProstejPaczki. ## Konfiguracja CAT LC w ProstejPaczce Jeżeli masz już wszystkie niezbędne dane to możesz wpisać je do programu ProstaPaczka. Dane dostępowe do konta API należy wpisać dodając nowe konto w zakładce CAT LC -> ikona zębatki -> przycisk KONTA. Listę usług należy wprowadzić do słownika w: zakładka ADMINISTRACJA -> zakładka SŁOWNIKI -> słownik: Usługi CAT LC. Listę  typów opakowań należy wpisać do słownika: zakładka ADMINISTRACJA -> zakładka SŁOWNIKI -> słownik: Rodzaje opakowań CAT LC.   ### Definicja konta CAT LC Dane konta należy uzupełnić  otrzymanymi od CAT LC danymi dostępowymi oraz adresem nadawcy. Zalecane jest aby w polu Adres 2 zamiast adresu wprowadzony był numer telefonu nadawcy przesyłki, dzięki czemu będzie on widoczny także w przesyłce zwrotnej generowanej przez CAT LC. W danych konta istotne  jest zdefiniowanie parametrów generowania numeru paczki przez wciśnięcie przycisku Edytuj w sekcji "Generowanie numeru paczki". Należy tam wpisać: - Wyróżnik klienta uzgodniony z CAT LC - Liczbę cyfr kolejnego numeru paczki Po uzgodnieniu sposobu budowania numeru paczki nie należy go modyfikować bez wiedzy przewoźnika, gdyż może się to skończyć problemami z doręczeniem. W ustawieniach konta można też oznaczyć aby numer pierwszej paczki był traktowany jako numer listu przewozowego. Numer paczki jest skanowany przez przewoźnika podczas wykonywania usługi transportowej i to po nim można później śledzić przesyłkę. Bez zaznaczenia jako numer listu będzie umieszczany numer zamówienia generowany przez API CAT LC (COPL). ![](https://prostapaczka.pl/wp-content/uploads/2024/11/image-46.png) ### Wzorzec etykiety Jako, że to ProstaPaczka odpowiada za przygotowanie etykiety, to musi być zaimportowany szablon etykiety. Jeżeli potrzebny jest domyślny wzorzec zbliżony do wyglądu etykiety generowanej przez EasyCAT, to można zgłosić się po niego do nas. W przeciwnym wypadku będzie konieczne zlecenie nam przygotowania dedykowanego wzorca. Wzorzec etykiety należy zaimportować w: zakładka CAT LC -> ikona zębatki -> przycisk DEFINICJE WYDRUKÓW. W oknie należy dodać nowy wzorzec i zaimportować otrzymany od nas plik z etykietą. Po zdefiniowaniu wzorca należy go wybrać w ustawieniach wydruku: zakładka CAT LC -> ikona zębatki -> przycisk WYDRUKI ### Import bazy routingu Otrzymany od CAT LC plik XLSX zawierający bazę routingu należy zaimportować do ProstejPaczki. Zakładka CAT LC -> ikona zębatki _> przycisk IMPORTUJ BAZĘ ROUTINGU. Plik będzie przesyłany co jakiś czas przez przewoźnika i z za każdym razem trzeba będzie go zaimportować do ProstejPaczki. ## Pierwszy list Po skonfigurowaniu należy przygotować testowy list przewozowy i wraz z etykietą należy przekazać do do wsparcia CAT LC, aby sprawdzili po swojej stornie czy wszystkie dane się zgadzają i czy numer paczki jest poprawnie przez nich odczytywany. ## Podsumowanie Integracja z API CAT LC jest mocno parametryzowana, a przez to może być kłopotliwa w konfiguracji. Zalecamy aby zlecić nam wsparcie w zakresie pośrednictwa w ustaleniach z przewoźnikiem i pomocy w konfiguracji.