Petra Industries as Source

In this guide, you'll learn how to set up Petra Industries as a source in Flxpoint — create the source, connect with your Petra Industries credentials, and configure the operations that import inventory, send dropship orders, and retrieve shipments. Petra Industries is a wholesale distributor of consumer electronics and accessories; once connected, Flxpoint keeps inventory current and automates order fulfillment and tracking.

Add Source and Establish Connection

🧭 Phase 1: Launch the Source Wizard +
Open Sources and start the Wizard
Log into your Flxpoint account, go to Sources (building icon) → + Add SourceConfigure Single Source. This opens the Source Wizard.
Step 1 — Create Source
Enter a clear name (e.g., Petra Industries). Then choose the Source Type that best fits how this Source will be used.

Choose the right Source Type

For most Petra Industries setups we recommend Vendor Warehouse. Use the other options only if they better match how you store and ship inventory.

  • Vendor Warehouse (Recommended): You send Fulfillment Requests to Petra Industries so they ship directly to your customers (dropship).
  • Internal Warehouse: You stock items and ship from your own facility.
  • External Warehouse: A 3PL or external partner ships your owned inventory.
  • Product Data Source: Content-only source to enrich product details (no fulfillment).
For Petra Industries: select Vendor Warehouse. This enables sending Fulfillment Requests to Petra Industries and using their inventory for routing.
After selecting the Source Type, click Save & Next.
Step 2 — Vendor Set-Up
Choose Yes (Recommended) to Assign VendorConfirm. Vendor reporting and the optional vendor portal will be enabled.
Step 3 — Order Fulfillment
Decide if this source is eligible to fulfill orders:
  • Yes (Recommended): You can route orders here.
  • No: Routing/Shipping steps won't apply.
Click Confirm.
Step 4 — Order Fulfillment Settings
Use Defaults or No, Customize. You'll see options for Override: Auto Processing, Commit Stock, and Allow Backorders / Cancel Unacknowledged Items. Click Save & Next.
Reminder: Complete Shipping Methods and Source Location in Phase 2 below, then proceed to Phase 3 to create your Petra Industries connection.
🚚 Phase 2: Shipping Methods & Source Location +
Goal

Finish the Source Wizard by adding at least one Shipping Method and confirming your Ship From location.

Step 1 — Shipping Methods
Add at least one shipping method (e.g., Standard Ground). Method names drive routing — the routing engine matches the shipping method on the order to the methods you configure here.
Step 2 — Source Location (Ship From)
Enter the Ship From address:
  • Address, City, State/Code, Postal Code, Country/Code
  • Optional: Contact Name, Phone, Email
This address is used for routing logic, rate shopping (if enabled), and reporting.
Finish the Wizard
Review your settings, then click Save and Complete.
🔑 Phase 3: Create Your Petra Industries Connection +
Goal

Connect Flxpoint to Petra Industries using your account credentials. One connection covers inventory, orders, and shipments — you don't need a separate connection per operation.

Step 1 — Open Get Inventory [Primary] and start
Inside your Petra Industries source, open Integrations → Get Inventory [Primary] and click Start Creating Integrations. In the connector gallery, choose Petra Industries.
Step 2 — Select or Create a Petra Industries Connection
When the Select Connection dialog opens, pick an existing Petra Industries connection or click Create New.
Step 3 — Enter Your Petra Industries Credentials
On the New Petra Industries Connection screen, enter:
  • Connection Name: A custom name for your integration.
  • Username / API Key: Your Petra Industries credentials.
  • Password: The corresponding password.
  • Optional Feed URL: If applicable for inventory updates.
The same connection is reused by all Petra Industries operations. Click Test Connection to verify, then Save Connection.
Tip: If Test Connection fails, double-check each credential for typos or trailing spaces and confirm your Petra Industries account has API access enabled.
Next Configure Product & Order Operations 🚀
Now that your Petra Industries connection is saved, go to the Operations sections of this doc to set up the integrations you need: Get Inventory for catalog & pricing, Send Fulfillment Requests for dropship orders, and Get Shipments for tracking.

Source Operations

Introduction

Petra Industries is a wholesale distributor of consumer electronics and accessories. The Get Inventory operation imports your Petra Industries catalog into Flxpoint — product titles, descriptions, categories, images, attributes, pricing, and inventory levels — and keeps quantities and cost up to date on each run.

Use Get Inventory to keep Petra Industries product data current in Flxpoint: import products and their variants, keep quantities and cost fresh, and identify items that are no longer available so they can be archived.

The sections below walk through each step of the setup and configuration process.

Note: Get Inventory imports the Petra Industries catalog. After each run, products and variants live in your Global Inventory Pool and can be mapped to downstream channels.

Each run follows this workflow:

  • 1Select Connection — Choose your Petra Industries connection.
  • 2Retrieve Catalog — Flxpoint retrieves the Petra Industries product catalog — products, variants, attributes, pricing, inventory, and images.
  • 3Map Fields — Incoming data is matched to your Mapping Template.
  • 4Save to Global Inventory Pool — The pool is updated; changes flow to channels after your next push.

