Carta record definition

Certificate

#/$defs/Certificate

Mapped target19 properties10 source mappings2 target questions
Generated SVG artifactOpen SVG ↗
Certificate mapping graph
Review threads

Questions about this target

Target-bound review threads are shown here with their source property and direct issue action.

2 open0 closed
OPENprice

Is the June 22 `Certificate.returnedInvestedCapital` the intended home for repurchase consideration — i.e. `price × quantity`? The field is new in this bundle, is a `Money`, and sits on the same `Certificate` that already receives this transaction's `returnedToTreasuryQuantity`, which makes it a plausible target for the capital returned to the holder on repurchase. Classified `no-equivalent` pending confirmation rather than mapped on inference, because the bundle carries no description for the field and a product-price aggregate would be wrong if Carta means original invested capital instead.

Asked by @johnscrudato→ Certificate.returnedInvestedCapital · objects/transactions/repurchase/StockRepurchase.mapping.md:198
Current answer Open: confirm whether `returnedInvestedCapital` records repurchase consideration (`price × quantity`) and, if so, whether Carta expects the importer to compute the product or whether the value has independent provenance. `RestrictedStockAward` has no equivalent field, so an RSA-variant answer is needed too.
OPENsecurity_id

Writing one OCF `security_id` into both `Certificate.id` and `Certificate.securityId` (and the RSA equivalents) asserts that the two slots hold the same value. The bundle describes them differently — `id` is "the identifier of the certificate", while `securityId` is "the UUID of the certificate. Use this to cross-reference with the List Transactions API" — so they may be distinct identifier spaces, with `securityId` server-assigned rather than client-supplied. Neither is marked `readOnly`, which is why both are currently mapped; this pattern was added across the issuance, exercise, cancellation, and repurchase mappings when June 22 made `id` required, so a single answer settles all of them.

Asked by @johnscrudato→ Certificate.securityId · objects/transactions/issuance/StockIssuance.mapping.md:358
Current answer Open: confirm whether an importer may supply `id` and `securityId` as the same client-chosen value, or whether `securityId` is Carta-assigned and OCF `security_id` should map to only one of the two.
Target evidence

Who can fill this target?

StockAcceptanceDefault · security_id · OCF type: string ↗
Open mapping issue ↗
StockCancellationDefault · security_id · OCF type: string ↗
Open mapping issue ↗
StockClassPreferred · name · OCF type: string ↗
Open mapping issue ↗
StockConsolidationDefault · resulting_security_id · OCF type: string ↗
Open mapping issue ↗
StockConversionDefault · resulting_security_ids · OCF type: array<string> ↗
Open mapping issue ↗
StockIssuanceDefault · vesting_terms_id · OCF type: string ↗
Open mapping issue ↗
StockReissuanceDefault · resulting_security_ids · OCF type: array<string> ↗
Open mapping issue ↗
StockRepurchaseDefault · balance_security_id · OCF type: string ↗
Open mapping issue ↗
StockTransferDefault · resulting_security_ids · OCF type: array<string> ↗
Open mapping issue ↗
Property ledger

Slot by slot

Schema types are shown for both sides of each mapping slot.

Carta property / typeStatusOCF evidence / type
canceledDateCarta type Iso8601CompleteCalendarDate ↗directIssue ↗
canceledQuantityCarta type Decimal ↗directIssue ↗
dividendAccrualStartDateCarta type Iso8601CompleteCalendarDate ↗empty
No OCF source evidence
Documented
idCarta type string ↗direct
EquityCompensationExercise.resulting_security_idsOCF type array<string> ↗EquityCompensationExercise.resulting_security_idsOCF type array<string> ↗StockAcceptance.security_idOCF type string ↗StockCancellation.balance_security_idOCF type string ↗
Issue ↗
issueDateCarta type Iso8601CompleteCalendarDate ↗direct
StockIssuance.dateOCF type Date ↗
Issue ↗
issuerIdCarta type string ↗empty
No OCF source evidence
Documented
lastModifiedDatetimeCarta type Iso8601CompleteCalendarDateTime ↗empty
No OCF source evidence
Documented
precededByCarta type CertificatePrecededBy ↗structuralIssue ↗
pricePerShareCarta type Money ↗direct
StockIssuance.share_priceOCF type Monetary ↗
Issue ↗
quantityCarta type Decimal ↗direct
StockIssuance.quantityOCF type Numeric ↗
Issue ↗
returnedInvestedCapitalCarta type Money ↗empty
No OCF source evidence
Documented
returnedToPoolQuantityCarta type Decimal ↗empty
No OCF source evidence
Documented
returnedToTreasuryQuantityCarta type Decimal ↗direct
StockRepurchase.quantityOCF type Numeric ↗
Issue ↗
securityIdCarta type string ↗direct
EquityCompensationExercise.resulting_security_idsOCF type array<string> ↗EquityCompensationExercise.resulting_security_idsOCF type array<string> ↗StockAcceptance.security_idOCF type string ↗StockCancellation.balance_security_idOCF type string ↗
Issue ↗
securityLabelCarta type string ↗direct
StockIssuance.custom_idOCF type string ↗
Issue ↗
shareClassIdCarta type string ↗direct
StockIssuance.stock_class_idOCF type string ↗
Issue ↗
shareClassNameCarta type string ↗direct
StockClass.nameOCF type string ↗StockClass.nameOCF type string ↗
Issue ↗
stakeholderIdCarta type string ↗direct
StockIssuance.stakeholder_idOCF type string ↗
Issue ↗
vestingScheduleTemplateIdCarta type string ↗direct
StockIssuance.vesting_terms_idOCF type string ↗
Issue ↗