eWZC PAD-02: Home’Link Apotheek v. 2
Beschrijving interface Factuurlink
versie 3.3
Inhoudstafel
1. Inleiding. 3
2. XML-layout 4
2.1 Beschrijving proces. 4
2.2 Beschrijving layout conform de Factuurlink V3.3.XSD.. 4
1. Inleiding
Het doel van dit proces is om medicatiefacturen van apothekers naar instellingen (bv. WZC’s) te versturen via eHealthBox. Hierdoor kan de facturatie naar de bewoners van de instellingen vereenvoudigd worden.
We noemen dit “Factuurlink”. De Factuurlink maakt deel uit van het Home’Link Apotheek v2 protocol. De Home’Link omvat alle interface protocollen tussen instelling en apotheek. Het is de tweede versie van het protocol dat initieel in 2007 gelanceerd werd, waarbij naast functionele uitbreidingen ook de beveiligde communicatie van deze medische patiënten gegevens belangrijk is. De Vlaamse overheid en alle Vlaamse beroepsfederaties hebben in het roadbook voor de informatisering van WZC het belang van beveiligde elektronische communicatie tussen zorgactoren toegelicht en de financiering van het eWZC project Pad-02 gekoppeld aan het gebruik van de eHealthbox.
De naamgeving van de bestanden en het type wordt gebruikt om te herkennen welke bestanden opgehaald mogen worden.
De instelling neemt initiatief vanuit zijn pakket om de factuur op te halen. Dit gebeurt op basis van de herkenning op naam van de beschikbare bestanden. In de naam zit het type verwerkt via 2 karakters (IN voor factuur), identificatie rustoord en identificatie apotheker.
Opmerking: in dit document is sprake van versie 3.3. Omdat verschillende versienummers bij verschillende partijen circuleerden is geopteerd om de hoogte nummer dat in gebruik is te nemen. Versie 3.3 komt overeen met de oude 1.4.
2. XML-layout
2.1 Beschrijving proces
Als bestandformaat werd gekozen voor XML met UTF-8 encoding, volgens Factuurlink.XSD.
Bestandsnaam:
De interface bestanden hebben steeds een naam volgens de volgende structuur:
bbbbbbbbbbbbbbbb_zzzzzzzzzzzzzzzz_yyyymmddhhmmss_tt.xml
waarbij
bbbbbbbbbbbbbbbb (16) = bestemmeling
zzzzzzzzzzzzzzzz (16) = afzender
yyyymmdd = datum van de transactie
hhmmss = tijdstip van de transactie
tt = type transactie, dus voor de factuur steeds IN.
Bij het versturen via eHealthBox wordt een functioneel type meegegeven. Voor de factuur is dit HL-IN (wat staat voor HomeLink-INvoice).
2.2 Beschrijving layout conform de Factuurlink V3.3.XSD
2.2.1 Invoices
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
Invoice | Complex Zie 2.2.2 |
| Ja |
|
| Root Tag |
2.2.2 Invoice
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
InvoiceHeader | Complex Zie 2.2.3 |
| Ja |
|
| Hoofding van de factuur |
InvoiceDetail | Complex |
| Ja |
|
| Details van de factuur |
InvoiceSummary | Complex |
| Ja |
|
| Totalen van de factuur |
2.2.3 InvoiceHeader
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
InvoiceType | Simple |
| Ja |
|
| Mag blanco zijn |
InvoiceStatus | Simple |
|
|
|
| Blanco |
TaxTreatment | Simple |
|
|
|
| Blanco |
InvoiceTreatment | Simple |
|
|
|
| Blanco |
InvoiceNumber | Simple |
|
|
|
| Is officiële factuurnummer |
InvoiceDate | Simple |
| Ja | 10 | A | yyyy-mm-dd |
Currency | Simple |
|
|
|
| EUR |
Party | Complex Zie 2.2.4. |
|
|
|
|
|
Customer | Complex Zie 2.2.5. |
|
|
|
|
|
2.2.4 Party
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
PartyID | Simple |
| Ja |
|
| APB apotheek |
CompanyNr | Simple |
|
|
|
| Ondernemingsnummer apotheek |
Name | Complex Zie 2.2.6 |
|
|
|
|
|
Street | Complex Zie 2.2.7 |
|
|
|
|
|
PostalInfo | Complex Zie 2.2.8 |
|
|
|
|
|
2.2.5 Customer
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
CustomerID | Simple |
| Ja |
|
| Klantnummer rustoord bij apotheek |
CustomerCode | Simple |
| Ja |
|
| RIZIV nr rustoord |
CompanyNr | Simple |
|
|
|
|
|
Name | Complex Zie 2.2.6 |
|
|
|
|
|
Street | Complex Zie 2.2.7 |
|
|
|
|
|
PostalInfo | Complex zie 2.2.8 |
|
|
|
|
|
2.2.6 Name
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
Name1 | Simple |
| Ja | Variabel | A | Naam apotheek (1) |
Name2 | Simple |
| Nee | Variabel | A | Naam apotheek (2) |
Name3 | Simple |
| Nee | Variabel | A | Naam apotheek (3) |
2.2.7 Street
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
Street1 | Simple |
| Ja | Variabel | A | Straat apotheek (1) |
Street2 | Simple |
| Nee | Variabel | A | Straat apotheek (2) |
Street3 | Simple |
| Nee | Variabel | A | Straat apotheek (3) |
2.2.8 PostalInfo
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
City | Simple |
| Ja | Variabel | A | Gemeente apotheek |
CountrySubEntity | Simple |
| Nee | Variabel | A |
|
PostalCode | Simple |
| Ja | Variabel | A | Postcode apotheek |
Country | Simple |
| Ja | Variabel | A | BE |
2.2.9 InvoiceDetail
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
PatientDetail | Complex Zie 2.2.10 |
| Ja |
|
|
|
2.2.10 PatientDetail
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
PatientDetailLines | Complex Zie 2.2.11 |
| Ja |
|
|
|
PatientSummary | Complex Zie 2.2.15 |
|
|
|
|
|
2.2.11 PatientDetailLines
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
BaseItemDetail | Complex Zie 2.2.12 |
| Ja |
|
|
|
2.2.12 BaseItemDetail
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
LineItemNum | Simple |
| Ja |
| N | Lijnnummer factuur over alle records van alle residenten. Is dus uniek per factuur. Beginnen met 1 |
PartNumDetail | Complex Zie 2.2.13 |
|
|
|
|
|
Quantity | Complex Zie 2.2.14 |
|
|
|
|
|
TotInterv | Simple |
|
|
| N | Bedrag remgeld |
TotPPIncl | Simple |
|
|
| N | Bedrag publieksprijs |
TotDiscount | Simple |
|
|
| N | Korting |
TaxPercent | Simple |
|
|
| N | BTW % |
2.2.13 PartNumDetail
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
PartNum | Simple |
| Ja |
| A | CNK |
PartDesc | Simple |
| Ja |
| A | Omschrijving medicament |
2.2.14 Quantity
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
Qty | Simple |
| Ja |
| A | Aantal verpakkingen |
UnitOfMeasure | Simple |
|
|
| A |
|
2.2.15 PatientSummary
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
PatFirstname | Simple |
| Ja |
| A | Voornaam |
PatLastname | Simple |
| Ja |
| A | Familienaam |
PatSSCode | Simple |
| Ja |
| A | INSZ Nr (Rijksregister) |
PatAmountPP | Simple |
| Ja |
| N | Totaal publiekprijs (informatief) |
PatAmount | Simple |
| Ja |
| N | Totaal te betalen door patiënt (btw incl) |
PatDiscountAmount | Simple |
| Ja |
| N | Reeds verrekende korting (btw incl) |
2.2.16 InvoiceSummary
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
TaxSummary | Complex Zie 2.2.17 |
| Ja |
|
| Samenvatting BTW |
PatientSummary | Complex Zie 2.2.15 |
|
|
|
| Patiënttotalen |
InvoiceTotals | Complex Zie 2.2.19 |
|
|
|
| Factuurtotalen |
ActualPayment | Complex Zie 2.2.20 |
|
|
|
| Betalingsinfo |
2.2.17 TaxSummary
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
Tax | Complex Zie 2.2.18 |
| Ja |
|
|
|
2.2.18 Taks
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
TaxFunction | Simple |
| Nee |
|
| Niet gebruikt |
TaxType | Simple |
|
|
|
| Niet gebruikt |
TaxCategory | Simple |
|
|
|
| Steeds ‘APO’ |
TaxPercent | Simple |
|
|
|
| BTW Tarief, 0, 6, 12, 21 |
BaseAmount | Simple |
|
|
|
| Basis PP voor korting |
Discount | Simple |
|
|
|
| Korting BTW Excl |
TaxableAmount | Simple |
|
|
|
| PP Basis na korting |
TaxAmount | Simple |
|
|
|
| BTW op basis na korting |
BaseAmountRem | Simple |
|
|
|
| Basis tussenkomst voor korting |
TaxableAmountRem | Simple |
|
|
|
| Basis voor BTW op tussenkomst na korting |
TaxAmountRem | Simple |
|
|
|
| BTW op tussenkomst na korting |
2.2.19 InvoiceTotals
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
NetValue | Simple |
| Ja | Variabel | A | Totaal Basis PP voor korting |
TaxValue | Simple |
| Nee | Variabel | A | Som BTW op basis PP na korting |
DiscountValue | Simple |
| Nee | Variabel | A | Sm korting BTW Excl |
GrossValue | Simple |
|
|
|
| NetValue + TaxValue - DiscountValue |
NetValueRem | Simple |
|
|
|
| Som basis tussenkost voor korting |
TaxValueRem | Simple |
|
|
|
| Som BTW op tussenkomst na korting |
GrossValueRem | Simple |
|
|
|
| NetValueRem + TaxValueRem – DiscountValue |
TotReemboursed | Simple |
|
|
|
| Som Remgeld terugbetaalde producten |
TotNonReemboursed | Simple |
|
|
|
| Som Remgeld niet terugbetaalde producten |
2.2.20 ActualPayment
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
PaymentAmount | Complex Zie 2.2.21 |
| Ja | Variabel | A |
|
PaymentDate | Simple |
| Nee | Variabel | A |
|
2.2.21 PaymentAmount
Fieldname | Type | Nederlands | verplicht | max. Lengte | Type | Beschrijving |
LocalCurrencyAmt | Simple |
| Ja | Variabel | A |
|
Add Comment