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

  1. 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.
  2. 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ń.
  3. 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.
  4. W kreatorze wpisz dane dostępu do Apilo, kliknij „Połącz z Apilo”, potem „Pobierz statusy” i wskaż trzy statusy z poprzedniego kroku.
  5. 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ć.
  6. 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ą.