v1.036

The returns list can now be filtered by when a return was received.
Polling the returns list by updated_at returns the same return several times during its lifecycle, because every status change bumps updated_at. The new received_at filter matches each return once receiving at the warehouse is completed, so integrations can import completed returns without duplicates.

🚀 New Endpoints

None

🛠 Schema & Property Updates

Received At Filter on the Returns List

• Retrieve Returns (GET /v1/integrations/returns-list):
  • received_at (string, date-time, optional) - Returns only returns received at the warehouse at or after this timestamp, the same value the response exposes as received_at. Combined with the other filters by AND.
    • Works the same way as updated_at: the bound is inclusive, and a value without a time zone (or a date only) is interpreted in New York time. An invalid value returns 400.
    • Returns not received yet (received_at is null) are never returned.
    • A return that is reopened is excluded until it is received again, then it matches with the new received_at.
    • To poll for newly received returns, pass the last received_at you processed and skip returns whose ID you already have.

📦 New Support Schemas

None

📖 Documentation & Constraints Changes

None

No endpoints, fields or enum values were removed. received_at is an optional query parameter, so this version is backward-compatible.