Read minimized verified evidence for a named approval request
Default off; requires COMMERCE_MCP_OAUTH_CONNECTED_ENABLED, the exact fresh nine-scope v3 consent, current Microsoft purchase and membership, and signed supported-source eligibility. It never upgrades a legacy v1 or v2 grant. Requires approval:request and current Accounts owner/admin. Only exact saved ORDER_ACCEPTANCE or REFUND_REQUEST SHADOW evidence and its current selected policy are admitted. Returns facts, missing/violated checks and verified dossier/action commitments. It neither completes a human approval nor executes an action.
Authorization
CommerceAccountsOAuth Opaque Accounts-issued Commerce OAuth access credential with resource-bound current purchase. Legacy base3, signed v2 ERP/history and fresh signed v3 nine-scope connected grants retain distinct route profiles. Refresh credentials never authenticate. Per-operation connection, current role, proof, quota and confirmation checks remain mandatory.
In: header
Request Body
application/json
uuiduuid1 <= length <= 100Response Body
application/json
curl -X POST "https://example.com/v1/protocol/commerce/connected/approvals/evidence" \ -H "Content-Type: application/json" \ -d '{ "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b", "dossier_id": "8a9bfc13-db6c-4e62-a117-1a4399450d29", "policy_version": "string" }'{ "version": "commerce-approval-evidence-v1", "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b", "dossier_id": "8a9bfc13-db6c-4e62-a117-1a4399450d29", "dossier_sha256": "string", "evaluation_id": "4108ec8e-6efd-4b9b-bace-0bb4c296c324", "action_type": "ORDER_ACCEPTANCE", "action_sha256": "string", "platform": "business-central", "order_id": "string", "amount": 0, "currency": "string", "policy": { "bundle_id": "fc6f5a67-caa1-4339-9c14-a67826143b60", "version": "string", "policy_digest": "string" }, "mode": "SHADOW", "outcome": "APPROVE", "preflight": { "version": "commerce-preflight-v2", "action_type": "PRICE_CHANGE", "action_digest": "string", "facts_digest": "string", "policy_version": "string", "idempotency_key": "string", "evaluated_at": "2019-08-24T14:15:22Z", "disposition": "PROCEED", "execution_available": false, "checks": [ { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } }, { "id": "P01", "status": "evaluated", "verdict": "PROCEED", "reason_codes": [ "string" ], "missing_facts": [ "string" ], "measurements": { "property1": 0, "property2": 0 } } ] }, "source_evidence": { "provenance": "supplied_evidence", "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9", "revision": -9007199254740991, "snapshot_sha256": "string" }, "review": { "summary": "string", "facts": [ { "key": "resource_id", "value": "string" } ] }, "verification": { "signature_verified": true, "inputs_commitment_verified": true, "policy_current": true }, "execution_available": false}Read an immutable historical assessment GET
Default off; requires COMMERCE_MCP_OAUTH_DATA_ACCESS_ENABLED and COMMERCE_MCP_BUSINESS_CENTRAL_ENABLED, a live Accounts Microsoft purchase, current membership and signed v2 or v3 consent. An opaque connection identifies a separately verified company within the purchaser tenant extracted by Accounts. Reads are bounded to eight seconds and 100 documents, return no connector credentials, and cannot execute an ERP action. Connected v3 source discovery reports BC history unavailable; its historical tools cover only Walmart and Adobe. This preserved BC historical flow admits only v2 erp:read and history:assess consent; v3 grants are refused. COMMERCE_HISTORY_ENABLED and an explicit history_assessment_limit_monthly in the verified publisher/offer/plan mapping are required; a missing limit disables assessments. Compares available historical merchandise margin against the exact selected policy floor over the previous ninety complete UTC dates. Missing costs or provenance are not_assessed; this is not full policy replay, execution authority, or a ninety-day trial. Results disclose partial coverage and are unsigned. Requires the same immutable Accounts user, workspace, membership and source entitlement; current authority and company connection are checked. Reading a saved report consumes no allowance.
Prepare current company-native order evidence and exact policy GET
Default off; requires COMMERCE_MCP_OAUTH_CONNECTED_ENABLED, the exact fresh nine-scope v3 consent, current Microsoft purchase and membership, and signed supported-source eligibility. It never upgrades a legacy v1 or v2 grant. Also requires COMMERCE_MCP_BUSINESS_CENTRAL_NATIVE_ENABLED and a separately verified current company connection/native read grant within the purchaser tenant extracted by Accounts. No caller-supplied tenant, economics or source URL is accepted. Eight-second deadline and fixed bounded source reads apply. Requires erp:read and erp:validate. Returns an immutable snapshot digest, explicit cost provenance and exact signed policy. Admitted v2 evidence binds complete source cost from the verified effective company profile; v1 retains its native current-estimate provenance and missing landed cost. Preparation does not reserve budget or authorize an ERP write.