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

# v2.0.2 - HOS Ruleset Expansion

> Added 42 new HOS ruleset codes for enhanced compliance coverage

**Released 15th December 2025**

This patch release expands Hours of Service (HOS) compliance coverage by adding 42 new ruleset codes for oil transport, oil well operations, and property carrier variations. No functional API behavior has changed.

<Check>
  **Documentation Update:** This is a non-breaking release that adds new enum values to the `HosRulesetCodeEnum` schema, expanding compliance options for specialized operations.
</Check>

## New HOS Ruleset Codes

<AccordionGroup>
  <Accordion title="Oil Transport Rulesets (20 codes)" icon="droplet">
    Added comprehensive ruleset codes for oil transport operations under 60-hour/7-day and 70-hour/8-day rules:

    **Standard Oil Transport:**

    * `US_INT_OILTR_60_7_BIG` - Interstate oil transport, 60/7, big rig
    * `US_INT_OILTR_60_7_BIG_SLP` - Interstate oil transport, 60/7, big rig with sleeper berth
    * `US_INT_OILTR_60_7_SLP` - Interstate oil transport, 60/7, sleeper berth
    * `US_INT_OILTR_70_8_BIG` - Interstate oil transport, 70/8, big rig
    * `US_INT_OILTR_70_8_BIG_SLP` - Interstate oil transport, 70/8, big rig with sleeper berth
    * `US_INT_OILTR_70_8_SLP` - Interstate oil transport, 70/8, sleeper berth

    **No-Break Oil Transport:**

    * `US_INT_OILTR_60_7_NOBRK` - Interstate oil transport, 60/7, no break
    * `US_INT_OILTR_60_7_NOBRK_BIG` - Interstate oil transport, 60/7, no break, big rig
    * `US_INT_OILTR_60_7_NOBRK_BIG_SLP` - Interstate oil transport, 60/7, no break, big rig with sleeper
    * `US_INT_OILTR_60_7_NOBRK_SLP` - Interstate oil transport, 60/7, no break, sleeper berth
    * `US_INT_OILTR_70_8_NOBRK` - Interstate oil transport, 70/8, no break
    * `US_INT_OILTR_70_8_NOBRK_BIG` - Interstate oil transport, 70/8, no break, big rig
    * `US_INT_OILTR_70_8_NOBRK_BIG_SLP` - Interstate oil transport, 70/8, no break, big rig with sleeper
    * `US_INT_OILTR_70_8_NOBRK_SLP` - Interstate oil transport, 70/8, no break, sleeper berth

    **Short Haul Oil Transport:**

    * `US_INT_OILTR_SH_12H` - Interstate oil transport, short haul, 12-hour
    * `US_INT_OILTR_SH_14H` - Interstate oil transport, short haul, 14-hour
    * `US_INT_OILTR_70_8_SH_12H` - Interstate oil transport, 70/8, short haul, 12-hour
    * `US_INT_OILTR_70_8_SH_14H` - Interstate oil transport, 70/8, short haul, 14-hour

    **Regional Oil Transport:**

    * `US_CA_INTRA_OILTR_80_8` - US/Canada intrastate oil transport, 80/8
    * `US_CA_INTRA_OILTR_PROP` - US/Canada intrastate oil transport, property
    * `US_TX_INTRA_OILTR_70_7` - Texas intrastate oil transport, 70/7
  </Accordion>

  <Accordion title="Oil Well Operations Rulesets (18 codes)" icon="oil-well">
    Added comprehensive ruleset codes for oil well operations under 60-hour/7-day and 70-hour/8-day rules:

    **Standard Oil Well:**

    * `US_INT_OILWL_60_7_BIG` - Interstate oil well, 60/7, big rig
    * `US_INT_OILWL_60_7_BIG_SLP` - Interstate oil well, 60/7, big rig with sleeper berth
    * `US_INT_OILWL_60_7_SLP` - Interstate oil well, 60/7, sleeper berth
    * `US_INT_OILWL_70_8_BIG` - Interstate oil well, 70/8, big rig
    * `US_INT_OILWL_70_8_BIG_SLP` - Interstate oil well, 70/8, big rig with sleeper berth
    * `US_INT_OILWL_70_8_SLP` - Interstate oil well, 70/8, sleeper berth

    **No-Break Oil Well:**

    * `US_INT_OILWL_60_7_NOBRK` - Interstate oil well, 60/7, no break
    * `US_INT_OILWL_60_7_NOBRK_BIG` - Interstate oil well, 60/7, no break, big rig
    * `US_INT_OILWL_60_7_NOBRK_BIG_SLP` - Interstate oil well, 60/7, no break, big rig with sleeper
    * `US_INT_OILWL_60_7_NOBRK_SLP` - Interstate oil well, 60/7, no break, sleeper berth
    * `US_INT_OILWL_70_8_NOBRK` - Interstate oil well, 70/8, no break
    * `US_INT_OILWL_70_8_NOBRK_BIG` - Interstate oil well, 70/8, no break, big rig
    * `US_INT_OILWL_70_8_NOBRK_BIG_SLP` - Interstate oil well, 70/8, no break, big rig with sleeper
    * `US_INT_OILWL_70_8_NOBRK_SLP` - Interstate oil well, 70/8, no break, sleeper berth

    **Regional Oil Well:**

    * `US_CA_INTRA_OILWL_80_8` - US/Canada intrastate oil well, 80/8
    * `US_CA_INTRA_OILWL_PROP` - US/Canada intrastate oil well, property
    * `US_TX_INTRA_OILWL_70_7` - Texas intrastate oil well, 70/7
  </Accordion>

  <Accordion title="Property Carrier Variations (2 codes)" icon="truck">
    Added sleeper berth variations for property carrier rulesets:

    * `US_INT_PROP_60_7_SLPVAR` - Interstate property, 60/7, sleeper berth variation
    * `US_INT_PROP_70_8_SLPVAR` - Interstate property, 70/8, sleeper berth variation

    <Tip>
      These variations complement the existing `US_INT_PROP_SLPVAR` ruleset by providing specific 60/7 and 70/8 options.
    </Tip>
  </Accordion>
