Zmęczyłem się szukaniem szablonów faktur, więc zbudowałem API, które generuje pięć typów dokumentów

Wyszukiwanie hasła "darmowy szablon faktury" zostało wykonane tak wiele razy w tak wielu przeglądarkach, że powinno chyba kwalifikować się jako wskaźnik diagnostyczny posiadania małej firmy. Schemat jest zawsze taki sam. Nowy klient się rejestruje, rozpoczyna się nowy projekt, lub zbliża się cykl rozliczeniowy, a ktoś siada do wystawienia faktury. Istniejący szablon, jeśli istnieje, jest albo zagubiony w strukturze folderów, którą nikt nie pamięta, albo został zbudowany w wersji Microsoft Word, która już się nie renderuje poprawnie, albo należy do innego podmiotu gospodarczego i wymaga znaczących modyfikacji, zanim będzie można go użyć do obecnego. Więc wyszukiwanie zaczyna się od nowa. "Profesjonalny szablon faktury." "Darmowy szablon faktury PDF." "Szablon faktury z automatycznym obliczaniem podatku." Strona za stroną wyników oferujących szablony, które są prawie dobre, ale nigdy dokładnie takie, jakie trzeba, każdy wymagający dwudziestu minut dostosowania, zanim będzie można go rzeczywiście użyć.

Prowadzenie trzech różnych firm o trzech różnych wymaganiach dotyczących fakturowania zamieniło tę czasami uciążliwą rzecz w powtarzającą się obciążenie operacyjne. Każda firma miała inne znakowanie, inne zobowiązania podatkowe, inne struktury pozycji i różne wymagania dotyczące numeracji dokumentów. Szablon, który działał dla fakturowania usług jednej firmy, był całkowicie nieodpowiedni dla innego, opartego na fakturach produktowych. Utrzymanie trzech oddzielnych zestawów szablonów, każdego w formacie procesora tekstu, który był podatny na uszkodzenie formatowania i błędy formuł, pochłaniało godziny każdego miesiąca, które mogłyby być poświęcone rzeczywistej produktywnej pracy. Frustracja nie wynikała z żadnej pojedynczej faktury. Wynikała z realizacji, że cały podход szablonowego fakturowania jest zasadniczo kruchy i nie może skalować się na wiele firm bez stania się obciążeniem w utrzymywaniu.

Alternatywa, która ostatecznie się pojawiła, polegała na przestaniu myślenia o fakturach jako dokumentach, które muszą być projektowane, i zaczęciu myślenia o nich jako danych, które muszą być renderowane. Dane, czyli kto, co, kiedy i ile każdego zdarzenia rozliczeniowego, są już znane w momencie, gdy faktura musi być wystawiona. Brakuje tylko renderowania: transformacji tych danych w profesjonalny dokument z poprawnym układem, obliczeniami i formatowaniem. Takie renderowanie to dokładnie to, co API może zrobić, i może to robić konsekwentnie, poprawnie i natychmiast dla każdej faktury, dla każdej firmy, bez żadnego szablonu.

Pięć typów dokumentów i dlaczego każdy z nich istnieje

API fakturowania na yeb.to generuje pięć odrębnych typów dokumentów, każdy służący określonemu celowi w przepływie pracy rozliczeniowej i księgowej. Zrozumienie, dlaczego potrzeba pięciu typów, a nie tylko jednego, wyjaśnia wiele na temat tego, jak rozliczenia biznesowe rzeczywiście działają w praktyce.

Faktura pro forma pojawia się jako pierwsza w większości sekwencji rozliczeniowych. Jest wstępnym dokumentem wysyłanym przed wysyłką towarów lub świadczeniem usług, określającym co będzie rozliczane i za jaką cenę. Faktury pro forma są powszechnie używane w handlu międzynarodowym, gdzie nabywca musi zaaranżować płatność lub dokumentację importową, zanim towary opuszczą magazyn sprzedawcy. Są również używane na rynku krajowym jako oficjalne oferty cenowe, które mają więcej wagi niż przypadkowa oferta ceny. Punkt końcowy generowania pro formy tworzy te dokumenty ze wszystkimi polami, które pro forma wymaga: dane sprzedawcy i kupującego, pozycje towaru lub usług, ceny i warunki, ale wyraźnie oznaczone jako pro forma, a nie faktura podatkowa, aby uniknąć zamieszania w zapisach księgowych.

