Documentação
Start typing to search…

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:

  1. 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
  1. 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á enviado uma lista das duplicatas que representam os itens e nelas serão informados o identificador da escrituração na registradora, por meio do novo 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,
  "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": "3d3d0a4e-fc56-11f0-951d-0e3657eaa12d"
        }
      ]
    }
  ]
}

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 1 month ago