Follow these steps in your Petra Industries source → Get Inventory:

Step 1: Connect an Integration

Choose Petra Industries and select your existing connection (or create one — see How to Connect → Phase 3). Click Save and Proceed.

Step 2: Configure Settings
  • Archive / Un-Archive Inventory — When enabled, items absent from the latest feed are archived (qty set to 0) and re-activated automatically if they return.

Click Save and Proceed.

Step 3: Define a Mapping Template

Choose the default Petra Industries Get Inventory template or build your own based on it. Click Save and Complete.

Step 4: Save & Schedule

Run manually first to verify the import. Then enable a schedule — a daily run is a good default for a full catalog refresh (jobs run in UTC). The status page will show Connected, Configured, and Mapped once complete.


Recommended Mapping

Starter field mapping for Petra Industries Get Inventory. Adjust per your template if needed.

Flxpoint Field Petra Industries Source Field Purpose Status
SKU (T) Inventory: SKU Variant identifier Required
Parent SKU (T) Inventory: Product Line Links variants to a parent product Optional
Title (T) Inventory: Product Name Display title Required
Description (T) Inventory: Description Product description Optional
Cost (N) Inventory: Dealer Price Dealer cost (USD) Required
MSRP (N) Inventory: MSRP Manufacturer suggested retail price Optional
MAP (N) Inventory: MAP Minimum advertised price Optional
Quantity (N) Inventory: Quantity On-hand quantity Required
UPC (T) Inventory: UPC Barcode Optional
Image (T) Inventory: Image Product image URL Optional
Mapping Options
  • Match It — Directly map a source field to a Flxpoint field.
  • Set It — Set a fixed/static value for a field.
  • Transform It (Mapping Set) — Apply a transformation or mapping set to the value.
  • Smart Rules — Use conditional logic to determine the mapped value.
  • Skip It (Don't Map) — Ignore the field entirely.
Summary: Map SKU, Title, Cost, and Quantity (the required fields) plus any attributes you need for downstream channels. Verify your Petra Industries connection passes Test Connection before running.

Quick Checks
  • Petra Industries connection is selected and passes Test Connection.
  • Mapping template is selected and saved.
  • Run once manually first, then enable a daily schedule once verified.
Troubleshooting
  • Catalog not importing: Open the Petra Industries connection and click Test Connection. If it fails, re-enter your credentials and retry.
  • Items missing from the import: Confirm your Petra Industries account is approved to access those products and that they are present in the feed your account receives.
  • Quantities look stale: Confirm the job ran successfully on its schedule and that the run did not error before completing.
Operation Details
Feature Availability What to Expect
Pricing Supported Cost, MSRP, and MAP where provided by Petra Industries.
Quantity Supported On-hand quantity refreshed on each run.
Images Supported Linked to the product.
Archive / Un-Archive Supported Items absent from a run are archived; re-activated when they return.
Tip: Run Get Inventory on a daily schedule to keep your Petra Industries catalog, quantities, and pricing current in Flxpoint.
Introduction

The Send Fulfillment Requests operation submits dropship orders to Petra Industries. When an order routes to your Petra Industries source, Flxpoint creates the order with Petra Industries through the configured connection, passing the customer's shipping address and the ordered line items.

The sections below walk through each step of the setup and configuration process.

Note: Send Fulfillment Requests creates the dropship order with Petra Industries. The order's PO reference is your Flxpoint Fulfillment Request Number.

The setup is completed in a few steps.

Step 1: Connect Petra Industries

Choose Petra Industries and select your existing connection. Click Test Connection, then Save and Proceed.

Step 2: Configure Settings

Set any order-level options your workflow requires (for example, a review hold). Click Save and Proceed.

Step 3: Define a Mapping Template

Choose the default Petra Industries Send Fulfillment Requests template or build your own. Click Save and Complete.

Step 4: Save & Schedule

Test with a single order first to verify Ship To mapping and connectivity, then enable automation across your routing group.


Recommended Mapping

Map your Flxpoint Fulfillment Request fields to the Petra Industries order so dropship orders submit cleanly.

Flxpoint Field Petra Industries Order Field Status
FR Number (T) PO / Reference Number Required
Ship To Name (T) Ship To Name Required
Address Line 1 (T) Ship To Address Line 1 Required
City / State / ZIP (T) Ship To City / State / Postal Code Required
SKU (T) Item: SKU Required
Quantity (N) Item: Quantity Required
Required fields: Confirm Ship To Name, Address, City, State, ZIP, SKU, and Quantity are mapped and supply non-empty values for every order. Orders missing required fields may be rejected.
Summary: Map the shipping address, SKU, and quantity as required fields. The PO reference is your Fulfillment Request Number.

Quick Checks
  • Connection shows Connected and passes Test Connection.
  • Mapping template is selected and saved.
  • Required fields (Name, Address, City, State, ZIP, SKU, Quantity) are mapped and supply non-empty values.
  • FR/PO reference is unique to avoid duplicate-order rejections.
Troubleshooting
  • Order rejected for missing fields: Audit your mapping template to ensure every required field is mapped and supplies a non-empty value for the order.
  • Duplicate PO error: If you need to retry an order, change the FR/PO reference and resend.
  • Order failed with a connection error: Click Test Connection on the Petra Industries connection. If it fails, re-enter your credentials and retry.
Operation Details
Feature Availability What to Expect
FR Number Supported Sent as the Petra Industries PO/Reference.
Ship To Address Supported Full address including Name, Address, City, State, ZIP.
FR Item Association Supported Line items include SKU and Quantity.
Tip: Always test with a single order first to verify Ship To mapping and connectivity before enabling automation across your routing group.
Introduction

The Get Shipments operation retrieves shipment confirmations for your Petra Industries orders — including the tracking number, shipped date, shipping method, and item-level shipped quantities — and posts them back to the matching order in Flxpoint. It uses your Petra Industries connection.

The sections below walk through each step of the setup and configuration process.

Note: This operation retrieves shipment confirmations from Petra Industries and updates your orders with tracking and item-level shipped quantities.

Each run follows this workflow:

  • 1Connect — Uses your Petra Industries connection to identify recently shipped orders.
  • 2Pull Detail — For each shipped order, Flxpoint retrieves the tracking number, shipping method, shipped date, and per-line-item shipped quantities.
  • 3Save — Shipment data posts back to the corresponding order; partial shipments attach with their own items and quantities.
Step 1: Connect Petra Industries

Choose Petra Industries and select your existing connection. Click Save and Proceed.

Step 2: Configure Settings
  • Fetch Shipments for Days — how many days back to look for shipments. Most teams use a 10- or 15-day window.

Click Save and Proceed.

Step 3: Define a Mapping Template

Choose the default Petra Industries Get Shipments template. Click Save and Complete.

Step 4: Save & Schedule

Run on demand or schedule periodic runs (UTC) — for example, every 2 hours — to keep tracking current.


Recommended Mapping

Map these Petra Industries shipment fields to your Flxpoint shipment object. Fields are split between header level (one per shipment) and item level (one per shipped line).

Flxpoint Field Petra Industries Field Level Status
Tracking Number (T) Shipment: Tracking Number Header Required
Shipped At (D) Shipment: Shipped At Header Optional
Method (T) Shipment: Shipping Method Header Optional
Order / PO Reference (T) Shipment: PO Number Header Optional
Shipment Item: SKU (T) Shipment Item: SKU Item Required
Shipment Item: Quantity (N) Shipment Item: Quantity Shipped Item Required
About item-level quantities: The Quantity Shipped is the actual count shipped on each line — not copied from the original PO. Partial shipments report exactly what was sent, and follow-up shipments complete the order with their own item rows.
Operation Workflow
  • On each scheduled run, Flxpoint identifies Petra Industries orders shipped within the configured window.
  • For each shipped order, Flxpoint retrieves shipment headers and per-item shipped quantities.
  • Partial shipments are supported — multiple shipments can attach to one order, each with their own items.
Summary: Map Tracking Number (header) and SKU / Quantity Shipped (item level). Add Method and Shipped At for richer reporting.

FAQs
  • How far back should I fetch? Most teams use a 10- or 15-day window. Increase it if you expect late confirmations.
  • Does the PO number have to match the case exactly? No. Shipment lookup by PO number is now case-insensitive, so a shipment is found regardless of whether the PO is entered in uppercase, lowercase, or mixed case.
  • Can partial shipments import? Yes. Each Petra Industries shipment attaches to the original order with its own items and quantities.
Troubleshooting
  • "No data" responses: The order may not have shipped yet. Confirm shipment status with Petra Industries and re-run after the shipment is dispatched.
  • Shipment not found for a PO number: Previously, fetching shipment data could fail if the PO number's letter case didn't match what Petra Industries stored (for example, a lowercase PO searched against an uppercase value such as ebyus05-14589-57987 vs. EBYUS05-14589-57987). This is now resolved — shipment lookup by PO number is case-insensitive, so the shipment is found regardless of how the PO is typed. No additional action is required to benefit from this fix.
  • Tracking not linking to the order: Confirm the shipment's PO/Reference matches your original Fulfillment Request Number. With the case-insensitive lookup above, differences in letter case no longer prevent a match.
  • Authentication errors: If the run fails with an auth error, click Test Connection on the Petra Industries connection and re-enter your credentials if needed.
Operation Details
Capability Status Notes
Tracking Number Supported Primary identifier returned for each shipment.
Shipped At Supported Use a fallback rule if omitted on a particular shipment.
Item-Level Quantity Supported Actual quantity shipped per line, not copied from the PO.
Partial Shipments Supported Each shipment attaches to the order with its own items.
Case-Insensitive PO Lookup Supported Shipments are matched regardless of PO letter case.
Tip: Schedule this job to run frequently (e.g., every 2 hours) so tracking lands in Flxpoint promptly.

Troubleshooting

Common issues and solutions for the Petra Industries integration. Expand each item to learn more.

Still need help? If you're experiencing issues not covered here, contact Petra Industries or your Flxpoint account manager.

Contact Support