Connection Options
Audience: Suppliers
In this article, you will find information related to our supported connection options. The sections within this article are outlined below:
- Overview
- Standard connection options (Web Portal, EDI, API)
- Advanced connection options (Shopify, ShipStation)
- Custom connection options
- Changing how you connect
Overview
We offer a variety of connection options for suppliers to integrate into our system. Regardless of how you connect, you will always have access to our web-portal to view and manage orders. If you are unsure of how you would like to connect, we recommend using our Web Portal and changing your connection later on - this will provide you with immediate access to our portal and the ability to process orders while you work on automating your connection.
Standard connection options (Web Portal, API, EDI)
Standard Options - these are available to all suppliers free of charge:
| Web Portal | API | EDI | |
|---|---|---|---|
| Summary | Process orders directly from our web-portal. This connection method offers the quickest go-live. | Use our API to seamlessly receive real-time data flows. Supported formats include XML and JSON. | Map to your retailer's EDI specifications to automate order processing with your external systems. Supported formats include AS2, FTP and SFTP. |
| Expected time to onboard | 1-5 business days | 7-14 business days | 7-14 business days |
| Supported documents |
✓ Orders ✓ Acknowledgments ✓ Shipments ✓ Invoices ✓ Returns ✓ Inventory ✓ Product Feeds ✓ Packing Slips |
✓ Orders ✓ Acknowledgments ✓ Shipments ✓ Invoices ✓ Returns ✓ Inventory ✓ Product Feeds ✓ Packing Slips |
✓ Orders ✓ Acknowledgments ✓ Shipments ✓ Invoices ✓ Returns ✓ Inventory ✓ Packing Slips
Product Feeds will need to be manually uploaded into the portal |
| Additional resources | See retailer's EDI specifications | ||
| Note: Supported documents vary based on the retailer. Review retailer-specific documentation to know which documents are required. | |||
Advanced connection options (Shopify, ShipStation)
Advanced Options - these are available for Logicbroker customers. Some retailers support these connection methods for suppliers - reach out to your retailer to know if advanced connection options are supported:
| Shopify | ShipStation | Squarespace | |
|---|---|---|---|
| Summary | Process orders directly from your Shopify account. | Process orders directly from your ShipStation account. | Process orders directly from your Squarespace account. |
| Expected time to onboard | 1-5 business days | 1-5 business days | 1-5 business days |
| Supported documents |
✓ Orders ✓ Shipments ✓ Inventory ✓ Packing Slips
We will auto-create Acknowledgments and Invoices. Cancellations, Returns and Product Feeds will need to be manually created/uploaded in the portal. |
✓ Orders ✓ Cancellations ✓ Shipments ✓ Packing Slips
We will auto-create Acknowledgments and Invoices. Returns, Inventory and Product Feeds will need to be manually created/uploaded in the portal.
|
|
| Additional resources | Shopify | ShipStation | Squarespace |
| Note: Supported documents vary based on the retailer. Review retailer-specific documentation to know which documents are required. | |||
Note: Supported documents vary based on the retailer. Review retailer-specific documentation to know which documents are required.
Custom connection options
If you need our team to support a custom connection to our system, please reach out to support@logicbroker.com to have that set up. This may include needing some documents to process through different connections, or different connections per partner.
Changing how you connect
You can change your connection method with a retailer after onboarding, for example from the Web Portal to EDI, from EDI to API, or from EDI to Shopify or ShipStation. Logicbroker Support makes the change on your account. You can't switch the connection type yourself in the portal.
Before you contact Support, decide the following:
- Which retailer the change is for. The connection type is set per retailer, so you can use the portal for one retailer and EDI for another.
- Which connection method you want to use: Web Portal, EDI, API or a connector such as Shopify or ShipStation.
- For EDI, how you will send and receive files (AS2, SFTP or a VAN) and your EDI ID (ISA qualifier and ID).
- Your target date, if you are already live in Production.
Email support@logicbroker.com with your company name, the retailer and the connection method you want.
I chose the wrong connection method during onboarding
Who it applies to: suppliers still testing in Stage whose connection type doesn't match how they process orders.
What it means: the connection method you pick in the onboarding form decides how orders reach you. If the form says Web Portal but you use EDI or API, or the reverse, test orders go to the wrong place or fail.
Signs of a mismatch:
- You use EDI, but test orders never arrive on your SFTP folder or AS2 system, even though your connection test succeeds or your inventory files process.
- You use the portal, but a test order shows the error "Unable to export documents because an EDI receiver identifier is not configured."
- You use the API, but test orders fail or show EDI transmission errors.
The fix:
- Email Support with the retailer and the connection method you meant to choose. You don't need to register again or fill in the onboarding form again.
- Support updates your connection type for that retailer and creates a new test order or resets your open test orders.
- If you moved to EDI, open Connections › EDI in Stage, or select Set up your EDI connection on your dashboard. Enter your connection details there. See AS2 Information or SFTP/FTP.
- If you moved to API, see API Authentication.
How to check it worked: the new test order reaches you the way you chose. EDI suppliers receive it on SFTP or AS2. API suppliers can retrieve it through the API. Portal suppliers see it in the portal without an EDI export error. Then continue your test cases under Testing. See Testing Overview.
Switching an existing connection after go-live
Who it applies to: suppliers already live in Production who want to change between the Web Portal, EDI, API or a connector.
What it means: a new connection method is a new integration. You test it in Stage before it replaces your current connection in Production.
- Email Support with the retailer, your current method and the method you want.
- Support sets up the new connection in Stage only. Your Production connection keeps running as it is.
- Set up your side in Stage. For a connector, open Connections › Connectors, select Connect to a new system and choose the system. For EDI, use Connections › EDI.
- Complete the retailer's test cases again with the new connection. Test cases you passed before may still show as completed. Select Create a New Test Order on each test case to run it again. Some retailers require every test case to be passed again after a change like this.
- When testing is done, Support coordinates the move of the new connection to Production with you.
If your retailer sends only UPCs on orders and your system uses your own SKUs, you may need a matching file before you switch to a connector.
How to check it worked: after the cutover, new Production orders arrive through the new connection.
Changing your EDI provider, VAN or AS2 setup
Who it applies to: EDI suppliers who are changing EDI provider, or moving between AS2, SFTP and a VAN.
What it means: it depends on whether your EDI ID changes.
- Your EDI ID stays the same and your connection to Logicbroker doesn't change (for example, your provider moves you to a VAN that still connects to Logicbroker over the same AS2 link): Logicbroker usually doesn't need to change your setup. Support still recommends a test in Stage before the cutover. Receive a test order, then send back an acknowledgement or shipment.
- You move between SFTP and AS2 with Logicbroker: this is a new connection. Update it under Connections › EDI in Stage and complete the test cases again.
- You move to a new EDI provider or a new EDI ID: this is a new connection. Set it up under Connections › EDI in Stage and complete the test cases again. If you change it for several retailers, complete the test cases for each one.
Two Logicbroker accounts can't use the same EDI ID. If your company has more than one Logicbroker account, use an EDI ID that isn't already set up on another account.
Send Support the new EDI ID and qualifier, the new connection details (AS2, SFTP or VAN), your provider's contact and your planned cutover date.
Moving a Shopify connection from Stage to Production
Your Shopify store is connected separately in Stage and in Production. When your account moves to Production, disconnect your store from Stage and connect it to Production. Then check that the products you want to sell have the tag Logicbroker. See Shopify.
What to send Support
Include:
- your company name and the retailer;
- your current connection method and the one you want;
- whether you are testing in Stage or live in Production;
- the PO number or test order of any order that didn't arrive, and the exact error;
- for EDI, your EDI ID and connection details;
- what you already tried.
We're updating this article. Some steps and screenshots may not match the portal yet. If anything is unclear, contact support@logicbroker.com.