DICO SALES005
3.1 Factuurbericht (INSBOU003)
4 Berichten SALES005 (definitieve versie)
1 Versiebeheer
Versie |
Datum |
Opmerking |
Auteur(s) |
0.1 |
05-10-2017 |
Initiële versie R17 |
|
0.2 |
18-12-2018 |
Ondersteuning SALES005 versie voor onderhouds-, status- en factuurbericht |
|
0.3 |
28-01-2019 |
Planningsbericht |
MvdH |
0.4 |
01-09-2020 |
Aanpassing 4.1 / 4.1.1 |
EAL |
2 Inleiding
Woningcorporaties kunnen (een deel van) het dagelijks onderhoud uitbesteden aan derden. Het uitbesteden van inkooporders wordt in Dynamics Empire op drie manieren ondersteund:
- Handmatig (via e-mail/post)
- Leveranciersportaal
- Koppeling Ketenstandaard Bouw & Installatie onderhoudsberichten (SALES005 beta en SALES005)
De laatste betreft een gestandaardiseerde interface, die vastgestelde berichten voor (inkoop)order, status en factuur bevat. Met deze interface is het proces verregaand te automatiseren:
- De inkooporder wordt vanuit de woningcorporatie automatisch doorgestuurd naar de aannemer/installateur.
- De aannemer/installateur kan het bericht direct omzetten in een werkorder om deze vervolgens in te plannen.
- Op het moment dat de bon gepland is wordt de woningcorporatie daar direct van op de hoogte gesteld (status ‘Gepland’ met datum/tijd), waardoor de woningcorporatie dit ook direct zichtbaar kan maken voor de huurder in het klantportaal.
- Na gereed melden wordt de woningcorporatie (en daarmee ook de huurder) op de hoogte gesteld.
- Kosten kunnen door de aannemer/installateur worden gespecificeerd en doorgezet worden naar de woningcorporatie.
- Zodra de factuur is opgesteld wordt deze via het reeds bekende ‘S@les in de Bouw’-formaat doorgestuurd naar de woningcorporatie.
Ook is het mogelijk om onderhoudsorders die via de DICO-integratie naar een leverancier zijn gestuurd, in Dynamics Empire af te handelen. Dit betreft de volgende acties:
- het gereedmelden van een onderhoudsorder;
- het gereedmelden en afhandelen zonder factuur; hierbij is het mogelijk om van de gekozen inkoopwijze af te wijken;
- het gereedmelden en afhandelen met factuur; hierbij is het mogelijk om van de gekozen inkoopwijze af te wijken;
- het invoeren van de kostenspecificatie;
- het definitief maken en heropenen van de kostenspecificatie;
- het factureren van de onderhoudsorder.
Omdat normaal gesproken deze acties uitgevoerd worden door de leverancier, verschijnt bij het uitvoeren van deze acties een bevestigingsmelding dat de leverancier verantwoordelijk is voor deze actie.
Let op! Voer deze acties altijd uit in overleg met de leverancier. Als de leverancier namelijk alsnog de DICO-status- of factuurberichten verstuurt voor deze onderhoudsorders, kunnen foutmeldingen ontstaan doordat de onderhoudsorders inmiddels zijn afgehandeld.
In dit document wordt de mapping van de berichten van de DICO-koppeling naar het Dynamics Empire-datamodel beschreven.
3 Berichten SALES005 Beta
3.1 Factuurbericht (INSBOU003)
3.1.1 Omschrijving
Het factuurbericht wordt gebruikt om orders die door de leverancier zijn afgehandeld te factureren naar de woningcorporatie. Voor de factuur wordt het bericht INSBOU003 gebruikt, omdat de SALES005 Beta berichten geen factuurbericht heeft.
3.1.2 Request
Veld |
Omschrijving |
Empire / vaste waarde |
Data-type |
Ver-plicht |
Factuur |
||||
Soort factuur |
Code waarmee de transactie waarop het bericht betrekking heeft nader wordt gespecificeerd. |
"380" |
Tekst(3) |
Ja |
Factuurnummer |
Nummer ter identificatie van de factuur. |
Inkoopkop (38), Ordernr. leverancier (68) |
Tekst(17) |
Ja |
Factuurdatum |
De factuurdatum. Dit is de datum die gehanteerd wordt voor de BTW-aangifte. Dit hoeft niet. |
Inkoopkop (38), Documentdatum (99) |
Datum |
Ja |
Vervaldatum |
De datum waarop de betaling voor de factuur uiterlijk binnen moet zijn. |
Inkoopkop (38), Vervaldatum (24) |
Datum |
Nee |
Valuta |
Code van de munteenheid waarin de bedragen in het bericht zijn uitgedrukt. |
"EUR" |
Tekst(3) |
Ja |
Betaalwijze |
Code waarmee de manier waarop de factuur moet worden betaald, wordt aangegeven. Als voor deze factuur wordt afgeweken van de standaard betaalwijze kan dat hier worden aangegeven. |
Niet gebruikt |
Code(3) |
Nee |
Bijlage De eerste bijlage wordt als de factuurbijlage verwerkt. De rest als normale bijlages. |
||||
URL |
Wereldwijd uniek kenmerk, voldoend aan de Uniform Resource Locator-specificatie, ter identificatie van een informatiebron. |
Bijlage (11031298), Omschrijving (90) |
Tekst(250) |
Nee |
Bijlage |
De bijlage zelf, weergegeven in een base64-codering. |
Bijlage (11031298), Bijlage (60) |
BLOB |
Nee |
Bestandsnaam |
Tekstveld met de naam van het bestand dat is bijgesloten en/of waarnaar verwezen wordt door de URL. |
Bijlage (11031298), Omschrijving (90) |
Tekst(250) |
Nee |
Indicatie ketenaansprakelijk-heid |
Code waarmee wordt aangegeven dat de Wet op de Ketenaansprakelijkheid (WKA) van toepassing is. Toegestane codes: |
Niet gebruikt |
Code(10) |
Nee |
Vrij tekstveld |
Vrije tekst die bestaat uit maximaal 10 regels. De eerste regel wordt gebruikt voor de factuuromschrijving, de andere regels voor de leveranciersopmerking. |
Inkoopkop (38), Omschrijving (22) Leverancieropmerkingsregel (11024243), Omschrijving (20) |
Tekst |
Nee |
Indicatie BTW-verleggingsregeling |
Code waarmee wordt aangegeven dat de BTW niet door de leverancier maar door de opdrachtgever moet worden afgedragen. Komt voor bij facturering van diensten van de onderaannemer aan de hoofdaannemer. De onderaannemer mag geen BTW op de factuur berekenen, de aannemer is BTW verschuldigd en moet die berekenen. Als dit veld niet gevuld is gaan we er vanuit dat er geen BTW-verleggingsregeling van toepassing is. |
Inkoopkop (38), BTW-verlegging van toepassing (11152581) |
Code(3) |
|
Ordernummer opdrachtgever |
Nummer ter identificatie van de order door de opdrachtgever. Het ordernummer van de opdrachtgever is de unieke code om te bepalen welke factuur bij welke order hoort. |
Onderhoudsorder (11031279), Nr. (1) |
Code(20) |
Ja |
Opdrachtgever Partij aan wie goederen en/of diensten worden verkocht en geleverd. Als FSC-certificering van toepassing is moeten de NAW-gegevens compleet worden vermeld. |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. De opdrachtgever is de corporatie of een afdeling van de corporatie. |
De inhoud van dit veld moet gelijk zijn aan de waarde die is vastgelegd in de bedrijfsgegevens (Bedrijfsgegevens (79), GLN (90)). |
Code(13) |
Ja |
Leverancier Partij die goederen en/of diensten verkoopt en levert. Als FSC-certificering van toepassing is moeten de NAW-gegevens compleet worden vermeld. |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
De inhoud van dit veld moet gelijk zijn aan de waarde die is vastgelegd in de leverancier (23), GLN (90)), die gekoppeld is aan de onderhoudsorder (11031279), die wordt opge-haald met de waarde in het veld BuyersOrderNumber in dit factuurbericht. |
Code(13) |
Ja |
IBAN |
International Bank Account Number, wereldwijd uniek nummer ter identificatie van een bankrekening. |
Inkoopkop (38), Code bankrekening (11000001), bepaald via de IBAN uit de leveranciersbankgegevens. |
Tekst(70) |
Nee |
Storting op G-rekening Gegevens over een geblokkeerde rekening, gebruikt door een aannemer om loonheffingen van door hem ingehuurd personeel aan de belastingdienst of aan onderaannemers te voldoen. Van een G-rekening kunnen geen andere betalingen gedaan worden. De rekening beschermt partijen tegen wanbetalingen van loonheffingen. |
||||
Bedrag |
Het bedrag dat op de G-rekening wordt gestort. Als dit bedrag gevuld is en het IBAN- en Rekeningnummer niet zijn gevuld, dan moet bij de leverancier een G-rekening zijn ingevuld. Is dit niet het geval, dan volgt een foutmelding. |
Inkoopkop (38), Bedrag naar G-rekening (60301) |
Decimaal |
Nee |
IBAN |
International Bank Account Number, wereldwijd uniek nummer ter identificatie van een bankrekening. |
Als het bedrag bestemd voor de G-rekening gevuld is, dan moet - indien gevuld - het G-rekening-IBAN voorkomen in de leveranciersbankgegevens. |
Tekst(70) |
Nee |
Rekeningnummer |
Banknummer |
Als het bedrag bestemd voor de G-rekening gevuld is, dan moet, indien gevuld, de bankrekening voorkomen in de leveranciersbankgegevens. |
Tekst(35) |
Nee |
Factuurregels Niveau in het bericht waar de in rekening gebrachte goederen worden gespecificeerd. |
||||
Regelnummer |
Nummer ter identificatie van een regel binnen een bericht. |
Inkoopregel (39), Regelnr. (4) |
Integer |
Ja |
Aantal factuureenheden |
Het aantal prijseenheden dat gefactureerd wordt. De eenheid (stuks, kilo, meter) wordt niet vermeld bij dit gegeven, maar is altijd hetzelfde als de eenheid van de prijsbasis. Het aantal factuureenheden is altijd gelijk aan het geleverde aantal, behalve bij artikelen waarvan de eenheid van de prijsbasis ongelijk is aan de eenheid van het geleverde aantal. Bijvoorbeeld voor spijkers die per stuk besteld worden maar per kilo gefactureerd worden. |
Inkoopregel (39), Aantal (15) |
Decimaal |
Ja |
Prijseenheid |
Gegevens over de basiseenheid waarin een prijs is uitgedrukt. |
Inkoopregel (39), Eenheidscode (5407) |
Code(10) |
Ja |
Netto regelbedrag |
Geldwaarde van het gefactureerde artikel, inclusief toeslagen en kortingen op regelniveau. |
Inkoopregel (39), Directe kostprijs (22) |
Decimaal |
Ja |
BTW Informatie |
||||
BTW-code |
De toegestane waarde wordt vertaald naar de gebruikte code in Dynamics Empire. Mogelijke waarden: |
Inkoopregel (39), Btw-productboekingsgroep (90) |
Code(10) |
Nee |
BTW-percentage |
Het gebruikte BTW-percentage voor de factuurregel. Mede op basis van dit percentage wordt de boekingsgroep bepaald, die weer gekoppeld is aan een BTW-percentage. |
Inkoopregel (39), Btw-productboekingsgroep (90) |
Code(10) |
Nee |
Vrije tekstveld |
Tekstveld met de inhoud van de aanvullende informatie. |
Inkoopregel (39), Omschrijving (11) |
Tekst(50) |
Nee |
Storting op G-rekening Gegevens over een geblokkeerde rekening, gebruikt door een aannemer om loonheffingen van door hen ingehuurd personeel aan de belastingdienst of aan onderaannemers te voldoen. Van een G-rekening kunnen geen andere betalingen gedaan worden. De rekening beschermt partijen tegen wanbetalingen van loonheffingen. |
||||
Bedrag |
Het bedrag dat op de G-rekening wordt gestort. Als dit bedrag gevuld is en het IBAN en Rekeningnummer niet zijn gevuld, dan moet bij de leverancier een G-rekening zijn ingevuld. Is dit niet het geval, dan volgt een foutmelding. |
Inkoopkop (38), Bedrag naar G-rekening (60301) |
Decimaal |
Nee |
IBAN |
International Bank Account Number, wereldwijd uniek nummer ter identificatie van een bankrekening. |
Als het bedrag bestemd voor de G-rekening gevuld is, dan moet, indien gevuld, het G-rekening IBAN voorkomen in de leveranciersbankgegevens. |
Tekst(70) |
Nee |
Rekeningnummer |
Banknummer |
Als het bedrag bestemd voor de G-rekening gevuld is, dan moet, indien gevuld, de bankrekening voorkomen in de leveranciersbankgegevens. |
Tekst(35) |
Nee |
Factuurtotalen Gegevens over totalen berekend over de gehele factuur. |
||||
Totaal factuurbedrag |
Geldwaarde van het totaal te betalen bedrag van de factuur inclusief BTW. |
Inkoopkop (38), Factuurbedrag (61047) |
Decimaal |
Ja |
Totaal BTW bedrag |
Geldwaarde van het totaal aan BTW verschuldigde bedrag voor de factuur. |
Inkoopkop (38), Factuur BTW-bedrag (62021) |
Decimaal |
Ja |
3.2 Onderhoudsstatusbericht
3.2.1 Omschrijving
Via het statusbericht kunnen diverse statussen worden uitgewisseld tussen leverancier en woningcorporatie. Tevens wordt in dit bericht de kostenspecificatie teruggegeven aan de woningcorporatie.
3.2.2 Request
Veld |
Omschrijving |
Empire / vaste waarde |
Data-type |
Ver-plicht |
Berichtinformatie |
||||
Berichtnummer |
Nummer ter identificatie van een bericht. Mag door de zendende applicatie worden bepaald. |
Niet gebruikt |
Tekst(17) |
Ja |
Berichtdatum |
Datum waarop een bericht is aangemaakt. |
Niet gebruikt |
Datum |
Ja |
Berichttijd |
Tijdstip waarop het bericht is aangemaakt. |
Niet gebruikt |
Tijd |
Nee |
Opdrachtgever Partij die de opdracht geeft. |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
Er moet een klant aanwezig zijn, waarvan de waarde van de GLN gelijk is aan de inhoud van dit veld. |
Code(13) |
Ja |
Opdrachtnemer Partij die opdracht gaat uitvoeren. |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
De waarde van dit veld moet gelijk zijn aan de waarde zoals vastgelegd in de bedrijfsgegevens. |
Code(13) |
Ja |
Opdrachtgegevens De uit te voeren opdracht. |
||||
Opdrachtnummer |
Nummer ter identificatie van een opdracht binnen een bericht. Alle informatie-uitwisseling (factuur/status) wordt hierdoor geïdentificeerd, tenzij er berichten zijn op regelniveau, dan dient ook het regelnummer toegevoegd te worden. |
Onderhoudsorder (11031279), Nr. (1) |
Code(20) |
Ja |
Subopdrachtnummer |
Extra nummer ter verdere identificatie van een opdracht of opdrachtonderdeel. |
|
Code(20) |
Nee |
Status |
Code waarmee de status wordt gespecificeerd. AFW Afwachten in verband met weer BBT Bewoner belt terug BNT Bewoner niet thuis VER Wachten op vervolgorder WEI Weigeren |
Onderhoudsorder (11031279), Status (26) De volgende statussen zijn in Empire geïmplementeerd: ACC, AFH, AFR, ANN, GER, UIT en WEI
|
Code(10) |
Ja |
Statusomschrijving |
Tekstveld met omschrijving van de status |
|
Tekst(70) |
|
Datum gereed |
Datum technische gereed |
Onderhoudsorder (11031279), Datum technsich gereed (44) |
Date |
|
Totaalbedrag |
Totaalbedrag van de opdracht |
|
Decimal |
|
Omschrijving |
Tekstveld met de inhoud van aanvullende informatie |
Leverancieropmerkingsregel (11024243), Omschrijving (20) |
Tekst |
Nee |
Afspraakgegevens Gegevens over de datum, tijd of periode van levering van onderhoud. |
||||
Uitvoeringstijdvak Gegevens over de periode waarbinnen iets moet worden uitgevoerd. Bloktijd of afspraak met de aannemer. Het betreft hier de tijd waarbinnen de werkzaamheden aanvangen. Deze bloktijd is bij reparatieverzoeken de bloktijd die is afgesproken met de bewoner. Bij reparatieverzoeken waarbij geen aanwezigheid van de bewoner noodzakelijk is wordt het uitvoeringstijdvak leeggelaten. |
||||
Vroegste datum van uitvoering |
Datum vanaf wanneer de uitvoering kan/moet beginnen. Het betreft hier de datum waarop de bewoner vanaf de afgesproken tijd aanwezig is in geval van reparatieverzoeken. Bij mutatie-onderhoud is dit de datum waarop de werkzaamheden op zijn vroegst mogen worden aangevangen. |
Onderhoudsorder (11031279), Afspraakdatum (45) |
Date |
|
Vroegste tijdstip van uitvoering |
Tijdstip vanaf wanneer de uitvoering kan/moet beginnen. Het betreft hier afgesproken tijd vanaf (in combinatie met de datum) waarop de bewoner aanwezig is in geval van reparatieverzoeken. Bij mutatieonderhoud is dit de tijd waarop de werkzaamheden mogen starten (in combinatie met de datum). |
Onderhoudsorder (11031279), Starttijd van (46) |
Code(20) |
|
Laatste tijdstip van uitvoering |
Tijdstip tot wanneer de uitvoering kan/moet beginnen. |
Onderhoudsorder (11031279), Starttijd tot (47) |
|
|
Opdrachtregel Niveau in het bericht waar de onderhoudsdetails worden gespecificeerd. |
||||
Regelnummer |
Nummer ter identificatie van een regel binnen een bericht. Volgnummer om de regel binnen de opdracht uniek te maken (Opdrachtgever-ordernummer regelnummer moet uniek zijn). |
Onderhoudstaak (11031294), Taaknr. (3) |
Code(10) |
Ja |
Aantal |
Het aantal eenheden van werk, geïdentificeerd door de normprijscode. |
Onderhoudstaak (11031294), Aantal (67) |
Decimaal |
Ja |
Eenheid van aantal |
Code van de meeteenheid waarin het aantal is uitgedrukt. Toegestane codes: |
Onderhoudstaak (11031294), Eenheidscode (68) |
Code(10) |
Ja |
Normprijscode |
Code waarmee het uit te voeren werk wordt aangegeven. Verwijzing naar vooraf overeengekomen werkzaamheden en bijbehorende prijsafspraken. |
Onderhoudstaak (11031294), Standaardtaakcode (6) |
Code(20) |
Ja |
Omschrijving kort |
Tekstveld met een korte nadere specificatie van het werk, geïdentificeerd door de normprijscode. |
Onderhoudstaak (11031294), Omschrijving (65) |
Tekst(150) |
Nee |
Omschrijving lang |
Tekstveld met een lange nadere specificatie van het werk, geïdentificeerd door de normprijscode. Gegevens die dienen als aanvullende informatie, niet bestemd voor automatische verwerking. |
Onderhoudstaak (11031294), Meldingstekst boeken (1340) |
Tekst(250) |
Nee |
Bijlage informatie Gegevens over de bijlage en/of de deeplink bij een bericht. Het is verplicht om de 'URL' of 'Bijlage' te gebruiken. |
||||
URL |
Wereldwijd uniek kenmerk, voldoend aan de Uniform Resource Locator-specificatie, ter identificatie van een informatiebron. |
Bijlage (11031298), Description (90) |
Tekst(250) |
Nee |
Bijlage |
De bijlage zelf, weergegeven in een base64-codering. |
Bijlage (11031298), Bijlage (60) |
BLOB |
Nee |
Bestandsnaam |
Tekstveld met de naam van het bestand dat is bijgesloten en/of waarnaar verwezen wordt door de URL. |
Bijlage (11031298), Omschrijving (90) |
Tekst(250) |
Nee |
Prijsinformatie Gegevens over de bijlage en/of de deeplink bij een bericht. Het is verplicht om de 'URL' of 'Bijlage' te gebruiken. |
||||
Prijs |
Hierin dient de te factureren prijs vermeld te worden. De controle op juiste prijs valt buiten de scope van het bericht. |
Inkoopregel (39), Directe kostprijs (22) |
Decimaal |
|
BTW-informatie Gegevens over de bijlage en/of de deeplink bij een bericht. Het is verplicht om de 'URL' of 'Bijlage' te gebruiken. |
||||
BTW tarief |
De toegestane waarde wordt vertaald naar de gebruikte code in Dynamics Empire. Mogelijke waarden: |
Inkoopregel (39), Btw-productboekingsgroep (90) |
Code(10) |
|
BTW percentage |
Het gebruikte BTW-percentage voor de factuurregel. Mede op basis van dit percentage wordt de boekingsgroep bepaald, die weer gekoppeld is aan een BTW-percentage. |
Inkoopregel (39), Btw-productboekingsgroep (90) |
Code(10) |
|
3.3 Onderhoudsopdrachtbericht
3.3.1 Omschrijving
Met dit bericht wordt de inkooporder/onderhoudsorder met taakspecificatie beschikbaar gesteld aan de leverancier, die vervolgens via het statusbericht deze order accepteert of weigert.
3.3.2 Request
Veld |
Omschrijving |
Empire / vaste waarde |
Data-type |
Ver-plicht |
Berichtinformatie |
||||
Berichtnummer |
Nummer ter identificatie van een bericht. Mag door de zendende applicatie worden bepaald. |
Niet gebruikt |
Tekst(17) |
Ja |
Berichtdatum |
Datum waarop een bericht is aangemaakt. |
Niet gebruikt |
Datum |
Ja |
Berichttijd |
Tijdstip waarop het bericht is aangemaakt. |
Niet gebruikt |
Tijd |
Nee |
Opdrachtgever |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
Er moet een klant aanwezig zijn, waarvan de waarde van de GLN gelijk is aan de inhoud van dit veld. |
Code(13) |
Ja |
Naam |
Naam opdrachtgever |
Bedrijfsgegevens (1), Naam (2) |
Tekst(50) |
|
Contact informatie Contact informatie van de budgethouder (Medewerker) |
||||
Naam contactpersoon |
Naam van contactpersoon |
Medewerker(14), Naam (2) |
Tekst(35) |
|
Telefoonnummer |
Telefoonnummer van contactpersoon |
Medewerker(14), Telefoonnr. (5053) |
Tekst(20) |
|
|
Email van contactpersoon |
Medewerker(14), E-mail (5052) |
Tekst(254) |
|
Opdrachtnemer |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
De waarde van dit veld moet gelijk zijn aan de waarde zoals vastgelegd in de bedrijfsgegevens. |
Code(13) |
Ja |
Naam |
Naam opdrachtnemer |
Leverancier (23), Naam (2) |
Tekst(50) |
|
Opdrachtgegevens |
||||
Opdrachtnummer |
Nummer ter identificatie van een opdracht binnen een bericht. Alle informatieuitwisseling (factuur/status) wordt hierdoor geïdentificeerd, tenzij er berichten zijn op regelniveau, dan dient ook het regelnummer toegevoegd te worden. |
Onderhoudsorder (11031279), Nr. (1) |
Code(20) |
Ja |
Subopdrachtnummer |
Extra nummer ter verdere identificatie van een opdracht of opdrachtonderdeel. |
|
Code(20) |
Nee |
Opdrachtsoort |
Code waarmee de opdracht nader wordt gespecificeerd. Alleen vullen als een van de onderstaande situaties voorkomt: |
Onderhoudstaak (11031294), Verkoopwijze (1130), Doorbelasten aan (1100) en Doorbelasten aan klantnr. (1110) |
Code(10) |
Ja |
Opdrachtdatum |
Datum gunnen onderhoudsorder |
Onderhoudsorder (11031279), Gunningsdatum (54) |
Datum |
|
Opdrachttijd |
Tijd gunnen onderhoudsorder |
Onderhoudsorder (11031279), Gunningsdatum (54) |
Tijd |
|
Omschrijving |
Tekstveld met de inhoud van aanvullende informatie. |
Onderhoudverzoek (11031240), Omschrijving (10) |
Tekst(150) |
Nee |
Onderhoudslocatie Gegevens over de te onderhouden locatie. |
||||
VGE nummer |
Uniek nummer ter identificatie van een vastgoedeenheid |
Onderhoudverzoek (11031240), Eenheidnr. (20) |
Code(17) |
|
Bouwjaar |
Bouwjaar vastgoedeenheid |
OGE (11024008), Bouwjaar (11024020) |
Integer |
|
Straatnaam |
Tekstveld met straatnaam van het adres van de locatie. |
Onderhoudsverzoek (11031240), Adres melder (120) |
Tekst(50) |
|
Huisnummer |
Tekstveld met het huisnummer van het adres van de onderhoudslocatie. |
Onderhoudsverzoek (11031240), Adres melder (120) |
Tekst(50) |
|
Huisnummer toevoeging |
Tekstveld met de huisnummertoevoeging van het adres van de onderhoudslocatie. |
Onderhoudsverzoek (11031240), Adres melder (120) |
Tekst(50) |
|
Postcode |
Tekstveld met de postcode van het adres van de onderhoudslocatie. |
Onderhoudsverzoek (11031240), Postcode melder (130) |
Tekst(20) |
|
Woonplaats |
Tekstveld met de plaatsnaam van het adres van de onderhoudslocatie. |
Onderhoudsverzoek (11031240), Plaats melder (140) |
Tekst(30) |
|
Contactpersoon |
Tekstveld met de naam van de huismeester of huurder die de onderhoudsmelding heeft gedaan. Eventueel kan hier ook de naam van de huismeester vermeld worden, bijvoorbeeld om toegang tot het te onderhouden object te verlenen. De rubriek is niet bestemd om de verantwoordelijke persoon van de opdrachtgever te vermelden. |
Onderhoudsverzoek (11031240), Naam melder (110) |
Tekst(50) |
|
Huurder telefoonnummer1 |
Nummer waarmee via de telefoon contact kan worden opgenomen. Kan ook gebruikt worden voor het versturen van SMS- en Whatsapp-berichten. |
Onderhoudsverzoek (11031240), Telefoon melder (150) |
Tekst(30) |
|
Huurder telefoonnummer2 |
Nummer waarmee via de telefoon contact kan worden opgenomen. Kan ook gebruikt worden voor het versturen van SMS- en Whatsapp-berichten. |
Onderhoudsverzoek (11031240), Telefoon (overdag) melder (170) |
Tekst(30) |
|
Huurder E-mail1 |
Tekstveld met het elektronische adres waarmee via e-mail contact kan worden opgenomen. |
Onderhoudsverzoek (11031240), E-mail melder (190) |
Tekst(80) |
|
Afspraakgegevens Gegevens over de datum, tijd of periode van levering van onderhoud. |
||||
Gewenste datum van uitvoering |
Datum waarop iets moet worden uitgevoerd. |
Onderhoudstaak (11031294), Uiterste datum (10072) |
Date |
Nee |
Uitvoeringstijdvak Gegevens over de periode waarbinnen iets moet worden uitgevoerd. Bloktijd of afspraak met de aannemer. Het betreft hier de tijd waarbinnen de werkzaamheden aanvangen. Deze bloktijd is bij reparatieverzoeken de bloktijd die is afgesproken met de bewoner. Bij reparatieverzoeken waarbij geen aanwezigheid van de bewoner noodzakelijk is wordt het uitvoeringstijdvak leeggelaten. |
||||
Vroegste datum van uitvoering |
Datum vanaf wanneer de uitvoering kan/moet beginnen. Het betreft hier de datum waarop de bewoner vanaf de afgesproken tijd aanwezig is in geval van reparatieverzoeken. Bij mutatieonderhoud is dit de datum waarop de werkzaamheden op zijn vroegst mogen worden aangevangen. |
Onderhoudstaak (11031294), Voorkeursdatum (305) |
Date |
|
Vroegste tijdstip van uitvoering |
Tijdstip vanaf wanneer de uitvoering kan/moet beginnen. Het betreft hier afgesproken tijd vanaf (in combinatie met de datum) waarop de bewoner aanwezig is in geval van reparatieverzoeken. Bij mutatieonderhoud is dit de tijd waarop de werkzaamheden mogen starten (in combinatie met de datum). |
Onderhoudstaak (11031294), Voorkeursdagdeel (306) |
Time |
|
Laatste tijdstip van uitvoering |
Tijdstip tot wanneer de uitvoering kan/moet beginnen. Het betreft hier afgesproken tijd tot (in combinatie met de datum) waarop de bewoner aanwezig is in geval van reparatieverzoeken. Bij mutatieonderhoud is dit de tijd waarop de werkzaamheden mogen starten (in combinatie met de datum). |
Onderhoudstaak (11031294), Voorkeursdagdeel (306) |
Time |
|
Opdrachtregel Niveau in het bericht waar de onderhoudsdetails worden gespecificeerd. |
||||
Regelnummer |
Nummer ter identificatie van een regel binnen een bericht. |
Onderhoudstaak (11031294), Taaknr. (3) |
Code(10) |
Ja |
Aantal |
Het aantal eenheden van werk, geïdentificeerd door de normprijscode. |
Onderhoudstaak (11031294), Aantal (67) |
Decimaal |
Ja |
Eenheid van aantal |
Code van de meeteenheid waarin het aantal is uitgedrukt. Toegestane codes: |
Onderhoudstaak (11031294), Eenheidscode (68) |
Code(10) |
Ja |
Normprijscode |
Code waarmee het uit te voeren werk wordt aangegeven. Verwijzing naar vooraf overeengekomen werkzaamheden en bijbehorende prijsafspraken. |
MaintenanceTask (11031294), Standaardtaakcode (6) |
Code(20) |
Ja |
LEDO informatie |
Tekstveld met beschrijving over Locatie, Element, Defect en Oorzaak |
Onderhoudsverzoek (11031240): Onderhoudstype (91), Betreft collectief object (22), Omschrijving (24), Nr. melder (100) |
Tekst |
Nee |
Omschrijving kort |
Tekstveld met een korte nadere specificatie van het werk, geïdentificeerd door de normprijscode. |
Onderhoudstaak (11031294), Omschrijving (65) |
Tekst(150) |
Nee |
Omschrijving lang |
Tekstveld met een lange nadere specificatie van het werk geïdentificeerd door de normprijscode. Gegevens die dienen als aanvullende informatie, niet bestemd voor automatische verwerking. |
Onderhoudstaak (11031294), Meldingstekst boeken (1340) |
Tekst(250) |
Nee |
Bijlage informatie Bijlagen gekoppeld aan onderhoudstaak. |
||||
Bijlage |
De bijlage zelf weergegeven in een base64-codering. |
Bijlage (11031298), Bijlage (60) |
BLOB |
Nee |
Bijlagetype |
Bijlagesoort |
Bijlage (11031298), Soort code (100) |
|
|
Bestandstype |
Bestandsextensie |
Bijlage (11031298), Bestandsextensie (80) |
|
|
Bestandsnaam |
Tekstveld met de naam van het bestand dat is bijgesloten en/of waarnaar verwezen wordt door de URL. |
Bijlage (11031298), Bijlage (90) |
Tekst(250) |
Nee |
4 Berichten SALES005 (definitieve versie)
4.1 Factuurbericht
4.1.1 Omschrijving
Het factuurbericht wordt gebruikt om orders die door de leverancier zijn afgehandeld te factureren naar de woningcorporatie.
Als de factuur wordt geweigerd door de woningcorporatie, dan kan de factuur door de leverancier opnieuw aangeboden worden. Echter, hiervoor moet de medewerker van de woningcorporatie eerst de oude factuur in Dynamics Empire verwijderen. Via het DICO-statusbericht kan vervolgens de nieuwe kostenspecificatie verstuurd worden.
Ook is het mogelijk om direct na het gereed melden de factuur te versturen, hiervoor moet men in Dynamics Empire eerst de onderhoudsorder heropenen.
Als men in de inkoopwerkwijze van de leverancier de instelling ‘Conceptfacturenregels invoeren via factuur’ heeft ingeschakeld hoeft men alleen nog maar de oude factuur in Dynamics Empire te verwijderen en is heropenen van de onderhoudsorder niet nodig.
4.1.2 Request
Veld |
Omschrijving |
Empire / vaste waarde |
Data-type |
Ver-plicht |
Factuur |
||||
InvoiceType |
Code waarmee de transactie waarop het bericht betrekking heeft nader wordt gespecificeerd. |
"380" |
Tekst(3) |
Ja |
InvoiceNumber |
Nummer ter identificatie van de factuur. |
Inkoopkop (38), Ordernr. leverancier (68) |
Tekst(17) |
Ja |
InvoiceDate |
De factuurdatum. Dit is de datum die gehanteerd wordt voor de BTW-aangifte. Dit hoeft niet. |
Inkoopkop (38), Documentdatum (99) |
Datum |
Ja |
ExpirationDate |
De datum waarop de betaling voor de factuur uiterlijk binnen moet zijn. |
Inkoopkop (38), Vervaldatum (24) |
Datum |
Nee |
Currency |
Code van de munteenheid waarin de bedragen in het bericht zijn uitgedrukt. |
"EUR" |
Tekst(3) |
Ja |
PaymentMethodCode |
Code waarmee de manier waarop de factuur moet worden betaald, wordt aangegeven. Als voor deze factuur wordt afgeweken van de standaard betaalwijze kan dat hier worden aangegeven. Als voor deze factuur wordt afgeweken van de standaard betaalwijze kan dat hier worden aangegeven. |
Niet gebruikt |
Code(3) |
Nee |
AdditionalInformation |
Eerste 50 karakters worden als omschrijving factuur gebruikt. Als de tekst langer is dan 50 karakters wordt de tekst ook als leveranciersopmerking opgenomen. |
Inkoopkop (38), Omschrijving (22) Leverancieropmerkingsregel (11024243), Omschrijving (20) |
Tekst |
Nee |
Attachment De eerste bijlage wordt als de factuurbijlage verwerkt. De rest als normale bijlages. |
||||
AttachedData |
De bijlage zelf, weergegeven in een base64-codering. |
Bijlage (11031298), Bijlage (60) |
BLOB |
Nee |
FileName |
Tekstveld met de naam van het bestand dat is bijgesloten en/of waarnaar verwezen wordt door de URL. |
Bijlage (11031298), Omschrijving (90) |
Tekst(250) |
Nee |
URLInformation |
||||
URL |
Wereldwijd uniek kenmerk, voldoend aan de Uniform Resource Locator specificatie, ter identificatie van een informatiebron. |
Bijlage (11031298), Omschrijving (90) |
Tekst(250) |
Nee |
ChainLiabilityIndicator |
Code waarmee wordt aangegeven dat de Wet op de Ketenaansprakelijkheid (WKA) van toepassing is. Toegestane codes: |
Niet gebruikt |
Code(10) |
Nee |
Reversecharge-Indicator |
Code waarmee wordt aangegeven dat de BTW niet door de leverancier maar door de opdrachtgever moet worden afgedragen. Komt voor bij facturering van diensten van de onderaannemer aan de hoofdaannemer. De onderaannemer mag geen BTW op de factuur berekenen, de aannemer is BTW verschuldigd en moet die berekenen. N Nee Afhankelijk van de opgegeven code in dit veld en van de inhoud van het veld ‘VAT Rate’ in de factuurregel wordt bepaald of BTW-verlegging plaats moet vinden. |
Inkoopkop (38), BTW-verlegging van toepassing (11152581) |
Code(3) |
|
BuyersorderNumber |
Nummer ter identificatie van de order door de opdrachtgever. Het ordernummer van de opdrachtgever is de unieke code om te bepalen welke factuur bij welke order hoort. |
Onderhoudsorder (11031279), Nr. (1) |
Code(20) |
Ja |
Buyer Partij aan wie goederen en/of diensten worden verkocht en geleverd. Als FSC-certificering van toepassing is moeten de NAW-gegevens compleet worden vermeld. |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. De opdrachtgever is de corporatie of een afdeling van de corporatie. |
De inhoud van dit veld moet gelijk zijn aan de waarde die is vastgelegd in de bedrijfsgegevens (Bedrijfsgegevens (79), GLN (90)). |
Code(13) |
Ja |
Supplier Partij die goederen en/of diensten verkoopt en levert. Als FSC-certificering van toepassing is moeten de NAW-gegevens compleet worden vermeld. |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
De inhoud van dit veld moet gelijk zijn aan de waarde die is vastgelegd in de leverancier (23), GLN (90)), die gekoppeld is aan de onderhoudsorder (11031279), die wordt opge-haald met de waarde in het veld BuyersOrderNumber in dit factuurbericht. |
Code(13) |
Ja |
IBAN |
International Bank Account Number, wereldwijd uniek nummer ter identificatie van een bankrekening. |
Inkoopkop (38), Code bankrekening (11000001), bepaald via de IBAN uit de leveranciersbankgegevens. |
Tekst(70) |
Nee |
InvoiceLines Niveau in het bericht waar de in rekening gebrachte goederen worden gespecificeerd. |
||||
LineNumber |
Nummer ter identificatie van een regel binnen een bericht. |
Inkoopregel (39), Regelnr. (4) |
Integer |
Ja |
NumberOfInvoicingUnits |
Het aantal prijseenheden dat gefactureerd wordt. De eenheid (stuks, kilo, meter) wordt niet vermeld bij dit gegeven, maar is altijd hetzelfde als de eenheid van de prijsbasis. Het aantal factuureenheden is altijd gelijk aan het geleverde aantal, behalve bij artikelen waarvan de eenheid van de prijsbasis ongelijk is aan de eenheid van het geleverde aantal. Bijvoorbeeld voor spijkers die per stuk besteld worden maar per kilo gefactureerd worden. |
Inkoopregel (39), Aantal (15) |
Decimaal |
Ja |
DeliveredQuantityUoM |
Gegevens over de basiseenheid waarin een prijs is uitgedrukt. De opgegeven code moet gelijk zijn aan de code uit de oorspronkelijke order. |
Inkoopregel (39), Eenheidscode (5407) |
Code(10) |
Ja |
NetLineAmount |
Geldwaarde van het gefactureerde artikel, inclusief toeslagen en kortingen op regelniveau. |
Inkoopregel (39), Directe kostprijs (22) |
Decimaal |
Ja |
VATInformation |
||||
VATRate |
De toegestane waarde wordt vertaald naar de gebruikte code in Dynamics Empire. Mogelijke waarden: ‘AE’ |
Inkoopregel (39), Btw-productboekingsgroep (90) |
Code(10) |
Nee |
VATPercentage |
Het gebruikte BTW-percentage voor de factuurregel. Mede op basis van dit percentage wordt de boekingsgroep bepaald, die weer gekoppeld is aan een BTW-percentage. |
Inkoopregel (39), Btw-productboekingsgroep (90) |
Code(10) |
Nee |
AdditionalInormation |
Tekstveld met de inhoud van de aanvullende informatie. |
Inkoopregel (39), Omschrijving (11) |
Tekst(50) |
Nee |
Attachment De eerste bijlage wordt als de factuurbijlage verwerkt. De rest als normale bijlages. |
||||
AttachedData |
De bijlage zelf weergegeven in een base64-codering. |
Bijlage (11031298), Bijlage (60) |
BLOB |
Nee |
FileName |
Tekstveld met de naam van het bestand dat is bijgesloten en/of waarnaar verwezen wordt door de URL. |
Bijlage (11031298), Omschrijving (90) |
Tekst(250) |
Nee |
URLInformation |
||||
URL |
Wereldwijd uniek kenmerk, voldoend aan de Uniform Resource Locator specificatie, ter identificatie van een informatiebron. |
Bijlage (11031298), Omschrijving (90) |
Tekst(250) |
Nee |
PaymentOnBlockedAccount Gegevens over een geblokkeerde rekening, gebruikt door een aannemer om loonheffingen van door hen ingehuurd personeel aan de belastingdienst of aan onderaannemers te voldoen. Van een G-rekening kunnen geen andere betalingen gedaan worden. De rekening beschermt partijen tegen wanbetalingen van loonheffingen. |
||||
Amount |
Het bedrag dat op de G-rekening wordt gestort. Als dit bedrag gevuld is en het IBAN en Rekeningnummer niet zijn gevuld, dan moet bij de leverancier een G-rekening zijn ingevuld. Is dit niet het geval, dan volgt een foutmelding. |
Inkoopkop (38), Bedrag naar G-rekening (60301) |
Decimaal |
Nee |
IBAN |
International Bank Account Number, wereldwijd uniek nummer ter identificatie van een bankrekening. |
Als het bedrag bestemd voor de G-rekening gevuld is, dan moet, indien gevuld, het G-rekening IBAN voorkomen in de leveranciersbankgegevens. |
Tekst(70) |
Nee |
AccountNumber |
Banknummer |
Als het bedrag bestemd voor de G-rekening gevuld is, dan moet, indien gevuld, de bankrekening voorkomen in de leveranciersbankgegevens. |
Tekst(35) |
Nee |
InvoiceTotals Gegevens over totalen berekend over de gehele factuur. |
||||
TotalInvoiceAmount |
Geldwaarde van het totaal te betalen bedrag van de factuur inclusief BTW. |
Inkoopkop (38), Factuurbedrag (61047) |
Decimaal |
Ja |
TotalVATAmount |
Geldwaarde van het totaal aan BTW verschuldigde bedrag voor de factuur. |
Inkoopkop (38), Factuur BTW-bedrag (62021) |
Decimaal |
Ja |
VATSubTotal Gegevens over een berekend BTWsubtotaal |
||||
VATAmount |
Geldwaarde met het totaal veschuldigde bedrag binnen dit BTW-subtotaal. |
Niet gebruikt |
Decimaal |
Ja |
VATRate |
De toegestane waarde wordt vertaald naar de gebruikte code in Dynamics Empire. Mogelijke waarden: |
Niet gebruikt |
Code(10) |
Ja |
VATPercentage |
Het gebruikte BTW-percentage voor de factuurregel. Mede op basis van dit percentage wordt de boekingsgroep bepaald, die weer gekoppeld is aan een BTW-percentage. |
Niet gebruikt |
Code(10) |
Nee |
VATBAseAmount |
Bedrag dat dient als basis voor de berekening van de BTW-heffing. |
Niet gebruikt |
Decimaal |
Ja |
4.2 Onderhoudsstatusbericht
4.2.1 Omschrijving
Via het statusbericht kunnen diverse statussen worden uitgewisseld tussen leverancier en woningcorporatie. Tevens wordt in dit bericht de kostenspecificatie teruggegeven aan de woningcorporatie.
4.2.2 Request
Veld |
Omschrijving |
Empire / vaste waarde |
Data-type |
Ver-plicht |
Maintenance instruction |
||||
Messagenumber |
Nummer ter identificatie van een bericht. Mag door de zendende applicatie worden bepaald. |
Via nummerreeks Berichtnrs. (DICO-instellingen) |
Tekst(17) |
Ja |
MessageDate |
Datum waarop een bericht is aangemaakt. |
Huidige datum |
Datum |
Ja |
MessageTime |
Tijdstip waarop het bericht is aangemaakt. |
Huidige tijd |
Tijd |
Nee |
ReverseCharge-Indicator |
Code waarmee wordt aangegeven dat de BTW niet door de leverancier maar door de afnemer moet worden afgedragen. Toegestane codes: J Ja N Nee |
Onderhoudsorder (11031279), BTW verlegd (103) |
Char(1) |
Nee |
Buyer Partij die de opdracht geeft. |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
Er moet een klant aanwezig zijn, waarvan de waarde van de GLN gelijk is aan de inhoud van dit veld. |
Code(13) |
Ja |
Contractor Partij die opdracht gaat uitvoeren. |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
De waarde van dit veld moet gelijk zijn aan de waarde zoals vastgelegd in de bedrijfsgegevens. |
Code(13) |
Ja |
InstructionData De uit te voeren opdracht. |
||||
InstructionNumber |
Nummer ter identificatie van een opdracht binnen een bericht. Alle informatie-uitwisseling (factuur/status) wordt hierdoor geïdentificeerd, tenzij er berichten zijn op regelniveau, dan dient ook het regelnummer toegevoegd te worden. |
Onderhoudsorder (11031279), Nr. (1) |
Code(20) |
Ja |
InstructionSubNumber |
Extra nummer ter verdere identificatie van een opdracht of opdrachtonderdeel. |
|
Code(20) |
Nee |
Status |
Code waarmee de status wordt gespecificeerd. AFW Afwachten, in verband met weer BBT Bewoner belt terug BNT Bewoner niet thuis MIB Materiaal in bestelling TFC Te factureren VBW Verzoek bewoner VER Verlenging |
Onderhoudsorder (11031279), Status (26) De volgende statussen zijn in Empire geïmplementeerd: ACC, AFH, AFR, ANN, GER, UIT en WEI. |
Code(10) |
Ja |
Statusdescription |
Tekstveld met omschrijving van de status |
|
Tekst(70) |
|
DateReady |
Datum technische gereed |
Onderhoudsorder (11031279), Datum technsich gereed (44) |
Date |
|
TotalAmount |
Totaalbedrag van de opdracht |
|
Decimal |
|
FreeText |
Tekstveld met de inhoud van aanvullende informatie |
Leverancieropmerkingsregel (11024243), Omschrijving (20) |
Tekst |
Nee |
AppointmentDateTimeInformation Gegevens over de datum, tijd of periode van levering van onderhoud. |
||||
RequiredDeliveryDate |
Datum waarop de werkzaamheden moeten worden uitgevoerd |
Niet gebruikt |
Date |
|
RequiredDeliveryTime |
Tijdstip waarop de werkzaamheden moeten worden uitgevoerd |
Niet gebruikt |
Code(20) |
|
Uitvoeringstijdvak Gegevens over de periode waarbinnen iets moet worden uitgevoerd. Bloktijd of afspraak met de aannemer. Het betreft hier de tijd waarbinnen de werkzaamheden aanvangen. Deze bloktijd is bij reparatieverzoeken de bloktijd die is afgesproken met de bewoner. Bij reparatieverzoeken waarbij geen aanwezigheid van de bewoner noodzakelijk is wordt het uitvoeringstijdvak leeggelaten. |
||||
DeliveryDateEarliest |
Datum vanaf wanneer de uitvoering kan/moet beginnen. Het betreft hier de datum waarop de bewoner vanaf de afgesproken tijd aanwezig is in geval van reparatieverzoeken. Bij mutatie-onderhoud is dit de datum waarop de werkzaamheden op zijn vroegst mogen worden aangevangen. |
Onderhoudsorder (11031279), Afspraakdatum (45) |
Date |
|
DeliveryTimeEarliest |
Tijdstip vanaf wanneer de uitvoering kan/moet beginnen. Het betreft hier afgesproken tijd vanaf (in combinatie met de datum) waarop de bewoner aanwezig is in geval van reparatieverzoeken. Bij mutatieonderhoud is dit de tijd waarop de werkzaamheden mogen starten (in combinatie met de datum). |
Onderhoudsorder (11031279), Starttijd van (46) |
Code(20) |
|
DeliveryTimeLatest |
Tijdstip tot wanneer de uitvoering kan/moet beginnen. |
Onderhoudsorder (11031279), Starttijd tot (47) |
|
|
InstructionLine Niveau in het bericht waar de onderhoudsdetails worden gespecificeerd. |
||||
LineNumber |
Nummer ter identificatie van een regel binnen een bericht. Volgnummer om de regel binnen de opdracht uniek te maken (Opdrachtgever-ordernummer regelnummer moet uniek zijn). |
Onderhoudstaak (11031294), Taaknr. (3) |
Code(10) |
Ja |
Quantity |
Het aantal eenheden van werk, geïdentificeerd door de normprijscode. |
Onderhoudstaak (11031294), Aantal (67) |
Decimaal |
Ja |
MeasurementUnitQuantity |
Code van de meeteenheid waarin het aantal is uitgedrukt. Toegestane codes: |
Onderhoudstaak (11031294), Eenheidscode (68) |
Code(10) |
Ja |
Status |
Status van een instructieregel Code waarmee de status wordt gespecificeerd. AFW Afwachten, in verband met weer BBT Bewoner belt terug BNT Bewoner niet thuis MIB Materiaal in bestelling TFC Te factureren VBW Verzoek bewoner VER Verlenging |
Niet gebruikt |
Code(3) |
|
NormpriceCode |
Code waarmee het uit te voeren werk wordt aangegeven. Verwijzing naar vooraf overeengekomen werkzaamheden en bijbehorende prijsafspraken. |
Onderhoudstaak (11031294), Standaardtaakcode (6) |
Code(20) |
Ja |
Short description |
Tekstveld met een korte nadere specificatie van het werk, geïdentificeerd door de normprijscode. |
Onderhoudstaak (11031294), Omschrijving (65) |
Tekst(150) |
Nee |
Long description |
Tekstveld met een lange nadere specificatie van het werk, geïdentificeerd door de normprijscode. Gegevens die dienen als aanvullende informatie, niet bestemd voor automatische verwerking. |
Onderhoudstaak (11031294), Meldingstekst boeken (1340) |
Tekst(250) |
Nee |
LEDO information Gegevens over locatie, element, defect en oorzaak van het te onderhouden object. |
||||
Location |
Omschrijving van de locatie |
Onderhoudstaak (11031294, Ruimtesoortcode (63) |
Tekst(70) |
Nee |
Element |
Omschrijving van het element |
Onderhoudstaak (11031294, Bouwelementcode (60) |
Tekst(70) |
Nee |
Defect |
Omschrijving van het defect |
Onderhoudstaak (11031294, Onderdeelcode (61) |
Tekst(1000) |
Nee |
Cause |
Omschrijving van de oorzaak |
Onderhoudstaak (11031294, Oorzaakcode (20) |
Tekst(1000) |
Nee |
Attachment Gegevens over de bijlage en/of de deeplink bij een bericht. Het is verplicht om de 'URL' of 'Bijlage' te gebruiken. |
||||
URL |
Wereldwijd uniek kenmerk, voldoend aan de Uniform Resource Locator-specificatie, ter identificatie van een informatiebron. |
Bijlage (11031298), Description (90) |
Tekst(250) |
Nee |
AttachedData |
De bijlage zelf weergegeven in een base64-codering. |
Bijlage (11031298), Bijlage (60) |
BLOB |
Nee |
Filename |
Tekstveld met de naam van het bestand dat is bijgesloten en/of waarnaar verwezen wordt door de URL. |
Bijlage (11031298), Omschrijving (90) |
Tekst(250) |
Nee |
Prijsinformation Gegevens over de bijlage en/of de deeplink bij een bericht. Het is verplicht om de 'URL' of 'Bijlage' te gebruiken. |
||||
Price |
Hierin dient de te factureren prijs vermeld te worden. De controle op juiste prijs valt buiten de scope van het bericht. |
Inkoopregel (39), Directe kostprijs (22) |
Decimaal |
|
VAT Information Gegevens over de bijlage en/of de deeplink bij een bericht. Het is verplicht om de 'URL' of 'Bijlage' te gebruiken. |
||||
VAT Rate |
De toegestane waarde wordt vertaald naar de gebruikte code in Dynamics Empire. Mogelijke waarden: |
Inkoopregel (39), Btw-productboekingsgroep (90) |
Code(10) |
|
VAT Percentage |
Het gebruikte BTW-percentage voor de factuurregel. Mede op basis van dit percentage wordt de boekingsgroep bepaald, die weer gekoppeld is aan een BTW-percentage. |
Inkoopregel (39), Btw-productboekingsgroep (90) |
Code(10) |
|
4.3 Onderhoudsopdrachtbericht
4.3.1 Omschrijving
Met dit bericht wordt de inkooporder/onderhoudsorder met taakspecificatie beschikbaar gesteld aan de leverancier, die vervolgens via het statusbericht deze order accepteert of weigert.
4.3.2 Request
Veld |
Omschrijving |
Empire / vaste waarde |
Data-type |
Ver-plicht |
Berichtinformatie |
||||
Messagenumber |
Nummer ter identificatie van een bericht. Mag door de zendende applicatie worden bepaald. |
Via nummerreeks Berichtnrs. (DICO-instellingen) |
Tekst(17) |
Ja |
MessageDate |
Datum waarop een bericht is aangemaakt. |
Huidige datum |
Datum |
Ja |
MessageTime |
Tijdstip waarop het bericht is aangemaakt. |
Huidige tijd |
Tijd |
Nee |
ReverseChargeIndicator |
Code waarmee wordt aangegeven dat de BTW niet door de leverancier maar door de afnemer moet worden afgedragen Toegestane Codes: J Ja N Nee |
Onderhoudsorder (11031279), BTW verlegd (103) |
Char(1) |
Nee |
Buyer |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
Er moet een klant aanwezig zijn, waarvan de waarde van de GLN gelijk is aan de inhoud van dit veld. |
Code(13) |
Ja |
Name |
Naam opdrachtgever |
Bedrijfsgegevens (1), Naam (2) |
Tekst(50) |
|
Contact informatie Contact informatie van de budgethouder (Medewerker) |
||||
ContactPersonName |
Naam van contactpersoon |
Medewerker(14), Naam (2) |
Tekst(35) |
|
PhoneNumber |
Telefoonnummer van contactpersoon |
Medewerker(14), Telefoonnr. (5053) |
Tekst(20) |
|
EmailAddress |
E-mail van contactpersoon |
Medewerker(14), E-mail (5052) |
Tekst(254) |
|
Contractor |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. GLN wordt verstrekt door Ketenstandaard. |
De waarde van dit veld moet gelijk zijn aan de waarde zoals vastgelegd in de bedrijfsgegevens. |
Code(13) |
Ja |
Name |
Naam opdrachtgever |
Bedrijfsgegevens (1), Naam (2) |
Tekst(50) |
|
Attachment Bijlagen gekoppeld aan de onderhoudsverzoek en onderhoudsorder |
||||
AttachedData |
De bijlage zelf weergegeven in een base64-codering. |
Bijlage (11031298), Bijlage (60) |
BLOB |
Nee |
DocumentType |
Bijlagesoort |
Bijlage (11031298), Soort code (100) |
|
|
FileType |
Bestandsextensie |
Bijlage (11031298), Bestandsextensie (80) |
|
|
FileName |
Tekstveld met de naam van het bestand dat is bijgesloten en/of waarnaar verwezen wordt door de URL. |
Bijlage (11031298), Bijlage (90) |
Tekst(250) |
Nee |
InstructionData |
||||
InstructionNumber |
Nummer ter identificatie van een opdracht binnen een bericht. Alle informatieuitwisseling (factuur/status) wordt hierdoor geïdentificeerd, tenzij er berichten zijn op regelniveau, dan dient ook het regelnummer toegevoegd te worden. |
Onderhoudsverzoek (11031240), Ordernr. opdrachtgever (5) |
Code(20) |
Ja |
InstructionSubNumber |
Extra nummer ter verdere identificatie van een opdracht of opdrachtonderdeel. |
|
Code(20) |
Nee |
InstructionDate |
Datum gunnen onderhoudsorder |
Onderhoudsorder (11031279), Gunningsdatum (54) |
Datum |
|
InstructionTime |
Tijd gunnen onderhoudsorder |
Onderhoudsorder (11031279), Gunningsdatum (54) |
Tijd |
|
Instruction information Gegevens over de opdracht met betrekking tot soort, afspraakwijze en typering. |
||||
InstructionType |
Code waarmee de opdracht nader wordt gespecificeerd Mogelijke codes: |
Onderhoudsverzoek (11031240), Onderhoudstype (91) Alleen de codes MUT en REP worden gebruikt. |
Code(3) |
Ja |
InstructionAgreementMethod |
Code waarmee de opdracht inkoopwijze nader wordt gespecificeerd. Mogelijke codes: EHP = Eenheidsprijs |
Onderhoudsorder (11031279), Inkoopwijze (70) Alleen de codes AFK, EHP en REG worden gebruikt. |
Code(3) |
Ja |
InstructionTypeSpecification |
Code waarmee de opdrachttypering wordt gespecificeerd. ORG = Origineel |
Vaste waarde: ORG |
Code(3) |
Nee |
FreeText |
Tekstveld met de inhoud van aanvullende informatie |
Onderhoudverzoek (11031240), Omschrijving (10) |
Tekst(150) |
Nee |
MaintenanceLocation Gegevens over de te onderhouden locatie. |
||||
RealEstateUnitNumber |
Uniek nummer ter identificatie van een vastgoedeenheid |
Onderhoudverzoek (11031240), Eenheidnr. (20) |
Code(17) |
|
YearOfConstruction |
Bouwjaar vastgoedeenheid |
OGE (11024008), Bouwjaar (11024020), formaat CCYY |
Integer |
|
Street |
Tekstveld met straatnaam van het adres van de locatie. |
OGE (11024008), Straatnaam (5) |
Tekst(80) |
|
HouseNumber |
Tekstveld met het huisnummer van het adres van de onderhoudslocatie. |
OGE (11024008), Huisnr. (3) |
Integer |
|
HouseLetter |
Tekstveld met letteraanduiding van het huisnummer van het adres van de onderhoudslocatie. |
Niet gebruikt |
Tekst(1) |
|
HouseNumberSuffix |
Tekstveld met de huisnummertoevoeging van het adres van de onderhoudslocatie. |
OGE (11024008), Toevoegsel (4) |
Tekst(4) |
|
PostalCode |
Tekstveld met de postcode van het adres van de onderhoudslocatie. |
OGE (11024008), Postcode (7), formaat 9999XX |
Tekst(9) |
|
City |
Tekstveld met de plaatsnaam van het adres van de onderhoudslocatie. |
OGE (11024008), Plaats (8) |
Tekst(80) |
|
ContactPersonName |
Tekstveld met de naam van de huismeester of huurder die de onderhoudsmelding heeft gedaan. |
Onderhoudsverzoek (11031240), Naam melder (110) |
Tekst(35) |
|
PhoneNumber1 |
Nummer waarmee via de telefoon contact kan worden opgenomen. Kan ook gebruikt worden voor het versturen van SMS- en Whatsapp-berichten. |
Onderhoudsverzoek (11031240), Telefoon melder (150) |
Tekst(20) |
|
PhoneNumber2 |
Nummer waarmee via de telefoon contact kan worden opgenomen. Kan ook gebruikt worden voor het versturen van SMS- en Whatsapp-berichten. |
Onderhoudsverzoek (11031240), Telefoon (overdag) melder (170) |
Tekst(20) |
|
EmailAddress1 |
Tekstveld met het elektronische adres waarmee via e-mail contact kan worden opgenomen. |
Onderhoudsverzoek (11031240), E-mail melder (190) |
Tekst(254) |
|
EmailAddress2 |
Tekstveld met het elektronische adres waarmee via e-mail contact kan worden opgenomen. |
Niet gebruikt |
Tekst(254) |
|
GeographicalCoordinates De geografische locatie volgens WGS84 in latitude en longitude. |
||||
Latitude |
De geografische coördinaat die de noord-zuid-positie op aarde aangeeft vanaf 0 op de evenaar tot 90 voor de polen, uitgedrukt in graden met decimalen. |
Niet gebruikt |
Tekst(35) |
|
Longitude |
De geografische coördinaat die de oost-west-positie op aarde aangeeft vanaf 0 op de nul-meridiaan tot 180 naar het oosten of westen, uitgedrukt in graden met decimalen. |
Niet gebruikt |
Tekst(35) |
|
AppointmentDateTimeInformation Gegevens over de datum, tijd of periode van levering van onderhoud. |
||||
RequiredDeliveryDate |
Datum waarop de werkzaamheden moeten worden uitgevoerd |
Onderhoudsorder (11031279), Uiterste gereeddatum (43) |
Date |
|
RequiredDeliveryTime |
Tijdstip waarop de werkzaamheden moeten worden uitgevoerd |
Niet gebruikt |
Time |
|
Uitvoeringstijdvak Gegevens over de periode waarbinnen iets moet worden uitgevoerd. Bloktijd of afspraak met de aannemer. Het betreft hier de tijd waarbinnen de werkzaamheden aanvangen. Deze bloktijd is bij reparatieverzoeken de bloktijd die is afgesproken met de bewoner. Bij reparatieverzoeken waarbij geen aanwezigheid van de bewoner noodzakelijk is wordt het uitvoeringstijdvak leeggelaten. |
||||
DeliveryDateEarliest |
Datum vanaf wanneer de uitvoering kan/moet beginnen. Het betreft hier de datum waarop de bewoner vanaf de afgesproken tijd aanwezig is in geval van reparatieverzoeken. Bij mutatie-onderhoud is dit de datum waarop de werkzaamheden op zijn vroegst mogen worden aangevangen. |
Onderhoudstaak (11031294), Voorkeursdatum (305) of indien gepland Onderhoudsorder (11031279), Afspraakdatum (45) |
Date |
|
DeliveryTimeEarliest |
Tijdstip vanaf wanneer de uitvoering kan/moet beginnen. Het betreft hier afgesproken tijd vanaf (in combinatie met de datum) waarop de bewoner aanwezig is in geval van reparatieverzoeken. Bij mutatieonderhoud is dit de tijd waarop de werkzaamheden mogen starten (in combinatie met de datum). |
Onderhoudstaak (11031294), Voorkeursdagdeel (306) of indien gepland Onderhoudsorder (11031279), Starttijd van (46) |
Time |
|
DeliveryTimeLatest |
Tijdstip tot wanneer de uitvoering kan/moet beginnen. |
Onderhoudstaak (11031294), Voorkeursdagdeel (306) of indien gepland Onderhoudsorder (11031279), Starttijd tot (47) |
Time |
|
InstructionLine Niveau in het bericht waar de onderhoudsdetails worden gespecificeerd. |
||||
LineNumber |
Nummer ter identificatie van een regel binnen een bericht. Volgnummer om de regel binnen de opdracht uniek te maken (Opdrachtgever-ordernummer regelnummer moet uniek zijn). |
Onderhoudstaak (11031294), Taaknr. (3) |
Code(10) |
Ja |
Quantity |
Het aantal eenheden van werk, geïdentificeerd door de normprijscode. |
Onderhoudstaak (11031294), Aantal (67) |
Decimaal |
Ja |
MeasurementUnit-Quantity |
Code van de meeteenheid waarin het aantal is uitgedrukt. Toegestane codes: |
Onderhoudstaak (11031294), Eenheidscode (68) |
Code(10) |
Ja |
Status |
Status van een instructieregel Code waarmee de status wordt gespecificeerd. AFW Afwachten, in verband met weer BBT Bewoner belt terug BNT Bewoner niet thuis MIB Materiaal in bestelling TFC Te factureren VBW Verzoek bewoner VER Verlenging |
Niet gebruikt |
Code(3) |
|
NormpriceCode |
Code waarmee het uit te voeren werk wordt aangegeven. Verwijzing naar vooraf overeengekomen werkzaamheden en bijbehorende prijsafspraken. |
Onderhoudstaak (11031294), Standaardtaakcode (6) |
Code(20) |
Ja |
Short description |
Tekstveld met een korte nadere specificatie van het werk, geïdentificeerd door de normprijscode. |
Onderhoudstaak (11031294), Omschrijving (65) |
Tekst(150) |
Nee |
Long description |
Tekstveld met een lange nadere specificatie van het werk, geïdentificeerd door de normprijscode. Gegevens die dienen als aanvullende informatie, niet bestemd voor automatische verwerking. |
Onderhoudstaak (11031294), Meldingstekst boeken (1340) |
Tekst(250) |
Nee |
LEDO information Gegevens over locatie, element, defect en oorzaak van het te onderhouden object. |
||||
Location |
Omschrijving van de locatie |
Onderhoudstaak (11031294, Ruimtesoortcode (63) |
Tekst(70) |
Nee |
Element |
Omschrijving van het element |
Onderhoudstaak (11031294, Bouwelementcode (60) |
Tekst(70) |
Nee |
Defect |
Omschrijving van het defect |
Onderhoudstaak (11031294, Onderdeelcode (61) |
Tekst(1000) |
Nee |
Cause |
Omschrijving van de oorzaak |
Onderhoudstaak (11031294, Oorzaakcode (20) |
Tekst(1000) |
Nee |
Attachment Bijlagen gekoppeld aan de onderhoudstaak |
||||
AttachedData |
De bijlage zelf weergegeven in een base64-codering. |
Bijlage (11031298), Bijlage (60) |
BLOB |
Nee |
DocumentType |
Bijlagesoort |
Bijlage (11031298), Soort code (100) |
|
|
FileType |
Bestandsextensie |
Bijlage (11031298), Bestandsextensie (80) |
|
|
FileName |
Tekstveld met de naam van het bestand dat is bijgesloten en/of waarnaar verwezen wordt door de URL. |
Bijlage (11031298), Bijlage (90) |
Tekst(250) |
Nee |
Prijsinformation Gegevens over de bijlage en/of de deeplink bij een bericht. Het is verplicht om de 'URL' of 'Bijlage' te gebruiken. |
||||
Price |
Hierin dient de te factureren prijs vermeld te worden. De controle op juiste prijs valt buiten de scope van het bericht. |
Niet gebruikt |
|
|
VAT Information Gegevens over de bijlage en/of de deeplink bij een bericht. Het is verplicht om de 'URL' of 'Bijlage' te gebruiken. |
||||
VAT RAte |
De toegestane waarde wordt vertaald naar de gebruikte code in Dynamics Empire. Mogelijke waarden: |
Niet gebruikt |
Code(10) |
|
VAT percentage |
Het gebruikte BTW-percentage voor de factuurregel. Mede op basis van dit percentage wordt de boekingsgroep bepaald, die weer gekoppeld is aan een BTW-percentage. |
Niet gebruikt |
Code(10) |
|
4.4 Planningsbericht
4.4.1 Omschrijving
Via het planningsbericht vraagt de woningcorporatie planningen (uitvoeringsmomenten) op bij de leverancier. De geselecteerde planning (uitvoeringsmoment) wordt in de afspraakgegevens van het opdrachtbericht meegegeven.
4.4.2 Request
Veld |
Omschrijving |
Empire / vaste waarde |
Data-type |
Ver-plicht |
PlanningRequest |
||||
PlanningRequestNumber |
Nummer ter identificatie van een bericht. |
Via nummerreeks Berichtnrs. (DICO-instellingen) |
Tekst(17) |
Ja |
MessageDate |
Datum waarop een bericht is aangemaakt. |
Huidige datum |
Datum |
Ja |
MessageTime |
Tijdstip waarop het bericht is aangemaakt. |
Huidige tijd |
Tijd |
Nee |
Duration |
De door de opdrachtgever bepaalde tijd voor een klus, formaat PnYnMnDTnHnM |
Onderhoudsorder (11031279), Duur (40) |
Duur |
ja |
NumberOfPlanningOptions |
Planningsverzoek/Aantal planning opties |
Leverancier (23), Aantal planning opties (11152231), indien leeg 20 |
Integer |
Ja |
Buyer Partij die een planning aanvraagt |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. |
Bedrijfsgegevens (79), GLN (90) |
Code(13) |
Ja |
Contractor Partij die een planning levert |
||||
GLN |
Global Location Number (GLN), een wereldwijd uniek nummer ter identificatie van een partij of locatie. |
Leverancier (23), GLN (90) |
Code(13) |
Ja |
MaintenanceLocation Onderhoudslocatie |
||||
Street |
Tekstveld met straatnaam van het adres van de locatie. |
Via Onderhoudsverzoek (11031240), Eenheidnr. (20) OGE (11024008), Straatnaam (5) |
Tekst(80) |
|
HouseNumber |
Tekstveld met het huisnummer van het adres van de locatie. |
OGE (11024008), Huisnr. (3) |
Integer |
|
HouseLetter |
Tekstveld met letteraanduiding van het huisnummer van het adres van de partij of locatie. |
OGE (11024008), Toevoegsel (4), indien 1 lang |
Tekst(1) |
|
HouseNumberSuffix |
Tekstveld met de huisnummertoevoeging van het adres van de locatie. |
OGE (11024008), Toevoegsel (4), indien meer dan 1 lang |
Tekst(4) |
|
PostalCode |
Tekstveld met de postcode van het adres van de locatie. |
OGE (11024008), Postcode (7) |
Tekst(9) |
|
City |
Tekstveld met de plaatsnaam van het adres van de locatie. |
OGE (11024008), Plaats (8) |
Tekst(80) |
|
GeographicalCoordinates De geografische locatie volgens WGS84 in latitude en longitude. |
||||
Latitude |
De geografische coördinaat die de noord-zuid-positie op aarde aangeeft vanaf 0 op de evenaar tot 90 voor de polen, uitgedrukt in graden met decimalen. |
Niet gebruikt |
Tekst(35) |
|
Longitude |
De geografische coördinaat die de oost-west-positie op aarde aangeeft vanaf 0 op de nul-meridiaan tot 180 naar het oosten of westen, uitgedrukt in graden met decimalen. |
Niet gebruikt |
Tekst(35) |
|
Competence Gegevens over benodigde vaardigheden. |
||||
CompetenceCode |
Code waarmee het soort competentie wordt aangegeven. Toegestane codes: ELE Electra LOO Loodgieter OVE Overige SCH Schilderen STU Stucen TIM Timmeren |
Onderhoudsorder (11031279), Bekwaamheidscode (51) |
Code(3) |
Ja |
NumberOfResources |
Het aantal benodigde/geleverde resources voor de betreffende competentie. De velden Duur en Aantal resources hebben een relatie tot elkaar. Als bij Duur 16 uur wordt ingevuld en bij Aantal resources 2 betekent dit dat er 2x8uur wordt gepland. |
Onderhoudsorder (11031279), Aantal resources (50) |
Integer |
Ja |
MaintenanceMoment Gegevens over de datum, tijd of periode van onderhoud. |
||||
EarliestExecutionDate |
Vroegste datum waarop iets moet/kan worden uitgevoerd. |
Invoer gebuiker |
Datum |
Ja |
LatestExecutionDate |
Laatste datum waarop iets moet/kan worden uitgevoerd. |
Invoer gebuiker |
Datum |
Ja |
TimeblocksPerWeekday Weekdag met of zonder start- en eindtijden. |
||||
Weekday |
Code die de dag van de week weergeeft. Toegestane codes: FRI Vrijdag MON Maandag SAT Zaterdag SUN Zondag THU Donderdag TUE Dinsdag WED Woensdag |
Niet gebruikt |
Code(3) |
|
TimeblocksPerWeekday/Timeblock Gegevens over de periode waarbinnen iets moet/kan worden uitgevoerd. |
||||
EarliestExecutionTime |
Tijdstip vanaf wanneer de uitvoering kan/moet beginnen. |
Niet gebruikt |
Tijd |
|
LatestExecutionTime |
Tijdstip tot wanneer de uitvoering kan/moet beginnen. |
Niet gebruikt |
Tijd |
|
Timeblock Gegevens over de periode waarbinnen iets moet/kan worden uitgevoerd. |
||||
EarliestExecutionTime |
Tijdstip vanaf wanneer de uitvoering kan/moet beginnen. |
Niet gebruikt |
Tijd |
|
LatestExecutionTime |
Tijdstip tot wanneer de uitvoering kan/moet beginnen. |
Niet gebruikt |
Tijd |
|