Feature/stripe mrr arr models by fivetran-savage · Pull Request #138 · fivetran/dbt_stripe

fivetran-savage · 2025-11-25T20:02:20Z

PR Overview

Package version introduced in this PR:

1.4.0

This PR addresses the following Issue/Feature(s):

GA-1007423

Summary of changes:

Adds one net-new end model to calculate MRR at the subscription_item level: stripe__subscription_item_mrr_report.
- Adds consistency test for new end model.
Adds seed data for price_plan.
Adds analyses folder with two analysis models: stripe__arr_snapshot_analysis, a high-level ARR snapshot report and stripe__customer_mrr_analysis, an MRR report at the customer level.
Adds new staging model stg_stripe__coupon.
Adds seed data for coupon model.
Adds intermediate model to join coupons and discounts.

Submission Checklist

Alignment meeting with the reviewer (if needed)
- Timeline and validation requirements discussed
Provide validation details:
- Validation Steps: Check for unintentional effects (e.g., add/run consistency & integrity tests)
- Testing Instructions: Confirm the change addresses the issue(s)
- Focus Areas: Complex logic or queries that need extra attention
[NA] Merge any relevant open PRs into this PR

Changelog

Draft changelog for PR
Final changelog for release review

* MagicBot/bump-dbt-to-v3 * Generate dbt docs via GitHub Actions --------- Finish merge of MRR/ARR model updates Co-authored-by: Claude README Updater <noreply@fivetran.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

fivetran-catfritz · 2025-12-09T19:49:16Z

Approved for pre-release.

fivetran-avinash

@fivetran-savage Ready to go, but not approved since it's a pre-release.

…r-models

fivetran-joemarkiewicz

@fivetran-savage great work on this PR! Some comments before approval. Let me know if you have any questions. Thanks!

fivetran-joemarkiewicz

LGTM after docs are generated

fivetran-catfritz · 2026-01-29T19:46:33Z

