Intrastat UI


From the Intrastat page of the SBS portal, you can perform the following actions:

  • View all Intrastat declarations for the currently selected account, application, and tenant
  • For each declaration, you can view its processes, input files, and representative details
  • Filter, search and sort Intrastat declarations.

Access

You can access the Intrastat page of the portal as follows:

  1. Sign in to the SBS Portal. During the sign-in process, you will be prompted to select the account, app, and tenant where you are entitled to sign in.
  2. Click intrastat-api in the left hand-side menu.
  3. If applicable, select the organization from the drop-down list at the top of the page.

To interact with the Intrastat service, you can use either the Web UI or a GraphQL interface. You can switch at any time between the two interfaces by clicking the switch displayed at the top of the page:

Switch between Web and GraphQL

View Intrastat declarations

After you access the Intrastat Declarations UI, the declarations stored in SBS for the selected account, application, and tenant are displayed in the upper grid. To view details about a particular declaration, click the respective row in the grid. This loads all processes, files and representative details of that declaration in the lower grid, for example:

Intrastat Declarations UI

Intrastat declaration structure

The table below shows the declaration fields that are exposed through the Web UI.

Field Description
ID The unique identifier of the Intrastat declaration in SBS.
Declaration type Specifies the type of the declaration. Valid values: NEW, REVISED, NILL.
File type Specifies whether the declaration is an import or an export kind. Valid values: Import, Export.
Month The month of the reporting period.
Year The year of the reporting period.
Created at The date and time when the declaration was created.

Process structure

A declaration may have multiple processes. A new process is created every time the declaration is computed (through a call to generateDeclaration mutation). A declaration’s process has the following structure:

Field Description
ID The unique identifier of the process in SBS.
Status The status of the declaration. Valid values: INPROCESS - computation is in progress, DONE - computation has completed without errors, ERROR - computation has completed with errors.
Errors This fields reports errors that occurred during processing, if applicable.
Created at The date and time when the process was created.
XML icon Click the icon to download the declaration’s result file to the local disk.

File structure

A declaration may have multiple input files. An Intrastat declaration’s file has the following structure:

Field Description
ID The unique identifier of the file in SBS.
File type The type of data reported by the file. Valid values: Import, Export.
Name The file name.
Created at The date and time when the file was created.

Representative structure

A declaration has one representative (that is, the legal person who submits the declaration). A declaration’s representative has the following structure:

Field Description
ID The unique identifier of the representative in SBS.
First name The representative’s first name.
Last name The representative’s last name.
Phone The representative’s phone.
Email The representative’s email address.

Filter, search, and sort Intrastat declarations

To filter declarations by the values displayed in the grid, click the Filter Filter icon icon on the respective column header in the grid. The colour of the Filter icon on each column header denotes whether the filter is active:

To search Intrastat declarations, type your search text in the Search text box available in the right-upper corner of the grid. You can use any field as search term (for example, the declaration ID).

To sort declarations, click the respective column of the grid. The arrow indicates the current sorting order.

Query Intrastat declarations through GraphQL

To query Intrastat declarations through GraphQL:

  1. Switch to the GraphQL interface.
  2. Run the declarations query of the Intrastat Declaration Service, for example:
query declarations ($filter:DeclarationsFilter!) {
  declarations(filter:$filter) {
    id
    organization { id name tin regNo }
    representative { firstName lastName email phone }
    declarationType
    fileType
    month
    year 
    files { id declarationId fileType name uploadUrl createdAt }
    processes { id status errorMessages result { id name createdAt downloadUrl } }
    createdAt
  }
}
{
  "filter": {
    "organizationId": "YOUR_ORGANIZATION_ID"
  }
}

Create, generate, delete declarations

You can create, generate, and delete declarations only from the GraphQL interface. For details, see the API reference to the Intrastat Declarations Service.