update Invoice

 * add backwards-compatible 'auto_advance' attribute, per <https://stripe.com/docs/upgrades#2018-11-08>
 * add backwards-compatible 'created' attribute, per <https://stripe.com/docs/upgrades#2019-03-14>
 * remove required constraints for 'closed' and 'date' attributes
 * update POD

README.pod

@@ -1225,6 +1225,27 @@ L<https://stripe.com/docs/upgrades#2018-08-23>, you can no longer use
 is reserved for immediate canceling going forward. You should update your
 code to use 'cancel_at_period_end in update_subscription() instead.
 
+=item update 'date' to 'created' for Invoice
+
+While the API returns both 'date' and 'created' for earlier versions, making
+the update backwards-compatible, Stripe API versions after 2019-03-14
+L<https://stripe.com/docs/upgrades#2019-03-14> only return 'created', so you
+should update your code where necessary to use the 'created' method for
+Invoice objects in preparation for the eventual deprecation of the 'date'
+argument.
+
+=item use 'auto_advance' instead of 'closed' for Invoice
+
+The 'closed' attribute for the Invoice object controls automatic collection,
+and has been deprecated in favor of the more specific 'auto_advance' attribute.
+Where you might have set closed=true on Invoices in the past, set
+auto_advance=false. While the API returns both 'closed' and 'auto_advance'
+for earlier versions, making the update backwards-compatible, Stripe API
+versions after 2018-11-08 L<https://stripe.com/docs/upgrades#2018-11-08>
+only return 'auto_advance', so you should update your code where necessary to
+use the 'auto_advance' argument and method for Invoice objects in preparation
+for the eventual deprecation of the 'closed' argument.
+
 =back
 
 =head3 BUG FIXES
@@ -1373,6 +1394,13 @@ Added 'balance' attribute and arguments for Customer objects and methods.
 Added 'cancel_at_period_end' argument update_subscription() and added
 'cancel_at_period_end' to the POST stream for Subscription objects.
 
+=item update Invoice
+
+Added 'created' attribute for Invoice objects, and removed the required
+constraint for the deprecated 'date' attribute. Also added the 'auto_advance'
+attribute and removed the required constraint for the deprecated 'closed'
+attribute.
+
 =back
 
 =head1 SEE ALSO

lib/Net/Stripe.pm

@@ -140,6 +140,27 @@ L<https://stripe.com/docs/upgrades#2018-08-23>, you can no longer use
 is reserved for immediate canceling going forward. You should update your
 code to use 'cancel_at_period_end in update_subscription() instead.
 
+=item update 'date' to 'created' for Invoice
+
+While the API returns both 'date' and 'created' for earlier versions, making
+the update backwards-compatible, Stripe API versions after 2019-03-14
+L<https://stripe.com/docs/upgrades#2019-03-14> only return 'created', so you
+should update your code where necessary to use the 'created' method for
+Invoice objects in preparation for the eventual deprecation of the 'date'
+argument.
+
+=item use 'auto_advance' instead of 'closed' for Invoice
+
+The 'closed' attribute for the Invoice object controls automatic collection,
+and has been deprecated in favor of the more specific 'auto_advance' attribute.
+Where you might have set closed=true on Invoices in the past, set
+auto_advance=false. While the API returns both 'closed' and 'auto_advance'
+for earlier versions, making the update backwards-compatible, Stripe API
+versions after 2018-11-08 L<https://stripe.com/docs/upgrades#2018-11-08>
+only return 'auto_advance', so you should update your code where necessary to
+use the 'auto_advance' argument and method for Invoice objects in preparation
+for the eventual deprecation of the 'closed' argument.
+
 =back
 
 =head3 BUG FIXES
@@ -288,6 +309,13 @@ Added 'balance' attribute and arguments for Customer objects and methods.
 Added 'cancel_at_period_end' argument update_subscription() and added
 'cancel_at_period_end' to the POST stream for Subscription objects.
 
+=item update Invoice
+
+Added 'created' attribute for Invoice objects, and removed the required
+constraint for the deprecated 'date' attribute. Also added the 'auto_advance'
+attribute and removed the required constraint for the deprecated 'closed'
+attribute.
+
 =back
 
 =method new PARAMHASH
@@ -1839,7 +1867,8 @@ Invoices: {
                           Int :$application_fee?,
                           Str :$description?,
                           HashRef :$metadata?,
-                          Net::Stripe::Subscription|Str :$subscription?) {
+                          Net::Stripe::Subscription|Str :$subscription?,
+                          Bool :$auto_advance?) {
         if (ref($customer)) {
             $customer = $customer->id;
         }
@@ -1854,14 +1883,16 @@ Invoices: {
                                 application_fee => $application_fee,
                                 description => $description,
                                 metadata => $metadata,
-                                subscription =>$subscription
+                                subscription => $subscription,
+                                auto_advance => $auto_advance,
                             });
     }
 
 
     method post_invoice(Net::Stripe::Invoice|Str :$invoice,
                         Int :$application_fee?,
                         Bool :$closed?,
+                        Bool :$auto_advance?,
                         Str :$description?,
                         HashRef :$metadata?) {
         if (ref($invoice)) {
@@ -1872,6 +1903,7 @@ Invoices: {
                             {
                                 application_fee => $application_fee,
                                 closed => $closed,
+                                auto_advance => $auto_advance,
                                 description => $description,
                                 metadata => $metadata
                             });

lib/Net/Stripe/Invoice.pm

@@ -12,9 +12,10 @@ has 'subtotal'      => ( is => 'ro', isa => 'Maybe[Int]', required => 1 );
 has 'amount_due'    => ( is => 'ro', isa => 'Maybe[Int]', required => 1 );
 has 'attempt_count' => ( is => 'ro', isa => 'Maybe[Int]', required => 1 );
 has 'attempted'     => ( is => 'ro', isa => 'Maybe[Bool|Object]', required => 1 );
-has 'closed'        => ( is => 'ro', isa => 'Maybe[Bool|Object]', required => 1, trigger => \&_closed_change_detector);
-has 'customer'      => ( is => 'ro', isa => 'Maybe[Str]', required => 1 );
-has 'date'          => ( is => 'ro', isa => 'Maybe[Str]', required => 1 );
+has 'closed'        => ( is => 'ro', isa => 'Maybe[Bool|Object]', trigger => \&_closed_change_detector);
+has 'auto_advance'  => ( is => 'ro', isa => 'Maybe[Bool]');
+has 'created'       => ( is => 'ro', isa => 'Maybe[Int]' );
+has 'date'          => ( is => 'ro', isa => 'Maybe[Str]' );
 has 'lines'         => ( is => 'ro', isa => 'Net::Stripe::List', required => 1 );
 has 'paid'          => ( is => 'ro', isa => 'Maybe[Bool|Object]', required => 1 );
 has 'period_end'    => ( is => 'ro', isa => 'Maybe[Int]' );
@@ -41,7 +42,7 @@ sub _closed_change_detector {
 
 method form_fields {
     return $self->form_fields_for(
-        qw/description metadata/,
+        qw/description metadata auto_advance/,
         ($self->{closed_value_changed} ? qw/closed/ : ())
     );
 }