Skip to content
/
DocumentGetStatusResponse

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

Users

User account management operations

Operations

Billing

Usage metrics and billing information

Operations

ApiKeys

API key generation and management

Operations

Schemas

Schemas

ReportingResponse

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"
{
  "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"
}

DocumentGetStatusResponse

documentIdstringrequired

The unique identifier of the invoice document.

Example: "6787a98e15306d37eed688a8"
documentSenderNamestringrequired

The name of the sender of the document.

Example: "Example Sender Ltd."
documentReceiverNamestringrequired

The name of the receiver of the document.

Example: "Example Receiver Ltd."
documentSenderVatNumberstringrequired

The VAT number of the sender without country prefix.

Example: "12345678910"
documentReceiverVatNumberstringrequired

The VAT number of the receiver without country prefix.

Example: "98765432100"
documentNumberstringrequired

The document number of the invoice.

Example: "INV-2023-001"
internalStatusstringrequired

The internal status of the document.

Example: "NEW|OK|FAILED"
externalStatusstringrequired

The external status of the document.

Example: "SENT|DELIVERED|ACKNOWLEDGED"
fiscalizationDetailsobject(FiscalizationResponse)

Details from the latest fiscalization attempt (optional)

reportingDetailsobject(ReportingResponse)

Details from the latest reporting attempt (optional)

internalStatusDetailsArray of objects(InternalStatusDetail)

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

{
  "documentId": "6787a98e15306d37eed688a8",
  "documentSenderName": "Example Sender Ltd.",
  "documentReceiverName": "Example Receiver Ltd.",
  "documentSenderVatNumber": "12345678910",
  "documentReceiverVatNumber": "98765432100",
  "documentNumber": "INV-2023-001",
  "internalStatus": "NEW|OK|FAILED",
  "externalStatus": "SENT|DELIVERED|ACKNOWLEDGED",
  "fiscalizationDetails": {
    "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"
  },
  "reportingDetails": {
    "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"
  },
  "internalStatusDetails": [
    { … }
  ]
}

DocumentGetStatusRequest

companyVatNumberstringrequired

The VAT number of the company.

Example: "HR12345678910"
dateFromstring(date-time)

Start date for document search (optional)

dateTostring(date-time)

End date for document search (optional)

{
  "companyVatNumber": "HR12345678910",
  "dateFrom": "2019-08-24T14:15:22Z",
  "dateTo": "2019-08-24T14:15:22Z"
}