README.md

# ExVatcheck

An Elixir Package for verifying VAT identification numbers using the
[VIES](http://ec.europa.eu/taxation_customs/vies/) service.

## Usage

To validate a VAT identification number, simply run:

```elixir
iex(1)> ExVatcheck.check("GB333289454")
%ExVatcheck.VAT{
  exists: true,
  valid: true,
  vies_available: true,
  vies_response: %{
    address: "BC0 B1 D1 BROADCAST CENTRE\nWHITE CITY PLACE\n201 WOOD LANE\nLONDON\n\nW12 7TP",
    country_code: "GB",
    name: "BRITISH BROADCASTING CORPORATION",
    request_date: "2019-04-06",
    valid: true,
    vat_number: "333289454"
  }
}
```

## Installation

If [available in Hex](https://hex.pm/docs/publish), the package can be installed
by adding `ex_vatcheck` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:ex_vatcheck, "~> 0.3.1"}
  ]
end
```

Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
be found at [https://hexdocs.pm/ex_vatcheck](https://hexdocs.pm/ex_vatcheck).

## Development

### Testing

To run the full test suite, run:

```
$ mix test
```

To run the test suite with a code coverage report, run:

```
$ mix test --cover
```

### Linting

To run the linter, run:

```
$ mix credo
```

### Type Analysis

To run static type analysis on the project using Dialyzer, run the following command:

```
$ mix dialyzer
```

The first time this command is run, it will first generate the PLT for the Elixir
standard library. It can take a little while, but subsequent Dialyzer runs should
be take a fraction of the time. The compiled PLT is saved at
`~/.dialyxir_core_${OTP_VERSION}_${ELIXIR_VERSION}.plt`. More information about
the PLT can be found here: https://github.com/jeremyjh/dialyxir#plt.