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
openapi.json
openapi.yaml
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

Send UBL 2.1 invoice

Request

Accepts a UBL 2.1 XML document as raw binary stream and processes it.

Security
PublicApiKey
Headers
companyVatNumberstringrequired

VAT number of the company.

Example: HR12345678910
fiscalizationboolean

Fiscalization flag.

x-fileNamestring

Optional file name override for uploaded XML document.

x-software-idstring

External software identifier to track the originating system.

Bodyapplication/octet-streamrequired
string(binary)
curl -i -X POST \
  https://omnizon-public-api.redocly.app/_mock/openapi/rest/v1/documents/send \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/octet-stream' \
  -H 'companyVatNumber: HR12345678910' \
  -H 'fiscalization: true' \
  -H 'x-fileName: string' \
  -H 'x-software-id: string' \
  -d '<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">...</Invoice>'

Responses

Document processed successfully.

Bodyapplication/json
documentIdstringrequired
Response
application/json
{
  "documentId": "string"
}

Get Invoice Internal Status

Request

Get Invoice Internal Status.

Security
PublicApiKey
Bodyapplication/jsonrequired
documentIdstringrequired

The unique identifier of the invoice document.

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

Responses

Invoice Internal Status Returned Successfully.

Bodyapplication/json
documentIdstringrequired

The unique identifier of the invoice document.

Example: "6787a98e15306d37eed688a8"
statusstringrequired

Status of document.

Example: "acknowledged"
internalStatusDetailsArray of objects(InternalStatusDetail)

Lista grešaka iz logRecords gdje je eventKey='generic' i eventData počinje s 'VE-'

Response
application/json
{
  "documentId": "6787a98e15306d37eed688a8",
  "status": "acknowledged",
  "internalStatusDetails": [
    { … }
  ]
}

Get External Invoice Status

Request

Get External Invoice Status.

Security
PublicApiKey
Bodyapplication/jsonrequired
documentIdstringrequired

The unique identifier of the invoice document.

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

Responses

Get external invoice status.

Bodyapplication/json
documentIdstringrequired

The unique identifier of the invoice document.

Example: "6787a98e15306d37eed688a8"
statusstringrequired

Status of document.

Example: "acknowledged"
internalStatusDetailsArray of objects(InternalStatusDetail)

Lista grešaka iz logRecords gdje je eventKey='generic' i eventData počinje s 'VE-'

Response
application/json
{
  "documentId": "6787a98e15306d37eed688a8",
  "status": "acknowledged",
  "internalStatusDetails": [
    { … }
  ]
}

Users

User account management operations

Operations

Billing

Usage metrics and billing information

Operations

ApiKeys

API key generation and management

Operations

Schemas

Schemas