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

\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{fuel}, \code{description},
\code{receipts_gbp_m}.
}
\description{
Downloads and tidies the HMRC Hydrocarbon Oils Bulletin, which reports
monthly fuel duty receipts. Data runs from January 1990 to the most
recent published month, updated twice per year (January and July).
}
\examples{
\donttest{
op <- options(hmrc.cache_dir = tempdir())
hmrc_fuel_duties(fuel = "total", start = "2010-01")
hmrc_fuel_duties()
options(op)
}

}
\seealso{
Other data fetchers: 
\code{\link{hmrc_capital_gains}()},
\code{\link{hmrc_corporation_tax}()},
\code{\link{hmrc_creative_industries}()},
\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_tobacco_duties}()},
\code{\link{hmrc_vat}()}
}
\concept{data fetchers}
