Skip to content

Omnizon Public REST API (v1.0.0)

This is the Omnizon Platform Public REST API specification. For access and API Keys please contact your Omnizon Platform representative.

Download OpenAPI description
Languages
Servers
Mock server
https://omnizon-public-api.redocly.app/_mock/openapi
U-DEV testing environment
https://{tenant}.u-dev.omnizon.network/api

Organizations

Company registration and management operations

Operations

Documents

Invoice/document processing and status management

Operations

Get latest fiscalization status for a document

Request

Returns the most recent fiscalization status for the specified document ID.

Security
PublicApiKey
Bodyapplication/jsonrequired
documentIdstringrequired

The unique identifier of the document

Example: "64a1b2c3d4e5f6789012345a"
curl -i -X POST \
  https://omnizon-public-api.redocly.app/_mock/openapi/rest/v1/documents/getLatestFiscalizationStatus \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "documentId": "64a1b2c3d4e5f6789012345a"
  }'

Responses

Latest fiscalization status retrieved successfully.

Bodyapplication/json
successfulboolean

Whether the fiscalization was successful

Example: true
errorMessagestring

Error message if fiscalization failed

Example: "Invalid tax rate"
errorCodestring

Error code if fiscalization failed

Example: "TAX_RATE_ERROR"
shouldRetryboolean

Whether the fiscalization should be retried

Example: false
timestampstring(date-time)

Timestamp when the fiscalization was attempted

Example: "2024-01-15T10:30:00Z"
fiscalizationRequestIdstring

Unique identifier for the fiscalization attempt

Example: "FISK-2024-001234"
fiscalizationResponseIdstring

JIR (Jedinstveni identifikator računa) number from FINA

Example: "12345678-1234-1234-1234-123456789012"
fiscalizationTypestring

Type of fiscalization process

Enum"FISCALIZATION""FISCALIZATION_REJECTION_REPORT""FISCALIZATION_PAYMENT_REPORT""FISCALIZATION_NOT_DELIVERED_REPORT"
Example: "FISCALIZATION"
Response
application/json
{ "successful": true, "errorMessage": "Invalid tax rate", "errorCode": "TAX_RATE_ERROR", "shouldRetry": false, "timestamp": "2024-01-15T10:30:00Z", "fiscalizationRequestId": "FISK-2024-001234", "fiscalizationResponseId": "12345678-1234-1234-1234-123456789012", "fiscalizationType": "FISCALIZATION" }

Get all reporting statuses for a document

Request

Returns all reporting statuses for the specified document ID.

Security
PublicApiKey
Bodyapplication/jsonrequired
documentIdstringrequired

The unique identifier of the document

Example: "64a1b2c3d4e5f6789012345a"
curl -i -X POST \
  https://omnizon-public-api.redocly.app/_mock/openapi/rest/v1/documents/getAllReportingStatuses \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "documentId": "64a1b2c3d4e5f6789012345a"
  }'

Responses

Reporting statuses retrieved successfully.

Bodyapplication/jsonArray [
successfulboolean

Whether the reporting was successful

Example: true
errorMessagestring

Error message if reporting failed

Example: "Invalid reporting format"
errorCodestring

Error code if reporting failed

Example: "FORMAT_ERROR"
shouldRetryboolean

Whether the reporting should be retried

Example: false
timestampstring(date-time)

Timestamp when the reporting was attempted

Example: "2024-01-15T10:30:00Z"
reportingRequestIdstring

Unique identifier for the reporting attempt

Example: "RPT-2024-001234"
reportingResponseIdstring

Reference number from the reporting system

Example: "REF-12345678-2024"
fiscalizationTypestring

Type of fiscalization process

Enum"FISCALIZATION""FISCALIZATION_REJECTION_REPORT""FISCALIZATION_PAYMENT_REPORT""FISCALIZATION_NOT_DELIVERED_REPORT"
Example: "FISCALIZATION"
]
Response
application/json
[ { "successful": true, "errorMessage": "Invalid reporting format", "errorCode": "FORMAT_ERROR", "shouldRetry": false, "timestamp": "2024-01-15T10:30:00Z", "reportingRequestId": "RPT-2024-001234", "reportingResponseId": "REF-12345678-2024", "fiscalizationType": "FISCALIZATION" } ]

Get latest reporting status for a document

Request

Returns the most recent reporting status for the specified document ID.

Security
PublicApiKey
Bodyapplication/jsonrequired
documentIdstringrequired

The unique identifier of the document

Example: "64a1b2c3d4e5f6789012345a"
curl -i -X POST \
  https://omnizon-public-api.redocly.app/_mock/openapi/rest/v1/documents/getLatestReportingStatus \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "documentId": "64a1b2c3d4e5f6789012345a"
  }'

Responses

Latest reporting status retrieved successfully.

Bodyapplication/json
successfulboolean

Whether the reporting was successful

Example: true
errorMessagestring

Error message if reporting failed

Example: "Invalid reporting format"
errorCodestring

Error code if reporting failed

Example: "FORMAT_ERROR"
shouldRetryboolean

Whether the reporting should be retried

Example: false
timestampstring(date-time)

Timestamp when the reporting was attempted

Example: "2024-01-15T10:30:00Z"
reportingRequestIdstring

Unique identifier for the reporting attempt

Example: "RPT-2024-001234"
reportingResponseIdstring

Reference number from the reporting system

Example: "REF-12345678-2024"
fiscalizationTypestring

Type of fiscalization process

Enum"FISCALIZATION""FISCALIZATION_REJECTION_REPORT""FISCALIZATION_PAYMENT_REPORT""FISCALIZATION_NOT_DELIVERED_REPORT"
Example: "FISCALIZATION"
Response
application/json
{ "successful": true, "errorMessage": "Invalid reporting format", "errorCode": "FORMAT_ERROR", "shouldRetry": false, "timestamp": "2024-01-15T10:30:00Z", "reportingRequestId": "RPT-2024-001234", "reportingResponseId": "REF-12345678-2024", "fiscalizationType": "FISCALIZATION" }

Users

User account management operations

Operations

Billing

Usage metrics and billing information

Operations

ApiKeys

API key generation and management

Operations
Schemas