% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/hmrc_tobacco_duties.R
\name{hmrc_tobacco_duties}
\alias{hmrc_tobacco_duties}
\title{Download HMRC tobacco duty receipts}
\source{
\url{https://www.gov.uk/government/statistics/tobacco-bulletin}
}
\usage{
hmrc_tobacco_duties(product = NULL, start = NULL, end = NULL, cache = TRUE)
}
\arguments{
\item{product}{Character vector or \code{NULL} (default = all products).
Valid values: \code{"cigarettes"}, \code{"cigars"}, \code{"hand_rolling"},
\code{"other"}, \code{"total"}.}

\item{start}{Character \code{"YYYY-MM"} or a \code{Date} object.}

\item{end}{Character \code{"YYYY-MM"} or a \code{Date} object.}

\item{cache}{Logical. Use cached file if available (default \code{TRUE}).}
}
\value{
An \code{hmrc_tbl} with columns \code{date}, \code{product}, \code{description},
\code{receipts_gbp_m}.
}
\description{
Downloads and tidies the HMRC Tobacco Bulletin, which reports monthly
tobacco products duty receipts by product type. Data runs from January
1991 to the most recent published month, updated twice per year
(February and August).
}
\examples{
\donttest{
op <- options(hmrc.cache_dir = tempdir())
hmrc_tobacco_duties(start = "2015-01")
hmrc_tobacco_duties(product = "cigarettes")
options(op)
}

}
\seealso{
Other data fetchers: 
\code{\link{hmrc_capital_gains}()},
\code{\link{hmrc_corporation_tax}()},
\code{\link{hmrc_creative_industries}()},
\code{\link{hmrc_fuel_duties}()},
\code{\link{hmrc_income_tax_stats}()},
\code{\link{hmrc_inheritance_tax}()},
\code{\link{hmrc_patent_box}()},
\code{\link{hmrc_property_transactions}()},
\code{\link{hmrc_rd_credits}()},
\code{\link{hmrc_stamp_duty}()},
\code{\link{hmrc_tax_gap}()},
\code{\link{hmrc_tax_receipts}()},
\code{\link{hmrc_vat}()}
}
\concept{data fetchers}