</AccordionGroup>

## Schema Changes

<AccordionGroup>
  <Accordion title="HosRulesetCodeEnum Expansion" icon="list">
    **Schema:** `HosRulesetCodeEnum`

    **Change:** Added 42 new enum values to support specialized oil and gas operations

    **Impact:** Existing integrations are unaffected. New ruleset codes are now available for:

    * Oil transport operations (interstate, intrastate, short haul)
    * Oil well operations (interstate, intrastate)
    * Property carrier sleeper berth variations

    **Example Usage:**

    ```json theme={null}
    {
      "hos_ruleset_code": "US_INT_OILTR_70_8_BIG_SLP",
      "description": "Interstate oil transport with 70-hour/8-day rule, big rig with sleeper berth"
    }
    ```

    <Check>
      All new ruleset codes follow the existing naming convention: `{JURISDICTION}_{SCOPE}_{OPERATION}_{HOURS}_{DAYS}_{VARIANT}`
    </Check>
  </Accordion>
</AccordionGroup>

## Summary

This release enhances HOS compliance coverage by:

* Adding 20 oil transport ruleset codes
* Adding 18 oil well operation ruleset codes
* Adding 2 property carrier sleeper berth variations
* Maintaining backward compatibility with all existing rulesets

**No code changes required** - all updates are additive enum expansions that don't affect existing functionality.

***

## Need Help?

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/api-reference/telematics-api">
    View complete endpoint documentation with current API structure
  </Card>

  <Card title="Contact Support" icon="life-ring" href="mailto:support@catenaclearing.io">
    Questions about migrating your integration? Our team is here to help
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.