Cancellation_Declaration_Schema_Documentation

Cancellation Declaration Schema

decHfr_annul_v3_restrict.xsd

1. Overview

This XML Schema Definition (XSD) defines the structure for cancellation notifications under Article 16 of Regulation No. H-5 of 29 September 2023 regarding fiscal control over the movement of high fiscal risk goods in the Republic of Bulgaria.

1.1 Purpose

The cancellation schema is used to notify the National Revenue Agency (NRA) when a previously submitted transport declaration needs to be cancelled. This notification must be submitted before the transport begins.

1.2 Version Information

Schema Version: 3
Encoding: WINDOWS-1251
Root Element: decHfrAnnul

2. Root Element: decHfrAnnul

The root element contains all cancellation notification data. It consists of one main section (part1) that includes all required information about the declarant and the transport being cancelled.

Documentation: Notification under Article 16 of Regulation No. H-5 of 29 September 2023 regarding fiscal control over the movement of high fiscal risk goods in the Republic of Bulgaria

3. Main Declaration Section (part1)

The part1 section contains all elements of the cancellation notification. All child elements use the <xs:all> compositor with minOccurs="1", meaning all elements are required and can appear in any order.

3.1 Identification Number (ident)

MANDATORY. Identifies the person submitting the cancellation.

Field	Type	Required	Description
ident	bulstat (9-13 digits)	Yes	Personal Identification Number (PIN)/Identification Number for foreigner/Bulstat/Service number NRA (National Revenue Agency)

Restrictions:

Base type: bulstat
Minimum length: 9 characters
Pattern: [0-9]{1,13}

3.2 Identification Type (identtype)

MANDATORY. Specifies the type of identification number provided.

Field	Type	Required	Description
identtype	identtype enum	Yes	Identification number type: 1 - Bulstat 2 - PIN 3 - FPN/PN 5 - Service number NRA (National Revenue Agency)

3.3 Unique Transport Number (uin)

MANDATORY. The unique transport number from the original declaration that is being cancelled.

Note: This schema is used to cancel/annul a previously submitted declaration by referencing its UIN (Unique Identification Number). The UIN must match an existing, active declaration. The cancellation must be submitted before the transport begins.

Field	Type	Required	Description
uin	string (max 13 chars)	Yes	Unique number for transportation

3.4 Declaration Confirmation (iscorrect)

MANDATORY. Boolean flag confirming the accuracy of the information.

Field	Type	Required	Description
iscorrect	boolean	Yes	Flag - I declare that the information provided in this form is true and accurate. I acknowledge that providing false information is subject to liability under Article 313 of the Criminal Code

Legal Note: By setting iscorrect to true, the declarator acknowledges criminal liability under Article 313 of the Bulgarian Criminal Code for providing false information.

4. Simple Data Types Reference

This section defines the custom simple types used in the schema.

Type Name	Base Type	Constraints	Description
bulstat	string	maxLength: 13	Base type for identification numbers
identtype	integer	Enum: 1, 2, 3, 5	1=Bulstat, 2=PIN, 3=FPN/PN, 5=NRA Service Number

5. Validation Rules Summary

5.1 Identification Number Validation

Must be numeric only (pattern: [0-9]{1,13})
Minimum 9 digits, maximum 13 digits
Must match the identtype specified

5.2 Transport Number Validation

Must be a valid UIN from a previously submitted declaration
Maximum 13 characters

5.3 Declaration Confirmation

Must be set to true to submit the cancellation

6. XML Example

<?xml version="1.0" encoding="WINDOWS-1251"?>
<decHfrAnnul>
  <part1>
    <ident>123456789</ident>
    <identtype>1</identtype>
    <uin>2501170000001</uin>
    <iscorrect>true</iscorrect>
  </part1>
</decHfrAnnul>

7. Usage Guidelines

7.1 When to Use This Schema

This schema should be used when:

A previously submitted transport declaration needs to be cancelled
The transport will not take place as originally declared
The cancellation must be submitted before the scheduled transport begins

7.2 Required Information

To submit a cancellation, you need:

Your identification number (same as used in the original declaration)
The type of your identification number
The unique transport number (UIN) from the original declaration

8. Schema Information

Schema Namespace: http://www.w3.org/2001/XMLSchema
Oracle XDB Namespace: http://xmlns.oracle.com/xdb
Element Form Default: qualified
Attribute Form Default: unqualified
Schema File: decHfr_annul_v3_restrict.xsd

End of Documentation