The LogicBroker connector pulls orders from your LogicBroker partner into the app and acknowledges them in LogicBroker. The app then sends shipments, invoices, cancellations, and inventory back to LogicBroker. You can also pull your product catalog from LogicBroker.
With this connector, you can:
- Pull orders from LogicBroker every 5 minutes and as LogicBroker sends them, and acknowledge them in LogicBroker.
- Cancel orders in the app when they're canceled in LogicBroker.
- Send fulfillments to LogicBroker as shipments, and send an invoice when an order is fully fulfilled.
- Send shipping request cancellations and rejected items to LogicBroker.
- Send available inventory to LogicBroker every 5 minutes.
- Pull products, including parent products and their color and size variants, from LogicBroker.
Setup
Before you begin, make sure you have:
- An active LogicBroker account.
- Your LogicBroker API key. Generate a Subscription Primary Key in the Connections API section of the LogicBroker portal.
- The Partner ID of the partner you want to sync with. You can find it on the Account Information page in LogicBroker.
- Optional: A retailer API key, if you want to pull the full product catalog (retailer and supplier products).
To connect LogicBroker:
- Navigate to Integrations in the app.
- Click Add Integration, and then select LogicBroker Ecomm.
- Select your environment under Select LogicBroker environment: LB Production (https://commerceapi.io) or LB Staging (https://stage.commerceapi.io).
- Enter your Subscription Primary Key in the API Key field.
- Enter your partner ID in the Partner ID field.
- Optional: Enter your retailer API key in the Retailer API key - optional (used for pulling Product Catalog Only) field.
- Click Connect.
- After you connect, toggle on the flows you want to use, such as Pull orders from LogicBroker and Push fulfillment information to LogicBroker.
When you connect, the app checks that the Partner ID belongs to your API key and registers LogicBroker webhooks for new and canceled orders.
Settings
| Setting | Description | Options/Default |
|---|---|---|
| Pull locations from LogicBroker | Creates locations in the app from your LogicBroker partners. Locations are required for order routing and inventory. | On/Off. Default: On |
| Pull orders from LogicBroker | Pulls orders from LogicBroker into the app. | On/Off. Default: Off |
| Exclude orders created before this date | Pulls only orders created after this date. If you leave it empty, the app uses the date you created the integration. To pull an older order after sync starts, update the order in LogicBroker. | Optional |
| Process only specific orders | Pulls only orders whose PO number matches a value you list. Regular expressions are supported. | Optional. Empty pulls all |
| Pull orders in these LogicBroker statuses | The LogicBroker statuses to pull orders in. The app acknowledges an order in LogicBroker only when it pulls it at Ready for Acknowledge. Orders pulled at Shipped, Ready to Invoice, or Completed are created as fulfilled and aren't routed. | Ready for Acknowledge (150), Acknowledged (200), Ready to Fulfill (400), Ready to Ship (500), Shipped (530), Ready to Invoice (600), Completed (1000). Default: Empty, which pulls Ready for Acknowledge only |
| Push SR cancelations into LogicBroker | Sends canceled quantities to LogicBroker when you cancel a shipping request in the app. | On/Off. Default: On |
| Push fulfillment information to LogicBroker | Sends fulfillments to LogicBroker as shipments. | On/Off. Default: Off |
| Push invoices to LogicBroker | Sends an invoice to LogicBroker after an order is fully fulfilled. | On/Off. Default: On |
| Pull products from LogicBroker | Pulls products from LogicBroker into the app. | On/Off. Default: Off |
| Force products resync | Pulls all products from LogicBroker again. The switch turns off after the resync starts. A full resync can take a long time. | On/Off. Default: Off |
| Pull full Product Catalog (retailer & supplier) from LogicBroker. | Pulls the full catalog with the retailer API key instead of your API key. Works only if you entered a retailer API key in the connection settings. | On/Off. Default: Off |
| Push inventory information to LogicBroker | Sends inventory from the app to LogicBroker. | On/Off. Default: Off |
| Push inventory from a specific location only | Sends inventory only from the location you select. If you leave it empty, the app sends totals from all active locations. | Optional |
| Process only inventory for specific SKUs | Sends inventory only for the SKUs you list. | Optional. Empty sends all |
| Force inventory resync | Sends inventory for all SKUs again. The switch turns off after the resync starts. A full resync can take a long time. | On/Off. Default: Off |
Flows
| Flow | Direction | Notes |
|---|---|---|
| Locations | LogicBroker → Pipe17 | Runs once a day. Creates a location for each LogicBroker partner that isn't in the app yet. |
| Products | LogicBroker → Pipe17 | Pulls products changed since the last pass. After the app finishes a pass, the next one starts within about a day. Products that share a parent SKU are grouped under a parent product with color and size variants. |
| Orders | LogicBroker → Pipe17 | Runs every 5 minutes and also when LogicBroker sends a new-order webhook. The app pulls orders in the statuses you select, and acknowledges orders pulled at Ready for Acknowledge. Every 4 hours, the app also checks the last 30 days for orders it missed. |
| Order cancellations | LogicBroker → Pipe17 | When LogicBroker sends a cancellation webhook, the app cancels the order. Once a day, the app also checks the last 30 days for canceled orders and cancels them in the app. |
| Fulfillments | Pipe17 → LogicBroker | Runs every 5 minutes. Creates a shipment in LogicBroker with tracking details. If the fulfillment has no ship-from address, the app uses the address of the location. The app doesn't send a shipment that already exists in LogicBroker. |
| Invoices | Pipe17 → LogicBroker | Sent after the order is fulfilled and LogicBroker has received all of its fulfillments. If the invoice fails, the app tries again on the next run. |
| Cancellations and rejected items | Pipe17 → LogicBroker | When you cancel a shipping request, or a fulfillment rejects items, the app sends an updated acknowledgement with the canceled quantities and the cancel reason. If there's no reason, the app uses "Cannot fulfill in time". |
| Rejected shipments | LogicBroker → Pipe17 | The app checks LogicBroker for shipments in Failed status and adds an exception to the matching shipping request. |
| Inventory | Pipe17 → LogicBroker | Runs every 5 minutes. Sends the available quantity for each SKU, up to 999,999. |
Troubleshooting
-
The connection fails with "Invalid partner ID"
The Partner ID isn't one of the partners available to your API key. Check the ID on the Account Information page in LogicBroker, confirm that you selected the right environment, and then update the connection settings. -
Orders don't appear in the app
By default, the app pulls only orders at Ready for Acknowledge. If your LogicBroker account acknowledges orders automatically, add the later statuses under Pull orders in these LogicBroker statuses. Also check Exclude orders created before this date and Process only specific orders. -
A shipping request has the exception "Shipment rejected by LogicBroker (Failed)"
LogicBroker rejected the shipment. Fix the shipment in LogicBroker. The app can't create the invoice until the shipment is resolved. -
An invoice wasn't sent to LogicBroker
The app sends the invoice only after the order is fulfilled and every fulfillment has reached LogicBroker. Check that Push invoices to LogicBroker is on and that no shipment for the order was rejected. -
Only some products are pulled
Your API key returns only the products available to your partner account. To pull the full catalog, enter a retailer API key in the connection settings and turn on Pull full Product Catalog (retailer & supplier) from LogicBroker.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the platform page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
We’re here to help you succeed with your operations.
Comments
0 comments