Integracja osCommerce z ifirma.pl

Instalacja wtyczki:

1. Pobierz wtyczkę (wersja 2.3.2). Wybierz opcję “Download” i format pliku (.zip lub tar.gz).
2. Korzystając z Menedżera FTP (np. FileZilla), w sklepie osCommerce, który wcześniej zainstalowano na serwerze, przejdź do katalogu o nazwie „admin”.
3. 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”.

4. Plik “configuration.php” podmień w “catalog/admin/includes/boxes/configuration.php”.
5. Zmień uprawnienia wszystkim wgranym plikom (również tym w folderze “ifirma”) na 755. Plikowi o nazwie “config.ini” ustaw uprawnienia równe 777.
6. 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”.
7. 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.