Standardowa faktura jest głównym dokumentem rozliczeniowym, tym, o którym większość ludzi myśli, gdy słyszy słowo "faktura." Rejestruje ukończoną transakcję, określa należną kwotę i służy jako podstawa prawna do żądania płatności. Faktury podatkowe zawierają obliczenia VAT lub podatku od sprzedaży, a API obsługuje wiele stawek podatku w obrębie jednej faktury dla jurysdykcji, które stosują różne stawki do różnych kategorii produktów. To typ dokumentu, który jest używany najczęściej i który większość wyszukiwań szablonów próbuje znaleźć.

Noty debetowe i noty kredytowe obsługują korekty po wystawieniu oryginalnej faktury. Nota debetowa dokumentuje dodatkowe opłaty, być może dlatego, że oryginalna faktura zaniżyła opłatę za wysyłkę, lub dlatego, że wykonano dodatkowe prace poza pierwotnymi umówionymi. Nota kredytowa dokumentuje redukcje, takie jak zwrócone towary, nadpłaty lub uzgodnione rabaty zastosowane post factum. Obie odwołują się do oryginalnej faktury, którą modyfikują i utrzymują ścieżkę audytu, którą wymagają regulacje księgowe. Na koniec pokwitowanie potwierdza, że płatność została otrzymana, zamykając cykl rozliczeniowy dla danej transakcji.

Od szukania szablonów do ładunku JSON

Różnica w przepływie pracy między fakturowaniem opartym na szablonach a fakturowaniem opartym na API jest dramatyczna. W przypadku szablonów wystawienie faktury oznacza otwarcie pliku dokumentu, zastąpienie tekstu zastępczego rzeczywistymi szczegółami klienta i rozliczenia, sprawdzenie, czy formuły nadal działają po dodaniu lub usunięciu pozycji, dostosowanie formatowania, jeśli coś się przesunęło, zapisanie wyniku jako PDF i zarchiwizowanie zarówno źródła edytowalnego, jak i wyjścia PDF. Z API wystawienie faktury oznacza złożenie ładunku JSON z danymi rozliczeniowymi i wysłanie go do punktu końcowego. Odpowiedzią jest gotowy PDF. Nie ma szablonu do otwarcia, żadnej formuły do sprawdzenia, żadnego formatowania do dostosowania, żadnego zarządzania plikami do wykonania.

Ładunek JSON zawiera wszystko, czego API potrzebuje do wytworzenia dokumentu: szczegóły wystawcy (nazwa, adres, numer identyfikacyjny podatkowy, informacje bankowe), szczegóły odbiorcy, numer faktury lub konfigurację autonumeracji, datę wystawienia i termin zapłaty, pozycje z opisami, ilościami, cenami jednostkowymi i obowiązującymi stawkami podatkowymi, wszelkie warunki rabatów, walutę i opcjonalne notatki lub instrukcje płatności. API wykonuje wszystkie obliczenia (razem za pozycję, sumy częściowe, kwoty podatku, razem ogółem), stosuje formatowanie i układ oraz renderuje ostateczny dokument. Cały proces zajmuje mniej niż sekundę.

Dla firm, które wydają faktury programowo, być może z platformy e-commerce, narzędzia do zarządzania projektami lub niestandardowego CRM, integracja API jest prosta. System, który wie, co musi być rozliczone, konstruuje ładunek JSON ze swoich własnych danych i wywołuje API. Nie jest potrzebna żadna interwencja człowieka między momentem, gdy nastąpi zdarzenie rozliczeniowe, a momentem, gdy istnieje profesjonalny dokument faktury. Dla firm, które wystawiają faktury ręcznie, JSON można złożyć za pomocą prostego interfejsu formularza mapującego strukturę wejściową API, nadal szybciej i niezawodniej niż edytowanie szablonu procesora tekstu.

Brak szablonów do znalezienia i brak formularzy do wypełnienia

Głębsza korzyść z fakturowania opartego na API to nie tylko szybkość, ale eliminacja całej kategorii pracy konserwacyjnej. Szablony się starzeją. Adres firmy się zmienia i ktoś musi zaktualizować każdy szablon. Nowa stawka podatkowa wchodzi w życie i każda formuła musi być zmieniona. Logo firmy jest przeprojektowywane i każdy szablon musi mieć nowy obraz wstawiony na poprawne miejsce. Indywidualnie są to małe zadania, ale w trzech firmach z wieloma wariantami szablonów każda, reprezentują one trwałe tło spustoszenia na czas i uwagę.

