{
  "schemaVersion": "1.0",
  "artifactType": "manual-review-template",
  "edition": "2026-10-02",
  "exampleOnly": true,
  "canonicalUrl": "https://www.iamgeorgekelly.com/field-guide/sale-price-effective-date-behavior",
  "scope": "Internal manual review record. No scheduling engine, validator, upload, or merchant write is provided. Fill with authorized evidence; do not import directly as a provider feed or checker input.",
  "destinationProfiles": [
    "google-merchant-center",
    "openai-stable-native",
    "openai-google-compatible-confirmed"
  ],
  "blankRecord": {
    "reviewId": null,
    "destinationProfile": null,
    "profileConfirmationRef": null,
    "itemId": null,
    "market": null,
    "currency": null,
    "rawSalePriceEffectiveDate": null,
    "dateValueLocation": null,
    "explicitTimezone": null,
    "intendedBusinessTimezoneConfirmed": null,
    "asOf": null,
    "currentSaleState": {
      "active": null,
      "regularPrice": null,
      "currentSalePrice": null,
      "payableItemPrice": null
    },
    "feedSnapshot": {
      "price": null,
      "sale_price": null
    },
    "evidence": {
      "promotionPlanRef": null,
      "currentOfferRef": null,
      "capturedAt": null,
      "sourceContractRef": null,
      "sourceCheckedAt": null
    },
    "editorialReview": {
      "status": "hold",
      "action": null,
      "reason": "Unfilled record: supply the selected profile and current-offer evidence.",
      "reviewer": null,
      "reviewedAt": null
    },
    "proposedFeedChange": null,
    "uploadReceiptRef": null,
    "observedDestinationResultRef": null
  },
  "filledFictionalReview": {
    "reviewId": "EXAMPLE-SW6-REVIEW",
    "destinationProfile": "openai-google-compatible-confirmed",
    "profileConfirmationRef": "fictional:SW6-feed-profile-confirmation",
    "itemId": "EXAMPLE-MUG-BLUE",
    "market": "US",
    "currency": "USD",
    "rawSalePriceEffectiveDate": "2026-10-05T09:00-0400/2026-10-07T18:00-0400",
    "dateValueLocation": "Candidate compatibility date field",
    "explicitTimezone": "-0400",
    "intendedBusinessTimezoneConfirmed": true,
    "asOf": "2026-10-02T12:00:00Z",
    "currentSaleState": {
      "active": false,
      "regularPrice": "100.00 USD",
      "currentSalePrice": null,
      "payableItemPrice": "100.00 USD"
    },
    "feedSnapshot": {
      "price": "100.00 USD",
      "sale_price": "80.00 USD"
    },
    "evidence": {
      "promotionPlanRef": "fictional:SW6-promotion-plan",
      "currentOfferRef": "fictional:SW6-current-offer",
      "capturedAt": "2026-10-02T12:00:00Z",
      "sourceContractRef": "https://developers.openai.com/commerce/specs/file-upload/products",
      "sourceCheckedAt": "2026-10-02"
    },
    "editorialReview": {
      "status": "update-needed",
      "action": "prepare-removal-of-premature-sale-and-dependent-date",
      "reason": "The supplied offer remains regular price; this confirmed compatibility profile treats the future date as metadata and requires sale_price when that date is supplied.",
      "reviewer": "Fictional reviewer",
      "reviewedAt": "2026-10-02T12:05:00Z"
    },
    "proposedFeedChange": {
      "keep": {
        "price": "100.00 USD"
      },
      "omit": [
        "sale_price",
        "sale_price_effective_date"
      ],
      "preserveInternally": [
        "raw promotion interval",
        "profile confirmation",
        "current-offer evidence"
      ],
      "status": "proposal only; not submitted"
    },
    "uploadReceiptRef": null,
    "observedDestinationResultRef": null
  },
  "reviewSteps": [
    "Confirm the exact destination and registered-feed profile; do not infer Google scheduling from a compatibility label.",
    "Preserve the original interval, timezone, item, market, currency, and plan reference.",
    "Record a frozen asOf and current-sale evidence for the same selection; do not derive current truth from the date string alone.",
    "Write a proposed current-price change or a manual hold, with the field-level reason.",
    "Keep preparation, authorized upload, processing receipt, and observed destination result as separate records."
  ],
  "sources": [
    {
      "id": "google-sale-window",
      "title": "Google Merchant Center: sale price effective date",
      "url": "https://support.google.com/merchants/answer/6324460?hl=en",
      "checked": "2026-10-02",
      "note": "Defines the interval controlling sale-price display, date/time formatting, and UTC/default whole-day behavior. It does not establish exact processing times or a live display result."
    },
    {
      "id": "openai-file-products",
      "title": "OpenAI Stable file-upload products specification",
      "url": "https://developers.openai.com/commerce/specs/file-upload/products",
      "checked": "2026-10-02",
      "note": "Separates native current-price updates from the confirmed Google-compatible date-metadata field. The compatibility path must be confirmed for the registered feed; its scheduling behavior differs from Google Merchant Center."
    }
  ]
}