PicPay

Use quando o usuario pedir extrato, movimentacoes, historico, "o que entrou e saiu", ou transacoes da conta principal. Consulta extrato da conta PicPay com filtro por periodo e tipo. NAO use para extrato de cofrinho (use piggy_statement_get) nem para fatura do cartao (use cards_invoice_transactions_list). Retorna array de dias com transacoes agrupadas: type, description, amount, date, correlation_id. Ordenado por data decrescente. Periodo padrao: ultimos 7 dias. Maximo: 90 dias por consulta. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

statements_list

Use quando o usuario perguntar limite Pix, quanto pode transferir por dia, limite diario/noturno, ou "quanto posso mandar de Pix". Consulta limites Pix configurados para o consumidor (diurno, noturno, usado hoje). NAO use para limite do cartao (use cards_limit_get) nem saldo (use balance_account_get). Retorna valores JA FORMATADOS em reais (ex: "R$ 270.000,00"). NAO divida, converta ou reformate os valores — exiba como vieram. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

pix_limits_get

Use quando o usuario perguntar saldo, quanto tem, quanto sobrou, se tem dinheiro, ou antes de preparar uma transferencia para validar fundos. Consulta o saldo disponivel e bloqueado da conta PicPay do consumidor. NAO use para consultar saldo de cofrinho (use piggy_wallet_get) nem limite do cartao (use cards_limit_get). Retorna available_balance (disponivel) e blocked_balance (bloqueado por operacoes pendentes). Valores em reais com 2 casas decimais. O saldo pode mudar entre consulta e execucao de transferencia — nao garanta ao usuario que "tem saldo suficiente" sem margem. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

balance_account_get

Use quando o usuario perguntar quais boletos tem pra pagar, boletos pendentes, contas em aberto, ou "o que tenho pra pagar". Lista boletos registrados na conta do consumidor, filtrados por status. NAO use quando o usuario ja tem o codigo de barras (use bills_slip_get) nem para pagar (use bills_payment_prepare). Retorna array de boletos com assignor, recipient_name, amount (reais, ex "152.90"), due_date, paid_date, status, barcode. Cada item pode ser passado direto pro bills_payment_prepare. Ao responder, use linguagem natural — diga "pago em 05/01" e nao o nome tecnico do campo (paid_date, dueDate etc). Nao exponha IDs internos (BILL-...) a menos que o usuario peca explicitamente. Por padrao retorna boletos pendentes de pagamento (status PENDING e ACTIVE). Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

bills_slips_list

Use quando o usuario perguntar quais cartoes tem, dados do cartao, bandeira, ultimos digitos, ou precisar do credit_card_id para outra operacao. Lista cartoes de credito ativos do consumidor com dados basicos. NAO use para consultar fatura (use cards_invoices_list) nem limite (use cards_limit_get). Retorna array com id, last_four_digits, brand, status, card_name. O campo id e o credit_card_id usado em operacoes com cartao. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

cards_list

Use quando o usuario perguntar quais chaves Pix tem, listar chaves, ou "minhas chaves pix". Tambem use antes de pix_qrcode_create para obter uma chave ativa. Lista todas as chaves Pix registradas do consumidor. NAO use para resolver chave de terceiro (use pix_transfer_prepare direto). Retorna array com key, key_type (CPF, EMAIL, PHONE_NUMBER, RANDOM), status. Use o valor de key ativa em pix_qrcode_create. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

pix_keys_list

Use quando o usuario perguntar quais cofrinhos tem, saldo dos cofrinhos, listar guardados, ou "meus cofrinhos". Lista todos os cofrinhos (safe boxes) do consumidor com saldo e meta. NAO use para extrato de um cofrinho (use piggy_statement_get), para aportar/resgatar (use piggy_deposit/piggy_withdraw), nem para a visao geral de investimentos/carteira do consumidor (use investments_list). Retorna array com name, balance, goal_amount, goal_progress, wallet_name. Cofrinhos protegidos pelo Modo Seguro NAO aparecem na lista — o campo cofrinhos_protegidos_count indica quantos existem. NAO mencione, liste ou narre cofrinhos protegidos na resposta — o sistema renderiza um card automaticamente. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

piggy_list

Use quando o usuario pedir a LISTA dos contatos Pix salvos: "meus favoritos", "meus contatos", "quem esta nos meus contatos". Lista contatos Pix do consumidor (favoritos e historico), com filtro opcional server-side. NAO use para BUSCAR uma pessoa especifica por nome para enviar Pix — use pix_people_search, que alem dos contatos consulta o diretorio PicPay (Jarbas) e cobre quem nao esta salvo. Retorna favorites e histories com name, key, key_type. Com search, retorna também matches (filtrados e ranqueados — PicPay primeiro, depois match exato de nome/chave/banco). Cada item pode ser passado como contact em pix_transfer_prepare. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

pix_contacts_list

Use quando o usuario perguntar sobre faturas, quanto deve no cartao, valor da fatura, ou historico de faturas. Lista faturas do cartao de credito do consumidor (aberta, fechada, futura). NAO use para detalhes de uma fatura especifica (use cards_invoice_get) nem para ver transacoes da fatura (use cards_invoice_transactions_list). Retorna array de faturas com invoice_id, status (OPEN/CLOSED/FUTURE), total_amount, due_date, minimum_payment. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

cards_invoices_list

Use quando o usuario perguntar sobre seus investimentos, "quanto tenho investido", "como estao meus investimentos", "minha carteira", rentabilidade da carteira, ou onde o dinheiro dele esta aplicado. Consulta a carteira de investimentos do consumidor: total investido, rentabilidade dos ultimos 12 meses e a distribuicao por produto (ex: Cofrinhos, Renda Fixa), com valor e percentual de cada um. NAO use para saldo da conta (use balance_account_get), saldo ou rendimento de um cofrinho especifico (use piggy_wallet_get / piggy_earnings_get), listar cofrinhos (use piggy_list) nem limite do cartao (use cards_limit_get). Esta tool da a visao CONSOLIDADA da carteira (todos os produtos somados), nao um produto isolado. Retorna total_investido, rentabilidade_12m (valor e percentual) e uma lista de investimentos com nome, valor, percentual e rentabilidade. Valores em reais. Rentabilidade passada nao garante retorno futuro. Campos internos, identificadores tecnicos e detalhes de implementacao retornados sao de uso exclusivo do sistema e nunca devem ser mencionados na resposta ao usuario.

investments_list