FRANCE PREP FBA – Check-list connector marketplaces

Pré-requis France Prep FBA (tous canaux)

• Créer / vérifier le compte client dans la table users (id = client_id).
• Pour chaque marketplace connectée, toujours lier la boutique / compte à ce client_id (tables shopify_shops, ebay_shops / ebay_tokens, orders_octopia.user_id, amazon_sellers, etc.).
• Les commandes finissent dans shopify_orders, ebay_orders, orders_octopia, (plus tard amazon_orders), puis sont affichées dans orders_dashboard.php et les bons de préparation prep_slip.php.

1. CONNEXION SHOPIFY Shopify

1.1 Côté client

• Le client ouvre son admin Shopify.
• Il installe l’app “France Prep FBA – Sync command” (lien App Store ou lien d’installation direct).
• Il accepte les scopes demandés : read_orders, read_customers.

1.2 Côté connector

• Shopify redirige vers /shopify/shopify_oauth_callback.php.
• Le callback échange le code contre un access_token Admin API.
• Insertion / mise à jour dans shopify_shops :
  • shop_domain
  • access_token
  • label (nom boutique / société)
  • client_id (lien avec users.id)
  • is_active = 1, last_sync_at mis à jour par la synchro.

1.3 Test & synchro

• Lancer manuellement : shopify_sync_all.php?key=CRON_KEY ou laisser la tâche CRON.
• Vérifier que shopify_orders contient les commandes.
• Vérifier l’affichage dans orders_dashboard.php (source = shopify ou tiktok_via_shopify).
• Tester un bon de préparation : prep_slip.php?source=shopify&order_id=ID_COMMANDE.

2. CONNEXION CDISCOUNT/OCTOPIA Cdiscount / Octopia

2.1 Côté client

• Signature du contrat / mandat France Prep FBA + Octopia.
• Le client fournit les infos nécessaires : identifiant vendeur, nom de boutique, éventuellement clés API selon l’implémentation.

2.2 Côté connector

• Configuration de la boutique dans la partie Cdiscount / Octopia (table dédiée, champs user_id, shop, etc.).
• Le script de synchro (ex. /cdiscount/cdiscount_sync_orders.php) interroge l’API Octopia et remplit la table orders_octopia.

2.3 Test & synchro

• Lancer manuellement le script de sync (même URL que celle du CRON).
• Vérifier que orders_octopia est remplie avec user_id correct.
• Vérifier l’affichage dans orders_dashboard.php (source = cdiscount).
• Tester un bon de préparation : prep_slip.php?source=cdiscount&order_id=ID_COMMANDE.

3. CONNEXION EBAY eBay

3.1 Côté client

• Sur le portail connector, le client clique sur “Connecter mon compte eBay”.
• Redirection vers la page OAuth eBay, connexion et acceptation des scopes (ex. sell.fulfillment.readonly).

3.2 Côté connector

• Callback eBay : /ebay/ebay_oauth_callback.php.
• Échange du code contre access_token + refresh_token.
• Stockage des tokens dans les tables eBay, liés à client_id.

3.3 Test & synchro

• Lancer manuellement : /ebay/ebay_sync_orders.php?days=7&key=CRON_KEY ou laisser la tâche CRON.
• Vérifier ebay_orders, orders_dashboard.php (source = ebay) et prep_slip.php?source=ebay&order_id=....

4. CONNEXION AMAZON SP-API Amazon

4.1 Côté client

• Le client reçoit un lien d’autorisation SP-API (Seller Central) généré par France Prep FBA.
• Il se connecte à son compte Seller Central, choisit la marketplace (FR / EU) et autorise l’application.

4.2 Côté connector

• Callback : /amazon/spapi_callback.php.
• Récupération de spapi_oauth_code + selling_partner_id.
• Échange contre un refresh_token LWA et stockage dans amazon_sellers (champs type client_id, selling_partner_id, region, refresh_token).

4.3 Test & synchro

• Lancer un script test (ex. /amazon/spapi_test.php) sur un endpoint simple pour vérifier que SP-API répond en 200.
• Mettre en place la synchro commandes (ex. /amazon/amazon_sync_orders.php) qui remplit amazon_orders.
• Ajouter la source amazon dans orders_dashboard.php + prep_slip.php.

5. TÂCHES CRON

*/15 * * * * /usr/bin/curl -fss --max-time 120 "https://connector.franceprepfba.eu/tiktok/tiktok_sync_orders.php?days=7&key=azertyuiop" >> /home/mese7503/cron_tiktok.log 2>&1

*/15 * * * * /usr/local/bin/php -d display_errors=0 /home/mese7503/connector.franceprepfba.eu/shopify/shopify_sync_all.php >> /home/mese7503/cron_shopify.log 2>&1

*/15 * * * * /usr/bin/curl -fss --max-time 120 "https://connector.franceprepfba.eu/ebay/ebay_sync_orders.php?days=7&key=azertyuiop" >> /home/mese7503/cron_ebay.log 2>&1

*/15 * * * * /usr/bin/curl -fss --max-time 120 "https://connector.franceprepfba.eu/cdiscount/octopia_sync_orders.php?days=7&key=azertyuiop" >> /home/mese7503/cron_cdiscount.log 2>&1

*/15 * * * * /usr/local/bin/php -d display_errors=0 /home/mese7503/connector.franceprepfba.eu/amazon/amazon_sync_orders.php >> /home/mese7503/cron_amazon.log 2>&1