Documentação

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

{
	"purchaseId" : "f7Hrm6k7RR",
	"auctionId" : "f7Hrm6k7Rl",
	"bidId" : "6620a220-b400-4222-bb94-afbc029956be",
	"status" : "WAITING_CUSTODY",
	"averageTax" : 1.3345,
	"averageTenor" : 169,
	"paymentDate" : 1649041200000,
	"grossPaymentValue" : 50891.25,
	"netPaymentValue" : 22451.45,
	"buyerName" : "BUYER SALES FINANCE",
	"buyerGovernmentId" : "62144175000120",
	"sellerName" : "SALES SALES FINANCE",
	"sellerPersonType" : "LEGAL_PERSON",
	"sellerGovernmentId" : "57648355000109",
	"sellerAddress" : "RUA SELLER",
	"sellerAddressNumber" : "404",
	"sellerAddressComplement": "Seller",
	"sellerNeighborhood" : "Moema",
	"sellerCity" : "SÃO PAULO",
	"sellerState" : "SP",
	"sellerCountry" : "Brasil",
	"sellerZipCode" : "13801510",
	"sellerBank" : "001",
	"sellerAgency" : "2323",
	"sellerAgencyDigit" : "0",
	"sellerAccount" : "11100",
	"sellerAccountDigit" : "1",
	"createdAt" : 1649424623283,
	"items" : [
		{
			"uuid" : "7qohB0H6m1",
			"tradeRepositoryId" : "J0000000000000000001",
			"externalId" : "CX4119",
			"invoiceDate" : 1593054000000,
			"invoiceNumber" : "1287572-32",
			"invoiceKey" : "XV4119",
			"installment" : 1,
			"totalInstallment" : 1,
			"grossPaymentValue" : 11897.25,
			"paymentDate" : 1665975600000,
			"effectivePaymentDate" : 1665975600000,
			"tax" : 1.3345,
			"netPaymentValue" : "3569.54",
			"sponsorName" : "SPONSOR SALES FINANCE",
			"sponsorPersonType" : "LEGAL_PERSON",
			"sponsorGovernmentId" : "36147299000159",
			"sponsorAddress" : "Rua Sponsor",
			"sponsorAddressNumber" : "404",
			"sponsorAddressComplement" : "NA",
			"sponsorNeighborhood" : "Moeda",
			"sponsorCity" : "São Paulo",
			"sponsorState" : "SP",
			"sponsorCountry" : "Brasil",
			"sponsorZipCode" : "13801510",
			"sponsorBank" : "001",
			"sponsorAgency" : "2323",
			"sponsorAgencyDigit" : "0"
		}
	],
	"_links" : {
		"purchase" : {
			"href" : "https://gateway.sales.finance/v2/buyers/62144175000120/purchases/f7Hrm6k7RR",
			"type" : "GET"
		},
		"purchase-response" : {
			"href" : "https://gateway.sales.finance/v1/buyers/62144175000120/purchases/f7Hrm6k7RR/response",
			"type" : "POST"
		}
	}
}

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

{
  "_links": {
    "documents": {
      "href": "https://gateway.dev.sales.finance/v1/buyers/17785205000122/signatures/SD4p6PkBEC/file",
      "type": "GET"
    },
    "buyer": {
      "href": "https://gateway.dev.sales.finance/v1/buyers/17785205000122",
      "type": "GET"
    }
  },
  "auctionId": "SD4p6PkBEC",
  "tradeRepositoryId" : "249e2f11-0fc3-4c9b-aad8-bd0003475795",
  "bidId": "78db94de-c256-4219-828e-edd14a7ca349",
  "sponsorName": "FANTASY SPONSOR LTDA",
  "sponsorGovernmentId": "59313502000115",
  "sellerName": "FANTASY SELLER SA",
  "sellerGovernmentId": "96701902000124",
  "buyerName": "FANTASY BANK",
  "buyerGovernmentId": "17785205000122",
  "amount": 2123476.9,
  "status": "WAITING",
  "sellerSignatures": [
    {
      "name": "Felipe Adorno",
      "email": "[email protected]",
      "governmentId": "80177922044",
      "status": "WAITING"
    },
    {
      "name": "Diego Tonzi",
      "email": "[email protected]",
      "governmentId": "99675942096",
      "status": "APPROVED"
    }
  ]
}

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 26 days ago

© Monkey Tech . Todos os direitos reservados. Acesse nossa Política de Privacidade.