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 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.

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.

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.

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