Título Negociado

Quando a compra/antecipação é concluída, ou seja, quando a mesma foi aprovada/paga ou recusada pelo comprador, nós disparamos um evento para indicar a conclusão dessa operação.

Segue abaixo um exemplo do Payload:

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"
        }
      },
      "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
    }
  ]
}

[*] O campo status pode conter o valor SOLD para itens negociados e REFUSED para itens recusados pelo comprador.

[**] Os campos installment e totalInstallment são utilizados apenas quando o título é pago de forma parcelada, quando é pago de forma a vista o valor default é 1.

No Payload acima temos as informações sobre qual investidor realizou a antecipação (Razão Social, CNPJ, Dados Bancários).

Esse Payload também contém os IDs (PayableId, ExternalId e InvoiceNumber) que são utilizados para que você identifique o título no seu sistema.

No momento do envio dos títulos, tanto via API, quanto via arquivo, é definido o layout e você irá optar por enviar um dos três identificadores acima. E você deve utilizar o mesmo identificador quando receber a requisição do Hook.