# DF ERP Bridge: zaplanowany eksport do ERP (Sage 100, EBP, Cegid, Codial)
> DF ERP Bridge automatycznie eksportuje zamówienia, klientów i stany magazynowe z PrestaShop do Twojego programu do zarządzania firmą (Sage 100, EBP, Cegid, Codial) albo do generycznego formatu CSV, XML lub…
- Strona:
- Język: pl
- Zaktualizowano: 2026-07-31
- Inne języki: [fr](https://www.datafirefly.com/documentation/dferpbridge/index.md), [en](https://www.datafirefly.com/en/documentation/dferpbridge/index.md), [es](https://www.datafirefly.com/es/documentation/dferpbridge/index.md), [de](https://www.datafirefly.com/de/documentation/dferpbridge/index.md), [it](https://www.datafirefly.com/it/documentation/dferpbridge/index.md), [pt](https://www.datafirefly.com/pt/documentation/dferpbridge/index.md), [nl](https://www.datafirefly.com/nl/documentation/dferpbridge/index.md)
- Indeks:
DF ERP Bridge automatycznie eksportuje **zamówienia**, **klientów** i **stany magazynowe** z PrestaShop do Twojego programu do zarządzania firmą (Sage 100, EBP, Cegid, Codial) albo do generycznego formatu CSV, XML lub JSON. Pliki są generowane z częstotliwością, którą sam ustalasz, i dostarczane automatycznie przez FTP/FTPS albo e-mailem, pod kontrolą crona. Ten przewodnik obejmuje instalację, tworzenie profili, formaty, transport, harmonogram i bezpieczeństwo.
## Instalacja
1. W panelu administracyjnym otwórz **Moduły > Menedżer modułów**, kliknij **Zainstaluj moduł** i wskaż plik `dferpbridge.zip`.
2. Po instalacji kliknij **Konfiguruj**.
3. Przy pierwszej instalacji token crona jest generowany automatycznie, a czas przechowywania dzienników ustawiany na 30 dni. Oba ustawienia można zmienić w sekcji **Ustawienia** na dole strony konfiguracji.
Moduł działa wyłącznie po stronie panelu administracyjnego: nie dodaje niczego do witryny sklepu. Jest zgodny z PrestaShop 8.0 do 9.x i z trybem wielosklepowym.
## Tworzenie profilu eksportu
**Profil** opisuje jeden eksport: jakie dane, w jakim formacie, do jakiego miejsca docelowego i z jaką częstotliwością. Możesz utworzyć dowolną liczbę profili. Kliknij **Dodaj profil** i wypełnij pola.
### Pola główne
- **Nazwa profilu**: etykieta ułatwiająca identyfikację (na przykład „Zamówienia do Sage, dziennie”).
- **Dane do eksportu**: Zamówienia, Klienci albo Stany magazynowe.
- **Format ERP**: Sage 100, EBP, Cegid, Codial albo format generyczny CSV / XML / JSON.
- **Transport**: umieszczenie na FTP albo załącznik e-mail.
- **Częstotliwość**: godzinowa, dzienna albo tygodniowa. Oceniana przy każdym wywołaniu crona.
- **Filtr statusów zamówień**: (tylko zamówienia) wybór wielokrotny; zostaw pusty, aby eksportować wszystkie statusy.
- **Eksport przyrostowy**: eksportuje wyłącznie rekordy utworzone od ostatniego przebiegu.
- **Aktywny**: profil nieaktywny jest pomijany przez crona, ale nadal można go uruchomić ręcznie.
## Formaty eksportu
Cztery gotowe ustawienia ERP są generowane w kodowaniu **Windows-1252**, ze średnikiem jako separatorem, zakończeniami wierszy CRLF i przecinkiem dziesiętnym, zgodnie z konwencją oczekiwaną przez francuskie narzędzia importu. Formaty generyczne wychodzą w **UTF-8**.
### Sage 100
Plik `.txt` o dwóch poziomach: wiersze nagłówka „E” i następujące po nich wiersze szczegółowe „L”, w strukturze zgodnej z importem dokumentów w Sage 100 Gestion Commerciale. Koszty wysyłki są dodawane w dedykowanym wierszu „PORT”. Kolejność kolumn można przemapować w kreatorze parametryzowanego formatu importu w Sage.
### EBP
Płaski plik CSV `.csv` z wierszem nagłówków, jeden wiersz na pozycję zamówienia (pola nagłówka są powtarzane). Dopasowany do parametryzowanego importu w EBP Gestion Commerciale.
### Cegid
Dokument XML `.xml` o strukturze DOCUMENTS / DOCUMENT z blokiem ENTETE i blokiem LIGNES, do integracji dokumentów w stylu Cegid Business / XRP Flex.
### Codial
Płaski plik CSV `.csv` z nagłówkami, jeden wiersz na pozycję zamówienia, przygotowany pod konfigurowalny moduł importu Codial.
### Generyczne CSV / XML / JSON
Do każdego innego narzędzia (Odoo, Dolibarr, własny system ERP, arkusz kalkulacyjny) te formaty eksportują komplet pól w UTF-8. Generyczny CSV zawiera znacznik BOM, dzięki czemu poprawnie otwiera się w Excelu; XML zagnieżdża pozycje pod każdym zamówieniem; JSON opakowuje rekordy w kopertę zawierającą encję, datę i liczbę rekordów.
## Transport
### FTP / FTPS
Podaj host, port (domyślnie 21), użytkownika, hasło i ścieżkę zdalną (na przykład `/exports/prestashop`). Tryb pasywny oraz jawny SSL (FTPS) są obsługiwane osobnymi przełącznikami.
Hasło FTP jest szyfrowane w bazie danych kluczem szyfrowania Twojego sklepu. Przy edycji profilu zostaw pole hasła puste, aby zachować dotychczasową wartość.
### E-mail
Plik jest wysyłany jako załącznik na adres wskazany w polu **E-mail odbiorcy**. Szablony wiadomości są dostarczane po francusku i po angielsku.
## Harmonogram przez cron
Panel **Wykonanie zaplanowane (cron)** pokazuje zabezpieczony adres URL do wywołania. Dodaj go do crontab lub do usługi cron. Przy każdym wywołaniu uruchamiane są wyłącznie profile, których częstotliwość upłynęła (z tolerancją 5 minut).
```
*/15 * * * * curl -s "https://twoj-sklep.pl/module/dferpbridge/cron?token=TWOJ_TOKEN" > /dev/null 2>&1
```
Opcjonalne parametry adresu URL:
- `id_profile=N`: uruchamia tylko jeden profil.
- `force=1`: pomija kontrolę częstotliwości i uruchamia eksport niezależnie od niej.
Zaplanuj crona co najmniej tak często, jak wynosi najwyższa częstotliwość używana przez Twoje profile. Profil „godzinowy” wymaga crona wywoływanego minimum raz na godzinę.
### Uruchomienie ręczne
Każdy profil ma pod listą przycisk **Uruchom teraz**, który natychmiast wyzwala eksport z pominięciem częstotliwości. To wygodne przy testowaniu profilu po konfiguracji.
## Eksport przyrostowy i filtry
W trybie przyrostowym eksportowane **zamówienia** i **klienci** to wyłącznie rekordy utworzone po dacie ostatniego udanego przebiegu, co zapobiega duplikatom w Twoim systemie ERP. **Stany magazynowe** są zawsze eksportowane jako pełna migawka, niezależnie od tego ustawienia.
W przypadku zamówień filtr statusów ogranicza eksport do wybranych stanów (na przykład „Płatność zaakceptowana” i „Wysłane”). Każde zamówienie zawiera swoje pozycje szczegółowe, VAT wyliczony dla każdej pozycji, koszty wysyłki oraz pełny adres rozliczeniowy wraz z identyfikatorem firmy (pole SIRET w PrestaShop) i numerem VAT UE.
## Dziennik eksportów i przechowywanie
Dwadzieścia ostatnich eksportów jest widocznych w panelu administracyjnym wraz ze statusem (sukces, pusty, błąd), liczbą rekordów, wygenerowanym plikiem i ewentualnym komunikatem. Wpisy starsze niż skonfigurowany czas **przechowywania** (domyślnie 30 dni) są usuwane automatycznie przy każdym przebiegu crona.
## Bezpieczeństwo
- Adres URL crona jest chroniony tokenem porównywanym w stałym czasie; wywołanie bez prawidłowego tokenu zwraca błąd 403.
- Hasło FTP jest szyfrowane w bazie i odszyfrowywane dopiero w momencie połączenia.
- Token crona możesz wygenerować ponownie w sekcji **Ustawienia**; poprzedni adres URL przestaje wtedy działać.
## Rozwiązywanie problemów
### Komunikat „Invalid token” przy wywołaniu crona
Sprawdź, czy token w adresie URL dokładnie odpowiada temu wyświetlonemu w panelu crona. Jeśli został wygenerowany ponownie, zaktualizuj wpis w crontab.
### Eksport FTP kończy się niepowodzeniem
Upewnij się, że rozszerzenie PHP FTP jest dostępne na serwerze, że host i użytkownik są poprawne oraz że ścieżka zdalna istnieje. Spróbuj włączyć albo wyłączyć tryb pasywny, zależnie od swojego serwera.
### Profil się wykonuje, ale nie powstaje żaden plik
Status „pusty” oznacza, że żaden rekord nie odpowiadał filtrom (na przykład brak nowych zamówień od ostatniego przebiegu w trybie przyrostowym albo zbyt restrykcyjny filtr statusów).
### Formaty XML zwracają błąd
Gotowe ustawienie Cegid oraz generyczny XML wymagają rozszerzenia PHP XMLWriter, standardowego na większości hostingów pod PrestaShop.
## Zgodność
- PrestaShop 8.0, 8.1, 8.2 i 9.x
- PHP 7.4 do 8.3
- Tryb wielosklepowy
- Rozszerzenie PHP FTP wymagane przy transporcie FTP; XMLWriter wymagany dla formatów XML