OCF source record

StockIssuance

objects/transactions/issuance/StockIssuance.mapping.md

Mapped44 executable edges42 source fields1 review question
Authored context

Notes / open questions

These notes are rendered from the mapping document and remain part of the review record.

Route by issuance_type: RSA → RsaIssuanceTransaction/RestrictedStockAward; FOUNDERS_STOCK → CertificateIssuanceTransaction/Certificate. Shared identity, date, holder/class/plan references, quantity, vesting-template, price, and cost basis populate the selected family.

RSA board approval and vesting events map to the award; those fields have no target for founders' stock. Security-law exemptions are explicitly excluded because Compliance was removed. The retained Certificate and RestrictedStockAward definitions now require id and issuerId in addition to the fields already mapped from the issuance; id is the security identity and issuerId must come from issuer context.

Share-number ranges, stock legend links, stockholder approval, consideration, and unsupported issuance fields are dropped for this pinned target bundle; OCF scaffolding is not copied. Carta's separate Draft Issuer certificate input has a legend string, but it is not part of this issuance target and does not establish a StockLegendTemplate mapping.

Review threads

Questions about this mapping

Property-level review threads stay close to the evidence. Open a prefilled issue for a new decision or follow the mapping link back to the authored file.

1 open0 closed
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.
Field evidence

Where the OCF fields go

VariantOCF fieldCarta destinationMapping kind
Rsaboard_approval_daterenameIssue ↗
Rsacomments
No Carta target
unmappableIssue ↗
Rsaconsideration_text
No Carta target
unmappableIssue ↗
Rsacost_basisrenameIssue ↗
Rsacustom_idrenameIssue ↗
RsadaterenameIssue ↗
Rsaid
No Carta target
unmappableIssue ↗
Rsaissuance_type
No Carta target
unmappableIssue ↗
Rsaobject_type
No Carta target
unmappableIssue ↗
RsaquantityrenameIssue ↗
Rsasecurity_idrenameIssue ↗
Rsasecurity_law_exemptions
No Carta target
unmappableIssue ↗
Rsashare_numbers_issued
No Carta target
unmappableIssue ↗
Rsashare_pricerenameIssue ↗
Rsastakeholder_idrenameIssue ↗
Rsastock_class_idrenameIssue ↗
Rsastock_legend_ids
No Carta target
unmappableIssue ↗
Rsastock_plan_idrenameIssue ↗
Rsastockholder_approval_date
No Carta target
unmappableIssue ↗
Rsavesting_terms_idrenameIssue ↗
RsavestingsrenameIssue ↗
Defaultboard_approval_date
No Carta target
unmappableIssue ↗
Defaultcomments
No Carta target
unmappableIssue ↗
Defaultconsideration_text
No Carta target
unmappableIssue ↗
Defaultcost_basisrenameIssue ↗
Defaultcustom_idrenameIssue ↗
DefaultdaterenameIssue ↗
Defaultid
No Carta target
unmappableIssue ↗
Defaultissuance_type
No Carta target
unmappableIssue ↗
Defaultobject_type
No Carta target
unmappableIssue ↗
DefaultquantityrenameIssue ↗
Defaultsecurity_idrenameIssue ↗
Defaultsecurity_law_exemptions
No Carta target
unmappableIssue ↗
Defaultshare_numbers_issued
No Carta target
unmappableIssue ↗
Defaultshare_pricerenameIssue ↗
Defaultstakeholder_idrenameIssue ↗
Defaultstock_class_idrenameIssue ↗
Defaultstock_legend_ids
No Carta target
unmappableIssue ↗
Defaultstock_plan_idrenameIssue ↗
Defaultstockholder_approval_date
No Carta target
unmappableIssue ↗
Defaultvesting_terms_idrenameIssue ↗
Defaultvestings
No Carta target
unmappableIssue ↗