SKD de integracao com RV Tecnologia
Project description
# rv-schubert-sdk
SDK de integração com a RV Tecnologia por meio de sua `API XML`
### Dependências
Atualmente o SDK é dependente dos seguintes pacotes:
```
- xmltodict
- json
- requests
- pendulum
```
### Considerações
O objeto `Recarga`, retorna as datas por padrão usando a lib `pendulum` pois é mais pratico para calculos de datas se
houver necessidade.
O objeto `Recarga` nada mais é que um helper para acessar a resposta padrão da `API` da `RV`.
### Integrações e tarefas pendentes
#### Transações
- [X] 1 - Consulta de Produtos e Operadoras
- [X] 3 - Venda de PINs
- [ ] 5 - Venda de RECARGA ONLINE
- [ ] 6 - Consulta de Status
- [ ] 7 - Confirmação / Desfazimento de Transações
- [ ] 8 - Lista de Transações Pendentes
- [ ] 9 - Consulta Limite de Crédito
- [ ] 10 - Consulta Lista de Boletos
- [ ] 11 - Consulta de Boleto
- [ ] 12 - Emissão Boleto Antecipado
- [ ] 13 - Consulta Totais por Dia
- [ ] 15 - Detalhe Venda
- [ ] 16 - Resumo Vendas
- [ ] 17 - Relatório Vendas
- [ ] 18 - Lista Vendas
#### Erros customizados implementados
Se você não desejar controlar os erros em um nível tão amplo, poderá utilizar `ErroRV` que é base para todos
os erros abaixo, ou seja, todos os erros abaixo herdam de `ErroRV`.
Caso haja um `raise` de erro, você poderá tratar da seguinte forma:
```python
try:
# seu codigo
except ErroRV as e:
print(str(e))
```
Ou caso queira algo mais específico:
```python
try:
# seu codigo
except FoneIncompletoInvalido as e:
print(str(e))
```
Os erros configuráveis são:
* `FoneIncompletoInvalido`
* `LimiteCreditoInsuficiente`
* `EstoqueInsuficiente`
* `TelefoneNaoAutorizado`
* `SenhaInvalida`
* `MaximoNumeroConexoesAtingida`
* `SistemaEmManutencao`
* `OperadoraProdutoNaoEncontrado`
* `CodigoInvalido`
* `ValorInvalido`
* `Timeout`
* `CompraExpirada`
* `CompraInexistente`
* `UsuarioLojaNaoEncontrado`
* `ParametrosInsuficientes`
* `CompraJaConfirmada`
* `BoletoNaoEncontrado`
* `ParametrosNaoEnviadosViaPOST`
* `CodigoTransacaoNaoInformado`
* `VersaoNaoInformada`
* `UsuarioSemNivelDeAcesso`
* `CobrancaAindaNaoVisualizada`
* `TransacaoNaoPermitida`
SDK de integração com a RV Tecnologia por meio de sua `API XML`
### Dependências
Atualmente o SDK é dependente dos seguintes pacotes:
```
- xmltodict
- json
- requests
- pendulum
```
### Considerações
O objeto `Recarga`, retorna as datas por padrão usando a lib `pendulum` pois é mais pratico para calculos de datas se
houver necessidade.
O objeto `Recarga` nada mais é que um helper para acessar a resposta padrão da `API` da `RV`.
### Integrações e tarefas pendentes
#### Transações
- [X] 1 - Consulta de Produtos e Operadoras
- [X] 3 - Venda de PINs
- [ ] 5 - Venda de RECARGA ONLINE
- [ ] 6 - Consulta de Status
- [ ] 7 - Confirmação / Desfazimento de Transações
- [ ] 8 - Lista de Transações Pendentes
- [ ] 9 - Consulta Limite de Crédito
- [ ] 10 - Consulta Lista de Boletos
- [ ] 11 - Consulta de Boleto
- [ ] 12 - Emissão Boleto Antecipado
- [ ] 13 - Consulta Totais por Dia
- [ ] 15 - Detalhe Venda
- [ ] 16 - Resumo Vendas
- [ ] 17 - Relatório Vendas
- [ ] 18 - Lista Vendas
#### Erros customizados implementados
Se você não desejar controlar os erros em um nível tão amplo, poderá utilizar `ErroRV` que é base para todos
os erros abaixo, ou seja, todos os erros abaixo herdam de `ErroRV`.
Caso haja um `raise` de erro, você poderá tratar da seguinte forma:
```python
try:
# seu codigo
except ErroRV as e:
print(str(e))
```
Ou caso queira algo mais específico:
```python
try:
# seu codigo
except FoneIncompletoInvalido as e:
print(str(e))
```
Os erros configuráveis são:
* `FoneIncompletoInvalido`
* `LimiteCreditoInsuficiente`
* `EstoqueInsuficiente`
* `TelefoneNaoAutorizado`
* `SenhaInvalida`
* `MaximoNumeroConexoesAtingida`
* `SistemaEmManutencao`
* `OperadoraProdutoNaoEncontrado`
* `CodigoInvalido`
* `ValorInvalido`
* `Timeout`
* `CompraExpirada`
* `CompraInexistente`
* `UsuarioLojaNaoEncontrado`
* `ParametrosInsuficientes`
* `CompraJaConfirmada`
* `BoletoNaoEncontrado`
* `ParametrosNaoEnviadosViaPOST`
* `CodigoTransacaoNaoInformado`
* `VersaoNaoInformada`
* `UsuarioSemNivelDeAcesso`
* `CobrancaAindaNaoVisualizada`
* `TransacaoNaoPermitida`
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
rv-schubert-sdk-0.0.5.tar.gz
(42.0 kB
view hashes)