README.Rmd

---
output: github_document
---

<!-- README.md is generated from README.Rmd. Please edit that file -->

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "inst/app/www/",
  out.width = "100%"
)
```

# 🛍 shopper <a href='https:/shopper.github.io'><img src="inst/app/www/favicon.png" align="right" height="135"/></a>

<!-- badges: start -->

[![Lifecycle: maturing](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)

<!-- badges: end -->

Package to collect tax receipt data from SEFAZ-RS.

<img src="https://media.giphy.com/media/KxtMLfh8k8GEJHpBVi/giphy.gif" align="right" padding-left="10 px" width="30%"/>

For now the package only collects data from the link generated by the QR in the tax receipts.

## Installation

You can install the development version from [GitHub](https://github.com/) with:

``` r
# install.packages("remotes")
remotes::install_github("fcsest/shopper")
```

## Example

This package helps in collecting data from SEFAZ-RS receipts, below is an example of a complete receipt:

![Full Receipt SEFAZ-RS](https://github.com/fcsest/shopper/raw/master/inst/app/www/example_full.png)

To collect the data we need to cropping the QR Code like this:

![Cropped SEFAZ-RS](https://github.com/fcsest/shopper/raw/master/inst/app/www/example.png)

And setting the image cropped as parameter to `shopper::get_qrcode_text()`...

```{r example, echo=TRUE}
# Importing pipe
library(magrittr)
# Importing the shopper package
library(shopper)

# QR Code cropped
image_example <- "https://github.com/fcsest/shopper/raw/master/inst/app/www/example.png"

# Read QR Code of impressed receipt 
my_df <- get_qrcode_text(image_example) %>% 
  get_sefaz_rs_rdata()

# Structure of data frame
str(my_df)
```