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 atua como camada de orquestração, abstraindo a complexidade regulatória e 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 atua como intermediária dos sacadores (fornecedores) no processo de escrituração, integrando o fluxo de escrituração 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.
- 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 do evento de Compra Realizada.
Webhooks do Investidor
Compra Realizada
Hoje, quando uma compra é realizada, esse evento é enviado. A partir de agora, ele passará a indicar o sucesso da escrituração das duplicatas e do registro da operação junto à registradora (caso o banco tenha escolhido a Monkey como agente de registro). Embora uma operação possa ser criada com múltiplas duplicatas, apenas aquelas que estiverem livres e aptas para compor a operação serão enviadas ao investidor. Nesse momento, será informado o identificador da operação na registradora por meio do campo tradeRepositoryId. Além disso, para cada item enviado, será disponibilizada a lista de duplicatas que o compõem. Em cada duplicata será informado o identificador fornecido pela escrituradora no momento de escrituração por meio do campo tradeRepositoryId.
Path: /purchase
{
"_links": {
"seller": {
"href": "https://hmg-zuul.monkeyecx.com/v2/buyers/1676325232/sellers/3",
"type": "GET"
},
"sponsor": {
"href": "https://hmg-zuul.monkeyecx.com/v2/buyers/1676325232/sponsors/1676324285",
"type": "GET"
},
"purchases": {
"href": "https://hmg-zuul.monkeyecx.com/v2/buyers/1676325232/purchases",
"type": "GET"
},
"signature": {
"href": "https://hmg-zuul.monkeyecx.com/v2/buyers/1676325232/signatures/PURCHASE-123",
"type": "GET"
},
"purchase": {
"href": "https://hmg-zuul.monkeyecx.com/v2/buyers/1676325232/purchases/PURCHASE-123",
"type": "GET"
}
},
"id": "PURCHASE-123",
"status": "WAITING_CUSTODY",
"tax": 0.1,
"days": 30,
"paymentDate": 1769691442203,
"grossPaymentValue": 10000.0,
"netPaymentValue": 9960.90,
"feeAmount": 10.00,
"discount": 5.00,
"subsidy": 2.00,
"netPaymentValueWithoutFee": 9960.90,
"totalEffectiveCost": 0.12,
"buyerId": 1676325232,
"buyerName": "BANCO GRANA FÁCIL SA",
"buyerGovernmentId": "62737331000166",
"sponsorId": 1676324285,
"sponsorName": "SILVA EVENTOS E ENTRETENIMENTO SA",
"sponsorPersonType": "LEGAL_PERSON",
"sponsorGovernmentId": "18067244000157",
"sponsorExternalCode": "EXT-123",
"sponsorAddress": "Sponsor Address",
"sponsorAddressNumber": "100",
"sponsorAddressComplement": "Room 1",
"sponsorNeighborhood": "Center",
"sponsorCity": "Sponsor City",
"sponsorState": "SP",
"sponsorCountry": "Brazil",
"sponsorZipCode": "01234-000",
"sponsorBank": "001",
"sponsorAgency": "0001",
"sponsorAccount": "11223",
"sponsorAccountDigit": "4",
"sponsorAccountKey": "key-999",
"sellerId": 3,
"sellerName": "Seller Name",
"sellerPersonType": "NATURAL_PERSON",
"sellerGovernmentId": "11222333000100",
"sellerAddress": "Seller Address",
"sellerAddressNumber": "200",
"sellerAddressComplement": "Block B",
"sellerNeighborhood": "Industrial",
"sellerCity": "Seller City",
"sellerState": "SP",
"sellerCountry": "Brazil",
"sellerZipCode": "04321-000",
"sellerBank": "237",
"sellerAgency": "0003",
"sellerAgencyDigit": "0",
"sellerAccount": "99887",
"sellerAccountDigit": "5",
"sellerAccountKey": "key-seller",
"sellerAccountType": "CHECKING",
"coobrigation": false,
"createdAt": 1769691447670,
"tradeRepositoryId": "249e2f11-0fc3-4c9b-aad8-bd0003475795",
"eventType": "PurchaseIntegratedEvent",
"items": [
{
"id": "ITEM-123",
"receivableUuid": "UUID-123",
"externalId": "adasd3r34ttdf",
"assetType": "DUPLICATA_MERCANTIL",
"performed": true,
"operationType": "PRE",
"invoiceType": "NOTA_FISCAL_ELETRONICA",
"invoiceDate": 1769691442208,
"invoiceNumber": "INV-123",
"invoiceKey": "123123123123123123123123123123123123123",
"installment": 1,
"totalInstallment": 1,
"paymentValue": 10000.0,
"paymentDate": 1769691442206,
"status": "WAITING_CUSTODY",
"tax": 1.2,
"sellerPaymentValue": 9960.90,
"sellerPaymentValueWithoutFee": 9960.90,
"sponsorTax": 0.0,
"sponsorPaymentValue": 0,
"penaltyBill": 0.0,
"interestLatePayment": 0.0,
"feeRate": 0.0,
"feeAmount": 0,
"discount": 39.10,
"subsidy": 0,
"fileBase64": "SGVsbG8gV29ybGQ=",
"invoices": [
{
"paymentDate": 1769691442208,
"paymentValue": 10000.00,
"invoiceNumber": "INV-123",
"assetType": "DUPLICATA_MERCANTIL",
"installment": 1,
"tradeRepositoryId": "0443935642310AB1299"
}
]
}
]
}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
}
]
}