Enviar Boletim de Subscrição Assinado

---

Introdução

Este recurso tem como objetivo nos enviar a comprovação de assinatura do boletim de subscrição de um investidor a uma oferta de cotas de um fundo.

Atenção

Este recurso está disponível apenas para integrações que exercem o papel de Distribuidor. Use a chave de API e o host do perfil Distribuidor: veja Ambientes (Hosts).

Input / Output:

Como input devem ser enviadas as informações da subscrição, o UUID da oferta de cotas que o investidor subscreveu, o método de assinatura e, dependendo do método, o conteúdo necessário para validação. Segue abaixo exemplo.

Como output será entregue o objeto completo do boletim de subscrição criado, incluindo a subscription_note_key, que identifica o boletim. O boletim é criado já no status active (ou sold_off, se remaining_subscription_note_value for zero).

Request

ENDPOINT

/quota_offering_control/investor/INVESTOR_KEY/signed_subscription_note

MÉTODO

POST

STATUS

201

Request body

Request Body

{
  "number_of_quotas": 500.0,
  "original_subscription_note_value": 50000.00,
  "start_date": "2026-01-15",
  "maturity_date": "2026-12-31",
  "quota_offering_key": "UUID",
  "transaction_type": "ted",
  "signature_method": "opt_in",
  "opt_in_hash" : "OPT_IN_HASH"
}

Campo	Tipo	Descrição	Obrigatório
original_subscription_note_value	number	Valor do boletim. Mínimo 0. Não pode exceder o valor restante da oferta	Sim
quota_offering_key	string	UUID da oferta de cotas. A oferta deve estar active, com valor restante e sem aditamento pendente	Sim
transaction_type	string	ted ou b3	Sim
signature_method	string	Método de assinatura usado. Com opt_in, envie opt_in_hash; com qualquer outro método, envie document_b64	Sim
opt_in_hash	string	Hash do opt-in (até 250 caracteres)	Não
document_b64	string	Boletim assinado codificado em base64	Não
number_of_quotas	number	Quantidade de cotas do boletim	Não
remaining_subscription_note_value	number	Saldo restante do boletim. Não pode ser maior que original_subscription_note_value	Não
start_date	string	Data inicial (YYYY-MM-DD). Se omitida, usa a data atual (UTC)	Não
maturity_date	string	Data de vencimento (YYYY-MM-DD). Não pode estar no passado	Não

Atenção

Durante o processo de integração será exigido um meio de autenticação da hash enviada.

Response

A resposta tem o mesmo formato da resposta de Solicitar Boletim de Subscrição.

Erros

Status	Código	Quando acontece
400	QOF000020	maturity_date está no passado
400	QOF000026	O valor do boletim é maior que o valor restante da oferta
400	QOF000046	transaction_type inválido
400	QOF000047	A classificação do investidor não permite subscrever a oferta
400	QOF000068	signature_method inválido
400	QOF000069	signature_method é opt_in e opt_in_hash não foi enviado
400	QOF000072	signature_method não é opt_in e document_b64 não foi enviado
400	QOF000150	remaining_subscription_note_value é maior que original_subscription_note_value
400	QIT000004	A integração não é a distribuidora do investidor
404	QOF000017	Investidor não encontrado
404	QOF000019	Oferta de cotas não encontrada
404	QOF000039	A oferta não está ativa, está vencida ou não tem valor restante
409	QOF000152	A oferta tem um aditamento aguardando aprovação

Erros de autenticação, permissão e host: veja Erros da API.