Fakturownia — konfiguracja

Integracja z Fakturownią działa w całości po stronie Sancho — nie instalujesz niczego na własnym serwerze i nie otwierasz żadnych portów. Sancho łączy się z https://<subdomena>.fakturownia.pl po HTTPS, uwierzytelniając się tokenem API wystawionym w Twoim koncie Fakturowni.

Co obejmuje integracja

Obszar	Zakres
Magazyny	odczyt, tworzenie, edycja, usuwanie
Towary	odczyt, tworzenie, edycja
Kontrahenci	odczyt, tworzenie, edycja
Przyjęcia (PZ, PW)	odczyt, tworzenie, edycja, usuwanie
Wydania (WZ, RW)	odczyt, tworzenie, edycja, usuwanie
Przesunięcia (MM)	odczyt, tworzenie, edycja, usuwanie
Faktury	tylko odczyt

Fakturownia nie ma bufora

Dokument zapisany przez Sancho jest w Fakturowni od razu zatwierdzony — nie ma stanu roboczego, w którym mógłby poczekać. Nie istnieje też anulowanie dokumentu: jedynym sposobem wycofania jest trwałe usunięcie, po którym dokument nie wraca. Sancho cofa wtedy stan w lokalizacjach magazynowych po swojej stronie.

Role kontrahentów

Kartoteka kontrahenta w Fakturowni rozróżnia tylko odbiorcę i dostawcę. Pozostałe role, które Sancho zna z Comarch Optimy — konkurencja, partner, potencjalny klient — nie mają w Fakturowni odpowiednika i nie zostaną zapisane.

Czego potrzebujesz

1. Subdomena. Człon adresu przed .fakturownia.pl — dla https://mojafirma.fakturownia.pl subdomeną jest mojafirma.

2. Token API. W Fakturowni: Ustawienia → Ustawienia konta → Integracja → Kod autoryzacyjny API. Token działa z uprawnieniami konta, na którym został wystawiony, więc użyj konta mającego dostęp do magazynów i dokumentów magazynowych.

Token jest poświadczeniem

Token API daje pełny dostęp do danych w Fakturowni. Sancho zapisuje go po stronie serwera i nigdy nie zwraca do przeglądarki ani do aplikacji mobilnej — dlatego w formularzu edycji pole tokenu jest puste. Zostaw je puste, aby zachować zapisany token; wpisz nową wartość tylko wtedy, gdy token rotujesz.

Dodanie integracji w Sancho

1. W ustawieniach wejdź w Obszar roboczy → Integracje i kliknij Dodaj integrację.

2. Wypełnij nagłówek: Nazwa (dowolna, widoczna na listach dokumentów), Typ — Fakturownia, Subdomena Fakturowni i Token API. Wybór typu decyduje o reszcie formularza: każdy system ERP ma własny zestaw pól.

   

3. Na zakładce Uprawnienia zaznacz zakresy, z których integracja ma korzystać. Zakres jest deklaracją możliwości — Sancho pokazuje w interfejsie tylko te operacje, na które integracja ma zakres, więc odznaczenie zapisu dokumentów ukrywa przyciski zapisu do Fakturowni.

4. Zapisz przyciskiem Utwórz integrację. Sancho od razu sprawdza połączenie i zapisuje jego status.

Weryfikacja

Na liście Integracje kolumna Status pokazuje wynik ostatniego sprawdzenia połączenia. Po udanym zapisie:

• listy Magazyny, Towary i Kontrahenci pokazują dane z Fakturowni,
• na liście Faktury widać faktury z Fakturowni, bez możliwości edycji,
• nowe przyjęcie, wydanie lub przesunięcie zapisuje się jako dokument magazynowy Fakturowni.

Zakładka Logi na karcie integracji zawiera historię wywołań — to pierwsze miejsce, w które warto zajrzeć, gdy lista jest pusta albo zapis się nie udał. Komunikat błędu z Fakturowni trafia do Sancho w oryginalnej treści.

Poniżej integracja z błędnym tokenem: nagłówek ma znacznik Błąd połączenia, a w logach co minutę ląduje nieudany system.ping. Pola poświadczeń pokazują Pozostaw puste, aby nie zmieniać — wpisz wartość tylko wtedy, gdy chcesz ją nadpisać.

Najczęstsze problemy

Objaw	Przyczyna
Status połączenia na czerwono zaraz po zapisie	Błędna subdomena albo token; sprawdź adres konta w Fakturowni i wygeneruj token ponownie
Listy puste mimo poprawnego statusu	Konto, na którym wystawiono token, nie ma dostępu do danych magazynowych
Cena towaru zerowa na dokumencie	Towar nie ma ceny zakupu ani sprzedaży w kartotece Fakturowni — Sancho podstawia cenę z kartoteki, nie z cennika
Brak przycisku zapisu dokumentu	Integracja nie ma zakresu zapisu na zakładce Uprawnienia