W podejściu opartym na API nie istnieje żadna z tych prac konserwacyjnych. Szczegóły wystawcy są przechowywane jako dane i zawarte w ładunku JSON. Gdy adres się zmienia, dane zmieniają się w jednym miejscu, a każda kolejna faktura odzwierciedla aktualizację automatycznie. Gdy stawka podatku się zmienia, parametr stawki w ładunku się zmienia, a API poprawnie oblicza od pierwszej faktury zgodnie z nową stawką. Gdy logo się zmienia, adres URL obrazu w konfiguracji się zmienia, a każdy przyszły dokument nosi nowe branding. Nie ma pliku szablonu do znalezienia, edycji, testowania i rozpowszechniania. Są tylko dane, a dane są łatwe do aktualizacji.

Brak wypełniania formularzy jest równie istotny. Usługi fakturowania online, które zastąpiły szablony formularzami internetowymi, rozwiązały problem formatowania, ale stworzyły nowe tarcie: ręczne wpisywanie tych samych szczegółów wystawcy, tych samych informacji bankowych, tych samych numerów rejestracji podatkowej i tych samych warunków płatności do formularzy internetowych dla każdej faktury. API akceptuje wszystko to jako ustrukturyzowane dane, co oznacza, że można je przechowywać raz i ponownie używać w nieskończoność. Firma, która wystawia pięćdziesiąt faktur miesięcznie dla dziesięciu stałych klientów, może przechowywać dziesięć profili klientów i konstruować każdy ładunek faktury, łącząc przechowywany profil klienta z konkretnymi pozycjami dla tego okresu rozliczeniowego. Wysiłek na jedną fakturę sprowadza się do określenia tylko tego, co jest unikalne dla tej konkretnej transakcji.

Dlaczego to zaczęło się od trzech firm, a nie jednej

Pojedyncza firma z prostymi wymaganiami dotyczącymi fakturowania może radzić sobie szablonami. Frustracja jest zarządzalna, gdy jest tylko jeden zestaw szablonów do utrzymania, jeden standard brandingu do naśladowania i jedna jurysdykcja podatkowa do obsługi. Podejście szablonowe robi się problematyczne, gdy złożoność rośnie, a prowadzenie trzech oddzielnych firm zapewniło dokładnie złożoność potrzebną do uwidocznienia każdej słabości tradycyjnego podejścia.

Każda firma działała w nieco innym kontekście. Jedna wystawiała faktury za usługi klientom międzynarodowym w wielu walutach, wymagając elastycznego obsługi walut i międzynarodowych danych bankowych na każdym dokumencie. Druga wystawiała faktury za produkty w kraju z obliczeniami VAT w Bułgarii, które musiały być zgodne z wymaganiami dotyczącymi formatowania władz podatkowych. Trzecia działała w modelu hybrydowym, wystawiając zarówno faktury za usługi, jak i produkty mieszanemu gronu klientów krajowych i międzynarodowych. Trzy różne szablony, trzy różne wymagania obliczeniowe, trzy różne standardy formatowania regulacyjnego. Utrzymanie wszystkiego tego w plikach procesora tekstu nie było tylko nieefektywne; było podatne na błędy w sposób, który miał rzeczywiste konsekwencje księgowe.

API rozwiązało wszystkie trzy przypadki za pomocą pojedynczej integracji. Struktura ładunku JSON jest taka sama niezależnie od wystawcy, waluty lub jurysdykcji podatkowej. Jedynymi rzeczami, które się zmieniają, są wartości danych: różne szczegóły wystawcy, różne stawki podatku, różne waluty, różne opisy pozycji. Silnik renderowania elegancko obsługuje zmienność, ponieważ został zbudowany w celu dostosowania się do różnorodności, zamiast być statycznym szablonem zaprojektowanym dla jednego konkretnego przypadku. Trzy firmy, trzy całkowicie różne profile fakturowania i jedno API, które służy wszystkim bez jakiejkolwiek konserwacji szablonu specyficznej dla firmy.