跳到主要内容

Criação de Ativo — CTE

Endpoint para inserir um ativo do tipo CTE (Conhecimento de Transporte Eletrônico) em um lote de cessão. O CTE é um documento fiscal eletrônico que comprova a prestação de serviço de transporte, utilizado como direito creditório na operação de cessão.

Disponível em
PerfilHostPermissão exigida
Gestoramanager-apiEscrita
Consultoriaconsultant-apiLotes
Cedenteassignor-apiEscrita

URL base de cada host: Ambientes (Hosts).

Onde estou no fluxo?

Este é o 2º passo do fluxo de cessão. Antes, você deve ter criado o lote. Após inserir os ativos, envie os documentos exigidos e encerre a inserção.

Atenção

O campo external_id do direito creditório identifica o ativo dentro do lote e não deve ser confundido com o external_id do lote.

Request​

ENDPOINT
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}/asset
MÉTODO
POST
Request Body
{
    "asset_type": "cte",
    "total_purchase_value": 1231.21,
    "discounted_credit_right": {
        "external_id": "ccf6f331-d55f-46c0-a32f-fb909884dbb2",
        "originator_document_number": "22.333.444/0001-81",
        "maturity_date": "2023-12-10",
        "order_number": "18923619954796912",
        "face_value": 1023.01,
        "person_type": "legal_person",
        "borrower": {
            "name": "Transportadora Exemplo Ltda",
            "document_number": "11.222.333/0001-81",
            "person_type": "legal_person",
            "email": "contato@transportadora.com.br",
            "address": {
                "street": "Avenida Paulista",
                "number": "1000",
                "neighborhood": "Bela Vista",
                "city": "São Paulo",
                "postal_code": "01310-100",
                "uf": "SP",
                "country": "BRA"
            },
            "phone": {
                "area_code": "11",
                "number": "936360268"
            },
            "legal_person": {
                "activity_code": "49.30-2-01"
            }
        },
        "participant_control_number": "ICX841HWCPUGU4U101XPLDW8D",
        "bankslip": {
            "our_number": {
                "number": 2,
                "digit": "P"
            }
        },
        "delay": {
            "fine": {
                "fine_type": "percentage",
                "percentage_value": 0.0
            },
            "interest": {
                "method": "pre_fixed",
                "pre_fixed": {
                    "daily_rate": 0.0,
                    "calendar_base": "calendar_360"
                }
            }
        },
        "invoice": {
            "access_key": "35231011222333000181570010000000011892361995",
            "total_value": 1231.21,
            "serie": "001",
            "number": "958431587",
            "issue_date": "2023-10-10"
        }
    }
}

Atributos do body​

CampoTipoObrigatoriedadeDescrição
asset_typestringobrigatórioTipo do ativo. Para CTE, informar cte.
total_purchase_valuenumberobrigatórioValor total da compra do ativo — efetivamente quanto o cessionário vai pagar. Até 2 casas decimais.
discounted_credit_rightobjectobrigatórioDados do direito creditório. Veja Atributos de discounted_credit_right.

Atributos de discounted_credit_right​

CampoTipoObrigatoriedadeDescrição
external_idstringobrigatórioChave única de identificação deste ativo no sistema do parceiro. Máximo de 50 caracteres.
originator_document_numberstringobrigatórioCPF ou CNPJ formatado (000.000.000-00 ou 00.000.000/0000-00) do originador que viabilizou a operação. Precisa estar cadastrado na QI Tech; caso contrário, devolve TRC000019.
maturity_datestringobrigatórioData de vencimento no formato YYYY-MM-DD.
order_numberstringobrigatórioNúmero do pedido. Máximo de 45 caracteres. Sem ele, a inserção devolve TRC000078.
face_valuenumberobrigatórioValor de face. Até 8 casas decimais.
person_typestringopcionalTipo de pessoa do sacado (natural_person ou legal_person).
borrowerobjectobrigatórioDados do sacado. Consulte os Atributos de borrower na página de Criação de Ativo — CCB.
invoiceobjectobrigatórioDados do CT-e. Veja Atributos de invoice. Sem ele, a inserção devolve TRC000075. Não envie o objeto contract neste tipo de ativo (TRC000076).
participant_control_numberstringopcionalNúmero de controle do participante no sistema do parceiro. Máximo de 25 caracteres alfanuméricos.
bankslipobjectopcionalDados do boleto. Veja Atributos de bankslip.
delayobjectopcionalDados de multa e juros por atraso. Veja Atributos de delay.

Atributos de invoice​

CampoTipoObrigatoriedadeDescrição
access_keystringobrigatórioChave de acesso do CT-e. 44 caracteres. As posições 21 e 22 da chave precisam ser o modelo do documento (57 ou 67).
total_valuenumberopcionalValor total do CT-e. Até 2 casas decimais.
seriestringobrigatórioNúmero de série do CT-e. Máximo de 3 caracteres.
numberstringobrigatórioNúmero do CT-e. Máximo de 9 caracteres.
issue_datestringobrigatórioData de emissão no formato YYYY-MM-DD.

Atributos de bankslip​

