{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/namirialnotify/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Integrate QeRDS notices","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrate-qerds-notices","__idx":0},"children":["Integrate QeRDS notices"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide follows a qualified EviNotice from preparation and submission to recipient access and evidence retrieval. For the service and identification concepts, start with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/services/qerds"},"children":["QeRDS with EviNotice"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The examples use the EviNotice ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["v2"]}," contract and the explicit values ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_ES"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]},". Use the variant enabled for your account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prepare-the-integration","__idx":1},"children":["Prepare the integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before submitting, confirm that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The issuing account is identity-verified, its legal-document kind is eligible for QeRDS, and its identity-verification configuration includes the intended qualified variant. These account prerequisites apply to both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_ES"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/services/qerds#sender-identification"},"children":["Sender identification"]}," for onboarding guidance."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You have Namirial Notify credentials and the certificate specifically issued and provisioned for qualified API submission in the intended environment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The email address associated with the certificate matches the issuing account's email address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The recipient can be identified using the information and identity context for the notice."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you enable enrollment during the notice flow, the enrollment profile is configured on the site and suitable for the intended variant and recipient."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any supplied ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSIdentityTenant"]}," is configured on the site for the selected variant."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Issuer identity verification and variant enablement are configured on the account during onboarding, outside the Submit JSON body. The client certificate separately authenticates the HTTPS connection for qualified API submissions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-correct-environment-and-authentication","__idx":2},"children":["Use the correct environment and authentication"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Environment"},"children":["Environment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API base URL"},"children":["API base URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pre-production / QA"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.ecertia.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Production"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.evicertia.com"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send submissions to the API host for the environment, rather than the customer's Web site host:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/EviNotice/Submit\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Qualified submission requires ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP Basic credentials plus client-certificate authentication"]},". Configure your HTTPS client with the certificate issued for this API use; the certificate is part of the connection configuration, not a field in the JSON body. Confirm the supplied certificate format and supported client setup during provisioning."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request the certificate through your Namirial commercial contact or project manager. Have the company name, contact email and mobile number, issuing account email, site URL and intended environment available so the certificate can be provisioned for the correct issuer and site."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The certificate must be associated with the site and authorized issuing account. Test and production certificates are managed separately; use the certificate supplied for the environment you are calling. Its email must match the issuer used in Basic authentication."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This certificate authenticates the issuer's API connection. Service qualification and the certificates used in a recipient's identification or signing process have distinct roles."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-a-pkcs12-certificate","__idx":3},"children":["Configure a PKCS#12 certificate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a supplied password-protected PKCS#12 (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".p12"]},") bundle, configure the HTTPS client's certificate file and password. Check that the client supports the supplied format and retains any certificate chain needed by the connection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following interactive example uses a curl/TLS backend that can load P12 files directly. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOTIFY_ISSUER_EMAIL"]}," to the issuing account, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_P12_FILE"]}," to the bundle path and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOTICE_IDEMPOTENCY_TOKEN"]}," to the token for this logical submission. Save the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#submit-a-spanish-variant-notice"},"children":["Spanish request body below"]},", with matching test-recipient details, as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qerds-es.json"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n  --user \"$NOTIFY_ISSUER_EMAIL\" \\\n  --cert-type P12 \\\n  --cert \"$QERDS_P12_FILE\" \\\n  --header 'Content-Type: application/json' \\\n  --header \"X-Evi-IdempotencyToken: $NOTICE_IDEMPOTENCY_TOKEN\" \\\n  --data-binary @qerds-es.json \\\n  'https://api.ecertia.com/v2/EviNotice/Submit'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter the account and certificate passwords when prompted. For the Italian request, use the corresponding ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qerds-it.json"]}," body and a new token for that distinct notice. Reuse a token only when retrying the same logical submission."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certificate handling depends on the client:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A TLS backend that uses a certificate store, such as Windows Schannel, needs its supported store configuration instead of the direct P12 file argument."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the certificate-file portion of curl's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--cert"]}," argument, escape a literal colon as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\\:"]}," so it is not treated as the password separator. Preserve that escape when quoting the argument in your shell."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For unattended jobs, use your HTTP client's protected credential/keystore configuration or a curl ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://curl.se/docs/manpage.html#--config"},"children":["configuration file"]}," restricted to the integration account. Keep passwords out of command-line arguments."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If an OpenSSL-based client cannot load an older P12 bundle using legacy encryption, ask the certificate provider for a compatible re-export. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.openssl.org/3.5/man1/openssl-pkcs12/"},"children":["OpenSSL PKCS#12 guidance"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://curl.se/docs/manpage.html#--cert"},"children":["curl client-certificate options"]}," and follow the setup supplied for your integration client."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The separate VerifID enrollment API uses its own API key. That key does not replace the credentials or certificate used to submit the EviNotice. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/dev/qerds-registration"},"children":["QeRDS user registration API"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-the-variant-and-recipient-path","__idx":4},"children":["Choose the variant and recipient path"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both variants require ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdRequired: true"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notification destination"},"children":["Notification destination"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"QERDS_ES"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_ES"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"QERDS_IT"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod: EmailPin"]},"; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedEmail"]}," equals ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod: MobilePin"]},"; supply the recipient's valid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedMobile"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mobile"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod: MobilePin"]},"; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedMobile"]}," equals ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod: EmailPin"]},"; supply the recipient's valid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedEmail"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Legal document"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supply document kind and value together for confirmation, or omit both so the recipient provides them"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdKind"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdValue"]}," are required and must validate together"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the Spanish variant, use identical values in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]}," and the fixed PIN destination. Write email addresses in lowercase without surrounding spaces and mobile numbers in the same E.164 form, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+34600000000"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Identification remains mandatory when enrollment is disabled. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentAllowed: false"]}," only when the recipient already has a verified identity available to the notice's identity context."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qerds-request-fields","__idx":5},"children":["QeRDS request fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The qualified requirements below apply in addition to the generic Submit fields ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]},". The generic schema's required-field list alone does not describe all QeRDS validation. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/oas/evinotice-api"},"children":["full EviNotice request schema"]}," for the other submission options."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use in a qualified request"},"children":["Use in a qualified request"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CertificationLevel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Select the account-enabled variant, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_ES"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]},", explicitly."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of strings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubmittedAdvanced"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", or include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CompleteAdvanced"]},". Additional kinds can be requested."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceAccessControlMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Public"]}," explicitly for both qualified variants. This controls access to the evidence record; recipient identification for the hosted notice remains required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdRequired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," for both variants, including recipients who are already identified."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdKind"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Legal-document kind recognized by the service and suitable for the configured identity flow. Send it together with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdValue"]},"; both are mandatory for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]},". For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_ES"]},", supply both or omit both."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdValue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The matching recipient's document number. It must be valid for the selected kind; the Italian variant validates the pair at submission."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentAllowed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," to allow enrollment when no matching verified identity is found. Omitting it does not enable enrollment. Setting it to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," still requires an existing matching verified identity for access."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentProfile"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required when enrollment is enabled. Any supplied non-empty profile must match a profile configured on the site, even when enrollment is disabled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSIdentityTenant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional identity context used for recipient identity lookup and in-notice enrollment. When supplied, it must exactly match a tenant configured on the site for the selected certification variant. Obtain the appropriate value during provisioning."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional recipient acceptance/rejection action; the API default is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Disabled"]},". To collect recipient comments, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Reject"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Keep disabled when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptOrReject"]},". To collect comments on a qualified notice, set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice: Reject"]}," and enable this field."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EmailPin"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePin"]}," according to the ES/IT routing table above."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedEmail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required for the qualified ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EmailPin"]}," path and used only with that method. It must match ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]}," for an ES email notice; for an IT mobile notice it is the recipient's separate email destination."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedMobile"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required for the qualified ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePin"]}," path and used only with that method. It must match ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]}," for an ES mobile notice; for an IT email notice it is the recipient's separate mobile destination."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NotificationChannels"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of strings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Routes the notice alert. When omitted, email recipients use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]}," and mobile recipients use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SMS"]},". This is separate from the PIN-delivery channels."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePinChannels"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of arrays of strings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional, only with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod: MobilePin"]},". Configures three non-empty PIN-delivery attempt groups. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/services/evinotice#mobile-pin-channels"},"children":["Mobile PIN channels"]}," for canonical values, defaults and enablement requirements."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For QeRDS acceptance, comments and acceptance reasons are unavailable. Leave ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptReasons"]}," unset and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequireAcceptReason"]}," false or omitted. Rejection reasons can be configured with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice: Reject"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed: true"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Document-kind identifiers such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IDC:ES"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAS:ES"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TIN:IT"]}," are case-sensitive examples, not an exhaustive list. The service validates the identifier and document value. Confirm the kinds supported by the target environment and the configured identity flow; a recognized document kind does not by itself establish that a particular identification method is available."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"select-the-identity-tenant","__idx":6},"children":["Select the identity tenant"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSIdentityTenant"]}," selects the identity context used to look up the recipient's verified identity and, when in-notice enrollment runs, to create it. The same context is recorded with the recipient's QeRDS service-terms acceptance. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentProfile"]}," selects the process offered if a new enrollment is needed. These are separate settings; one does not replace the other."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If Namirial has provisioned a tenant for the integration, add its actual identifier to the appropriate complete request below:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"QERDSIdentityTenant\": \"<PROVISIONED_IDENTITY_TENANT>\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is a request fragment, not a complete submission. Replace the placeholder with the tenant configured for the requested variant. The API does not require this field on every qualified request; confirm the intended identity context during provisioning rather than assuming that omitting it selects a site-specific tenant."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"enable-recipient-enrollment","__idx":7},"children":["Enable recipient enrollment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To allow a new recipient to enroll during the notice flow, replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentAllowed: false"]}," in either complete request below with the following fields:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"QERDSEnrollmentAllowed\": true,\n  \"QERDSEnrollmentProfile\": \"<PROVISIONED_ENROLLMENT_PROFILE>\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This fragment is merged into the complete request; it is not a separate API call. Replace the profile placeholder with the actual site-configured profile for the intended variant and recipient. The site must have that profile configured before submission. If the integration also uses a provisioned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSIdentityTenant"]},", retain it in the same request. Do not copy a provider/profile or tenant identifier from another account's example."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The remaining qualified requirements still apply, including the Italian variant's legal-document pair and the appropriate PIN destination. A supplied profile is validated against the site even when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentAllowed"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the selected identification method is AML ID, both registration and identity reuse are limited to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]}," and to financial institutions with a specific agreement with Namirial. Enabling enrollment does not remove these conditions. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/dev/qerds-registration#aml-id-eligibility"},"children":["AML ID eligibility"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Successful matching enrollment during the same recipient session can give direct access. Failed enrollment or an identity that does not match the notice leaves access blocked until the issuer resolves the requirement. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/recipient/receive-evinotice#verify-your-identity-qerds-notices"},"children":["recipient identification flow"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"submit-a-spanish-variant-notice","__idx":8},"children":["Submit a Spanish-variant notice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example uses email notification and an already identified recipient. Replace the example contact details with those of an authorized test recipient whose verified identity is available to the configured service."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure the client certificate on the HTTPS connection, then send:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/EviNotice/Submit HTTP/1.1\nHost: api.ecertia.com\nAuthorization: Basic <base64(issuer-email:password)>\nContent-Type: application/json\nX-Evi-IdempotencyToken: 5f19c728-e17c-4f2e-86fd-b915523cbe02\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"LookupKey\": \"QERDS-ES-EXAMPLE-001\",\n  \"Subject\": \"Document available for review\",\n  \"Body\": \"<p>Please review the communication on this secure page.</p>\",\n  \"RecipientAddress\": \"recipient@example.com\",\n  \"RecipientDisplayName\": \"Example Recipient\",\n  \"IssuerLegalName\": \"Example Organisation\",\n  \"CertificationLevel\": \"QERDS_ES\",\n  \"RecipientLegalIdRequired\": true,\n  \"QERDSEnrollmentAllowed\": false,\n  \"NotificationChannels\": [\"Email\"],\n  \"DeliverySignMethod\": \"EmailPin\",\n  \"DeliverySignFixedEmail\": \"recipient@example.com\",\n  \"EvidenceAccessControlMethod\": \"Public\",\n  \"AffidavitKinds\": [\"SubmittedAdvanced\", \"Dispatched\", \"DeliveryResult\", \"Read\", \"Closed\"]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The recipient opens the email link and completes the identity confirmation and applicable notice-access steps. If no matching verified identity is available, this example does not enroll the recipient; the issuer must resolve that requirement."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"submit-an-italian-variant-notice","__idx":9},"children":["Submit an Italian-variant notice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example also uses an already identified recipient. The notification goes to email and the access PIN goes to mobile. This template uses the recipient's Italian Codice Fiscale (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TIN:IT"]},"). Replace the example contacts and placeholder with the matching data of the authorized recipient. Supply the valid 16-character Codice Fiscale corresponding to the verified identity; the service checks its format and checksum."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the same v2 endpoint and authentication setup as above, with a new idempotency token for this distinct notice:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"LookupKey\": \"QERDS-IT-EXAMPLE-001\",\n  \"Subject\": \"Document available for review\",\n  \"Body\": \"<p>Please review the communication on this secure page.</p>\",\n  \"RecipientAddress\": \"recipient@example.com\",\n  \"RecipientDisplayName\": \"Example Recipient\",\n  \"IssuerLegalName\": \"Example Organisation\",\n  \"CertificationLevel\": \"QERDS_IT\",\n  \"RecipientLegalIdRequired\": true,\n  \"RecipientLegalIdKind\": \"TIN:IT\",\n  \"RecipientLegalIdValue\": \"<RECIPIENT_CODICE_FISCALE>\",\n  \"QERDSEnrollmentAllowed\": false,\n  \"NotificationChannels\": [\"Email\"],\n  \"DeliverySignMethod\": \"MobilePin\",\n  \"DeliverySignFixedMobile\": \"+390000000000\",\n  \"EvidenceAccessControlMethod\": \"Public\",\n  \"AffidavitKinds\": [\"SubmittedAdvanced\", \"Dispatched\", \"DeliveryResult\", \"Read\", \"Closed\"]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The recipient needs access to both the notification email address and the configured mobile number. The issuer must have the Italian qualified configuration enabled before using this request. With this explicit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePin"]}," method and no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePinChannels"]},", PIN delivery defaults to three SMS attempt groups; see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/services/evinotice#mobile-pin-channels"},"children":["Mobile PIN channels"]}," to configure another enabled channel combination."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"store-the-submission-result","__idx":10},"children":["Store the submission result"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful new submission returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}," with the notice ID:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"Id\": \"9f3e1a02-b74c-4d8e-91c5-f00012345678\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Persist ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]},", your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]},", the environment and the idempotency token. Use the same token when retrying the same logical submission; a replay of a previously successful request returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]}," with the original response body."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]}," response means another submission with the same token is still in flight. Wait before retrying the same logical request with the same token; do not create a new token merely to bypass the conflict."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submission acceptance means the API accepted the notice. It does not establish that the recipient has completed identification, received the notification or read the content."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"follow-recipient-access-and-retrieve-evidence","__idx":11},"children":["Follow recipient access and retrieve evidence"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-operations-for-a-qualified-notice","__idx":12},"children":["API operations for a qualified notice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Qualified notices use the existing EviNotice v2 operations. The additional certificate prerequisite described in this guide applies to qualified Submit; it does not create separate QeRDS endpoints."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Main request fields and result"},"children":["Main request fields and result"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit one notice"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#submit-a-new-evinotice"},"children":["POST ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/EviNotice/Submit"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#qerds-request-fields"},"children":["qualified request fields"]}," apply alongside the generic request fields. A successful submission returns the notice ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve one notice"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#get-a-single-evinotice"},"children":["GET ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/EviNotice/{Id}"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supply the notice ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]},". Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAffidavits"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAttachments"]}," for the corresponding metadata."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find notices and track progress"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#query-multiple-evinotices"},"children":["POST ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/EviNotice/Query"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filters include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKeys"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LinkedId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["State"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome"]},", with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Limit"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cursor"]}," for pagination. The response contains ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cursor"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Results"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request additional evidence"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#request-an-on-demand-affidavit"},"children":["POST ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/EviNotice/Affidavits/Request"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supply the notice ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]},"; optional flags are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeBody"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAttachments"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeEvents"]},". The original submission must include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]},", and the notice must still be eligible. The response's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequestId"]}," identifies the generation request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Download one affidavit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#download-one-affidavit"},"children":["GET ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/EviNotice/Affidavits/{Id}"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supply the affidavit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]},", not the notice ID. Returns a PDF."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Download all notice affidavits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#download-all-affidavits"},"children":["GET ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/EviNotice/{Id}/Affidavits"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supply the notice ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]},". Returns the available affidavits in a ZIP archive."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Download notice attachments"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#download-all-attachments"},"children":["GET ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/EviNotice/{Id}/Attachments"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supply the notice ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]},". Returns the attachments in a ZIP archive."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get and Query use their own response schemas; they do not echo all Submit settings. In particular, the v2 responses do not return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentAllowed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentProfile"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSIdentityTenant"]}," or the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalId*"]}," settings. Keep the submitted configuration in your integration if you need it later. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/oas/evinotice-api"},"children":["complete request and response schemas"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The separate ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/dev/qerds-registration#availability-and-prerequisites"},"children":["recipient registration API"]}," is an enrollment interface, not an additional step required for every Submit call. Confirm whether that workflow applies to your integration before using it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table covers single-notice operations. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#batch-operations"},"children":["Batch resources"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/downloads-api"},"children":["shared ID-based downloads"]}," have separate references; the qualified examples in this guide do not validate a batch-submission workflow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"track-recipient-access-and-evidence","__idx":13},"children":["Track recipient access and evidence"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The recipient opens the notification link, completes the required identity steps and accepts any pending QeRDS service terms/privacy conditions. Existing identities and new enrollment have different paths; see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/recipient/receive-evinotice#verify-your-identity-qerds-notices"},"children":["How a recipient receives an EviNotice"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/dev/callbacks"},"children":["callbacks"]}," if your application needs asynchronous updates. Configure a reachable callback URL and the events your process consumes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reconcile the notice using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#get-a-single-evinotice"},"children":["Get"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#query-multiple-evinotices"},"children":["Query"]},". Keep notification delivery, hosted-notice access and reading distinct when interpreting progress."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve affidavit metadata and download the available evidence using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#download-all-affidavits"},"children":["EviNotice API reference"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/user-guides/evidences-affidavits"},"children":["Evidence and affidavits"]}," for interpretation."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API reference documents Basic authentication for Get, Query and evidence downloads. The additional client-certificate prerequisite described here is for qualified Submit; confirm any environment-specific connection requirements with Namirial during provisioning."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resolve-prerequisite-failures","__idx":14},"children":["Resolve prerequisite failures"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Check"},"children":["Check"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to verify"},"children":["What to verify"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificate authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The supplied certificate is configured on the HTTPS client for the intended environment and associated with the issuer/site."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificate and issuer mismatch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The certificate's email matches the account used in Basic authentication."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Qualified variant unavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The issuer is identity-verified, its legal-document kind is eligible for QeRDS, and its identity-verification configuration includes the selected variant, for both ES and IT."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Affidavit kinds rejected"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubmittedAdvanced"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CompleteAdvanced"]},", in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Evidence access rejected"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceAccessControlMethod: Public"]}," explicitly."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Commitment comments rejected"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Keep comments disabled for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptOrReject"]},"; use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Reject"]}," when collecting comments or rejection reasons."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enrollment unavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enrollment is enabled in the request when needed and the selected profile is configured on the site."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identity or document mismatch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact details, document kind/value and any supplied identity tenant refer to the intended verified recipient."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PIN destination"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The destination follows the ES same-channel or IT cross-channel requirements."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the returned Problem+JSON details and request ID when investigating an error. For response formats and shared handling, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/apis/evinotice-api#error-responses"},"children":["EviNotice API errors"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/dev/error-handling"},"children":["Error handling"]},"."]}]},"headings":[{"value":"Integrate QeRDS notices","id":"integrate-qerds-notices","depth":1},{"value":"Prepare the integration","id":"prepare-the-integration","depth":2},{"value":"Use the correct environment and authentication","id":"use-the-correct-environment-and-authentication","depth":2},{"value":"Configure a PKCS#12 certificate","id":"configure-a-pkcs12-certificate","depth":3},{"value":"Choose the variant and recipient path","id":"choose-the-variant-and-recipient-path","depth":2},{"value":"QeRDS request fields","id":"qerds-request-fields","depth":2},{"value":"Select the identity tenant","id":"select-the-identity-tenant","depth":3},{"value":"Enable recipient enrollment","id":"enable-recipient-enrollment","depth":3},{"value":"Submit a Spanish-variant notice","id":"submit-a-spanish-variant-notice","depth":2},{"value":"Submit an Italian-variant notice","id":"submit-an-italian-variant-notice","depth":2},{"value":"Store the submission result","id":"store-the-submission-result","depth":2},{"value":"Follow recipient access and retrieve evidence","id":"follow-recipient-access-and-retrieve-evidence","depth":2},{"value":"API operations for a qualified notice","id":"api-operations-for-a-qualified-notice","depth":3},{"value":"Track recipient access and evidence","id":"track-recipient-access-and-evidence","depth":3},{"value":"Resolve prerequisite failures","id":"resolve-prerequisite-failures","depth":2}],"frontmatter":{"title":"Integrate QeRDS notices","description":"Prepare qualified EviNotice submission, supply the required certificate and recipient data, and follow the notice through access and evidence retrieval.","layout":"doc","outline":"deep","keywords":["QeRDS","QERDS_ES","QERDS_IT","evinotice api","client certificate","recipient identification","namirial notify"],"seo":{"title":"Integrate QeRDS notices"}},"lastModified":"2026-11-06T12:27:17.000Z","isTranslationFallback":true,"pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/namirialnotify/dev/qerds-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}