Interfaces

The MESPAS TSM software and MESPAS SBM platform are used by many of our customers in an environment where data is exchanged with other software, databases or platforms. Therefore MESPAS provides a variety of predefined export and import interfaces to manually or automatically share data. All available import- and export interfaces are listed below.

In order to implement these interfaces, the respective file descriptions and transfer modalities have to be adopted in the customers software or platform. To get the file descriptions and example files, please contact your project manager at MESPAS.

Import interfaces (to MESPAS)

Name	Format	Function
Budget import	XML	MESPAS TSM offers to record a budget value for each account code or vessel which in general comes from an accounting system. For companies, which have a large number of vessels and account codes, the task to enter these budget values can be quite time consuming. Therefore an interface is provided to get the values automatically. The interface allows to record the initial budget (at the beginning of the year) as well as to update the budget values during the year. It works only for a "month" based budget. It cannot be used for an "annual" based budget (where the amount is evenly split to each month).
Document import	XML	The document import interface makes documents which are managed and stored in a 3rd party document management system available for the MESPAS users in the office and on board of the vessel. The creation of the document record, the entries of the document assignments and the upload of the document as such is done in one import step.
Interface confirmation import	XML	Any export interface can be configured as "confirmed" interface. The 3rd party system has to create an XML file with an acknowledge message for MESPAS TSM. As long as a record is not confirmed with this acknowledge message, the record will be included in the XML file with each export run again.
Invoice import	XML	For an automated budget update in MESPAS TSM invoices that are recorded in the accounting system can be imported into MESPAS TSM. The import contains the invoices meta data, not the invoice document as such.
Invoice paid import	XML	This interface is to inform the purchaser about the status of an invoice that was exported to the accounting system. The import gets the payment information (payment date, currency and amount) from the accounting system back into MESPAS TSM.
Offer approval import	XML	If offers need to be approved by a third party system (e.g. a ship owner who approves offers for his ship manager), this interface feeds the offer approval information from a third party system back into MESPAS TSM. As the offer approval interface refers to the MESPAS TSM OFFER_ID, this interface works only in combination with the Offer Export.
Offer import from ShipServ	MTML-XML	This import feeds offer data from the ShipServ platform into MESPAS TSM.
SVV (state variable values) import	XML	If a computerized automation and control system is installed on board of the vessel, running hours of machinery are available in electronic form. In order to make use of the already existing running hour values, this interface imports these values from the automation system into MESPAS TSM.
Task import	XML	This interface imports the tasks to the MESPAS TSM Tasks.
Ship schedule import	XML	For customers, using a system outside of MESPAS TSM to record the ship schedule information, this interface transfers the data into MESPAS TSM, to make use of the it in the MESPAS TSM procurement module.
Project code budget import	XML	MESPAS TSM offers to assign orders and invoices to a project code (in addition to the assignment to accounting codes). The management of the project codes and the corresponding budget values is done in an external system and updated in MESPAS TSM via this interface.
Order tracking update import	XML	MESPAS TSM offers to record for each order the different delivery locations a delivery is going through from the until it reaches its final destination: the vessel. The interface allows to update the 'effective' dates of the different delivery locations automatically.

Export interfaces (from MESPAS)

Name	Format	Function
Delivery confirmation export	XML	For automated invoice handling or for an accounting system delivery data from MESPAS TSM can be exported to a third party system.
Invoice export	XML	For external invoice processing and for accounting systems invoice data from MESPAS TSM can be exported to a third party system.
Invoice address export	XML	for exporting the invoice addresses defined in MESPAS with indication for which vessel it is assigned
Document (invoice) export	XML	With the above invoice export it is possible to export invoice data, but documents, attached to the invoice (e.g. the invoice document) need to be exported with a separate job.
Monthly PMS statistics export	XML	In order to have the monthly PMS statistics data (as required by TMSA regulation) for further processing in third party systems, the relevant data from MESPAS TSM are exported.
Noon report export	XML	This interface exports Noon Report data for further processing in third party systems (e.g. Crew management systems).
Offer export	XML	If offers need to be approved in a third party system (e.g. a ship owner who approves offers for his ship manager) this interface exports all offers within a particular case.
Order export for ShipServ	MTML-XML	This interface allows the exchange of orders between purchaser and via the ShipServ platform.
Request export for ShipServ	MTML-XML	This interface allows the exchange of requests between purchaser and supplier via the ShipServ platform.
Order export for ShipNet	SNAPS	For automated invoice handling or accounting order data from MESPAS TSM is exported to the ShipNet accounting system.
Order export	XML	For automated invoice handling or for an accounting system order data (including the user who did the final approval if available) from MESPAS TSM is exported to a third party system.
Order export for logistics	XML	In order to inform a logistics company about upcoming deliveries, this export provides order data with all information needed by the logistics company.
Overhaul export	XML	This export provides overhaul data for further processing in third party systems.
PMS Settings export	XML	PMS setting data is exported for monitoring of working hours (reported by maintenance staff) in a third party software.
PMS Statistics export	XML	In order to have PMS statistics data on a third party system dashboard, this export provides PMS statistics data from MESPAS TSM.
Purchase request export	XML	This export provides purchase request data for third party procurement systems that don't have a vessel to office synchronisation.
Supplier export	XML	This export provides the data of supplier companies that are marked as "favourite" in the procurement section of MESPAS TSM.
Task export	XML	For further processing of spent hours and work performed, it might bee needed to export task data from MESPAS TSM to a third party system.