---
title: "Finalizar Assinatura CMS/CAdES - V2 Assíncrono Compliance FW2"
method: POST
path: "/fw/v2/cms/pkcs1/assinaturas/acoes/finalizar"
tags: ["Assinador CMS"]
---

# Finalizar Assinatura CMS/CAdES - V2 Assíncrono Compliance FW2

`POST /fw/v2/cms/pkcs1/assinaturas/acoes/finalizar`

## Request

- Base URL: `https://cloud-hom.bry.com.br`
- URL: `https://cloud-hom.bry.com.br/fw/v2/cms/pkcs1/assinaturas/acoes/finalizar`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/docs/fw/v2/cms/pkcs1/assinaturas/acoes/finalizar/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body `multipart/form-data`

- object
  - `certificate` string, required: Certificado do signatário [chave pública do certificado codificada em Base64].
  - `returnType` string: Define o tipo de retorno da requisição. LINK retorna uma resposta JSON, a qual possui links para downloads dos arquivos assinados. BASE64 retorna uma lista com arquivos assinados, codificados em Base64. Caso LINK, o arquivo será excluído da cache após o download. Default: BASE64.
  - `attached` string, required: Define se o documento original deve ou não ser anexado na estrutura da assinatura digital. [Valores disponíveis: true ou false].
  - `hashAlgorithm` string, required: Algoritmo de HASH. [Valores disponíveis: SHA1, SHA256, SHA512]
  - `profile` string, required: Tipo de perfil desejado para a assinatura a ser gerada. [Valores disponíveis: BASIC, COMPLETE, ADRB, ADRT, ADRV, ADRC, ADRA, ETSI_B, ETSI_T, ETSI_LT, ETSI_LTA]
  - `nonce` string, required: Nonce da Requisição. Nonce de Requisição é um número qualquer para identificação do lote de itens para serem assinados.
  - `operationType` string, required: Tipo de Operação. [Valores disponíveis: SIGNATURE, CO_SIGNATURE]
  - `finalizations[0][document]` string, binary, required: Documento original, em qualquer formato, que será assinado (tamanho máximo do arquivo: 100 MB). Formato do documento: qualquer formato. Caso efetue o envio dos documentos em formato hash, este parâmetro não deve ser utilizado. Para lotes, basta incrementar o valor do índice, por ex: originalDocuments[1][content], originalDocuments[2][content]
  - `finalizations[0][hash]` string: Hash do documento original (formato na base hexadecimal). Esse parâmetro é o recomendado a ser utilizado, pois melhora o desempenho e evita tráfego desnecessário do conteúdo do documento. Para lotes, basta incrementar o valor do índice, por ex: originalDocuments[1][hash], originalDocuments[2][hash]
  - `finalizations[0][nonce]` string, required: Nonce da assinatura. Nonce é um número qualquer para identificação do item dentro de um lote, que é retornado na resposta.
  - `finalizations[0][signatureValue]` string, required: Conteúdo Base64 da Assinatura [Assinatura ou co-assinatura]. Valor correspondente ao signedAttributes cifrado com a chave privada, por exemplo, via BRy Extension, e codificado em Base64).
  - `finalizations[0][signedAttributes]` string, required: Conteúdo Base64 dos atributos assinados SignedAttributes [Assinatura ou co-assinatura] retornados na Inicialização da assinatura.
  - `finalizations[0][signature]` string, binary: O arquivo de assinatura digital, quando a operação ser feita for Co-Assinatura.
  - `oidPolitica` string: Quando enviado, este parâmetro define o OID da política de assinatura a ser usada com perfil de assinatura selecionado.

## Response `200`

- union
  - object
    - `identificador` string: Identificador da requisição
    - `quantidadeAssinaturas` integer: Numero de documentos da requisição
    - `documentos` object[]
      - `nonce` integer: Nonce do documento, se enviado na requisição
      - `hash` string: Hash do documento
      - `nomeArquivo` string: Nome do documento
      - `links` object[]
        - `rel` string
        - `href` string: Link para recuperar documento assinado
  - object
    - `nonce` string, required: Nonce da requisição. Nonce é um número qualquer para identificação da requisição.
    - `signatures` object[], required: Conjunto de objetos JSON contendo seus respectivos nonces enviados na requisição e as assinaturas digitais em formato base64.
      - `nonce` string, required: Nonce do documento.
      - `content` string, required: Conteúdo gerado pela operação.

## Other responses

- `400`: Resposta de erro da aplicação
- `default`: Para mais detalhes sobre as Respostas: [link para as respostas de erro](/openapi/assinadoresCms.html) ou [no formato properties](/openapi/assinadoresCmsErrors.properties)

---

[API](https://skmtc.dev/bry/apis/bry-easy-sign-api-rest.md) - [All operations](https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/llms.txt) - [OpenAPI document](https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/revisions/c87e026e87ac?raw)