Supplier Registered

When a new supplier registers on the platform, this event is sent containing the registration data.

You can use the _links to navigate directly related resources for this event. Through the documents link, you can download the supplier’s documents.

EventType: SellerCreatedEvent

Path: /seller

Webhook payload object

Key

Type

Description


buyerId


integer


Investor identifier.


sellerId


integer


Supplier identifier.


name


string


Name of the supplier.


governmentId


string


EIN of the supplier.


companyName


string


Name of the supplier.


fantasyName


string


DBA name of the supplier.


foundationDate


long


Founding date of the supplier.


mainPhone


string


Main business phone of the supplier.


phone


string


Mobile phone of the supplier.


alternativePhone


string


Additional phone of the supplier.


address


string


Address line 1 of the supplier.


addressNumber


string


Street number of the supplier.


addressComplement


string


Address line 2 of the supplier.


neighborhood


string


Neighborhood of the supplier.


city


string


City of the supplier.


state


string


State of the supplier.


country


string


Country of the supplier.


zipCode


string


ZIP code of the supplier.


activityCode


string


CNAE (Economic Activities Classification) of the supplier.


legalNature


string


Type of corporate structure of the supplier.

Possible values:
LTDA, SA ou OTHER


personType


string


Type of entity of the grantor.

Possible values:
LEGAL_PERSON - Legal entity
NATURAL_PERSON - Individual


email


string


Email of the supplier.


minimumNumberSignatures


integer


Minimum number of signatures.


minimumInvoiceNumberSignatures


integer


Minimum number of invoice signatures.


eventType


string


Event type.


legalResponsibles


array[object]


List of legal representative of this supplier.


legalResponsibles[][name]


string


Name of the legal representative.


legalResponsibles[][governmentId]


string


SSN of the legal representative.


legalResponsibles[][type]


string


Relationship of the legal representative to the supplier.

Possible values:
PARTNER - Partner
SHAREHOLDER - Shareholder
ADMINISTRATOR - Administrator
DIRECTOR - Director
CONSULTANT - Consultant


legalResponsibles[][birthdayDate]


long


Birthday of the legal representative.


legalResponsibles[][documentType]


string


Type of document.

Possible values:
CNH - DL (Driver's License)
RG - SID (State ID)
PASSPORT - Passport


legalResponsibles[][documentNumber]


string


Document number according to the informed type.


legalResponsibles[][phone]


string


Phone of the legal representative.


legalResponsibles[][email]


string


Email of the legal representative.


legalResponsibles[][sign]


boolean


Whether the legal representative signs for the company.


legalResponsibles[][signatureType]


string


Type of signature.

Possible values:
NOT_SIGN - Not sign
INDIVIDUALLY_SIGN - Individually sign
SIGN_IN_GROUP - Sign in group


legalResponsibles[][financialAuthority]


boolean


Whether the legal representative has financial authority.


legalResponsibles[][financialAuthorityValue]


string


Amount of the financial authority.


_links


object


Resources available through HATEOAS.
More information here.

Resources available:
approve - approve supplier
unapprove - disapprove supplier
documents - download of supplier’s documents
update - change risk group of the supplier
self - list supplier data
sellers - list all suppliers.

Webhook payload example

{
   "buyerId":78676,
   "sellerId":1639274,
   "name":"CEDENTE",
   "governmentId":"22874589000179",
   "companyName":"CEDENTE",
   "fantasyName":"CEDENTE",
   "foundationDate":1437015600000,
   "mainPhone":"+559875893475",
   "phone":"+559875893475",
   "alternativePhone":"+559875893475",
   "address":"Rua A",
   "addressNumber":"456",
   "addressComplement":"Sala 02",
   "neighborhood":"Centro",
   "city":"São Paulo",
   "state":"SP",
   "country":"Brazil",
   "zipCode":"04900011",
   "activityCode":"12348-44",
   "legalNature":"LTDA",
   "personType":"LEGAL_PERSON",
   "email":"[email protected]",
   "minimumNumberSignatures": 1,
   "minimumInvoiceNumberSignatures": 0, 
   "eventType":"SellerCreatedEvent",
   "legalResponsibles":[
      {
         "name":"Gilberto Ferreira",
         "governmentId":"22567536000179",
         "type":"PARTNER",
         "birthdayDate":"2550257612000",
         "documentType":"CNH",
         "documentNumber":"72972845281",
         "phone":"+559875893475",
         "email":"[email protected]",
         "sign": true,
         "signatureType": "SIGN_IN_GROUP",
         "financialAuthority": true,
         "financialAuthorityValue": 2000000,00 
      }
   ],
   "_links":{
      "approve":{
         "href":"https://zuul.monkey.exchange/v2/buyers/78676/sellers/1639274/approve",
         "type":"POST"
      },
      "unapprove":{
		 "href":"https://zuul.monkey.exchange/v2/buyers/78676/sellers/1639274/unapprove",
		 "type":"POST"
      },
      "documents":{
		 "href":"https://zuul.monkey.exchange/v2/buyers/78676/sellers/1639274/documents",
         "type":"GET"
      },
      "update":{
         "href":"https://zuul.monkey.exchange/v2/buyers/78676/sellers/1639274",
         "type":"PUT"
      },
      "self":{
         "href":"https://zuul.monkey.exchange/v2/buyers/78676/sellers/1639274",
         "type":"GET"
      },
      "sellers":{
         "href":"https://zuul.monkey.exchange/v2/buyers/78676/sellers",
         "type":"GET"
      }
   }
}