Registrar Endosso-Mandato

POST

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

Nesta API, você registra um endosso‑mandato em duplicatas, permitindo que um mandatário atue em nome do titular para cobrança ou negociação, podendo delegar a gestão das duplicatas, especificando o tipo de mandato (cobrança, negociação ou ambos). Na requisição, você deve informar o tenantId e, no corpo, os dados do titular (CPF/CNPJ e nome), o tipo de titularidade, um identificador único da operação e o código IPOC(se houver).
Inclua as datas de início e de fim de vigência, os valores total e de garantia, o tipo de mandato e as informações do endossante e do agente mandatário. Indique também as duplicatas abrangidas (pelos UIDs) e o CPF/CNPJ do sacado. O sistema valida os dados e registra o mandato, atualizando as duplicatas conforme a autorização dada.

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 mandatário

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 ********************

or

Parâmetros de Caminho

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200OK

application/json

OK

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' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ownershipType": "drawer",
    "ownershipIdentification": "86649606154",
    "ownershipLegalName": "Luciana Joana Liz Oliveira",
    "certificateNegotiationReference": "FB8D6B18-F18F-471A-8A57-02DF71284489",
    "creditOperationIdentifier": "IPOC000001234567890ABCDEFGHIJKLMNPQRSTVWXYZ1234567890ABCDEFGHIJKLMNPQRSTV",
    "startDate": "2025-11-12T12:30:12.000Z",
    "endDate": "2025-11-12T12:30:12.000Z",
    "totalAmount": 124124.5,
    "guaranteedAmount": 124523523.43,
    "mandate": {
        "mandateType": "COBR",
        "endorser": {
            "identification": "63515826360",
            "legalName": "Malu Cecília Isabela Sales",
            "email": "malu_cecilia_sales@gmail.com",
            "signature": "f5a18f9952e6953141539b6e69b4d79958cf0e75566f3489281496b27393686c",
            "signatureType": "ASDG",
            "signatureDate": "2025-11-12T12:30:12.000Z"
        },
        "delegatedAgent": {
            "identification": "06563852009",
            "legalName": "Luan Heitor Monteiro",
            "email": "luan-monteiro79@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

Próxima página

Registrar Endosso-Substabelecimento