Skip to main content

Create new Delegated

This endpoint creates a new delegated which is linked to an intermediary .

[POST] /api/v1/{itemId}/intermediary/{taxId}/delegated

Reminder : One intermediary can have many delegates

Header

Header used on this API are those taken from header standards of TS Digital.

Content-type is accepted in application/json

Query Parameters

Parameters used to make a successful request.

  • itemId: Unique personal identification of the item associated with the Intermediary requested. Mandatory for personal or technical users. (required)
  • taxId: Unique fiscal code of the item associated with Intermediary requested. (required)

Body

Body request for this endpoint is a JSON in a format described below

{
  "taxId": "stringstringstri",
  "firstName": "string",
  "lastName": "string",
  "description": "string"
}
  • taxId: Unique fiscal code of the Delegated which is being requested.
  • firstName: First name of the item which is requesting Delegated.
  • lastName: Last name of the item which is requesting Delegated.
  • description: Description associated with the Delegated which is being processed. 

Response

On successful response

If successful, the API responds with HTTP code 200(OK) with the following body:

{
  "firstName": "string",
  "lastName": "string",
  "description": "string"
}
  • firstName: First name of the Delegated created.
  • lastName: Last name of the Delegated created.
  • description: Description of the Delegated created
On error response

In the event of an error, the API responds with a body JSON with the following format:

{
  "code": "string",
  "timestamp": "2022-04-13T13:35:16.678Z",
  "message": "string",
  "subErrors": [
    {}
  ]
}
  • code: A string representation of the HTTP error code, linked with the returned http error
  • timestamp: Date and time of the answer, expressed as a string.
  • message: Message expressing error.

Possible errors are:

  • 400: The request is malformed (parameters with incorrect format, invalid or inconsistent parameters).
  • 401: An authorization token has not been provided or the authorization token provided is invalid (eg: it has expired).
  • 403: The provided token is valid, but the user is not authorized to perform the operation.
  • 500: An unexpected error occurred.