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

# 3PL / fulfillment scorecard: fill rate, perfect-order rate, and at-risk

> orders (chargeback exposure) aggregated across all reconciled orders.

orders (chargeback exposure) aggregated across all reconciled orders.

### Response

`FulfillmentScorecard`

<ResponseField name="at_risk" type="AtRiskOrder[]" required>
  Orders carrying chargeback risk, worst first.

  <Expandable title="AtRiskOrder">
    <ResponseField name="reference" type="string" required />

    <ResponseField name="severity" type="string" required />

    <ResponseField name="top_issue" type="string" required>
      The most severe variance kind on the order.
    </ResponseField>

    <ResponseField name="variance_count" type="integer" required />
  </Expandable>
</ResponseField>

<ResponseField name="fill_rate" type="integer (int32)">
  `min(shipped, ordered) / ordered` as a percent 0–100 — the true fill rate (over-shipping doesn't inflate it; it shows up as a variance).
</ResponseField>

<ResponseField name="orders" type="integer" required>
  Orders with a purchase order.
</ResponseField>

<ResponseField name="orders_with_shipment" type="integer" required>
  Orders that also have a shipment notice or warehouse advice.
</ResponseField>

<ResponseField name="perfect_order_rate" type="integer (int32)">
  `perfect_orders / orders` percent.
</ResponseField>

<ResponseField name="perfect_orders" type="integer" required>
  Orders with zero variances.
</ResponseField>

<ResponseField name="total_ordered" type="string" required />

<ResponseField name="total_shipped" type="string" required />

<ResponseField name="total_warehouse_shipped" type="string" required />

<ResponseField name="variance_counts" type="object" required>
  Variance count by kind (`short_shipped`, `over_shipped`, …).
</ResponseField>

<ResponseField name="warehouse_fill_rate" type="integer (int32)">
  `min(warehouse_shipped, ordered) / ordered` percent — 3PL execution.
</ResponseField>

### Status codes

| Code  | Meaning                   |
| ----- | ------------------------- |
| `200` | Fulfillment scorecard     |
| `403` | Admin credential required |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://edi.stateset.com/v1/fulfillment' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "at_risk": [
      {
        "reference": "ORD-10042",
        "severity": "string",
        "top_issue": "string",
        "variance_count": 1
      }
    ],
    "fill_rate": 8,
    "orders": 1,
    "orders_with_shipment": 1,
    "perfect_order_rate": 8,
    "perfect_orders": 1,
    "total_ordered": "string",
    "total_shipped": "string",
    "total_warehouse_shipped": "string",
    "variance_counts": {},
    "warehouse_fill_rate": 8
  }
  ```
</ResponseExample>