This method returns:
- the disposable contract (Mod_NAMCA22D)
- the privacy document url
- the T&C document url
The disposable contract (Mod_NAMCA22D)
- is filled if
disposableHolder,disposableContactsanddisposableDocare specified - is not filled if
disposableHolder,disposableContactsanddisposableDocare not specified
For the full technical reference, see the OpenAPI specification.
POST /api/document/{lraId}/getDisposableContract| Name | Required | Description |
|---|---|---|
Content-Type | Yes | Must be application/json. |
Authorization | Yes | Basic Auth credentials. |
| Parameter | Type | Required | Description |
|---|---|---|---|
lraId | integer | Yes | LRA identifier. |
| Parameter | Type | Required | Description |
|---|---|---|---|
languageCode | array | Yes | Language(s) of the document. ISO 639-1 alpha-2 codes. |
docTypes | array | Yes | Document type(s). 1 = PDF, 2 = TXT. |
productType | string | Yes | Disposable certificate type. Allowed values defined in DisposableType. |
country | string | No | Country where the end user is located. ISO 3166-1 alpha-2. If omitted, the default template for the specified languageCode is returned. |
disposableHolder | object | No | DisposableHolder object. |
disposableContacts | object | No | DisposableContacts object. |
disposableDoc | object | No | DisposableDoc object. |
{
"languageCode": ["IT"],
"docTypes": [2],
"disposableHolder": {
"birthCity": "Ancona",
"firstName": "Mario",
"identificationCode": "RSSMRA80A01H501U",
"identificationCountry": "IT",
"identificationType": "ITALIAN_TAX_CODE",
"lastName": "Rossi"
},
"disposableDoc": {
"documentExpirationDate": "2029-11-09",
"documentIssuer": "Comune di Ancona",
"documentIssuerDate": "2019-08-22",
"documentNr": "AB1234567",
"documentType": "CI"
},
"disposableContacts": {
"email": "user@example.com",
"mobile": "+390000000000"
},
"productType": "DISPOSABLE_30_DAYS"
}200 — Contract returned
[
{
"languageCode": "IT",
"docTypes": 2,
"doc": "encoded file",
"privacy_link": "https://docs.namirialtsp.com/documents/Mod_NAM_GDPR03D_ITA_IT.pdf",
"termsAndConditions_link": "https://docs.namirialtsp.com/documents/Mod_NAM_CA01D_ITA_IT.pdf",
"checkBoxes": [
"Al fine di perfezionare la sottoscrizione del Modulo di richiesta con firma elettronica, è necessario accettare i termini e le condizioni della fornitura richiesta contrassegnando con segno di spunta le caselle sottostanti:",
"(1) Io sottoscritto/a dichiaro quanto indicato nel QUADRO E - AUTOCERTIFICAZIONE E SOTTOSCRIZIONE DA PARTE DEL TITOLARE.",
"(2) Io sottoscritto/a accetto le Condizioni Generali di Contratto (Mod.NAM CA01) e le clausole vessatorie riportate nel QUADRO F – CLAUSOLE VESSATORIE"
]
}
]The main errors that can be found within this method are (all return HTTP 500):
| Error code | Description |
|---|---|
| 2 | Some required fields are missing |
| 2083 | Contract template not found |
| 2084 | The specified language was not found |
| 10094 | Product does not exist |
For authentication errors, see Authentication.
For details on how to handle errors, see How to handle errors.