Registrar Endosso

POST

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

Nesta API, você registra o endosso de duplicatas, transferindo os direitos de crédito para um novo titular. Para isto, informe o tenantId e indique se a titularidade pertence ao sacador (drawer) ou ao portador (holder), incluindo CPF/CNPJ e nome legal. Adicione um identificador único de operação, as datas de vigência e os valores (total e garantia). Se houver coobrigação, forneça os dados de endossante e endossatário e liste os UIDs das duplicatas e o documento (CPF/CNPJ) do sacado. O sistema validará e registrará o endosso, atualizando as duplicatas no sistema.

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

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/endorsement' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ownershipType": "drawer",
    "ownershipIdentification": "58149158383",
    "ownershipLegalName": "Natália Lúcia Isabel Moura",
    "certificateNegotiationReference": "77E81108-3C51-4D0B-8C18-DD8A301175DA",
    "creditOperationIdentifier": "IPOC000001234567890ABCDEFGHIJKLMNPQRSTVWXYZ1234567890ABCDEFGHIJKLMNPQRSTV ",
    "startDate": "2025-11-12T12:30:12.000Z",
    "endDate": "2025-11-12T12:30:12.000Z",
    "totalAmount": 21421421.12,
    "guaranteeAmount": 235235235.34,
    "endorsement": {
        "cosigningIndicator": false,
        "endorser": {
            "identification": "29741457014",
            "legalName": "Diogo Martin Danilo Moraes",
            "email": "diogo_martin_moraes@gmail.com",
            "signature": "A591A6D40BF420404A011733CFB7B190D62C65BF0BCDA32B57B277D9AD9F146E ",
            "signatureType": "ASDG",
            "signatureDate": "2025-11-12T12:30:12.000Z"
        },
        "endorsee": {
            "identification": "83053733633",
            "legalName": "Ryan Julio Lima",
            "email": "ryan-lima91@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

Cancelar Duplicata em uma operação

Próxima página

Registrar Endosso-Penhor

Registrar Endosso

Checklist de uso da API#

Requisição

Respostas

Checklist de uso da API