Compra Finalizada

Quando uma compra é finalizada(após todos os responsáveis legais do cedente e do investidor concluirem as assinaturas) enviamos este evento onde temos as informações a respeito de quem realizou a operação, valores a serem pagos e as datas para os pagamentos.

Você pode utilizar os _links para navegar nos recursos relacionados a este evento.

Path: /purchase-finalized

Webhook payload object

Chave

Tipo

Descrição


auctionId


string


Identificador da compra.


bidId


string


Identificador do lance.


status


string


Situação da compra. Possíveis valores:
SOLD - Antecipada
REFUSED - Recusada


grossPaymentValue


number


Valor bruto da compra.


netPaymentValue


number


Valor líquido da compra.


averageTax


number


Taxa atribuída à compra.


averageTenor


integer


Prazo de adiantamento em dias.


paymentDate


long


Data de pagamento da compra.


buyerName


string


Razão Social ou Nome do investidor.


buyerGovernmentId


string


CNPJ ou CPF do investidor.


sponsorName


string


Razão Social ou Nome do sacado.


sponsorGovernmentId


string


CNPJ ou CPF do sacado.


sponsorAddress


string


Endereço do sacado.


sponsorAddressNumber


string


Número do endereço do sacado.


sponsorAddressComplement


string


Complemento do endereço do sacado.


sponsorNeighborhood


string


Bairro do sacado.


sponsorCity


string


Cidade do sacado.


sponsorState


string


Estado do sacado.


sponsorCountry


string


País do sacado.


sponsorZipCode


string


CEP do sacado.


sponsorBank


string


Código do banco do sacado.


sponsorAgency


string


Código da agência bancária do sacado (Sem o dígito)
.


sponsorAccount


string


Conta corrente do sacado (Sem o dígito)
.


sponsorAccountDigit


string


Dígito da conta corrente do sacado.


sellerName


string


Razão Social ou Nome do cedente.


sellerGovernmentId


string


CNPJ ou CPF do cedente.


sellerAddress


string


Endereço do cedente.


sellerAddressNumber


string


Número do endereço do cedente.


sellerAddressComplement


string


Complemento do endereço do cedente.


sellerNeighborhood


string


Bairro do cedente.


sellerCity


string


Cidade do cedente.


sellerState


string


Estado do cedente.


sellerCountry


string


País do cedente.


sellerZipCode


string


CEP do cedente.


sellerBank


string


Código do banco do cedente.


sellerAgency


string


Código da agência bancária do cedente (Sem o dígito)
.


sellerAccount


string


Conta corrente do cedente (Sem o dígito)
.


sellerAccountDigit


string


Dígito da conta corrente do cedente.


sellerExternalCode


string


Código do convênio com o cedente.


items


array


Array contendo os itens desta compra.


items[][uuid]


string


Identificador do título na plataforma.


items[][externalId]


string


Identificador externo do título. (Até 255 Caracteres).


items[][invoiceDate]


long


Data do título.


items[][invoiceNumber]


string


Número do título. (Até 255 Caracteres).


items[][invoiceKey]


string


Chave eletrônica do título. (Até 255 Caracteres).


items[][installment]


integer


Parcela referente ao título. Utilizado apenas quando o título é pago de forma parcelada. Quando é pago de forma à vista o valor default é 1.


items[][totalInstallment]


integer


Total de parcelas referente ao título. Utilizado apenas quando o título é pago de forma parcelada. Quando é pago de forma à vista o valor default é 1.


items[][grossPaymentValue]


number


Valor do título.


items[][netPaymentValue]


number


Valor cedido ao cedente.


items[][paymentDate]


long


Data de vencimento do título.


items[][effectivePaymentDate]


long


Data de vencimento do título.


items[][tax]


number


Taxa atribuída ao item da compra.


_links


object


Recursos disponíveis através de HATEOAS.
Para saber mais clique aqui.

Recursos disponíveis são:
bid - Listar dados do lance vencedor.
file - Download do termo assinado.

Webhook payload example

{
  "_links": {
    "file": {
      "href": "https://gateway.hmg.sales.finance/v1/buyers/30306294000145/signatures/mDg2EVIduN/file",
      "type": "GET"
    },
    "bid": {
      "href": "https://gateway.hmg.sales.finance/v1/buyers/30306294000145/bids/eac0c0d2-0f87-4094-ab7c-976fe5e03394",
      "type": "GET"
    }
  },
  "auctionId": "zXGg0kZsw6",
  "bidId": "eac0c0d2-0f87-4094-ab7c-976fe5e03394",
  "status": "SOLD",
  "sellerExternalCode": "A-779",
  "grossPaymentValue": "96425.00",
  "netPaymentValue": "95930.26",
  "averageTax": 0.30000001192092896,
  "averageTenor": 51,
  "paymentDate": 1699992781,
  "buyerName": "Buyer Sales Plus",
  "buyerGovernmentId": "19653243000157",
  "sponsorName": "Sponsor Sales Plus",
  "sponsorGovernmentId": "20752233000158",
  "sponsorAddress": "Rua Sponsor",
  "sponsorAddressNumber": "574",
  "sponsorAddressComplement": "sponsor",
  "sponsorNeighborhood": "Moema",
  "sponsorCity": "São Paulo",
  "sponsorState": "SP",
  "sponsorCountry": "Brasil",
  "sponsorZipCode": "13801510",
  "sponsorBank": "033",
  "sponsorAgency": "341",
  "sponsorAccount": "1265",
  "sponsorAccountDigit": "0",
  "sellerName": "Sales Sales Plus",
  "sellerGovernmentId": "08668520000189",
  "sellerAddress": "Rua Seller",
  "sellerAddressNumber": "2",
  "sellerAddressComplement": "Seller 2",
  "sellerNeighborhood": "Moema",
  "sellerCity": "São Paulo",
  "sellerState": "SP",
  "sellerCountry": "Brasil",
  "sellerZipCode": "13801510",
  "sellerBank": "001",
  "sellerAgency": "2323",
  "sellerAccount": "22",
  "sellerAccountDigit": "2",
  "items": [
    {
      "uuid": "s30f7ZTtyq",
      "externalId": "DS4059",
      "invoiceDate": 1703798071,
      "invoiceNumber": "DC9216",
      "invoiceKey": null,
      "installment": 1,
      "totalInstallment": 1,
      "grossPaymentValue": 11897.25,
      "paymentDate": 1665975600000,
      "effectivePaymentDate": 1665975600000,
      "tax": 19.9,
      "netPaymentValue": 3569.54
    }
  ]
}