use serde::Serialize;
use crate::client::{Client, Response};
use crate::ids::{CouponId, CustomerId, InvoiceId, PlanId, SubscriptionId, SubscriptionItemId};
use crate::params::{Metadata, SearchList, Timestamp};
use crate::resources::{CollectionMethod, Invoice};
#[deprecated(since = "0.12.0")]
pub type InvoiceCollectionMethod = CollectionMethod;
impl Invoice {
pub fn upcoming(client: &Client, params: RetrieveUpcomingInvoice) -> Response<Invoice> {
client.get_query("/invoices/upcoming", ¶ms)
}
pub fn finalize(
client: &Client,
invoice_id: &InvoiceId,
params: FinalizeInvoiceParams,
) -> Response<Invoice> {
client.post_form(&format!("/invoices/{}/finalize", invoice_id), params)
}
pub fn pay(client: &Client, invoice_id: &InvoiceId) -> Response<Invoice> {
client.post(&format!("/invoices/{}/pay", invoice_id))
}
pub fn search(client: &Client, params: InvoiceSearchParams) -> Response<SearchList<Invoice>> {
client.get_query("/invoices/search", params)
}
}
#[derive(Clone, Debug, Serialize)]
pub struct RetrieveUpcomingInvoice {
pub customer: CustomerId, #[serde(skip_serializing_if = "Option::is_none")]
pub coupon: Option<CouponId>,
#[serde(skip_serializing_if = "Option::is_none")]
pub subscription: Option<SubscriptionId>,
#[serde(skip_serializing_if = "Option::is_none")]
pub subscription_items: Option<SubscriptionItemFilter>,
#[serde(skip_serializing_if = "Option::is_none")]
pub subscription_prorate: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub subscription_proration_date: Option<Timestamp>,
#[serde(skip_serializing_if = "Option::is_none")]
pub subscription_tax_percent: Option<f64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub subscription_trial_end: Option<Timestamp>,
}
impl RetrieveUpcomingInvoice {
pub fn new(customer: CustomerId) -> Self {
RetrieveUpcomingInvoice {
customer,
coupon: None,
subscription: None,
subscription_items: None,
subscription_prorate: None,
subscription_proration_date: None,
subscription_tax_percent: None,
subscription_trial_end: None,
}
}
}
#[derive(Clone, Debug, Serialize)]
pub struct SubscriptionItemFilter {
#[serde(skip_serializing_if = "Option::is_none")]
pub id: Option<SubscriptionItemId>,
#[serde(skip_serializing_if = "Option::is_none")]
pub deleted: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub metadata: Option<Metadata>,
#[serde(skip_serializing_if = "Option::is_none")]
pub plan: Option<PlanId>,
#[serde(skip_serializing_if = "Option::is_none")]
pub quantity: Option<u64>,
}
#[derive(Clone, Debug, Default, Serialize)]
pub struct InvoiceSearchParams<'a> {
pub query: String,
#[serde(skip_serializing_if = "Option::is_none")]
pub limit: Option<u64>,
#[serde(skip_serializing_if = "Option::is_none")]
pub page: Option<u64>,
pub expand: &'a [&'a str],
}
impl<'a> InvoiceSearchParams<'a> {
pub fn new() -> InvoiceSearchParams<'a> {
InvoiceSearchParams { query: String::new(), limit: None, page: None, expand: &[] }
}
}
#[derive(Clone, Debug, Default, Serialize)]
pub struct FinalizeInvoiceParams {
#[serde(skip_serializing_if = "Option::is_none")]
pub auto_advance: Option<bool>,
}