Envio de Garantia na Operação

Este endpoint permite a adição de garantias (collateral) a uma operação de Debênture. A garantia é submetida para assinatura junto com os documentos da operação. Cada tipo de garantia (collateral_type) possui suas próprias regras de documentos obrigatórios, listadas abaixo.

Origem do document_key

Os campos collateral_document_key e document_key (em additional_documents) referenciam documentos previamente enviados. Cada chave é obtida no endpoint Envio de documento (POST /debenture/upload), que recebe o arquivo em Base64 e retorna o document_key correspondente.

Request

ENDPOINT

/debenture/operation/OPERATION-KEY/collateral

MÉTODO

POST

Path Params

Campo	Tipo	Descrição	Caracteres
`OPERATION-KEY` *	string	Chave única da operação (UUID v4).	36

Tipos de garantia

aviso

Documentos marcados como obrigatórios são exigidos para o respectivo tipo de garantia.

Alienação fiduciária de imóvel (`fiduciary_alienation_property`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "fiduciary_alienation_property",
    "additional_documents": [
        { "document_type": "property_appraisal_report", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "property_registration_updated", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "property_full_content_certificate", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`property_appraisal_report`	Laudo de avaliação do imóvel.	Sim
`property_registration_updated`	Matrícula atualizada.	Sim
`property_full_content_certificate`	Certidão de inteiro teor da matrícula.	Sim
`property_insurance_policy`	Apólice de seguro (se exigível no contrato).	-
`others`	Outros documentos.	-

Alienação fiduciária de veículo (`fiduciary_alienation_vehicle`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "fiduciary_alienation_vehicle",
    "additional_documents": [
        { "document_type": "vehicle_appraisal_report", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "vehicle_inspection_report", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "vehicle_crv_certificate", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`vehicle_appraisal_report`	Laudo de avaliação do veículo ou Tabela FIPE.	Sim
`vehicle_inspection_report`	Laudo de vistoria.	Sim
`vehicle_crv_certificate`	CRLV atualizado.	Sim
`others`	Outros documentos.	-

Alienação fiduciária de aeronave (`fiduciary_alienation_aircraft`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "fiduciary_alienation_aircraft",
    "additional_documents": [
        { "document_type": "aircraft_certificate_anac", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "aircraft_rab_consult", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "aircraft_insurance_policy", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "aircraft_appraisal_report", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`aircraft_certificate_anac`	Certificado de matrícula - ANAC.	Sim
`aircraft_rab_consult`	Consulta no Registro Aeronáutico Brasileiro (RAB).	Sim
`aircraft_insurance_policy`	Apólice de seguro - beneficiário o fundo.	Sim
`aircraft_appraisal_report`	Laudo de avaliação da aeronave.	Sim
`others`	Outros documentos.	-

Alienação fiduciária de equipamentos/produtos/estoque (`fiduciary_alienation_equipment`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "fiduciary_alienation_equipment",
    "additional_documents": [
        { "document_type": "equipment_purchase_invoice", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "equipment_appraisal_report", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`equipment_purchase_invoice`	Nota fiscal de compra.	Sim
`equipment_appraisal_report`	Laudo de avaliação de equipamentos.	Sim
`equipment_insurance_policy`	Apólice de seguro de equipamentos (se exigível).	-
`fiduciary_depositary_declaration`	Declaração de fiel depositário.	-
`others`	Outros documentos.	-

Alienação fiduciária de obras de arte (`fiduciary_alienation_artwork`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "fiduciary_alienation_artwork",
    "additional_documents": [
        { "document_type": "artwork_appraisal_report", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "artwork_storage_certificate", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`artwork_appraisal_report`	Laudo de avaliação de obras de arte.	Sim
`artwork_storage_certificate`	Certificado de adequação do local de armazenamento.	Sim
`artwork_insurance_policy`	Apólice de seguro (se exigível).	-
`others`	Outros documentos.	-

Alienação fiduciária de títulos e valores mobiliários (`fiduciary_alienation_securities`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "fiduciary_alienation_securities",
    "additional_documents": [
        { "document_type": "securities_negotiation_block", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`securities_negotiation_block`	Bloqueio para negociação junto ao custodiante.	Sim
`securities_registration_gravame`	Registro do gravame.	-
`others`	Outros documentos.	-

Alienação fiduciária / penhor de ações e cotas (`fiduciary_assignment_shares`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "fiduciary_assignment_shares",
    "additional_documents": [
        { "document_type": "share_registration_book", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`share_registration_book`	Livro de registro de ações nominativas com anotação do gravame.	Sim
`others`	Outros documentos.	-

Hipoteca de imóveis (`mortgage_property`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "mortgage_property",
    "additional_documents": [
        { "document_type": "property_appraisal_report", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "property_registration", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "property_full_content_certificate", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`property_appraisal_report`	Laudo de avaliação do imóvel.	Sim
`property_registration`	Registro de propriedade atualizado.	Sim
`property_full_content_certificate`	Certidão de inteiro teor da matrícula.	Sim
`property_insurance_policy`	Apólice de seguro (se exigível no contrato).	-
`others`	Outros documentos.	-

Hipoteca de embarcações (`mortgage_ship`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "mortgage_ship",
    "additional_documents": [
        { "document_type": "ship_registration", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "ship_appraisal_report", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`ship_registration`	Registro de propriedade da embarcação atualizado.	Sim
`ship_appraisal_report`	Laudo de avaliação da embarcação.	Sim
`ship_insurance_policy`	Apólice de seguro da embarcação (se exigível).	-
`others`	Outros documentos.	-

Aval (`guarantor`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "guarantor",
    "additional_documents": [
        { "document_type": "guarantor_civil_status_declaration", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`guarantor_civil_status_declaration`	Declaração de estado civil do avalista.	Sim
`guarantor_personal_document`	Documento pessoal do avalista.	-
`guarantor_income_tax_declaration`	Declaração de imposto de renda do avalista.	-
`others`	Outros documentos.	-

Fiança (fiador) (`surety`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "surety",
    "additional_documents": [
        { "document_type": "surety_civil_status_declaration", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "surety_personal_document", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "surety_income_tax_declaration", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`surety_civil_status_declaration`	Declaração de estado civil do fiador.	Sim
`surety_personal_document`	Documento pessoal do fiador.	Sim
`surety_income_tax_declaration`	Declaração de imposto de renda do fiador.	Sim
`others`	Outros documentos.	-

Seguro (`insurance`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "insurance",
    "additional_documents": [
        { "document_type": "insurance_policy_endorsed", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "insurance_policy_with_expiration_and_renewal", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`insurance_policy_endorsed`	Apólice de seguro endossada.	Sim
`insurance_policy_with_expiration_and_renewal`	Apólice de seguro com vigência e renovação.	Sim
`others`	Outros documentos.	-

Monitoramento de garantias (`monitoring_guarantee`)

Request Body

{
    "collateral_document_key": "25dd10b8-7364-4abe-b0e8-0e419b04194b",
    "collateral_type": "monitoring_guarantee",
    "additional_documents": [
        { "document_type": "guarantee_contract", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" },
        { "document_type": "guarantee_agent_contract", "document_key": "1bffe8c6-0a54-4854-b693-745b3dba9e04" }
    ]
}

Tipos de documentos

Enum	Descrição	Obrigatório
`guarantee_contract`	Contrato de garantia.	Sim
`guarantee_agent_contract`	Contrato de agente de garantia.	Sim
`others`	Outros documentos.	-

Request Body Params

Campo	Tipo	Descrição	Obrigatório
`collateral_document_key` *	string	Chave do documento do instrumento de garantia.	Sim
`collateral_type` *	string	Tipo da garantia.	Enumeradores collateral_type
`additional_documents`	array	Documentos adicionais da garantia.	-

additional_documents

Campo	Tipo	Descrição	Obrigatório
`document_key` *	string	Chave do documento.	Sim
`document_type` *	string	Tipo do documento.	Sim

Enumeradores collateral_type

Enum	Descrição
`fiduciary_alienation_property`	Alienação fiduciária de imóvel.
`fiduciary_alienation_vehicle`	Alienação fiduciária de veículo.
`fiduciary_alienation_aircraft`	Alienação fiduciária de aeronave.
`fiduciary_alienation_equipment`	Alienação fiduciária de equipamentos/produtos/estoque.
`fiduciary_alienation_artwork`	Alienação fiduciária de obras de arte.
`fiduciary_alienation_securities`	Alienação fiduciária de títulos e valores mobiliários.
`fiduciary_assignment_shares`	Alienação fiduciária / penhor de ações e cotas.
`mortgage_property`	Hipoteca de imóveis.
`mortgage_ship`	Hipoteca de embarcações.
`guarantor`	Aval.
`surety`	Fiança (fiador).
`insurance`	Seguro.
`monitoring_guarantee`	Monitoramento de garantias.
`bank_surety`	Fiança bancária.
`fiduciary_assignment_credit_rights`	Cessão fiduciária de direitos creditórios.
`card_receivables`	Recebíveis de cartão.
`stock_guarantee`	Garantia de estoque.
`others`	Outras garantias.

Response

O corpo da resposta é um JSON completo da operação atualizada, com a nova garantia em collateral_list.

Request​

Path Params​

Tipos de garantia​

Alienação fiduciária de imóvel (fiduciary_alienation_property)​

Tipos de documentos​

Alienação fiduciária de veículo (fiduciary_alienation_vehicle)​

Tipos de documentos​

Alienação fiduciária de aeronave (fiduciary_alienation_aircraft)​

Tipos de documentos​

Alienação fiduciária de equipamentos/produtos/estoque (fiduciary_alienation_equipment)​

Tipos de documentos​

Alienação fiduciária de obras de arte (fiduciary_alienation_artwork)​

Tipos de documentos​

Alienação fiduciária de títulos e valores mobiliários (fiduciary_alienation_securities)​

Tipos de documentos​

Alienação fiduciária / penhor de ações e cotas (fiduciary_assignment_shares)​

Tipos de documentos​

Hipoteca de imóveis (mortgage_property)​

Tipos de documentos​

Hipoteca de embarcações (mortgage_ship)​

Tipos de documentos​

Aval (guarantor)​

Tipos de documentos​

Fiança (fiador) (surety)​

Tipos de documentos​

Seguro (insurance)​

Tipos de documentos​

Monitoramento de garantias (monitoring_guarantee)​

Tipos de documentos​

Request Body Params​

additional_documents​

Enumeradores collateral_type​

Response​

Request

Path Params

Tipos de garantia

Alienação fiduciária de imóvel (`fiduciary_alienation_property`)

Tipos de documentos

Alienação fiduciária de veículo (`fiduciary_alienation_vehicle`)

Tipos de documentos

Alienação fiduciária de aeronave (`fiduciary_alienation_aircraft`)

Tipos de documentos

Alienação fiduciária de equipamentos/produtos/estoque (`fiduciary_alienation_equipment`)

Tipos de documentos

Alienação fiduciária de obras de arte (`fiduciary_alienation_artwork`)

Tipos de documentos

Alienação fiduciária de títulos e valores mobiliários (`fiduciary_alienation_securities`)

Tipos de documentos

Alienação fiduciária / penhor de ações e cotas (`fiduciary_assignment_shares`)

Tipos de documentos

Hipoteca de imóveis (`mortgage_property`)

Tipos de documentos

Hipoteca de embarcações (`mortgage_ship`)

Tipos de documentos

Aval (`guarantor`)

Tipos de documentos

Fiança (fiador) (`surety`)

Tipos de documentos

Seguro (`insurance`)

Tipos de documentos

Monitoramento de garantias (`monitoring_guarantee`)

Tipos de documentos

Request Body Params

additional_documents

Enumeradores collateral_type

Response