Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Technical onboarding

...

Please see attached CRSM Integration Doc for details. As always, please feel free to contact with MOLE team for further help needed.

...


Enhancements/Updates: During the CRSM integration with Vessel Registry(LOB 001). We found some interesting stuff that would be helpful and avoid the hiccups for other lines of business to consider or implement. The following are the important to consider:

  • Payment event and expected values from LOB:

  When you update or save payment details from your application before or after a service request is completed to generate remissions or invoicing on the CRSM side, WLM expects the following values to be provided to update the payment table in WLM.  Once we receive the payment details, then the WLM forward the same to the CRSM side via service bus to generate invoicing.

...

If you are using WLM v2 endpoints, you might need to pass additional information like invoice number and transaction ID

  • How to add or edit new statuses:

   First, find out the list of value types available in LOV by calling the endpoint:

...

https://wwwappstestext.tc.gc.ca/Saf-Sec-Sur/13/MTAPI-INT/api/v1/servicerequests/statuses?serviceId=500

image-20240416-215454.png

  • How to evaluate service performance:

Service performance will be automatically calculated when a WorkItem is completed from the application side. To verify whether the service performance has been created from the CRSM side by calling the below SPAPI endpoint, and needs to pass the external request ID as like below:

...

Important Note: Make sure, the MTAPI status is changed to “Completed“ and “ServiceCategoryCode“ should be marked as “END“ as like in below screenshot:

image-20240417-144431.png

  • How to evaluate remissions:

Remissions can be evaluated either when a Work Item is completed or they can be completed at a later date provided by payment amount and receipt number from the application. The main important to keep in mind is to verify whether the invoice has been generated for the Work Item.  You can verify the status of invoicing from MTAPI by using the below API call in MTAPI:

image-20240417-145550.png

  • Implementation of using generic system id:

To get a generic system ID, you need to contact MTAPI by providing the generic user email ID to register with MTAPI, MTAPI will provide you the generic system user ID for the corresponding generic user email.

...

Note: If your line of business is integrated with CRSM, the “isEnabled” flag should be turned ON, and if your LOB wants to use a generic system ID, you need to update the values as like shown in the “CustomProperties” below:

image-20240417-151255.png

  • How to reach MTAPI platform in case of any issues/failures:

MTAPI team is a key resource for us for any permission-related or any secrets to share or add/generate user IDs.

...

https://forms.office.com/pages/responsepage.aspx?id=qf8IILLJl02a2UrOJThr57DEY0tN-EBEqZzzVbSn-gpUQU9BTlBQWUUyRklGVEhBSERQTk9XTzNUSS4u

...

  • MOLE Support:

Again, we are here to help out and advise for CRSM integration for new lines of businesses, and at any point, you feel need our assistance, please do not hesitate to reach out to us.

You are done!