Event destinations now support file processing events

You can now subscribe to file processing events using event destinations:

• file.processed – Stedi generates this event when it successfully processes a file, such as a 277CA claim acknowledgment from a payer.

• file.failed – Stedi generates this event when it fails to process a file, such as an SFTP claim submission it can't parse.

• transaction.processed – Stedi generates this event when it translates a transaction, such as a payer's Electronic Remittance Advice (ERA) into JSON.

You can subscribe on the Stedi portal's Event Destinations page, with the Event Destination APIs, or with the Stedi SDKs.

An installed OAuth app can also subscribe to these events in its provider's account.

Event payloads

Stedi events use a thin event schema. A thin event notifies you that a resource changed, but it doesn't include the resource's data.

A single file with multiple transactions produces one file.processed event and one transaction.processed event per transaction. The relatedResources array identifies the transaction type.

{
  ...
  "resource": {
    "id": "019bb508-dc63-73a1-8ddc-9d4720299072",
    "type": "transaction"
  },
  "relatedResources": [
    {
      "id": "019bb508-dc63-73a1-8ddc-9d4720299072",
      "type": "transaction.x12.835" // ERA
    }
  ],
  "type": "transaction.processed"
}

Once you receive an event, retrieve the details using Stedi's APIs or the Stedi portal:

• transaction.processed – Pass the transaction ID in relatedResources to the Get 835 ERA Report or Get 277CA Report endpoint.

• file.processed and file.failed – Pass the execution ID in resource.id to the Retrieve File Execution Input endpoint.

For event schemas, see our event types reference.