loader
Image
gto-p-claims-sme_icon

ConnectZ - Retrieve Claims from BU

1.0
Average Rating
0
No votes yet
Provide a Process Layer on the SME Tower eco-system allowing specific Business Unit Claims information to be obtained in a consistent way for the consumer.

Documentation
Home

Provide a Process Layer on the SME Tower eco-system allowing specific Business Unit Claims information to be obtained in a consistent way for the consumer.

How this can help you

Retrieve claims information on a consistent way, transforming local Business Unit Claim information to a global format which can be used when needed, preventing individual transformation needs per Business Unit.

resources/hla-1003ff5f-e826-4db7-a8fe-6ea6420adbe4.png

How does it work

The Claims Process API based on context information (Business Unit) will route the request to the relevant system on the Business Unit and return a common data model with Claim information.

How do I get access

New applications wishing to use the service can request access via the API Exchange. As part of the request, you will be asked for a cost centre and to select the service tier you require. Once the API Owner accepts your request you will be issued a Client ID and Secret which you can use to call the API. See Getting Start page for more information.

Getting Started

All our API’s are designed to be easy and fast to consume! You can play with them from day 0 through our built in mocking services (were you can explore our API's before any further engagement), but if you want the real deal go through our Terms and conditions and Pricing pages and get started without exiting this site.

Step 0. First time

If this is your first time using one of our API's we suggest to go through our Terms and conditions to understand the overall conditions of use.

Step 1. Request API access

Yes, just click on the "Request Access" button in this page where you will need to:

  1. Select the Environment you want to access (more details on our Environment page)
  2. Select the right tier for your application, you can find more information on Pricing page and move to the next screen
  3. "Select an existing client application" or "Create a new application" that will be allowed to call this api
  4. Read the Terms & Conditions and check the box to accept them

    • Terms and conditions vary between API's, it is important take knowledge of this information to prevent any API missusage
    • Please read Terms and conditions page to know our global terms and this API specific terms
  5. Access approval & account setup

    • All access requests are assessed and approved whithin 1 working day, during this phase you might be contacted for specific details (e.g. cost centre)
Step 2. Use the API

Once you client application gets approved, and you have your credentials, you can visit our Authentication page to understand which authentication mechanism should be used to interacting with our API.

You can use this API through your preferable wrapper, MuleSoft, Azure API, Java, Python... Just follow our API Runbook to understand how to use it, or exmplore our API documentation to see in more detail our API documentation.

Step 3. Monitor your API

Monitorization of your API is also a key aspect to improve you API usage, our API's are actively monitored, please through our Support page to know more on our monitoring solution.

Step 4. Maintain your Application

We are allways looking to improve our API's, this means that is also important for you to know how this API can evolve and how we manage it.

The Versioning page details which versioning model is being used, and how this can affect your dependent applications.

Step 5. Provide feedback and get support

Visit your Support page to know how to interact with us, but while you are here, feel free to use our Reviews section

Step 6. Decommissioning

Hope you are not thinking about it :) But if you must, simply delete your Application on "My Applications" page, and you will be unregistered from this API.

Pricing
Costs exempt

This API is business unit specific as part of the overall SME Tower, for external use (outside SME Tower) please Contact the C4E team.

Authentication

Our API is protected by Basic Auth: standard HTTP Authorization header with the authorization type to Basic

The user and password are governed through an Anypoint Platform enforced Client Id/Secret policy.


Client ID/Secret

Complete the pre-requisite steps on the Getting Started page to obtain API client credentials.

The Client Id/Secret is enforced using the Basic Authentication scheme. This requires the client_id and client_secret values are communicated using the standard HTTP Authorization header with the authorization type to Basic.

The format of the Authorization header is as follows:

Basic client_id:client_secret

In accordance with the Basic Authentication specification the client_id:client_secret value must be passed as base64-encoded string as shown below:

Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=

The API will return a 401 HTTP Status Code with code authentication_error in case of an invalid value or credential.

Postman

In order to speed up your integration we prepared a curated Zurich Postman collection which you can found on Zurich Postman Enterprise - CC_API_Centre for Enablement.

