Canonical Definition
{
"audit_events": [
"case_created",
"document_uploaded",
"document_extracted",
"field_corrected",
"validation_passed",
"validation_failed",
"review_requested",
"approved",
"rejected",
"signature_requested",
"signature_completed",
"proof_anchored"
],
"editor_hints": {
"canonical_graph_format": "hera_workflow_request",
"future_compilers": [
"rust_module",
"wasm_rule_pack"
],
"importers": [
"dify_json"
]
},
"id": "kyb_case",
"metadata": {
"artifact_type": "vetra-kyb-case-workflow",
"category": "compliance",
"consumers": [
"Vetra-rust",
"Imaginclaw"
],
"owner_app": "Vetra-rust",
"promotion_reason": "KYB execution must remain external to the app UI while staying reusable across Vetra surfaces.",
"scope": "app-scoped",
"version": "1.0.0"
},
"overlays": {
"co": {
"checks": [
"registry_chamber_of_commerce",
"ofac",
"pep"
],
"required_documents": [
"certificate_of_incorporation",
"rut",
"representative_id",
"bank_statement"
]
},
"default": {
"languages": [
"es",
"en"
],
"required_documents": [
"certificate_of_incorporation",
"representative_id",
"bank_statement"
],
"signature_required": true
},
"us": {
"checks": [
"ofac",
"state_registry",
"ubo"
],
"required_documents": [
"certificate_of_incorporation",
"ein_letter",
"representative_id",
"bank_statement"
]
}
},
"roles": {
"applicant": [
"create_case",
"upload_documents",
"confirm_extracted_fields",
"sign_attestation"
],
"auditor": [
"read_events",
"read_artifacts",
"verify_hash_chain",
"verify_blockchain_proof"
],
"reviewer": [
"review_flags",
"request_changes",
"approve_case",
"reject_case"
],
"system": [
"extract_facts",
"run_checks",
"create_snapshot",
"anchor_proof"
]
},
"slug": "kyb-case",
"stages": [
{
"key": "intake",
"outputs": [
"case_profile"
],
"required_fields": [
"company_name",
"jurisdiction",
"language",
"representative_name"
],
"title": {
"en": "Intake",
"es": "Inicio"
}
},
{
"key": "document_collection",
"outputs": [
"uploaded_documents"
],
"required_documents_by_overlay": true,
"title": {
"en": "Documents",
"es": "Documentos"
}
},
{
"key": "extraction",
"outputs": [
"extracted_facts",
"field_confidence",
"source_map"
],
"title": {
"en": "Extraction",
"es": "Extraccion"
},
"tools": [
"run_ocr",
"extract_document_facts",
"validate_bank_document"
]
},
{
"key": "automated_checks",
"outputs": [
"risk_flags",
"risk_score",
"check_report"
],
"title": {
"en": "Automated checks",
"es": "Validaciones automaticas"
},
"tools": [
"run_sanctions_check",
"validate_company_registry",
"validate_address_consistency"
]
},
{
"key": "manual_review",
"outputs": [
"decision",
"decision_reason",
"review_notes"
],
"title": {
"en": "Manual review",
"es": "Revision humana"
}
},
{
"key": "attestation",
"outputs": [
"signed_attestation",
"proof_record"
],
"title": {
"en": "Signature and proof",
"es": "Firma y prueba"
},
"tools": [
"request_signature",
"register_signature",
"create_blockchain_proof"
]
}
],
"status_model": {
"allowed": [
"draft",
"awaiting_documents",
"extracting",
"awaiting_user_confirmation",
"automated_checks",
"manual_review",
"awaiting_signature",
"approved",
"rejected",
"expired"
],
"initial": "draft"
},
"summary": {
"en": "Multi-stage business verification with document extraction, review, signature, and verifiable proof.",
"es": "Proceso empresarial multi-etapa con extraccion documental, revision, firma y prueba verificable."
},
"title": {
"en": "Versioned KYB case",
"es": "Expediente KYB versionado"
}
}