+| [`stripe__subscription_item_mrr_report`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stripe__subscription_item_mrr_report) | New End Model | | | Each record represents a subscription item for a given month with MRR metrics for both contract and billed/net mrr, movement classification, and monthly discounts applied. Tracks MRR changes over time, classifying each month as new, expansion, contraction, churned, reactivation, or unchanged. If you notice any discrepencies in MRR calculations with this new model, please open up a [support ticket](https://support.fivetran.com/hc/en-us). |
+| [`stg_stripe__coupon`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__coupon) | New Staging Model | | | Staging model for Stripe coupon data. |
+| [`stg_stripe__coupon_tmp`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__coupon_tmp) | New Staging Model | | | |
+| [`stg_stripe__price_plan`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__price_plan) | Explicitly casts`recurring_interval` field as string, `recurring_interval_count` field as integer, and `price_plan_id` field as string.| | | Avoids datatype errors. |


Suggestion so it's more in line with other changelogs.

Suggested change

| [`stg_stripe__price_plan`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__price_plan) | Explicitly casts`recurring_interval` field as string, `recurring_interval_count` field as integer, and `price_plan_id` field as string.| | | Avoids datatype errors. |

| [`stg_stripe__price_plan`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__price_plan) | Datatype Casts | | `recurring_interval` as `string`<br>`recurring_interval_count` field as `integer`<br>`price_plan_id` field as `string` | Avoids datatype errors. |

fivetran-catfritz · 2026-01-29T19:48:37Z

+| [`stg_stripe__coupon`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__coupon) | New Staging Model | | | Staging model for Stripe coupon data. |
+| [`stg_stripe__coupon_tmp`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__coupon_tmp) | New Staging Model | | | |
+| [`stg_stripe__price_plan`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__price_plan) | Explicitly casts`recurring_interval` field as string, `recurring_interval_count` field as integer, and `price_plan_id` field as string.| | | Avoids datatype errors. |
+| [`stg_stripe__subscription_item`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__subscription_item) | Explicitly casts `plan_id` field as string. | | | Avoids datatype errors. |


Suggested change

| [`stg_stripe__subscription_item`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__subscription_item) | Explicitly casts `plan_id` field as string. | | | Avoids datatype errors. |

| [`stg_stripe__subscription_item`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__subscription_item) | Datatype Casts | `plan_id` field as `string` | | Avoids datatype errors. |

Co-authored-by: fivetran-catfritz <111930712+fivetran-catfritz@users.noreply.github.com>

fivetran-catfritz

approved for release!

fivetran-savage added 3 commits November 24, 2025 11:35

feature/stripe-mrr-arr-models

528f205

add_price_plan_seed_data

8cfb74e

Update PR reference in CHANGELOG.md

00f748e

fivetran-savage requested a review from fivetran-joemarkiewicz November 25, 2025 20:09

update_price_seed_data

0e5ff19

fivetran-joemarkiewicz assigned fivetran-savage Nov 26, 2025

fivetran-savage and others added 11 commits November 26, 2025 08:37

update CHANGELOG

bcd3252

dbt bump to v3.0.0 (#137)

4cf6395

* MagicBot/bump-dbt-to-v3 * Generate dbt docs via GitHub Actions --------- Finish merge of MRR/ARR model updates Co-authored-by: Claude README Updater <noreply@fivetran.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

continue rebase - resolve conflict

9d4b6b6

Update PR reference in CHANGELOG.md

2077707

add-arr-to-analysis-folder

5e3efc4

update_folder_name

70d297a

Merge branch 'main' into feature/stripe-mrr-arr-models

ef514e9

update-project-yml

765788a

add_config_to_analyses

92904e6

update_changelog

23cd46e

prerelease_update

577afa5

fivetran-savage added the pre-release Triggers the auto-releaser workflow. label Dec 9, 2025

add_new_model_to_quickstart

6f66adf

fivetran-savage added pre-release Triggers the auto-releaser workflow. and removed pre-release Triggers the auto-releaser workflow. labels Dec 12, 2025

fivetran-avinash reviewed Dec 12, 2025

View reviewed changes

fivetran-savage added the docs:ready Triggers the docs generator workflow. label Dec 15, 2025

github-actions Bot and others added 2 commits December 15, 2025 18:03

Generate dbt docs via GitHub Actions

2f8af64

add_docs

df0172d

fivetran-savage added pre-release Triggers the auto-releaser workflow. and removed pre-release Triggers the auto-releaser workflow. labels Dec 15, 2025

fivetran-avinash reviewed Dec 15, 2025

View reviewed changes

Comment thread CHANGELOG.md Outdated

fivetran-avinash reviewed Dec 15, 2025

View reviewed changes

Comment thread CHANGELOG.md Outdated

add_coupon_and_int_discount_model

e92da7b

fivetran-savage removed docs:ready Triggers the docs generator workflow. pre-release Triggers the auto-releaser workflow. labels Jan 16, 2026

fivetran-savage added 6 commits January 16, 2026 14:02

correct_version

6ae933e

Merge remote-tracking branch 'origin/main' into feature/stripe-mrr-ar…

4fab22e

…r-models

Cast recurring_interval_count to integer type

a37a417

cast discount_amount as dbt.type_numeric

ba77519

Fix discount_amount cast

aa21685

update_version

7944982

fivetran-joemarkiewicz requested changes Jan 26, 2026

View reviewed changes

incorporate_review_suggestions

1d3e7c2

fivetran-joemarkiewicz requested changes Jan 27, 2026

View reviewed changes

Comment thread .quickstart/quickstart.yml Outdated

Comment thread CHANGELOG.md Outdated

Comment thread CHANGELOG.md Outdated

Comment thread README.md

Comment thread DECISIONLOG.md

Comment thread models/staging/stg_stripe__coupon.sql Outdated

Comment thread models/stripe.yml Outdated

fivetran-savage added 3 commits January 27, 2026 15:24

Add 'coupon' feature to disable models section

60046da

update_changelog

9821457

remove_subscription_variable_from_subscription_item

0800ac1

fivetran-joemarkiewicz requested changes Jan 28, 2026

View reviewed changes

Comment thread README.md Outdated

Comment thread models/stripe__subscription_item_mrr_report.sql Outdated

Comment thread models/stripe__subscription_item_mrr_report.sql Outdated

fix_variable_config_placement

eb640c7

fivetran-joemarkiewicz approved these changes Jan 28, 2026

View reviewed changes

fivetran-savage added the docs:ready Triggers the docs generator workflow. label Jan 28, 2026

github-actions Bot and others added 2 commits January 28, 2026 22:19

Generate dbt docs via GitHub Actions

1505af4

update_changelog

d666c43

fivetran-catfritz reviewed Jan 29, 2026

View reviewed changes

Incorporate review suggestions

24be7b2

fivetran-catfritz reviewed Jan 29, 2026

View reviewed changes

Comment thread CHANGELOG.md Outdated

Comment thread CHANGELOG.md Outdated

fivetran-savage and others added 3 commits January 29, 2026 12:27

Update CHANGELOG.md

024b26a

Co-authored-by: fivetran-catfritz <111930712+fivetran-catfritz@users.noreply.github.com>

Update CHANGELOG.md

fabb267

Co-authored-by: fivetran-catfritz <111930712+fivetran-catfritz@users.noreply.github.com>

Update CHANGELOG

060bdf4

fivetran-catfritz approved these changes Jan 29, 2026

View reviewed changes

fivetran-savage merged commit 922ae62 into main Jan 29, 2026
9 checks passed

fivetran-savage deleted the feature/stripe-mrr-arr-models branch January 29, 2026 20:55

	\| [`stg_stripe__price_plan`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__price_plan) \| Explicitly casts`recurring_interval` field as string, `recurring_interval_count` field as integer, and `price_plan_id` field as string.\| \| \| Avoids datatype errors. \|
	\| [`stg_stripe__price_plan`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__price_plan) \| Datatype Casts \| \| `recurring_interval` as `string`<br>`recurring_interval_count` field as `integer`<br>`price_plan_id` field as `string` \| Avoids datatype errors. \|

	\| [`stg_stripe__subscription_item`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__subscription_item) \| Explicitly casts `plan_id` field as string. \| \| \| Avoids datatype errors. \|
	\| [`stg_stripe__subscription_item`](https://fivetran.github.io/dbt_stripe/#!/model/model.stripe.stg_stripe__subscription_item) \| Datatype Casts \| `plan_id` field as `string` \| \| Avoids datatype errors. \|

Uh oh!

Conversation

fivetran-savage commented Nov 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Overview

Submission Checklist

Changelog

Uh oh!

fivetran-catfritz commented Dec 9, 2025

Uh oh!

fivetran-avinash left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

fivetran-joemarkiewicz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fivetran-joemarkiewicz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

fivetran-catfritz Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

fivetran-catfritz Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fivetran-catfritz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

fivetran-savage commented Nov 25, 2025 •

edited

Loading

fivetran-avinash left a comment •

edited

Loading