e-Transport UI


From the e-Transport page of the SBS portal, you can perform the following actions:

  • View the list of shipments created by your organization
  • For each shipment, view its stages (such as Notification, Modification, Deletion), and download any accompanying XML files
  • Sort and filter shipments and shipment stages
  • View real-time e-Transport messages from ANAF
  • View real-time e-Transport carrier messages from ANAF

Before using the e-Transport service, make sure that an organization exists which has been authorized with ANAF.

Access

You can access the e-Transport 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 RO e-Transport in the left hand-side menu.
  3. If applicable, select the organization from the drop-down list at the top of the page.

To view or manage e-Transport data for a different, account, app, or tenant, switch accounts.

To interact with the e-Transport 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

Shipments

Shipments are e-Transport notifications created by your organization and uploaded to ANAF, with the purpose of obtaining a UIT - unique transport identification number. A shipment may consist of multiple stages. At the minimum, each shipment contains a “Notification” stage. When you modify a shipment record, however, a new “Modification” stage is created. Likewise, if you delete a shipment record, a “Deletion” stage is created.

View shipments

To view shipments:

  1. If applicable, select the organization from the drop-down list at the top of the page.
  2. Click the Shipments tab.

Shipments

Whenever you click a row in the Shipments grid, its stages are loaded in the Stages grid.

By default, shipments are ordered by their creation date, most recent first. To refresh the grid, click Refresh Refresh button in the top-right corner of the grid.

The “Shipments” grid contains the following columns:

SBS fetches the latest information from ANAF every minute. So, for example, if the status is UPLOADED, then you will need to wait at least 1 minute and then click the refresh button to get the latest status information. This applies both to shipments and shipment stages.

Shipment stages

The “Stages” grid contains the following columns:

To download the XML file associated with each stage, click the XML XML icon icon on the respective row.

Choose grid columns

Optionally, you can customize the grid to display less columns. This apples for both “Shipments” and “Stages” grids.

To remove a column from the grid:

  1. Click the Column chooser Column chooser icon button on the grid. The Column Chooser dialog appears.
  2. Drag a column header from the grid onto the column chooser area.

To add a column back the grid:

  1. Click the Column chooser Column chooser icon button on the grid. The Column Chooser dialog box appears:

    Column chooser dialog

  2. Drag the column of interest from the column chooser onto the grid.

Filter shipments by creation date

You can filter shipments by the date they were created in SBS. To do this, use the date picker available above the grid. By default, this filter is set to display all shipments starting with the 1st of the current month up to today’s date.

To change the date range:

  1. Click twice on any date except the first date of the currently visible range. A single date is selected.
  2. Click a date previous or subsequent to the selected date to create the range.

Create, modify, delete shipments

Creating, modifying, and deleting shipments is available only from the GraphQL interface. For details, see the e-Transport Service API Reference.

Debug stage status

Under normal circumstances, refreshing the “Shipments” and the “Stages” grids fetches the latest available information from ANAF. However, if system failures or API downtime occur in the process of exchanging data with ANAF, the displayed shipment stage status may be out-of-sync with ANAF.

To help you work around such issues, SBS provides a debug button that is displayed in the “Stages” grid for each stage that has the status UPLOADED. Click the debug button to issue a real-time query to ANAF and get the latest information about the respect shipment stage as it currently stands with ANAF.

Debug stage status

Messages

The Messages tab displays a list of messages as provided by ANAF in real time.

Messages

A message indicates that ANAF has registered an event in connection with a shipment. The most important information about each message is displayed directly on the grid, namely:

  • Upload ID - The identifier obtained from ANAF after uploading the declaration file.
  • UIT - The unique transport identification number assigned to the shipment by ANAF.
  • Vehicle Plate Number - The plate number of the vehicle involved in the event, if available.
  • Shipment Date - The date when the shipment is due to take place.
  • Created At - The date when the record was created in Socrate Business Services.

To view full details of a message, click the Upload ID column of the grid.

By default, the grid shows messages starting with the 1st of the current month. Use the calendar picker to load earlier messages. Note, however, that you can load messages from the past 60 days only, which is the current limit set by ANAF.

Carrier messages

The Carrier Messages tab displays a list of messages available from ANAF for e-transport carrier organizations. Information in this tab is relevant only if your company has been declared as a carrier when the shipment notification was submitted to ANAF.

Carrier messages

The most important information about each carrier message is displayed directly on the grid, namely:

  • UIT - The unique transport identification number assigned to the shipment by ANAF.
  • Declarant Code - The tax identification number of the declaring entity.
  • Declarant Name - The name of the declaring entity.
  • Declarant Reference - A reference generated by the declaring entity from their system on obtaining the UIT.
  • Shipment Date - The date when the shipment is due to take place.
  • Vehicle Plate Number - The plate number of the vehicle involved in the event, if available.

To view full details of a message, click the UIT column of the grid.

Note that carrier messages are available from ANAF only while there are active shipments.