> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://wiser.airwallet.net/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Posso ligar a Airwallet ao meu próprio sistema de relatórios?

# Posso ligar a Airwallet ao meu próprio sistema de relatórios?

*Acesso à API*

Sim. A Airwallet tem uma interface que permite aos seus próprios sistemas ler os seus dados da Airwallet. Pode carregar transações, o estado das máquinas e dados dos locais no seu sistema de relatórios, no seu data warehouse ou na sua ferramenta de business intelligence.

Está disponível no plano **Smart** e no plano **Business**. Não está disponível no plano Basic. Não há taxa adicional além do plano.

## Que dados pode obter

| Dados | O que contêm |
| ---- |
| Transações | Valor, moeda, local, dispositivo, tipo de máquina, tipo de pagamento, plataforma, saldo da carteira e hora |
| Reembolsos | Os mesmos campos, mais uma ligação para a transação original e o motivo |
| Carregamentos da carteira | Valor, moeda, identificador do utilizador e hora |
| Disponibilidade das máquinas | Estado em tempo real por máquina (disponível, em utilização, em manutenção), tipo de máquina e último pagamento |
| Detalhes do dispositivo | Marca, modelo, número de série, preço, programas da máquina, contadores de serviço e última utilização |
| Locais | Morada, coordenadas, horário de funcionamento, definições de reserva, moeda e lista de máquinas |
| Terminais | Número de série, idioma predefinido e estado |
| Cupões | Campanhas de desconto, com o âmbito, o tipo e os resgates |
| Clientes | As contas empresariais abaixo da sua, se gerir locais para outras empresas |

Os locais, dispositivos, terminais e cupões também aceitam pedidos de criação, atualização e eliminação. As transações, os reembolsos e os carregamentos da carteira são apenas de leitura.

## Com que frequência pode atualizar

É o cliente que decide o calendário. Uma atualização por dia é normal. Uma atualização por hora também.

Um pedido devolve até 10.000 registos. Para volumes maiores, percorre os resultados página a página.

A Airwallet retém os últimos dez minutos de transações. Os pagamentos muito recentes ainda podem estar a ser processados. Não trate os dados dos últimos dez minutos como definitivos.

## O que a interface não faz atualmente

**Não devolve registos de utilizadores finais.** As transações incluem um identificador de utilizador. Pode agrupar a atividade por utilizador e acompanhar um utilizador ao longo do tempo. Não pode descobrir quem é a pessoa por trás desse identificador.

**Não lhe envia dados.** O seu sistema pede os dados à Airwallet. A Airwallet não contacta o seu sistema quando algo acontece. Para uma atualização diária, isso não faz diferença.

## Como obter acesso

1. Tenha uma conta no Dashboard com o plano Smart ou o plano Business. Consulte [Planos](https://wiser.airwallet.net/en/article/plans-oruw7h).
2. Envie o endereço de e-mail da conta ao seu contacto na Airwallet. Peça acesso de programador.
3. A Airwallet ativa o acesso de programador. Aparece então uma secção **Developer** no Dashboard, em **Settings**.
4. Gere o seu par de chaves nessa secção. Guarde a chave secreta imediatamente. A Airwallet mostra a chave secreta apenas uma vez.

## Onde está a documentação técnica

A especificação completa está no Dashboard, em **Settings** e depois **Developer**. Abrange todos os endpoints, todos os parâmetros e todas as respostas. Fica acessível depois de a Airwallet ativar o acesso de programador.

Há também um ambiente de teste, para que o seu programador possa desenvolver e testar antes de entrar em produção.

Contacte o seu representante da Airwallet para obter acesso, ou se precisar de algo que a interface ainda não faz. Descreva o que pretende criar e o volume de dados que prevê.