Clone
5
DFC Guide
Filipe edited this page 2025-11-27 18:11:36 +00:00

This section contains a first attempt to gather information on the Shopify/OFN integration, and provide an overview on features and setup steps.

Table of contents

Setup guide for testing

How do I connect to DFC?

  • Enable the feature toggle for connected_apps
  • Visit the Connected Apps setting on the Configuration section, and check the option DFC anonymized orders API for research purposes ; Click Update.
  • Visit /admin/enterprises/oidc_settings and login with the OIDC test account

image

Troubleshoot 🔧

  1. If you're getting an error stating that the account is already being used elsewhere, you can:
  1. If your're getting 403 Faraday error - Backorder failed (seen on Bugnsnag notifications, and per Email)

The hub's email needs to be added to the customer list (on the Shopify profile), and respectively approved:

image

So, login to the Shopify account; visit the authorized customers section (to be verified...), add the Hub's email and approve it. The error should now stop occurring.

Which server can I use?

Connecting with DFC should be possible with all three available staging servers (AU, UK, FR).

Which account should I use?

testdfc@protonmail.com, details are on Bitwarden.

How do I import products?

  1. After connecting the staging server (or using -UK, -FR) and your account, visit the product import page.
  2. Visit /admin/product_import
  3. Scroll to bottom, enter URL of a DFC products endpoint, eg: https://env-0105831.jcloud-ver-jpe.ik-server.com/api/dfc/Enterprises/test-hodmedod/SuppliedProducts https://staging.openfoodnetwork.org.au/api/dfc/enterprises/{id}/catalog_items (where id is the db id of an enterprise that your user has management role for) Select enterprise to import into
  4. Click "Preview"
  5. Summary should be shown with correct info.
  6. Click import. The correct number of products should be imported.

Order Cycle and Product Sync

Order Cycle Setup

Useful Links