O histórico completo de todos os eventos de Pagamento associados a uma fatura. Acompanhe os montantes dos pagamentos e os prazos de pagamento com detalhes granulares
Principais Caraterísticas:
Todos os pagamentos registados
Informações de moeda
Referência Detalhada da Coluna
Identificadores Principais
Coluna | Tipo | Descrição | Exemplos | Lógica de Negócio |
provet_id | STRING | O seu identificador único da clínica | "pcus_1" | Chave de isolamento do inquilino — tenha sempre em conta este filtro para desempenho |
payment_id | BIGINT | Identificador único da transação de pagamento | 78901, 234567 | Gerado pelo sistema e imutável após criado. Chave primária com provet_id |
invoice_id | BIGINT | Identificador da fatura relacionada | 12345, 67890 | Liga-se à fatura que está a ser paga. Vários pagamentos podem referenciar a mesma fatura |
invoice_number | STRING | Número da fatura do negócio | "1001-2024-00123", "DEPT2-240915-456" | Referência legível da fatura para reconciliação |
Informação Financeira
Coluna | Tipo | Descrição | Exemplos | Lógica de Negócio |
paid_amount | DECIMAL | Montante de Pagamento recebido | 125.50, -45.00, 25.00 | Positivo para pagamentos, negativo para reembolsos. Pode ser pagamento parcial |
currency_code | STRING | Código de moeda ISO 4217 | "EUR", "USD", "GBP", "CAD" | Herdado da localização da clínica da fatura |
currency_name | STRING | Nome completo da moeda | "Euro", "US Dollar", "British Pound Sterling" | Descrição legível da moeda |
payment_info | STRING | Notas/referência do pagamento | "Check #1234", "Card ending 5678", "Insurance claim ABC123" | Campo de texto livre para detalhes, referências ou notas do pagamento |
Lógica de Cancelamento de Pagamento
Coluna | Tipo | Descrição | Exemplos | Lógica de Negócio |
cancels_payment_id | BIGINT | ID do pagamento cancelado (se for inversão) | 78900, NULL | Lógica: Quando o pagamento é revertido, é criado um novo registo de pagamento com montante negativo e este campo aponta para o payment_id original. NULL para pagamentos regulares |
Detalhes do Método de Pagamento
Coluna | Tipo | Descrição | Exemplos | Lógica de Negócio |
payment_method_type | STRING | Categoria de pagamento padronizada | "Card", "Cash or Check", "Digital Wallet", "Financing" | Lógica de auto-categorização: Igual à tabela de faturas — sinalizador Card → "Card", palavras-chave → categorias |
payment_method_name | STRING | Nome do método de pagamento original | "Visa Credit Card", "Cash", "CareCredit" | Nome bruto do sistema de gestão de práticas |
payment_method_name_standardized | STRING | Nome do pagamento padronizado | "Visa", "Cash", "CareCredit" | Lógica de padronização: Correspondência de padrões (por ex., '%visa%' → 'Visa', '%mastercard%' → 'Mastercard') |
Snapshot & Tracking
Coluna | Tipo | Descrição | Exemplos | Lógica de Negócio |
snapshot_date | DATA | Data do snapshot dos dados | 2024-09-15, 2024-08-22 | Mostra quando os dados do pagamento foram capturados |
Carimbos de data/hora em UTC (horas do sistema)
Coluna | Tipo | Descrição | Exemplos | Lógica de Negócio |
created_ts_utc | TIMESTAMP | Carimbo de data/hora de registo do sistema (UTC) | 2024-09-18 09:15:30.456 | Quando o pagamento foi inserido no sistema — por exemplo, numa segunda-feira quando o pessoal processa o pagamento de sexta-feira |
date_added_ts_utc | TIMESTAMP | Data da transação (UTC) | 2024-09-15 16:30:00.000 | Quando o pagamento ocorreu efetivamente — por exemplo, na sexta-feira quando o cliente pagou |
Carimbos de data/hora locais (fuso horário da clínica)
Coluna | Tipo | Descrição | Exemplos | Lógica de Negócio |
created_ts_local | TIMESTAMP | Carimbo de data/hora de registo do sistema (local) | 2024-09-18 05:15:30.456 | |
date_added_ts_local | TIMESTAMP | Carimbo de data/hora da transação (local) | 2024-09-15 12:30:00.000 |
Padrões Comuns de Consulta
Análise da Recolha de Pagamentos
-- Recolhas diárias de pagamentos com acompanhamento de cancelamentosSELECT snapshot_date, COUNT(DISTINCT payment_id) as total_payments, COUNT(DISTINCT CASE WHEN cancels_payment_id IS NOT NULL THEN payment_id END) as cancellations, SUM(CASE WHEN cancels_payment_id IS NULL THEN paid_amount ELSE 0 END) as net_collections, currency_codeFROM production.invoices_payments WHERE provet_id = 'your_practice_id' AND snapshot_date >= DATE_SUB(CURRENT_DATE(), 30)GROUP BY 1, 5ORDER BY 1 DESC;
Desempenho do Método de Pagamento
-- Análise de método de pagamento com taxas de reversãoSELECT payment_method_type, payment_method_name_standardized, COUNT(DISTINCT payment_id) as total_transactions, SUM(paid_amount) as gross_amount, SUM(CASE WHEN cancels_payment_id IS NULL THEN paid_amount ELSE 0 END) as net_amount, COUNT(DISTINCT CASE WHEN cancels_payment_id IS NOT NULL THEN payment_id END) as reversals, ROUND(COUNT(DISTINCT CASE WHEN cancels_payment_id IS NOT NULL THEN payment_id END) * 100.0 / COUNT(DISTINCT payment_id), 2) as reversal_rate_pctFROM production.invoices_paymentsWHERE provet_id = 'your_practice_id' AND snapshot_date >= DATE_SUB(CURRENT_DATE(), 90)GROUP BY 1, 2ORDER BY net_amount DESC;