Duplicata Escritural
O que é a duplicata escritural
A duplicata escritural é um título de crédito que representa uma venda de mercadorias ou prestação de serviços. Ela formaliza a obrigação de pagamento do sacado (comprador) ao sacador (fornecedor) e pode ser utilizada como base para operações de antecipação de recebíveis e outras modalidades de crédito.
No modelo atual, a duplicata passa a existir de forma escritural (eletrônica), sendo registrada em Entidades Registradoras, autorizadas pelo Banco Central, eliminando a emissão em papel e aumentando a segurança, rastreabilidade e transparência da operação.
O que muda na operação
Com a duplicata escritural, as operações de antecipação de recebíveis passam a funcionar da seguinte forma:
- A duplicata nasce e é controlada de forma eletrônica, com registro obrigatório.
- A titularidade, ônus e negociações passam a ser centralmente registradas, evitando duplicidades e fraudes.
- As operações de antecipação de recebíveis passam a exigir integração com registradoras, respeitando os fluxos regulatórios.
- As negociações continuam ocorrendo como hoje do ponto de vista comercial, com etapas adicionais de escrituração e registro.
A Monkey abstrai essa complexidade regulatória, integrando os fluxos de registro à experiência atual de negociação de recebíveis.
Atuação da Monkey no processo da duplicata escritural
A Monkey sempre realizará a escrituração, sendo intermediário dos sacadores (fornecedores). O fluxo de escrituração é integrado ao fluxo atual de antecipação de recebíveis na plataforma.
Em relação ao registro do contrato, de responsabilidade dos financiadores, a Monkey suporta diferentes modelos, garantindo flexibilidade operacional:
- Registro via Monkey
- A Monkey poderá realizar o registro do contrato junto à(s) registradora(s), atuando como Agente de Registro dos financiadores
- Ao confirmar a operação na plataforma, o financiador autoriza a Monkey a efetuar o registro do contrato na registradora aplicável
- A Monkey disponibiliza aos financiadores os identificadores de registro (IDs) para fins de conciliação e auditoria
- Registro direto pelo financiador
- O financiador pode realizar o registro do contrato diretamente na registradora de sua escolha, utilizando sua infraestrutura e integração própria.
- A Monkey continua integrada ao fluxo de negociação na plataforma, mantendo a orquestração da operação e troca de informações entre as partes.
Em ambos os modelos, a Monkey atua como camada de orquestração, garantindo consistência operacional, integração sistêmica e conformidade regulatória.
Novos campos na integração
Definimos uma forma de adaptar o fluxo de duplicata escritural com impacto mínimo na operação. Para isso, estabelecemos os seguintes ajustes:
Atualmente, a operação possui um identificador e cada item da operação também possui um identificador, ambos gerados pela plataforma. A partir de agora, além desses identificadores internos, cada entidade passará a contar também com um identificador proveniente da registradora.
No caso da operação, o identificador da registradora corresponderá ao identificador do contrato de registro. Já no caso do item da operação, o identificador da registradora será o identificador da duplicata após a escrituração.
Esses novos identificadores serão enviados aos investidores por meio dos eventos de Compra Realizada e Assinatura do Cedente.
Webhooks do Investidor
Compra Realizada
Hoje, quando uma compra é realizada, esse evento é enviado . A partir de agora, ele passará a ser o indicativo de sucesso na escrituração das duplicatas junto à registradora. Mesmo que a operação seja criada com várias duplicatas, apenas aquelas que estiverem livres e aptas à operação serão enviadas ao investidor. Para cada item enviado, será informado o identificador da escrituração na registradora, por meio do novo campo tradeRepositoryId.
Path: /purchase
{
"_links": {
"seller": {
"href": "https://dev-zuul.monkeyecx.com/v2/buyers/540897447/sellers/1614639276",
"type": "GET"
},
"sponsor": {
"href": "https://dev-zuul.monkeyecx.com/v2/buyers/540897447/sponsors/4026534",
"type": "GET"
},
"purchases": {
"href": "https://dev-zuul.monkeyecx.com/v2/buyers/540897447/purchases",
"type": "GET"
},
"signature": {
"href": "https://dev-zuul.monkeyecx.com/v2/buyers/540897447/signatures/X1Gl6y6qhc",
"type": "GET"
},
"purchase": {
"href": "https://dev-zuul.monkeyecx.com/v2/buyers/540897447/purchases/X1Gl6y6qhc",
"type": "GET"
}
},
"id": "X1Gl6y6qhc",
"status": "WAITING_CUSTODY",
"tax": 1.8,
"days": 6,
"paymentDate": 1600916400000,
"grossPaymentValue": 199.89,
"netPaymentValue": 199.18,
"feeAmount": 8500,
"discount": 8500,
"subsidy": 8500,
"netPaymentValueWithoutFee": 189.18,
"totalEffectiveCost": 2.71,
"buyerId": 540897447,
"buyerName": "JALLES MACHADO S.A.",
"buyerGovernmentId": "02635522000195",
"sponsorId": 4026534,
"sponsorName": "JALLES MACHADO S.A.",
"sponsorPersonType": "LEGAL_PERSON",
"sponsorGovernmentId": "02635522000195",
"sponsorExternalCode": null,
"sponsorAddress": "ROD. GO 080 KM 75,1",
"sponsorAddressNumber": "S/N",
"sponsorAddressComplement": "",
"sponsorNeighborhood": "CENTRO",
"sponsorCity": "GOIANESIA",
"sponsorState": "SC",
"sponsorCountry": "Brasil",
"sponsorZipCode": "76380000",
"sponsorBank": "035",
"sponsorAgency": "0003",
"sponsorAccount": "48526",
"sponsorAccountDigit": "3",
"sponsorAccountKey": "6758567567",
"sellerId": 1614639276,
"sellerName": "AGRIMIX INDUSTRIA E COMERCIO DE PECAS LTDA",
"sellerPersonType": "LEGAL_PERSON",
"sellerGovernmentId": "12292693000112",
"sellerAddress": "Rua Adelina Cardim Bigal",
"sellerAddressNumber": "235",
"sellerAddressComplement": "",
"sellerNeighborhood": "Jardim do Trevo",
"sellerCity": "Ribeirão Preto",
"sellerState": "SP",
"sellerCountry": "Brasil",
"sellerZipCode": "14092370",
"sellerBank": "341",
"sellerAgency": "2222",
"sellerAgencyDigit": "0",
"sellerAccount": "122233",
"sellerAccountDigit": "2",
"sellerAccountKey": "234235232",
"coobrigation": false,
"createdAt": 1600870010095,
"eventType": "PurchaseIntegratedEvent",
"items": [
{
"id": "Se4VTCTuac",
"tradeRepositoryId": "J0000000000000000001",
"receivableUuid": "0DdiYruAHH",
"externalId": "MU4IE8cR1i",
"assetType": "DUPLICATA_MERCANTIL",
"performed": true,
"operationType": "PRE",
"invoiceType": "NOTA_FISCAL_ELETRONICA",
"invoiceDate": null,
"invoiceNumber": "2wXXDlFasw",
"invoiceKey": "",
"installment": 1,
"totalInstallment": 1,
"paymentValue": 199.89,
"paymentDate": 1601434800000,
"status": "WAITING_CUSTODY",
"tax": 1.8,
"sellerPaymentValue": 199.18,
"sellerPaymentValueWithoutFee": 189.18,
"sponsorTax": 0.0,
"sponsorPaymentValue": 0.00,
"penaltyBill": 0.0,
"interestLatePayment": 0.0,
"feeRate": 2.71,
"feeAmount": 10.00,
"discount": 0.71,
"subsidy": 0,
"fileBase64": "string base64"
}
]
}Assinatura do Cedente
Hoje, quando o cedente realiza a assinatura da operação, esse evento é enviado. A partir de agora, esse evento passará a ser também o indicativo de sucesso no registro da operação junto à registradora. Nesse momento, será enviado o identificador do registro na registradora, por meio do novo campo tradeRepositoryId.
Importante: o novo campo tradeRepositoryId será enviado apenas nos casos em que o investidor optar por registrar a operação com a Monkey.
Path: /seller-signature
{
"sponsorId":111111,
"buyerId":78676,
"sellerId":1611954924,
"purchaseId":"GUXbVzi0Tn",
"tradeRepositoryId": "249e2f11-0fc3-4c9b-aad8-bd0003475795",
"status":"APPROVED",
"signatures":[
{
"name":"José Carlos",
"email":"[email protected]",
"governmentId":"05319135679",
"status":"APPROVED"
},
{
"name":"João Pedro",
"email":"[email protected]",
"governmentId":"99813646063",
"status":"APPROVED"
}
],
"_links": {
"documents":{
"href":"https://zuul.monkey.exchange/v2/buyers/78676/signatures/GUXbVzi0Tn/documents{?type}",
"type":"GET",
"templated":true
},
"purchase":{
"href":"https://zuul.monkey.exchange/v2/buyers/78676/purchases/GUXbVzi0Tn",
"type":"GET"
},
"signature":{
"href":"https://zuul.monkey.exchange/v2/buyers/78676/signatures/GUXbVzi0Tn",
"type":"GET"
}
}
}Webhook do Sacado
Título Negociado
Nesse evento, enviado no momento em que a operação é concluída, serão informados os identificadores das duplicatas já escrituradas. Assim, em cada item da operação será adicionado o campo tradeRepositoryId, que representa o identificador da escrituração na registradora.
Path: /payables-response
{
"_links": {
"sponsor": {
"href": "https://dev-zuul.monkeyecx.com/v2/sponsors/4026534",
"type": "GET"
},
"payables": {
"href": "https://dev-zuul.monkeyecx.com/v2/sponsors/4026534/payables",
"type": "GET"
}
},
"purchaseId": "RGmO4qbIvb",
"sponsorId": 4026534,
"sponsorName": "Monkey Company - Sponsor",
"sponsorGovernmentId": "73068519000185",
"sellerId": 1617323624,
"sellerName": "Monkey Company - Seller",
"sellerGovernmentId": "12292693000112",
"buyerId": 540897447,
"buyerName": "Monkey Company",
"buyerGovernmentId": "62237425000176",
"buyerReceivementBank": "001",
"buyerReceivementAgency": "0001",
"buyerReceivementAccount": "0262",
"buyerReceivementAccountDigit": "1",
"buyerReceivementAccountKey": "15354652342",
"eventType": "PurchaseFlowCompletedEvent",
"items": [
{
"_links": {
"payable": {
"href": "https://dev-zuul.monkeyecx.com/v2/sponsors/4026534/payables/DQUBiYl5Kv",
"type": "GET"
}
},
"tradeRepositoryId": "J0000000000000000001",
"payableUuid": "DQUBiYl5Kv",
"status": "SOLD",
"detail": "Payment received",
"externalId": "2511202004",
"invoiceNumber": "25112020d",
"installment": 1,
"totalInstallment": 1,
"paymentDate": 1601434800000,
"tax": 1.5,
"sponsorTax": 0.2,
"paymentValue": 200.00,
"sellerPaymentValue": 199.89,
"sponsorPaymentValue": 0,
"discountValue": 0.11,
"subsidyValue": 0
}
]
}Updated about 13 hours ago