Registrar Endosso-Substabelecimento

POST

https://app.qescritural.com.br/api/bookkeeping/integration/v1/{tenantId}/act/mandate/subdelegation

Nesta API, você registra um endosso‑substabelecimento em duplicatas, permitindo que o endossante subdelegue a outro agente a gestão e representação do título, transferindo a responsabilidade de cobrança ou negociação para um novo agente. Na requisição, informe o tenantId e, no corpo, os dados do titular (CPF/CNPJ, nome, tipo de titularidade), um identificador da operação e o código IPOC, se houver, junto com as datas de vigência, os valores total e de garantia, e as informações do submandato, do endossante e do novo agente. Inclua também a lista de duplicatas (pelos UIDs) e o documento do sacado. O sistema valida e registra o substabelecimento, atualizando as duplicatas e preservando a trilha de auditoria.

Checklist de uso da API

Realizei login

Estou com Bearer Token atualizado

Tenho tenantId da minha conta

Tenho as informações da duplicata

Tenho as informações do substabelecido

Envio a requisição com as informações abaixo

Requisição

Authorization

Bearer Token

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200OK

application/json

Body

🟠400Erro de validação

🟠401Não autorizado

🟠403Acesso negado

🔴500Erro interno do servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.qescritural.com.br/api/bookkeeping/integration/v1/83696183000159/act/mandate/subdelegation' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ownershipType": "drawer",
    "ownershipIdentification": "16008054938",
    "ownershipLegalName": "Isabel Camila Elza Sales",
    "certificateNegotiationReference": "FB8D6B18-F18F-471A-8A57-02DF71284489",
    "creditOperationIdentifier": "IPOC000001234567890ABCDEFGHIJKLMNPQRSTVWXYZ1234567890ABCDEFGHIJKLMNPQRSTV",
    "startDate": "2025-11-12T12:30:12.000Z",
    "endDate": "2025-11-12T12:30:12.000Z",
    "totalAmount": 32525325.3,
    "guaranteedAmount": 12421421.34,
    "mandateSubdelegation": {
        "endorser": {
            "identification": "88414906249",
            "legalName": "Ruan Roberto Pietro Porto",
            "email": "ruan.roberto.porto@gmail.com",
            "signature": "f5a18f9952e6953141539b6e69b4d79958cf0e75566f3489281496b27393686c",
            "signatureType": "Assinatura Eletrônica",
            "signatureDate": "2025-11-12T12:30:12.000Z"
        },
        "subDelegatedAgent": {
            "identification": "10778936988",
            "legalName": "Vitor Manoel Porto",
            "email": "vitor_manoel_porto@gmail.com"
        }
    },
    "actReceivables": [
        {
            "drawerIdentification": "00941170047",
            "tradeReceivableCertificateUniqueIdentifications": [
                "J7284200025185A4EJZZ"
            ]
        }
    ]
}'

Response Example

200 - Success

{
    "title": "One or more validation errors occurred.",
    "status": 400,
    "errors": {
        "Email": [
            "The Email field is required."
        ]
    }
}

Página anterior

Registrar Endosso-Mandato

Registrar Endosso-Substabelecimento

Checklist de uso da API#

Requisição

Respostas

Checklist de uso da API