CampoTipoObrigatoriedadeDescrição
our_numberobjectopcionalDados do nosso número. Aplicável apenas quando o nosso número é emitido pelo cliente. Veja Atributos de our_number.

Atributos de our_number​

CampoTipoObrigatoriedadeDescrição
numbernumberobrigatórioNosso número. Número bancário para cobrança com registro. 1 a 11 caracteres numéricos.
digitstringobrigatórioDígito verificador de auto conferência do nosso número. 1 caractere alfanumérico.

Atributos de delay​

CampoTipoObrigatoriedadeDescrição
fineobjectobrigatórioDados da multa por atraso. Veja Atributos de fine.
interestobjectobrigatórioDados do juros de mora. Veja Atributos de interest.

Quando enviar delay, informe fine e interest. Este objeto vale para todos os direitos creditórios (duplicatas e CT-e).

Atributos de fine​

CampoTipoObrigatoriedadeDescrição
fine_typestringobrigatórioTipo da multa.
percentage_valuenumbercondicionalValor da multa quando fine_type for percentage. De 0 a 1, representando 0% a 100%. Até 2 casas decimais.
amountnumbercondicionalValor fixo da multa quando fine_type for fixed. Até 2 casas decimais.

Enumeradores de fine_type:

ValorDescrição
percentageMulta percentual sobre o valor da parcela.
fixedValor fixo de multa.

Atributos de interest​

CampoTipoObrigatoriedadeDescrição
methodstringobrigatórioMétodo do juros de mora.
pre_fixedobjectobrigatórioDados da taxa pré-fixada. Veja Atributos de pre_fixed.

Enumeradores de method:

ValorDescrição
compoundJuros de mora composto.
simpleJuros de mora simples.
pre_fixedJuros de mora pré-fixado.

Atributos de pre_fixed​

CampoTipoObrigatoriedadeDescrição
daily_ratenumbercondicionalTaxa diária. Para 1%, informar 0.01. Informe daily_rate ou monthly_rate.
monthly_ratenumbercondicionalTaxa mensal. Para 1%, informar 0.01. Informe daily_rate ou monthly_rate.
calendar_basestringobrigatórioBase de cálculo utilizada.

Enumeradores de calendar_base:

ValorDescrição
workdaysBase de cálculo em dias úteis (252).
calendar_365Base de cálculo em 365 dias.
calendar_360Base de cálculo em 360 dias.

Response​

STATUS
201
Response Body
{
    "asset_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "ccf6f331-d55f-46c0-a32f-fb909884dbb2",
    "status": "pending_eligibility"
}

Atributos da resposta​

CampoTipoDescrição
asset_keystringIdentificador único do ativo gerado pela QI Tech (UUID).
external_idstringA mesma chave externa fornecida no campo external_id do discounted_credit_right.
statusstringStatus inicial do ativo. Sempre retorna pending_eligibility, indicando que o ativo foi inserido e aguarda análise de elegibilidade.

Erros​

StatusCódigoQuando acontece
400QIT000001O request body não segue o formato esperado: campo obrigatório ausente, tipo ou formato inválido. A description aponta o campo.
404TRC000018Não existe lote com esse assignment_external_id nesta configuração de cessão.
400TRC000025O asset_type é diferente do tipo de ativo da configuração de cessão.
400TRC000022O lote não aceita mais ativos: a inserção já foi encerrada. Para incluir mais, reabra o lote.
400TRC000009CPF ou CNPJ inválido em originator_document_number ou no document_number de um sacado pessoa física.
404TRC000019Não há originador cadastrado com o originator_document_number informado. Apesar do título (Originator bond not found), o erro não se refere ao vínculo com a configuração.
400TRC000078order_number ausente.
400TRC000075Objeto invoice ausente.
400TRC000076Objeto contract enviado num CT-e.
400TRC000134invoice.access_key ausente.
400TRC000133invoice.access_key não é de um CT-e (modelo 57 ou 67 nas posições 21 e 22).
409TRC000054Já existe um ativo com esse external_id neste lote.
409TRC100026Já existe um direito creditório com esse external_id para o mesmo cedente na carteira do fundo.
400TRC1000xxA validação financeira do ativo recusou o payload. Exemplo: TRC100017 (409), o fundo não compra ativos vencidos.

O corpo de erro segue o formato abaixo:

{
  "title": "Already Exist This External Id",
  "description": "Already exist an asset with this External Id and asset_key->41d6ff41-1dac-4df7-9e50-d15210ec57f3",
  "translation": "Ja existe um ativo com esse External Id e asset_key->41d6ff41-1dac-4df7-9e50-d15210ec57f3",
  "code": "TRC000054"
}

Em caso de erro, reenvie a requisição. Duplicidade (TRC000054) significa que o recurso já existe: consulte-o em vez de recriar, pelo endpoint de consulta de ativo. Mais em Reenvio e duplicidade.

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

Próximos passos​

Após inserir o ativo, o fluxo continua com:

  1. Envio dos documentos — envie a documentação exigida para cada ativo aprovado na elegibilidade.
  2. Encerramento da inserção — sinalize que todos os ativos foram inseridos para que o lote siga para a análise de elegibilidade.