Remoção de Ativos do Lote

Para retirar um ativo de um lote antes da aprovação, atualize o status do ativo para denied. O ativo deixa de compor o lote e seu valor sai do total da cessão. Se for preciso também incluir ativos, reabra o lote, ajuste os ativos e encerre a inserção de novo.

Quando cada perfil pode remover ativos

O ativo precisa estar em pending_eligibility, pending_invoice_validation, pending_documentation ou pre_approved. O lote precisa estar num destes status:

Perfil	Status do lote em que pode remover ativos
Gestora	pending_assets_insertion, completed_assets_insertion, pending_consultant_approval, pending_manager_approval
Consultoria	pending_assets_insertion, completed_assets_insertion, pending_consultant_approval
Cedente	pending_assets_insertion, completed_assets_insertion

A gestora remove ativos de um lote em pending_manager_approval sem reabri-lo e depois aprova o lote.

Remover um ativo

Faça uma requisição para cada ativo a ser removido.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Lotes
Cedente	assignor-api	Escrita

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}/asset/{asset_external_id}

MÉTODO

PUT

Path params

Parâmetro	Tipo	Descrição
assignment_external_id	string	O external_id do lote.
asset_external_id	string	O external_id do ativo que será removido.

Request Body

{
    "asset_status": "denied",
    "denial_reason": {
        "reason_type": "manager",
        "denial_reason": "Sacado fora da política do fundo"
    }
}

Atributos do body

Campo	Tipo	Obrigatoriedade	Descrição
asset_status	string	obrigatório	Único valor aceito: denied.
denial_reason	object	opcional	Motivo da remoção: reason_type (obrigatório dentro do objeto; use manager, consultant ou assignor) e denial_reason (texto livre). Sem esse objeto, a origem registrada é o seu perfil.

Response

STATUS

200

A resposta é o ativo atualizado, no mesmo formato de cada item da Consulta de Ativos do Lote, com o objeto da operação (credit_operation, discounted_credit_right ou contract). Trecho:

Response Body (trecho)

{
    "asset_key": "f4348106-01c4-4c59-a261-7c09db811c47",
    "external_id": "9eec85be-97c9-41e0-88b3-b17a39869b36",
    "total_purchase_value": 1231.21,
    "asset_type": "ccb",
    "status": "denied",
    "denied_by": "manager",
    "denial_reason": "Sacado fora da política do fundo"
}

Reabrir e encerrar o lote

Para incluir novos ativos num lote que já teve a inserção encerrada, reabra-o com pending_assets_insertion, insira ou remova os ativos e encerre de novo com completed_assets_insertion. Depois de encerrado, o lote passa outra vez pela elegibilidade e pelas aprovações.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Lotes
Cedente	assignor-api	Escrita

URL base de cada host: Ambientes (Hosts).

O lote pode ser reaberto quando está em completed_assets_insertion, pending_consultant_approval ou pending_manager_approval. A consultoria não reabre lotes em pending_manager_approval.

Request

ENDPOINT

/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}

MÉTODO

PUT

Request Body — reabrir

{
    "assignment_status": "pending_assets_insertion"
}

Campo	Tipo	Obrigatoriedade	Descrição
assignment_status	string	obrigatório	pending_assets_insertion para reabrir. Para encerrar de novo, envie completed_assets_insertion — veja Encerrar Inserção de Ativos.

Response

STATUS

200

Response Body

{
    "assignment_key": "8e515a17-8b4d-49a3-aed6-47c9574e426a",
    "external_id": "9eec85be-97c9-41e0-88b3-b17a39869b36",
    "status": "pending_assets_insertion",
    "number_of_approved_assets": 0,
    "assignment_total_value": 1234.99
}

Campo	Tipo	Descrição
assignment_key	string	Identificador único do lote (UUID).
external_id	string	Chave externa do lote fornecida pelo parceiro.
status	string	Novo status do lote: pending_assets_insertion.
number_of_approved_assets	integer	Sempre 0 nesta chamada.
assignment_total_value	number	Último valor total calculado para o lote, em reais. É recalculado no próximo encerramento.

Erros

Status	Código	Quando acontece
400	TRC000086	O ativo não está em pending_eligibility, pending_invoice_validation, pending_documentation ou pre_approved (por exemplo, já reprovado ou formalizado).
400	TRC000023	asset_status diferente de denied, ou assignment_status com valor não aceito.
400	TRC000087	O status do lote não permite que o seu perfil remova ativos ou reabra o lote (veja as tabelas acima).
400	TRC000024	Reabertura pedida para um lote que não está em completed_assets_insertion, pending_consultant_approval ou pending_manager_approval.
404	TRC000018	Nenhum lote com esse external_id nesta configuração de cessão.
404	TRC000020	Nenhum ativo com esse asset_external_id no lote.

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