Skip to content

Fiscal Transactions

The FiscalTransactions entity represents the technical fiscal data associated with a receipt or document, typically used for legal reporting and fiscal memory.

Fields

FieldTypeDescription
idIntegerUnique identifier (Primary Key).
dateDateTimeDate and time of the fiscal transaction.
amountFloatTotal amount reported to the fiscal service.
typeEnumType of fiscal operation (e.g., receipt, refund, zReport).
receiptRelationLink to the associated Receipt.
conveniqRelationLink to the Conveniqs device.
transactionDataJSONDetailed response data from the fiscal service provider.
createdAtDateTimeMetadata: Creation timestamp.
updatedAtDateTimeMetadata: Last update timestamp.

Get List of Fiscal Transactions

Fetch a list of fiscal transactions.

Endpoint: POST /core/data/FiscalTransactions/select

Example Request:

json
{
  "fields": {
    "id": true,
    "date": true,
    "amount": true,
    "type": { "id": true, "value": true },
    "receipt": { "id": true, "number": true }
  },
  "conditions": {
    "operator": "and",
    "filters": [
      {
        "field": "date",
        "comparator": ">",
        "value": "2025-01-01T00:00:00Z"
      }
    ]
  },
  "orderBy": [
    {
      "field": "date",
      "order": "desc"
    }
  ],
  "limit": 50,
  "offset": 0
}

Get Single Fiscal Transaction

Retrieve details for a specific fiscal transaction by ID.

Endpoint: POST /core/data/FiscalTransactions/select

Example Request:

json
{
  "fields": {
    "id": true,
    "amount": true,
    "transactionData": true,
    "receipt": { "id": true }
  },
  "conditions": {
    "filters": [
      {
        "field": "id",
        "comparator": "=",
        "value": 6001
      }
    ]
  },
  "limit": 1
}