O extrato é a representação detalhada do saldo Pagar.me, apresentando valores recebidos, descontados e à receber, dessa maneira extrato nada mais é do que um compilado dos [recebíveis](🔗) e das [operações de saldo](🔗). O extrato é dividido em dois, sendo um deles o atual, ou seja todos os valores já liquidados, e o outro o à receber. Ambos os extratos possuem informações referentes às movimentações de saldo separadas dia-a-dia, exibindo cada valor positivo, cada valor negativo e o saldo final do dia.
## Extraindo o extrato através da API
**Extrato atual**
Para reconstruir o extrato atual é necessário utilizar as informações contidas na rota [/balance_operations](🔗) que se refere as [operações de saldo](🔗).
O primeiro passo é buscar as operações referentes ao período que deseja reconstruir através de um GET informando a data de início (start_date) e de fim (end_date), ambas no formato timestamp com milissegundos.
Atenção
A API irá retornar apenas 10 itens por vez caso parâmetro "count" não seja informado, sendo que o mesmo tem o limite de 1000 itens por busca. Para paginar os resultados é necessário utilizar o parâmetro "page".
O retorno dessa busca será um vetor de objetos.
Após buscar todas as operações do período desejado, é necessário filtrar por recebedor (movement_object.recipient_id) as informações que irão compor o extrato, no caso da dashboard essas informações seriam: valor (amount), taxa (fee), data de criação (date_created), tipo de movimentação (movement_object.payment_method ou movement_object.type) e id da transação (movement_object.transaction_id ou movement_object.id).
Todas as operações de saldo são agrupadas de acordo com a sua data de criação, sendo que cada uma é detalhada de acordo com sua origem (no caso de movientações originadas de transações o transaction_id nos demais casos apenas id), o tipo de movimentação (payment_method ou type), valor bruto (amount), taxa (fee), valor líquido (amount subtraindo o fee)
Somando todos os valores líquidos do dia temos o balanço diário.
**Extrato à receber**
Para reconstruir o extrato à receber é necessário utilizar as informações contidas na rota [/payables](🔗) que se refere aos [recebíveis](🔗).
O primeiro passo é buscar os payables referentes ao período que deseja reconstruir através de um GET informando a data de início e de fim utilizando os operadores maior igual (>=) e menor igual (<=). É importante se atentar que o formato a ser enviado é timestamp com milissegundos.
Requisição
Atenção
A API irá retornar apenas 10 itens por vez caso parâmetro "count" não seja informado, sendo que o mesmo tem o limite de 1000 itens por busca. Para paginar os resultados é necessário utilizar o parâmetro "page".
O retorno dessa busca será um vetor de objetos.
Após buscar todos os recebíveis do período desejado, é necessário selecionar as informações que irão compor o extrato, no caso da dashboard essas informações seriam: valor (amount), taxa (fee), data de pagamento (payment_date), tipo de movimentação (type) e id da transação (transaction_id).
Todos os recebíveis são agrupados de acordo com a sua data de pagamento, sendo que cada registro é detalhado de acordo com sua origem (transaction_id), o tipo de movimentação (type), valor bruto (amount), taxa (fee), valor líquido (amount subtraindo o fee).
Somando todos os valores líquidos do dia temos o balanço diário.
