Poradnik
Jak połączyć Apilo z Subiektem nexo PRO
Aktualizacja: · CoreConnector
Krótko
Apilo łączy się z Subiektem nexo PRO przez program CoreConnector, który instalujesz na komputerze z Subiektem. Gdy zamówienie w Apilo dostanie wybrany status, na przykład „Do wysłania”, CoreConnector wystawia w Subiekcie fakturę albo paragon, odsyła PDF do zamówienia i zmienia jego status – zwykle w niecałą minutę. Potrzebujesz Subiekta nexo PRO (Sfera jest w jego cenie), jednego wolnego stanowiska w licencji Subiekta, dostępu API do Apilo i bezpłatnego .NET 10 Desktop Runtime x64 od Microsoftu.
Czego potrzebujesz
- Komputera z Windows 10 lub 11 (64-bitowym) albo z Windows Server 2016 lub nowszym – tego samego, na którym jest zainstalowany Subiekt nexo PRO.
- Bezpłatnego .NET 10 Desktop Runtime x64 od Microsoftu (dotnet.microsoft.com/download/dotnet/10.0) na tym komputerze – instalujesz go raz, przed CoreConnectorem.
- Subiekta nexo PRO. CoreConnector łączy się z nim przez Sferę, która jest w cenie Subiekta nexo PRO. Płatnego dodatku „Sfera PRO+” program nie potrzebuje.
- Jednego wolnego stanowiska w licencji Subiekta – program pracuje w tle jako osobne stanowisko.
- Użytkownika Subiekta z prawem wystawiania dokumentów i jego hasła. W jego imieniu powstają dokumenty.
- Dostępu API do Apilo: adresu panelu (np. mojafirma.apilo.com), identyfikatora i klucza aplikacji (Client ID, Client Secret) oraz kodu autoryzacyjnego.
- Do wysyłki faktur do KSeF: aktywnego abonamentu InsERT na Subiekta nexo PRO, bo e-faktury wychodzą przez Subiekta.
Krok po kroku
- W panelu Apilo załóż aplikację API i wygeneruj dla niej kod autoryzacyjny. Kod działa jeden raz, więc wklej go od razu w kreatorze.
- Przygotuj w Apilo trzy statusy zamówień: ten, który ma uruchamiać wystawienie dokumentu (np. „Do wysłania” albo „Do fakturowania”), status po wystawieniu i status „Błąd” na sprawy wymagające uwagi. Nowy status zakładasz w Apilo w menu Administracja → Statusy zamówień.
- Zainstaluj na komputerze z Subiektem najpierw .NET 10 Desktop Runtime x64 (bez niego program się nie uruchomi), a potem CoreConnector. Kreator sam odczytuje z konfiguracji Subiekta serwer i bazę, a potem pokazuje listę użytkowników – wybierasz użytkownika i podajesz jego hasło.
- W kreatorze wpisz dane dostępu do Apilo, kliknij „Połącz z Apilo”, potem „Pobierz statusy” i wskaż trzy statusy z poprzedniego kroku.
- Sprawdź program na jednym zamówieniu: przestaw je w Apilo na status wyzwalający. W ciągu mniej więcej minuty w Subiekcie powstanie dokument, a w Apilo pojawi się PDF przy zamówieniu i nowy status. To prawdziwy dokument z numeracją Subiekta, więc wybierz zamówienie, które i tak trzeba udokumentować.
- Włącz to, czego potrzebujesz: fiskalizację paragonów, wysyłkę do KSeF, sprzedaż firmom z Unii (VIES i WDT 0%), stany i ceny (w testach). Każda z tych funkcji ma osobny przełącznik i fabrycznie jest wyłączona. Faktury OSS dla konsumentów z Unii są fabrycznie włączone – wyłączysz je w Ustawieniach → Dokumenty.
Jak wygląda praca na co dzień
- Program sam wybiera dokument: firma z NIP-em dostaje fakturę, osoba prywatna paragon, a gdy chce faktury – paragon i fakturę do paragonu (w testach).
- Numer dokumentu nadaje Subiekt, a PDF powstaje z jego wzorców wydruku: dla Polski po polsku, dla klientów z zagranicy po angielsku.
- Zestaw zapisany w Apilo jako symbol towaru z gwiazdką i liczbą sztuk (np. ABC*6) trafia na dokument jako 6 sztuk towaru ABC i tyle schodzi ze stanu.
- Koszt dostawy wchodzi na dokument jako pozycja opisowa z nazwą z Apilo – nie trzeba zakładać dla niego kartoteki w Subiekcie.
- Gdy czegoś brakuje, np. towaru o danym symbolu w kartotece Subiekta, dokument nie powstaje. Zamówienie trafia do statusu „Błąd” z notatką, czego dotyczy – widzi ją każdy, kto otworzy zamówienie w Apilo, także magazyn.
- Gdy Subiekt, baza albo Apilo chwilowo nie odpowiada, zamówienia czekają w statusie wyzwalającym i program weźmie je, gdy łączność wróci.
- Do jednego zamówienia nie powstaną dwa dokumenty: przed wystawieniem program sprawdza Subiekta i Apilo.
Pytania
Czy zamówienia z Apilo przechodzą przez serwer CoreConnectora?
Nie. Program pracuje na komputerze albo serwerze Twojej firmy i łączy się z Apilo i z Subiektem bezpośrednio. Baza Subiekta i dane dostępu zostają u Ciebie, a hasła są szyfrowane mechanizmem Windows.
Co się stanie, gdy kwota dokumentu nie zgadza się z zamówieniem w Apilo?
Dokument nie powstaje. Gdy różnica przekracza 5 groszy i 1 grosz za każdą sztukę towaru albo cena pozycji jest nieczytelna, zamówienie trafia do statusu „Błąd” z notatką, a pozostałe zamówienia idą normalnie. Wystawionego dokumentu nie da się cofnąć, tylko skorygować, dlatego program woli zatrzymać jedno zamówienie.
Który status w Apilo wybrać jako wyzwalający?
Taki, który ustawiacie świadomie, gdy zamówienie jest opłacone i gotowe do wysyłki, np. „Do wysłania”. Zbyt wczesny status oznacza dokumenty do zamówień, które mogą jeszcze zostać anulowane – wtedy zamiast anulować zamówienie, trzeba wystawić korektę.
Czy mogę sprawdzić połączenie Apilo z Subiektem przed zakupem?
Tak. Demo Bronze działa 60 dni w pełnym zakresie Diamond, na Twoim Subiekcie i Twoim Apilo, bez karty płatniczej. Dokumenty w demo są prawdziwe: powstają w Subiekcie firmy, z jego numeracją.