If you are a Zurich employee / contractor and you don't have access, please visit Zurich Get Postman link, and take the oportunity to visit our C4E Postman Best Practices while your access is being aproved.

Configure your environment variables

As defined on the Postman Best practices, this is a shared Collection, which is already curated for initial use.

When using the provided collection, please ensure you create your own copy into your team workspace and don't update the collection.

Only current values in environment properties can be changed as presented below:

postman_collection_environment

Run your postman collection

Once you have configured the environment variables feel free to invoke the available methods and retrieve the API details.

Any additional question please contact the C4E team

Errors

This API uses conventional HTTP response codes to indicate the success or failure of an API request:

  • Codes in the 2xx range indicate success.
  • Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required field was omitted).
  • Codes in the 5xx range indicate an error with the server.

The sections below explain in detail the HTTSP status codes returned by the API and the error response message returned to the user.


Error HTTP Status Code Summary

The table below contains all the possible HTTP status codes that the API returns, however, one should refer to each individual resource and method endpoint definition for specific details on the possible status codes returned.

Status CodeDescription
400 Bad RequestThe server could not understand the request due to invalid syntax.
401 UnauthorizedInvalid token. The server was unable to authenticate the user.
405 Unaccepted HTTP MethodThe method received in the request-line is known by the origin server but not supported by the target resource.
406 Not AcceptableThe service is unable to fulfil the request based on the Accept header provided.
415 Unsupported Media TypeThe media format of the requested data is not supported by the server.
500 Internal Server ErrorAn internal server error was observed.
502 Bad GatewayThe server encountered received an invalid response from an inbound server it accessed while attempting to fulfil the request.
503 Service UnavailableThe server was unable to handle the request due to a temporary overloading or maintenance of the server.

Please refer to each individual resource and method endpoint definition for specific details on the possible status codes returned.


Error Response

Independently of the error scenario a common error structure will be returned, allowing consumers to manage error results through a common structure, below the specific attributes that compose this error message structure can be checked in more details.

Attributes
Field NameDescription
codePattern based scheme that identifies a specific and unique error condition. Typically human readable but more suited for machine processing.
messageHuman readable description of the error that occurred that is not intended to be machine parsable.
correlationIdProvide ability to rapidly identify and trace distributed request processing. ​
sourceOptional. Describes the source of the error; used to indicate the error originated elsewhere or self-reference when error was generated internally or in direct consequence of downstream events.
source/nameImplementation provider defined name for the API, service or system.​
source/layerImplementation provider defined name for the API, service or system.​
causesOptional. Describes the source of the error; used to indicate the error originated elsewhere or self-reference when error was generated internally or in direct consequence of downstream events.
causes/codeOptional. Pattern based string that identifies a more fine grained error condition, which contributed to the general/parent error code above. ​
causes/messageMandatory. More specific information on the failure cause. ​
causes/fieldOptional. A JSON Pointer (RFC6901) that identifies the entity or entity attribute responsible for the more specific error code and message. ​​
causes/sourceOptional. See “source” object definition above ​​​
Error Response Payload Examples
{
  "code" : "RESOUCE_UPDATE_FAILED",
  "message" : "Cannot update User account groups",
  "correlationId": "3d9445ca-dd6c-4fe2-b93d-c23423f0d612",
  "causes": [
    {
      "code": FAILED_UPDATE_SECURITY_TYPE_DEFAULT,
      "message": "Failed to set security type to 1"
    }
  ]
}

Environments

Exchange: gto-p-claims-sme


Environments available.

This API is intended to support API development and operations lifecycle management functions. This API may be made available in the following environments:

By default we only publish the Mock and Production versions of the API for consumption because the underlying service is the same in all circumstances. Additional environments can be subscribed on special request.

URLs

This API is published to the following environments but may be made available in the following environments:

Please refer available APIs on Request Access section to view which deployments are available.

Additional environments are provided for development of the API but these should only be used in consultation with the API team.

Support

Contact the C4E team or your local service desk for more information or support.

If you are already having a specific issue, maybe our Known Issues section may help you:


Known Issues

Nothing to report... Hooray!

Release Notes

v1.0.0: Unreleased