Skip to content
FiskHub

device_inactive

HTTP 400   type: validation_error   param: device_id
{
  "error": {
    "type": "validation_error",
    "code": "device_inactive",
    "message": "Device VM-0044 is archived and cannot fiscalize. Reactivate it first.",
    "param": "device_id",
    "upstream": null,
    "doc_url": "https://docs.fiskhub.com/errors/device_inactive"
  }
}

What happened

The device exists but its status is suspended or archived, not active. Only active devices may fiscalize.

Nothing was fiscalized and no receipt number was allocated.

Usual causes: a machine retired and later brought back into service, a device suspended during an investigation, or a device that was archived while a stale configuration on the machine still points at its id.

Should you retry?

No. The status will not change on its own.

The fix

  1. Check the device:

    Terminal window
    curl -sS "https://api.fiskhub.com/v1/devices?company_id=3a5f2b18-7c4d-4e91-9a2b-6d8e0f1c3a57" \
      -H "Authorization: Bearer $FISKHUB_API_KEY"

  2. If it should be selling, reactivate it:

    Terminal window
    curl -sS -X PATCH \
      "https://api.fiskhub.com/v1/devices/d0e5b921-6a47-4c38-b1f9-8e2d3a70c645" \
      -H "Authorization: Bearer $FISKHUB_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "status": "active" }'

    Check its isu_status at the same time. A device that was archived before ever receiving an ISU number will move straight from this error to hr.device_missing_isu.

  3. If it should not be selling, the machine is misconfigured — it is pointing at a device record that was deliberately retired. Correct the device_id on the machine rather than reactivating the record.

Suspended versus archived

StatusMeaning
activeNormal. Can fiscalize.
suspendedTemporarily stopped — maintenance, an investigation, a site closed for the season. Expected to return.
archivedRetired. Not expected to return.

Both block fiscalization identically. The distinction is for whoever is reading the fleet later.

Archiving a device does not touch its invoices: past sales keep their records, their JIRs and their history.

Sales made while it was inactive

They were never fiscalized. If the machine stored them locally, submit them once the device is active again, with their original occurred_at — FiskHub marks them as late delivery automatically.