Kodia Code

La codifica ambulatoriale svizzera, integrata nel vostro prodotto.

Kodia Code è un'API che riceve la documentazione clinica dal vostro software e restituisce proposte di codifica: posizioni TARDOC, il forfait ambulatoriale applicabile e le diagnosi ICD-10, ogni codice con il passaggio su cui si fonda e la regola applicata.

A chi si rivolge

Progettato per integrarsi nel vostro prodotto.

Fornitori di software sanitari

Integrate la codifica ambulatoriale svizzera nelle cartelle cliniche elettroniche, nei sistemi informativi ospedalieri e nei gestionali per studi medici.

Fornitori di documentazione clinica

Trasformate le note cliniche dettate, trascritte o generate tramite ascolto ambientale in suggerimenti di codifica strutturati e supportati da evidenze.

Piattaforme di fatturazione

Automatizzate la codifica preliminare nei flussi di fatturazione e di gestione del ciclo dei ricavi — con riferimenti tracciabili alle fonti.

Come funziona

Una chiamata, una proposta di codifica completa.

POST /v1/code Richiesta
POST /v1/code HTTP/1.1
Host: api.kodia.ch
X-API-Key: kd_live_••••••••
Content-Type: application/json

{
  "document": "Consultazione del 12.03.2026 in
               studio.\n\nPaziente di 54 anni,
               noto per ipertensione trattata,
               consulta per tosse produttiva da
               8 giorni, febbricola a 38.0 °C,
               senza dispnea.\n\nAnamnesi ed
               esame clinico: auscultazione
               polmonare con alcuni ronchi
               diffusi, nessun focolaio.
               Otoscopia bilaterale nella norma,
               timpani tranquilli. Gola
               lievemente arrossata.\n\nPrelievo
               di sangue, risultati attesi
               domani.\n\nDurata della
               consultazione: 15 minuti.
               Controllo clinico tra una
               settimana se i sintomi
               persistono.",
  "qualifications": ["9999", "3010"]
}
200 OK Risposta
{
  "outcome": "coded",  // o "cannot_determine_safely"
  "result": {
    "billing_system": "TARDOC",
    "summary": "Consultazione di medicina di
                famiglia di 15 minuti con esami
                d'organo apparato respiratorio e
                orecchio documentati. Il
                prelievo di sangue è incluso di
                norma nella consultazione.",
    "predicted_codes": [
      { "code": "CA.00.0010", "quantity": 1,
        "description": "Consultazione del medico
                        di famiglia, primi 5 min",
        "chapter": "CA.00", "service_type": "main",
        "points_unit": 19.2, "points_total": 19.2,
        "confidence": "high", "evidence_verified": true,
        "evidence": "Consultazione del
                     12.03.2026 in studio.",
        "reasoning":
           "Consultazione di medicina di
            famiglia documentata. Il medico
            possiede la qualifica 3010 Medicina
            interna generale richiesta. Unità
            0001 Sala di consultazione
            corrisponde all'attività in studio." },
      { "code": "CA.00.0020", "quantity": 10,
        "description": "+ Consultazione del
                        medico di famiglia, ogni
                        ulteriore 1 min",
        "chapter": "CA.00", "service_type": "add-on (+)",
        "points_unit": 3.84, "points_total": 38.4,
        "confidence": "high", "evidence_verified": true,
        "evidence": "Durata della consultazione:
                     15 minuti.",
        "reasoning":
           "Primi 5 minuti coperti da
            CA.00.0010, 10 minuti supplementari
            fatturabili tramite la prestazione
            aggiuntiva. Durata esplicita, unità
            0001." },
      { "code": "AA.05.0040", "quantity": 1,
        "description": "Esame dell'apparato
                        respiratorio",
        "chapter": "AA.05", "service_type": "main",
        "points_unit": 25.69, "points_total": 25.69,
        "confidence": "medium", "evidence_verified": true,
        "evidence": "auscultazione polmonare con
                     alcuni ronchi diffusi,
                     nessun focolaio.",
        "reasoning":
           "Esame delle vie respiratorie
            superiori e inferiori con
            auscultazione polmonare documentata.
            L'interpretazione medica richiede
            almeno respirazione, cavità orale,
            tonsille, parete posteriore della
            faringe, seni, auscultazione e
            percussione dei polmoni. La gola
            lievemente arrossata è annotata, ma
            la percussione e altri elementi non
            sono esplicitamente documentati.
            Qualifica 3010 e unità 0022
            presenti, cumulabile con CA.00.0010
            tramite LG-053." },
      { "code": "AA.05.0030", "quantity": 1,
        "description": "Esame dell'orecchio",
        "chapter": "AA.05", "service_type": "main",
        "points_unit": 25.69, "points_total": 25.69,
        "confidence": "medium", "evidence_verified": true,
        "evidence": "Otoscopia bilaterale nella
                     norma, timpani tranquilli.",
        "reasoning":
           "Esame bilaterale delle orecchie
            documentato con otoscopia e timpani.
            L'interpretazione medica richiede
            orecchie esterne, condotto uditivo,
            timpani, mastoidi e linfonodi
            regionali. Mastoidi e linfonodi non
            sono menzionati. Qualifica 3010 e
            unità 0022 presenti, cumulabile con
            CA.00.0010 tramite LG-053." }
    ],
    "total_points": 108.98,
    "alternatives": [
      { "code": "AA.00.0010", "billable": true,
        "instead_of": "CA.00.0010", "points_unit": 19.2,
        "description": "Consultazione medica,
                        primi 5 min",
        "when":
           "Il medico sceglie la consultazione
            medica generale invece della
            consultazione del medico di
            famiglia. Stesso contenuto,
            qualifica 9999." },
      { "code": "AA.00.0020", "billable": true,
        "instead_of": "CA.00.0020", "points_unit": 3.84,
        "description": "+ Consultazione medica,
                        per ogni 1 min ulteriore",
        "when":
           "Minuti aggiuntivi della
            consultazione generale AA se si
            preferisce AA.00.0010 a CA.00.0010." },
      { "code": "AK.00.0020", "billable": true,
        "points_unit": 8.64,
        "description": "Prelievo di sangue
                        (venoso) da parte di
                        personale non medico",
        "when":
           "Se il prelievo di sangue è stato
            eseguito da personale non medico e
            non dal medico, è fatturabile in
            aggiunta alla consultazione. Di
            norma si presume che sia stato il
            medico a eseguirlo e il prelievo è
            quindi incluso nella consultazione." }
    ],
    "flags": [
      { "key": "performer_assumed",
        "detail":
           "Prelievo di sangue — l'esecutore non
            è precisato, si presume il medico.
            Il prelievo eseguito dal medico è
            incluso nella consultazione." },
      { "key": "documentation_incomplete",
        "detail":
           "Esame dell'apparato respiratorio
            AA.05.0040 — la percussione e
            l'esame esplicito di cavità orale,
            tonsille, parete posteriore della
            faringe e seni non sono documentati." },
      { "key": "documentation_incomplete",
        "detail":
           "Esame dell'orecchio AA.05.0030 —
            l'esame di mastoidi e linfonodi
            regionali non è documentato." }
    ]
  },
  "catalog_versions": { "tardoc": "1.4c" }
}
  • REST su HTTPS, JSON in entrata e in uscita
  • Autenticazione con chiave API a ogni richiesta (header X-API-Key)
  • Elaborazione senza stato — nulla viene conservato dopo la restituzione della risposta
  • Documentazione clinica in italiano, francese o tedesco
  • Ogni risposta indica le versioni dei cataloghi applicate
  • Specifica OpenAPI inclusa nella documentazione del progetto pilota
Nel vostro prodotto

Suggerimenti che i vostri utenti confermano.

Ogni posizione viene restituita con un livello di confidenza. Il vostro prodotto mostra l'elenco là dove avviene la codifica — il medico o il codificatore accetta, modifica o scarta ogni suggerimento. Nulla arriva in fattura senza una decisione.

PraxisSoftCartella paziente · Caso 48213 ConsultazioneCodificaFattura Kodia Code · connesso
Nota di consultazione12 marzo 2026

Consultazione del 12.03.2026 in studio.

Paziente di 54 anni, noto per ipertensione trattata, consulta per tosse produttiva da 8 giorni, febbricola a 38.0 °C, senza dispnea.

Anamnesi ed esame clinico: auscultazione polmonare con alcuni ronchi diffusi, nessun focolaio. Otoscopia bilaterale nella norma, timpani tranquilli. Gola lievemente arrossata.

Prelievo di sangue, risultati attesi domani.

Durata della consultazione: 15 minuti. Controllo clinico tra una settimana se i sintomi persistono.

Medicina interna generale · valore intrinseco 3010 · TARDOC 1.4c
Suggerimenti di codificatramite Kodia Code
Analisi della nota…
Forfait Nessun forfait ambulatoriale applicabileConsultazione ed esami d'organo sono fuori dal catalogo dei forfait Verificato
CA.00.0010 Consultazione del medico di famiglia, primi 5 min«Consultazione del 12.03.2026 in studio» ×1 Alta
CA.00.0020 + Consultazione del medico di famiglia, ogni ulteriore 1 min10 min oltre i primi 5 — «15 minuti» ×10 Alta
AA.05.0040 Esame dell'apparato respiratorioPercussione, cavità orale, tonsille e seni non documentati ×1 Media
AA.05.0030 Esame dell'orecchioMastoidi e linfonodi regionali non documentati ×1 Media
AK.00.0020 Prelievo di sangue (venoso) da parte di personale non medicoDi norma non fatturato — esecutore non precisato; se eseguito dal medico è incluso nella consultazione Da documentare
0 accettati · 2 da confermare · 1 da documentare Salva la codifica
Il risultato

Più di un elenco di codici.

Codifica e fatturazione proposte

Posizioni TARDOC con quantità, decisione tra forfait e TARDOC e diagnosi ICD-10 — strutturate, pronte da visualizzare o precompilare.

Evidenze cliniche a supporto

I passaggi della documentazione su cui si fonda ogni codice proposto — così il revisore vede la base, non solo il risultato.

Regola applicabile e versione della tariffa

Le voci di catalogo e le regole di fatturazione applicate, ancorate alla versione della tariffa in vigore alla data della prestazione.

Livello di confidenza

Ogni posizione è contrassegnata con confidenza alta o media — così il vostro prodotto può indirizzare l'attenzione umana su quelle che la richiedono.

Avvisi di documentazione mancante

Quando alla nota manca ciò che una posizione richiede — o quando giustifica più di quanto dichiara — la lacuna viene segnalata all'autore.

Un esito esplicito «non determinabile in modo sicuro»

Quando la documentazione non consente una determinazione sicura, l'API lo dichiara — invece di tirare a indovinare.

Non una scatola nera

Un risultato corredato di fonti, non una supposizione.

Un modello generico può produrre codici dall'aspetto plausibile a partire da una nota. Kodia Code esegue invece il workflow agentico: consulta i cataloghi ufficiali come fonte di verità, applica le regole in vigore e restituisce i riferimenti utilizzati — così il vostro prodotto può mostrare ai suoi utenti il perché.

  • Ogni codice restituito cita la voce di catalogo su cui si basa
  • Regole di cumulo, requisiti di qualifica e limiti di quantità vengono applicati, non approssimati
  • La decisione tra forfait e TARDOC è esplicita, con la relativa motivazione
Un modello generico chiede

«A quali codici assomiglia questa nota?»

Kodia Code chiede

«Quali posizioni giustifica realmente questa documentazione — secondo le regole in vigore?»

Responsabilità

L'API propone. I vostri utenti decidono.

Kodia Code restituisce una proposta di codifica con i relativi riferimenti — non invia fatture né modifica cartelle. Il modo in cui la proposta viene presentata, esaminata e confermata resta sotto il controllo del vostro prodotto, e la responsabilità delle prestazioni fatturate rimane all'organizzazione che fattura.

Per iniziare

Iniziate con un'integrazione pilota.

Per iniziare

Richiedete l'accesso

Integrate su casi reali e valutate la qualità della codifica insieme al vostro team.

  • Accesso all'API e documentazione
  • Supporto all'integrazione da parte del team Kodia
  • Valutazione sulla vostra documentazione deidentificata, con tassi di concordanza misurati
  • Nessun impegno di volume
Contattateci

Portate la codifica svizzera nel vostro prodotto.

Parlateci della vostra integrazione e definiremo insieme un progetto pilota.