Offer: The object and its attributes #
- An offer object is created in the database once the admin submitted the initial offer creation form.
- The full creation process includes several tabs that must be completed before the offer is ready to be LEGAL-ACCEPTED and published for investment opportunities.
Attributes #
| Parameter Name | Parameter Description |
|---|---|
| ID | Unique identifier |
| Status | Offer’s status. Possible options: NEW, DRAFT, LEGAL-REVIEW, LEGAL-ACCEPTED, LEGAL-DECLINED, PUBLISHED, LEGAL-CLOSED, CLOSED-SUCCESSFULLY, CLOSED-UNSUCCESSFULLY |
| Name | Offer’s name |
| Slug | Offer’s slug |
| Legal Name | formal name of the offer |
| Esign ID | ID of template from e-sign provider |
| Entity ID | Escrow account reference number |
| Wallet ID | Dwollla wallet ID, wallet created for collecting fund for investments after escrow release |
| Created at | date of offer creation |
| Updated at | date of the last offer update |
| Publication_date | date when offer is published for investing |
| Closse at | Expected date of the offer closing |
| Author | djadmin user who created the offer |
| Valuation | $, estimated or assigned value of the offer, reflecting its perceived worth |
| Minimum Investment | Minimal amount of shares to purchase |
| Total shares | Number of total shares |
| Subscribed shares | Number of shares reserved for investors according to submitted investments |
| Confirmed shares | Number of shares reserved for investors according to created trades on escrow provider end |
| Price er Share | $, prise per share |
| Capital being raised | $, funds amount to be raised, calculated as Total shares * Price per Share |
| Security type | category of the offer based on its nature, rights, and characteristics, such as ownership (equity), debt obligations, or derivative contracts. Possible options: equity, preferred equity, debt, convertable debt, equity warrants, preference shares, convertible bonds |
| data.wire_to | Wire instructions to be sent to the investor, beneficiary |
| data.swift_id | Wire instructions to be sent to the investor, swift ID |
| data.custodian | Wire instructions to be sent to the investor, custodian name or account name |
| data.account_number | Wire instructions to be sent to the investor, account number of the escrow account |
| data.routing_number | Wire instructions to be sent to the investor, routing number of the escrow account |
| data.nc_stamping_text | offer’s indicator for the escrow provider |
| data.nc_escrow_account_number | account number of the escrow account |
| data.nc_escrow_routing_number | routing number of the escrow account |
| address 1 | offer’s address 1 |
| address 2 | offer’s address 2 |
| city | offer’s city |
| state | offer’s state |
| country | offer’s country, default to US |
| zipcode | offer’s zipcode |
| Title | Short title for the offer |
| Thumbnail | Image for thumnail on offerings page |
| Description | |
| Highlights | |
| Additional details | |
| Website | website of the offer or company-owner |
| SEO title | |
| SEO description | |
| Links to social network accounts | Options: FB, Linkedin, telegram, instagram, twitter, etc |
Documents #
Another important offer’s parameter is a document list. It could include documents relevant for the different offer’s stages.
Each document attached has a flag public (true/false) to specify if document could be accessible for preview by potential investors. Documents (tax, offer update) that are attached as a report for investors have a read flag (true/false) which will represent if the invetor reviewed the document.
Mandatory documents for offer approval include the Investment Agreement, Articles of Organization, and EIN Application, all of which can be marked as public.
Other possible documents: offer, update, tax documents, financial statements, offering memorandum, etc.
Investment list #
List of successfully finished investments and list of unfinished/cancelled investments. List of successfully finished investments represents final shares owners at the closing stage.
Logs #
Offer’s log list contains info of approval process. The offer status is LEGAL-ACCEPTED, with the following parameters filled out with information from North Capital and Dwolla:
- North Capital offeringId
- North Capital Document Upload
- North Capital Submit form
- Dwolla Customer ID
- Dwolla status = verified
- Attached funding source
- Dwolla Documents Upload
History #
Offer object maintains a detailed history that records all changes made to it. This history logs modifications performed by administrators, third-party integrations, or user actions, ensuring full traceability of updates. Each entry includes details such as the timestamp, the actor responsible for the change, and the nature of the modification. This audit trail enhances transparency, supports compliance requirements, and allows for rollback or review of previous states when necessary.