Wstępny opis integracji z BAS przez HTTP
Konfiguracja BAS Księgowość: Oprogramowanie do automatyzacji biznesu dla księgowości, edycja 2.1 (2.1.31.1)
## 1. Wyjściowe zapytanie z systemu CRM Bitrix → BAS (podczas wystawiania faktury)
Podczas wystawiania faktury klientowi i jej wysyłania, jednym zapytaniem uruchamiamy integrację i przekazujemy dane do BAS.
W to zapytanie wchodzi pełny pakiet informacji, w tym:
(id Bitrix jest przekazywane i zapisywane w oddzielnych polach)
- Kontrahent (klient) //jeśli już istnieje, sprawdzamy po guid 1c lub (jeśli nie zostało przekazane): "Osoba fizyczna" - NIP; "Osoba prawna" - REGON) (wyjaśnić, które obowiązkowe pola powinny być przekazywane)
- Dane bankowe kontrahenta //jeśli już istnieje, sprawdzamy po guid 1c lub po IBAN//(wyjaśnić, które obowiązkowe pola powinny być przekazywane)
- Umowa (kontrakt) kontrahenta //jeśli już istnieje, sprawdzamy po guid 1c lub po NUMERZE Umowy//(wyjaśnić, które obowiązkowe pola powinny być przekazywane)
- link do załącznika do umowy/faktury, faktura (wiele) (nowe pole tekstowe)
- Faktura (invoice) //pola faktury// (wyjaśnić, które obowiązkowe pola powinny być przekazywane)
- link do załącznika do umowy/faktury (nowe pole tekstowe)
- CMR międzynarodowy numer TTN /lub TTN w Ukrainie numer (nowe pole tekstowe)
- link do TTN do faktury (nowe pole tekstowe)
Treść faktury - nazwa(y) (guid 1c) oraz treść(i) usług
Również dla wszystkich załączonych/powiązanych dokumentów w danych, które wysyłamy do BAS, przekazywane są wewnętrzne ID z Bitrixa.
## 2. Logika przetwarzania po stronie BAS
Po otrzymaniu zapytania BAS sprawdza obecność wymaganych encji i:
- tworzy brakujące dane, jeśli ich jeszcze nie ma, aby móc poprawnie wystawić fakturę w BAS;
- w przypadku duplikatów BAS przetwarza je samodzielnie (logika deduplikacji - po stronie BAS).
## 3. Odpowiedź BAS → nasz system (po pomyślnym utworzeniu)
Po pomyślnym utworzeniu/aktualizacji danych w BAS, BAS zwraca nam swoje wewnętrzne ID utworzonych/powiązanych obiektów (do dalszej synchronizacji i powiązania).
## 4. Zdarzenia zwrotne z BAS → nasz system (przy wpływie środków)
Ze strony BAS do naszego systemu wysyłane są tylko przychodowe dokumenty kasowe (fakt wpływu pieniędzy) na nasz endpoint.
W tym webhooku / callback 1C przekazuje:
- kwotę
- walutę
- datę wpływu
- ID faktury CRM, na którą zarejestrowano płatność
ID faktury jest nam znane, ponieważ jest pobierane z danych, które wcześniej przekazaliśmy do BAS (i/lub z otrzymanych w odpowiedzi wewnętrznych ID).
## aktualizacja kontrahenta (i innych słowników) z (i do) systemu CRM planowana jest w przyszłości
