Skip to content
Invogi Docs

Choose which structured invoices get full reference validation (OWNER only)

PATCH
/organizations/current/reference-validation
curl --request PATCH \
  --url https://api.invogi.com/v1/organizations/current/reference-validation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "mode": "OFF" }'

DECLARED_PROFILES (default) validates invoices that declare XRechnung; ALL also validates Peppol BIS and plain UBL/CII and requires an active Invoice Firewall subscription; OFF uses only the built-in checks. KSeF FA(3) is always schema-validated in the Worker.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
mode
required
string
Allowed values: OFF DECLARED_PROFILES ALL

Responses

Section titled “Responses”

200

Section titled “200”

Setting updated and audit event recorded

Media typeapplication/json
object
referenceValidationMode
required
string
Allowed values: OFF DECLARED_PROFILES ALL

Example 

{
  "referenceValidationMode": "OFF"
}

400

Section titled “400”

Invalid request

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

401

Section titled “401”

Missing or invalid API key

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

403

Section titled “403”

API key lacks required scope/role

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}