Instalacja osCommerce oraz wtyczki potrzebnej do jego integracji z ifirma.pl jest całkowicie darmowa. Aby zainstalować wtyczkę, postępuj zgodnie z poniższą instrukcją.
Instalacja wtyczki:
- Pobierz wtyczkę (wersja 2.3.2). Wybierz opcję “Download” i format pliku (.zip lub tar.gz).
- Korzystając z Menedżera FTP (np. FileZilla), w sklepie osCommerce, który wcześniej zainstalowano na serwerze, przejdź do katalogu o nazwie „admin”.
- Z ściągniętej wtyczki wybierz następujące pliki i wgraj do katalogu “admin”:
- api_configuration.php
- api_request.php
- config.ini
- download.php
- orders.php
Wgraj też FOLDER (nie pliki z foldera, a folder) “ifirma”.
- Plik “configuration.php” podmień w “catalog/admin/includes/boxes/configuration.php”.
- Zmień uprawnienia wszystkim wgranym plikom (również tym w folderze “ifirma”) na 755. Plikowi o nazwie “config.ini” ustaw uprawnienia równe 777.
- Plik “001_ifirma_invoice_map.sql” zawiera zapytanie, które musimy wysłać do bazy danych naszego sklepu. Aby to zrobić należy:
- Zalogować się do phpMyAdmin.
- Wybrać bazę danych osCommerce, która domyślnie zapisana jest jako “_osco1”
- Wybrać zakładkę “SQL”.
- Wkleić treść pliku “001_ifirma_invoice_map.sql’ i kliknąć opcję ‘Wykonaj”.
- Przed skorzystaniem z API należy je skonfigurować za pomocą wygenerowanych w ifirma kluczy autoryzacyjnych. Aby wygenerować klucz należy:
- Zalogować się w ifirma.pl.
- Wybrać menu “administracja” ➡ “ustawienia” ➡ “ustawienia” ➡ “klucze autoryzacji”.
- Wygenerować dwa klucze symetryczne, jeden dla abonenta, drugi dla faktury.
W przypadku integracji kilku sklepów z jednym kontem ifirma należy użyć tych samych kluczy autoryzacyjnych.
Integracja API:
- Zaloguj się w panelu administracyjnym swojego sklepu.
- Kliknij “Configuration” ➡ “Ifirma konfiguracja”.
- Wklej wcześniej wygenerowane klucze, podaj login, którego używasz w ifirma i zapisz parametry.
- Aby wystawić fakturę wybierz “Customers” ➡ “Orders”.
Integracja osCommerce z ifirma.pl została ukończona. Teraz przy każdym zamówieniu będzie można użyć opcji “wystaw fakturę” lub “wystaw fakturę wysyłkową”. Taka faktura pojawi się w menu ‘Przychody’ w aplikacji ifirma.
