> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shippo on Vortex IQ

> Monitor Shippo delivery performance, SLA risk and cost per order, and catch carrier problems before customers feel them.

Monitor Shippo delivery performance, SLA risk and cost per order, and catch carrier problems before customers feel them.

[Connect or manage this source](https://app.vortexiq.ai/workbench/settings/sources) · [How connecting works](/integrations/connector-catalogue) · [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=shippo)

<CardGroup cols={5}>
  <Card title="36">
    performance signals
  </Card>

  <Card title="6">
    automated checks
  </Card>

  <Card title="Build your own">
    automated fixes
  </Card>

  <Card title="Ready to build yours">
    workflows
  </Card>

  <Card title="5">
    API operations
  </Card>
</CardGroup>

<Tabs>
  <Tab title="Overview">
    ### What you can achieve

    Capabilities are grouped around merchant outcomes, not API terminology.

    <CardGroup cols={2}>
      <Card title="Protect revenue">
        Find failures, leaks and risks before they cost sales.
      </Card>

      <Card title="Run operations">
        Monitor orders, fulfilment, delivery and settlement.
      </Card>

      <Card title="Customer experience">
        Find storefront, speed, accessibility and journey problems.
      </Card>

      <Card title="Control risk and change">
        Keep tracking, access and change under governed control.
      </Card>
    </CardGroup>

    ### From connection to verified outcome

    The controlled sequence every capability follows. Nothing changes a connected system without the approval step.

    <Steps>
      <Step title="Connect">
        Authorise the source. Scopes are shown before access is granted.
      </Step>

      <Step title="Monitor">
        Watch the signals against your own baselines, not universal defaults.
      </Step>

      <Step title="Detect">
        Run checks and gather evidence specific to your store.
      </Step>

      <Step title="Recommend">
        Explain what happened, why it matters and the proposed action.
      </Step>

      <Step title="Approve">
        You review scope, risk and reversibility before anything changes.
      </Step>

      <Step title="Execute">
        Apply through governed connector operations.
      </Step>

      <Step title="Verify">
        Confirm the intended result and keep the receipt.
      </Step>
    </Steps>

    No changes are made without the configured approval policy. Read-only operations do not modify the connected system; schedules, access scopes, API usage and data handling remain governed by Vortex IQ controls.
  </Tab>

  <Tab title="Monitor (36)">
    ### Monitor performance

    36 performance signals. Open an outcome to see its signals and how each one alerts. Read-only operations do not modify the connected system.

    <AccordionGroup>
      <Accordion title="Run operations (23 signals)">
        | Signal                                      | Alert behaviour    | What it tracks                                                                                                                       |
        | ------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
        | **API Error Rate**                          | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Avg Shipping Cost**                       | Merchant rule      | Description pending editorial review; the signal is live.                                                                            |
        | **Claim Value (open)**                      | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Cost Per Shipment Trend**                 | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Cost by Zone**                            | Watch only         | Cost by Zone.                                                                                                                        |
        | **Days to Token Expiry**                    | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Dispatch SLA Breached on N Orders Today** | Merchant rule      | Alerts for Dispatch SLA Breached on N Orders Today.                                                                                  |
        | **Exception Rate**                          | Alert band 2 / 5   | Description pending editorial review; the signal is live.                                                                            |
        | **High-Cost Shipment Outliers**             | Watch only         | High-Cost Shipment Outliers, broken down by row.                                                                                     |
        | **Inactive Carrier Accounts**               | Merchant rule      | Description pending editorial review; the signal is live.                                                                            |
        | **Label Failure Rate by Carrier**           | Alert band 1 / 2   | Per-underlying-carrier label-creation failure rate via Shippo. Surface which credential needs refresh.                               |
        | **Label Generation Success**                | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Label Print Failures Spike**              | Alert band 99 / 95 | Alerts for Label Print Failures Spike.                                                                                               |
        | **OTD by Route**                            | Watch only         | OTD by Route.                                                                                                                        |
        | **Open Claims**                             | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Returned to Sender**                      | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Returns Label Generation Failure Rate**   | Alert band 1 / 2   | % of /shipments/?metadata=return requests failing. Spike = carrier API down OR returns rate-shopping logic broken , RMA flow stalls. |
        | **Route Volume Concentration**              | Watch only         | Route Volume Concentration, compared across items.                                                                                   |
        | **Shipments**                               | Merchant rule      | Description pending editorial review; the signal is live.                                                                            |
        | **Shipments Over Time**                     | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Shipments by Destination**                | Watch only         | Description pending editorial review; the signal is live.                                                                            |
        | **Shipments by Service**                    | Watch only         | Shipments by Service.                                                                                                                |
        | **Shipments by Underlying Carrier**         | Watch only         | Shipments by Underlying Carrier.                                                                                                     |
      </Accordion>

      <Accordion title="Customer experience (6 signals)">
        | Signal                          | Alert behaviour    | What it tracks                                                                                                                                        |
        | ------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
        | **Avg Transit (days)**          | Watch only         | Description pending editorial review; the signal is live.                                                                                             |
        | **First-Attempt Delivery Rate** | Watch only         | Description pending editorial review; the signal is live.                                                                                             |
        | **Late Shipments**              | Watch only         | Description pending editorial review; the signal is live.                                                                                             |
        | **On-Time Delivery Rate**       | Alert band 95 / 90 | Description pending editorial review; the signal is live.                                                                                             |
        | **Orca Predicted-ETA Accuracy** | Merchant rule      | % of shipments where actual delivery matched Orca's checkout-promised ETA within +/- 1 day. Below 85% = systematic over-promising at checkout, drives |
        | **Rates Cache Staleness**       | Merchant rule      | Shippo caches rates per-route for performance. Stale cache = wrong shipping cost shown at checkout. Bust threshold.                                   |
      </Accordion>

      <Accordion title="Protect revenue (5 signals)">
        | Signal                                        | Alert behaviour   | What it tracks                                              |
        | --------------------------------------------- | ----------------- | ----------------------------------------------------------- |
        | **Cost per Parcel by Zone vs Direct-Carrier** | Merchant rule     | Cost per Parcel by Zone vs Direct-Carrier.                  |
        | **Failed Deliveries**                         | Merchant rule     | Description pending editorial review; the signal is live.   |
        | **Orders with Carrier Dispatch SLA Missed**   | Merchant rule     | Description pending editorial review; the signal is live.   |
        | **Return Rate by Underlying Carrier**         | Merchant rule     | Description pending editorial review; the signal is live.   |
        | **Shipments with Tracking-Event Gap >24h**    | Alert band 0 / 10 | Shipments with Tracking-Event Gap >24h, broken down by row. |
      </Accordion>

      <Accordion title="Control risk and change (2 signals)">
        | Signal                             | Alert behaviour | What it tracks                                                                                          |
        | ---------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------- |
        | **Returns Label Volume**           | Watch only      | Daily returns labels generated via Shippo Returns API. Trend shapes reverse-logistics cost forecasting. |
        | **Tracking API Unavailable / 5xx** | Merchant rule   | Alerts for Tracking API Unavailable / 5xx.                                                              |
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Audit (6)">
    ### Audit risks and opportunities

    A fix status appears only where the action, inputs, approval, verification and recovery controls are mapped. Candidate remediations are never executable. Open a check for the detail.

    <AccordionGroup>
      <Accordion title="API token expired or about to expire (<14 days)">
        **Severity** critical · **Outcome** Run operations · **Fix status** Report only

        Once this token expires, VortexIQ stops receiving tracking and delivery data from this carrier entirely, and every finding in this report that depends on courier data goes stale from that moment, silently, until someone notices shipments look wrong.

        Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps.

        Reference: `COURIER-AUTH-001`
      </Accordion>

      <Accordion title="Exception rate above 3%">
        **Severity** high · **Outcome** Protect revenue · **Fix status** Report only

        More than 3% of shipments with this carrier are hitting an exception, a failed delivery attempt, damage, an address problem, a lost parcel, each of which usually turns into a support ticket and, often, a refund or reshipment cost the store absorbs.

        Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps.

        Reference: `COURIER-EXCEPTION-001`
      </Accordion>

      <Accordion title="On-time delivery rate below 90%">
        **Severity** high · **Outcome** Protect revenue · **Fix status** Report only

        More than 1 in 10 shipments with this carrier is arriving late. Late delivery is one of the most common drivers of customer support contacts, refund requests and negative reviews, and it lands on the store's reputation even though the carrier caused it.

        Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps.

        Reference: `COURIER-OTD-001`
      </Accordion>

      <Accordion title="Avg cost per shipment up > 10% vs prior period">
        **Severity** medium · **Outcome** Run operations · **Fix status** Candidate remediation

        Average cost per shipment with this carrier rose more than 10% compared to the prior period. Shipping is rarely re-priced into the product on the same timeline it changes, so a jump this size quietly erodes margin on every order this carrier touches until pricing or carrier choice is revisited.

        A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided.

        Reference: `COURIER-COST-001`
      </Accordion>

      <Accordion title="Failed-delivery rate above 2%">
        **Severity** medium · **Outcome** Protect revenue · **Fix status** Candidate remediation

        Failed deliveries above 2 percent create support contacts, redelivery costs and refunds; address validation and carrier choice are the usual levers.

        A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided.

        Reference: `COURIER-FAIL-001`
      </Accordion>

      <Accordion title="OTD trending down >5pp WoW">
        **Severity** medium · **Outcome** Run operations · **Fix status** Report only

        On-time delivery dropped more than 5 percentage points in a single week. A move this fast usually has a specific, recent cause (a service disruption, a capacity issue at the carrier, a seasonal volume spike), which is worth catching now, before it settles into a new, worse normal that customers star

        Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps.

        Reference: `COURIER-OTD-002`
      </Accordion>
    </AccordionGroup>

    #### Build your own automated fixes

    Turn any finding into an automated fix with a Vortex IQ workflow: **over 13,000 read and write operations across more than 200 connectors** are available as building blocks, with approval, verification and rollback on every change.
  </Tab>

  <Tab title="Automate">
    ### Automate approved work

    Vortex IQ is integrated with **4 read** and **1 write** operations across shipments, accounts, carrieraccounts, tracks on Shippo. Combine them with anything from the **over 13,000 operations across more than 200 connectors** to automate the work in your own words.

    Changes follow your configured approval policy: the target, proposed change, affected records, risk, reversibility and verification plan are shown before execution.

    [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=shippo)

    #### Ready to build your first Shippo workflow

    Pick a trigger, add the operations above as steps, and every step that changes data pauses for your approval. Monitoring and audits are live now and can start any workflow you build.

    <Accordion title="Browse the operations you can build with">
      | Resource        | Read operations | Write operations |
      | --------------- | --------------- | ---------------- |
      | shipments       | 1               | 1                |
      | accounts        | 1               | 0                |
      | carrieraccounts | 1               | 0                |
      | tracks          | 1               | 0                |

      Signed-in users see the full catalogue in the workflow builder, filtered to the sources they have connected.
    </Accordion>
  </Tab>
</Tabs>
