Function buildReportingAdjustmentReceipt

Parameters

• adjustment: ReportingAdjustment
• revision: {
      reporting_revision_id: string;
      revision_content_sha256: string;
      report_definition_id: string;
      report_definition_uri: string;
      report_definition_sha256: string;
      reporting_profile: string;
      schema_version: string;
      schema_uri: string;
      schema_sha256: string;
      schema_dialect: "https://json-schema.org/draft/2020-12/schema";
      schema_ref_policy: "local_fragment_only";
      account_id: string;
      media_buy_ids: string[];
      coverage: ReportingCoverage;
      period: { start: string; end: string; source_timezone: string };
      finality: ReportingFinality;
      finality_basis?: "source_final" | "contractual_cutoff" | "stabilized";
      finality_policy_id?: string;
      finalized_at?: string;
      observed_at: string;
      data_through: string | null;
      data_through_precision: "unknown" | "exact" | "lower_bound";
      supersedes_reporting_revision_id?: string;
      row_count: number;
      control_totals: ReportingControlTotal[];
      canonical_content_digest?: ReportingCanonicalContentDigest;
      created_at: string;
  }

  • reporting_revision_id: string

    Portable AdCP identity for this immutable report publication. Distinct from package delivery_revision_id and provider-native versions.

  • revision_content_sha256: string

    SHA-256 of the immutable RFC 8785 JCS binding object containing reporting_revision_id, row_count, control_totals, and reporting_rows. Reliable Reporting 1.0 Core revisions include it and exact reads return the identical value.

  • report_definition_id: string

    Identity or canonical fingerprint of immutable metric, grain, attribution, breakdown, action-definition, profile, and calendar/timezone semantics.

  • report_definition_uri: string

  • report_definition_sha256: string

  • reporting_profile: string

  • schema_version: string

  • schema_uri: string

    Machine-readable schema on the authenticated seller/provider or AdCP-registry origin.

  • schema_sha256: string

    Digest of the exact schema bytes used to validate this immutable revision.

  • schema_dialect: "https://json-schema.org/draft/2020-12/schema"

    Closed SDK-bundled dialect; the metaschema is never network-fetched.

  • schema_ref_policy: "local_fragment_only"

    The fetched schema is self-contained and every $ref is a local # fragment.

  • account_id: string

  • media_buy_ids: string[]

    Exact frozen media-buy denominator inherited from the obligation, including buys with zero rows. An empty array proves a zero-buy period rather than an unknown denominator.

  • coverage: ReportingCoverage

  • period: { start: string; end: string; source_timezone: string }

    Half-open reporting interval with its source calendar boundary.

  • finality: ReportingFinality

  • Optionalfinality_basis?: "source_final" | "contractual_cutoff" | "stabilized"

    Why an official revision is considered final: an authoritative source signal, a versioned contractual cutoff, or a versioned stabilization rule.

  • Optionalfinality_policy_id?: string

    Immutable policy/version reference that defines the selected finality basis. It MUST be bound by report_definition_id.

  • Optionalfinalized_at?: string

    When the producer applied the declared finality basis to this official revision.

  • observed_at: string

    When the seller obtained or committed this source observation.

  • data_through: string | null

    Latest event time conservatively included, or null when precision is unknown.

  • data_through_precision: "unknown" | "exact" | "lower_bound"

  • Optionalsupersedes_reporting_revision_id?: string

    Immediately superseded snapshot revision of the same logical slice. An official revision is terminal and MUST NOT be named here; later corrections use reporting-adjustment records.

  • row_count: number

    Logical row count, including zero for a successfully evaluated empty report.

  • control_totals: ReportingControlTotal[]

    Profile-defined totals computed from the canonical logical revision. Names MUST be unique.

  • Optionalcanonical_content_digest?: ReportingCanonicalContentDigest

  • created_at: string

• options: {
      reportingReceiptId?: string;
      observedAt?: string;
      supersedesReportingReceiptId?: string;
  } = {}