DF ERP Bridge: geplande ERP-export (Sage 100, EBP, Cegid, Codial)

DF ERP Bridge exporteert uw PrestaShop-bestellingen, klanten en voorraad automatisch naar uw boekhoud- of beheerpakket (Sage 100, EBP, Cegid, Codial) of naar een generiek CSV-, XML- of JSON-formaat. De bestanden worden aangemaakt in het ritme dat u bepaalt en automatisch afgeleverd via FTP/FTPS of e-mail, aangestuurd door een cron. Deze gids behandelt de installatie, het aanmaken van profielen, de formaten, de transportwijzen, de planning en de beveiliging.

Installatie

1. Open in de backoffice Modules > Modulebeheer, klik op Een module installeren en plaats het bestand dferpbridge.zip.
2. Klik na de installatie op Configureren.
3. Bij de eerste installatie wordt automatisch een crontoken aangemaakt en wordt de bewaartermijn van de logboeken op 30 dagen gezet. Deze instellingen wijzigt u in het gedeelte Instellingen onder aan de configuratiepagina.

Een exportprofiel aanmaken

Een profiel beschrijft een export: welke gegevens, in welk formaat, naar welke bestemming en met welke frequentie. U kunt zoveel profielen aanmaken als nodig. Klik op Een profiel toevoegen en vul de velden in.

Belangrijkste velden

• Naam van het profiel: een benaming die u helpt het te herkennen (bijvoorbeeld « Bestellingen naar Sage, dagelijks »).
• Te exporteren gegevens: Bestellingen, Klanten of Voorraad.
• ERP-formaat: Sage 100, EBP, Cegid, Codial, of een generiek CSV-, XML- of JSON-formaat.
• Transport: FTP-aflevering of e-mailbijlage.
• Frequentie: elk uur, dagelijks of wekelijks. Wordt bij elke aanroep van de cron beoordeeld.
• Filter op besteltoestanden: alleen voor bestellingen, meervoudige selectie; laat leeg om alle toestanden te exporteren.
• Incrementele export: exporteert alleen de records die sinds de vorige doorloop zijn aangemaakt.
• Actief: een inactief profiel wordt door de cron genegeerd maar blijft handmatig uitvoerbaar.

De exportformaten

De vier ERP-presets worden aangemaakt in de codering Windows-1252, met een puntkomma als scheidingsteken, CRLF-regeleinden en een komma als decimaalteken: de conventie die de Franse importtools verwachten. De generieke formaten komen in UTF-8 naar buiten.

Sage 100

Bestand .txt met twee niveaus: kopregels « E », gevolgd door hun detailregels « L », in een structuur die geschikt is voor de documentimport van Sage 100 Gestion Commerciale. De verzendkosten komen op een aparte regel « PORT ». De volgorde van de kolommen kunt u opnieuw toewijzen in de wizard « Instelbaar importformaat » van Sage.

EBP

Platte CSV .csv met een kopregel, één regel per bestelregel (de kopvelden worden herhaald). Geschikt voor de instelbare import van EBP Gestion Commerciale.

Cegid

XML-document .xml met een structuur DOCUMENTS / DOCUMENT, met een blok ENTETE en een blok LIGNES, voor documentintegratie in de stijl van Cegid Business / XRP Flex.

Codial

Platte CSV .csv met kopregel, één regel per bestelregel, bedacht voor de instelbare importmodule van Codial.

Generiek CSV / XML / JSON

Voor elk ander pakket (Odoo, Dolibarr, een eigen ERP, een rekenblad) exporteren deze formaten alle velden in UTF-8. De generieke CSV bevat een BOM zodat die netjes in Excel opent; de XML nest de regels onder elke bestelling; de JSON verpakt de records in een omhulsel met entiteit, datum en aantal.

Transportwijzen

FTP / FTPS

Vul de host, de poort (standaard 21), de gebruiker, het wachtwoord en het pad op afstand in (bijvoorbeeld /exports/prestashop). De passieve modus en expliciete SSL (FTPS) worden met eigen schakelaars ondersteund.

E-mail

Het bestand wordt als bijlage verstuurd naar het adres bij E-mail ontvanger. De e-mailsjablonen worden in het Frans en het Engels geleverd.

Planning via cron

Het paneel Geplande uitvoering (cron) toont de beveiligde URL die u moet aanroepen. Voeg die toe aan uw crontab of aan een cron-dienst. Bij elke aanroep draaien alleen de profielen waarvan de frequentie is verstreken (met een tolerantie van 5 minuten).

*/15 * * * * curl -s "https://uw-winkel.nl/module/dferpbridge/cron?token=UW_TOKEN" > /dev/null 2>&1

Optionele parameters in de URL:

• id_profile=N: voert slechts één profiel uit.
• force=1: negeert de frequentiecontrole en voert hoe dan ook uit.

Handmatige uitvoering

Elk profiel heeft onder de lijst een knop Nu uitvoeren, die de export meteen start en de frequentie negeert. Handig om een profiel na de configuratie te testen.

Incrementele export en filters

In incrementele modus worden alleen de bestellingen en klanten geëxporteerd die na de datum van de laatste geslaagde doorloop zijn aangemaakt, wat dubbels in uw ERP voorkomt. De voorraad wordt altijd als volledige momentopname geëxporteerd, ongeacht deze instelling.

Voor bestellingen beperkt het toestandenfilter de export tot de geselecteerde toestanden (bijvoorbeeld « Betaling aanvaard » en « Verzonden »). Elke bestelling neemt haar detailregels mee, de per regel berekende btw, de verzendkosten en het volledige factuuradres (ondernemingsnummer, intracommunautair btw-nummer).

Exportlogboek en bewaartermijn

De 20 recentste exports verschijnen in de backoffice met hun status (geslaagd, leeg, fout), het aantal records, het aangemaakte bestand en een eventuele melding. Logboeken die ouder zijn dan de ingestelde bewaartermijn (standaard 30 dagen) worden bij elke doorloop van de cron automatisch opgeruimd.

Beveiliging

• De cron-URL is beschermd met een token dat in constante tijd wordt vergeleken; een aanroep zonder geldig token geeft een 403-fout.
• Het FTP-wachtwoord wordt versleuteld bewaard en pas op het moment van verbinden ontsleuteld.
• U kunt het crontoken opnieuw genereren via de Instellingen; de oude URL werkt dan niet meer.

Problemen oplossen

« Invalid token » bij het aanroepen van de cron

Controleer of het token in de URL exact overeenkomt met dat in het cronpaneel. Is het opnieuw gegenereerd, werk dan uw crontab bij.

De FTP-export mislukt

Ga na of de PHP-extensie FTP op de server beschikbaar is, of de host en de gebruiker kloppen, en of het pad op afstand bestaat. Probeer de passieve modus aan of uit te zetten, afhankelijk van uw server.

Het profiel draait maar er komt geen bestand uit

De status « leeg » betekent dat er geen enkel record aan de filters voldeed (bijvoorbeeld geen nieuwe bestellingen sinds de vorige doorloop in incrementele modus, of een te streng toestandenfilter).

De XML-formaten geven een fout

De presets Cegid en generieke XML vragen de PHP-extensie XMLWriter, die op de meeste PrestaShop-hostings standaard aanwezig is.

Compatibiliteit

• PrestaShop 8.0, 8.1, 8.2 en 9.x
• PHP 7.4 tot 8.3
• Multistore
• PHP-extensie FTP vereist voor het FTP-transport; XMLWriter vereist voor de XML-formaten