La cronologia completa di tutti gli eventi di pagamento associati a una fattura. Traccia gli importi dei pagamenti e le tempistiche dei pagamenti con dettagli puntuali
Punti salienti:
Tutti i pagamenti registrati
Informazioni sulla valuta
Riferimento dettagliato alle colonne
Identificatori principali
Colonna | Tipo | Descrizione | Esempi | Logica di business |
provet_id | STRING | Il tuo identificatore univoco della struttura | "pcus_1" | Chiave di isolamento del tenant: filtra sempre per questa per le prestazioni |
payment_id | BIGINT | Identificatore univoco della transazione di pagamento | 78901, 234567 | Generato dal sistema, immutabile una volta creato. Chiave primaria con provet_id |
invoice_id | BIGINT | Identificatore della fattura correlata | 12345, 67890 | Link alla fattura in fase di pagamento. Più pagamenti possono fare riferimento alla stessa fattura |
invoice_number | STRING | Numero della fattura in ambito aziendale | "1001-2024-00123", "DEPT2-240915-456" | Riferimento alla fattura leggibile per la riconciliazione |
Informazioni finanziarie
Colonna | Tipo | Descrizione | Esempi | Logica di business |
paid_amount | DECIMALE | Importo del pagamento ricevuto | 125.50, -45.00, 25.00 | Positivo per i pagamenti, negativo per i rimborsi. Può essere un pagamento parziale |
currency_code | STRING | Codice valuta ISO 4217 | "EUR", "USD", "GBP", "CAD" | Ereditato dalla ubicazione della struttura della fattura |
currency_name | STRING | Nome completo della valuta | "Euro", "US Dollar", "British Pound Sterling" | Descrizione leggibile della valuta |
payment_info | STRING | Note/riferimento del pagamento | "Check #1234", "Card ending 5678", "Insurance claim ABC123" | Campo di testo libero per dettagli del pagamento, riferimenti o note |
Logica di Cancellazione dei pagamenti
Colonna | Tipo | Descrizione | Esempi | Logica di business |
cancels_payment_id | BIGINT | ID del pagamento annullato (se è uno storno) | 78900, NULL | Logica: quando il pagamento viene stornato, viene creato un nuovo record di pagamento con importo negativo e questo campo indica payment_id originale. NULL per i pagamenti regolari |
Dettagli del metodo di pagamento
Colonna | Tipo | Descrizione | Esempi | Logica di business |
payment_method_type | STRING | Categoria standardizzata del pagamento | "Card", "Contante o Check", "Digital Wallet", "Finanza" | Logica di categorizzazione automatica: uguale alla tabella delle fatture - flag Card → "Card", parole chiave → Categorie |
payment_method_name | STRING | Nome originale del metodo di pagamento | "Visa Credit Card", "Contante", "CareCredit" | Nome grezzo dal sistema di gestione delle pratiche |
payment_method_name_standardized | STRING | Nome del metodo di pagamento standardizzato | "Visa", "Contante", "CareCredit" | Logica di standardizzazione: corrispondenza di pattern (ad es., '%visa%' → 'Visa', '%mastercard%' → 'Mastercard') |
Snapshot e tracking
Colonna | Tipo | Descrizione | Esempi | Logica di business |
snapshot_date | DATA | Data dello snapshot dei dati | 2024-09-15, 2024-08-22 | Indica quando sono stati acquisiti i dati dei pagamenti |
Timestamp UTC (Orari di sistema)
Colonna | Tipo | Descrizione | Esempi | Logica di business |
created_ts_utc | TIMESTAMP | Timestamp di inserimento nel sistema (UTC) | 2024-09-18 09:15:30.456 | Quando il pagamento è stato inserito nel sistema - ad es., Lunedì quando il personale elabora il pagamento di Venerdì |
date_added_ts_utc | TIMESTAMP | Data della transazione (UTC) | 2024-09-15 16:30:00.000 | Quando il pagamento è effettivamente avvenuto - ad es., Venerdì quando il cliente paga |
Timestamp locali (Fuso orario della struttura)
Colonna | Tipo | Descrizione | Esempi | Logica di business |
created_ts_local | TIMESTAMP | Timestamp di inserimento nel sistema (locale) | 2024-09-18 05:15:30.456 | |
date_added_ts_local | TIMESTAMP | Timestamp della transazione (locale) | 2024-09-15 12:30:00.000 |
Modelli comuni di query
Analisi delle raccolte di pagamenti
-- Raccolte giornaliere dei pagamenti con tracciamento delle cancellazioniSELECT snapshot_date, CONTARE(DISTINTO payment_id) as total_payments, CONTARE(DISTINTO CASO QUANDO cancels_payment_id IS NOT NULL THEN payment_id END) as cancellations, SOMMA(CASO QUANDO 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(DATA_CORRENTE(), 30)GROUP BY 1, 5ORDER BY 1 DESC;
Prestazioni per metodo di pagamento
-- Analisi del metodo di pagamento con tassi di stornoSELECT 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;