Ga naar inhoud

ds_p4f_relatie

Plan4Flex operatie voor het invoeren en wijzigen van gegevens van een relatie.
Deze service is ontwikkeld om de koppeling tussen Plan4Flex applicatie en Easyflex mogelijk te maken.
Indien de aangeboden relatie tevens is gekopieerd naar één of meerdere samenwerkende werkmaatschappijen worden deze ook aangepast.
In de response van de service is te zien of het één of meerdere updates betreft aangezien van alle aangepaste relaties het registratienummer inclusief werkmaatschappijnummer wordt geretourneerd.

Parameters

Attribuut Type Verplicht Omschrijving
Vestiging V
  • Inschrijver
    Klik hier voor meer info...Deze velden zijn noodzakelijk om een relatie in te voeren. Indien ze niet in het request aanwezig zijn wordt gecontroleerd of ze zijn opgenomen in Easyflex bij onderdeel Bedrijfsinstellingen – inschrijven (Gebruiken bij externe koppeling).
 xsd:int O Identificatienummer (idnr) van de medewerker.
  • Relatiebeheerder
    Klik hier voor meer info...Deze velden zijn noodzakelijk om een relatie in te voeren. Indien ze niet in het request aanwezig zijn wordt gecontroleerd of ze zijn opgenomen in Easyflex bij onderdeel Bedrijfsinstellingen – inschrijven (Gebruiken bij externe koppeling).
 xsd:int O Identificatienummer (idnr) van de medewerker.
  • Locatie
    Klik hier voor meer info...Deze velden zijn noodzakelijk om een relatie in te voeren. Indien ze niet in het request aanwezig zijn wordt gecontroleerd of ze zijn opgenomen in Easyflex bij onderdeel Bedrijfsinstellingen – inschrijven (Gebruiken bij externe koppeling).
 xsd:int O Locatie.
  • Id
    Klik hier voor meer info...Wanneer de relatie wordt aangeboden wordt gecontroleerd of de relatie reeds aanwezig is in de Easyflex werkmaatschappij. Indien ‘ImportId’ aanwezig is wordt eerst hiermee gezocht en anders eventueel via ‘Debiteurnr’. Indien de relatie niet wordt gevonden betreft het een ‘Insert‘, en anders een ‘Update‘. In beide gevallen wordt vervolgens de waarde van het attribuut Id opgeslagen tezamen met identificerende Easyflex gegevens zodat bij een volgende aanlevering van deze relatie de koppeling bekend is. Het is dus noodzakelijk dat attribuut ‘Id‘ aanwezig is.

    Update van debiteurnummer is alleen mogelijk indien deze niet voorkomt bij een andere relatie. Tevens zal een update van het debiteurnummer en bijbehorende status alleen plaatsvinden bij de relatie van de aangeboden werkmaatschappij en niet bij de relaties in de samenwerkende werkmaatschappijen. Indien de relatie in de samenwerkende werkmaatschappij nog geen debiteurnummer heeft zal deze wel worden gevuld, mits het aangeboden debiteurnummer niet reeds voorkomt in deze werkmaatschappij.

    De externe koppeling gegevens zijn terug te vinden in Easyflex bij onderdeel Relatie – webservices (Overzicht koppelingen extern).

    Bij een insert mag het debiteurnummer maximaal uit 7 cijfers bestaan, maar omdat er bij conversies relaties zijn aangemaakt met 8 cijfers is het wel mogelijk debiteurnummer met meer dan 7 cijfers te zoeken en evt. aan te passen.
 xsd:int V Identificatienummer (idnr) van externe partij.
  • ImportId
    Klik hier voor meer info...Wanneer de relatie wordt aangeboden wordt gecontroleerd of de relatie reeds aanwezig is in de Easyflex werkmaatschappij. Indien ‘ImportId’ aanwezig is wordt eerst hiermee gezocht en anders eventueel via ‘Debiteurnr’. Indien de relatie niet wordt gevonden betreft het een ‘Insert‘, en anders een ‘Update‘. In beide gevallen wordt vervolgens de waarde van het attribuut Id opgeslagen tezamen met identificerende Easyflex gegevens zodat bij een volgende aanlevering van deze relatie de koppeling bekend is. Het is dus noodzakelijk dat attribuut ‘Id‘ aanwezig is.

    Update van debiteurnummer is alleen mogelijk indien deze niet voorkomt bij een andere relatie. Tevens zal een update van het debiteurnummer en bijbehorende status alleen plaatsvinden bij de relatie van de aangeboden werkmaatschappij en niet bij de relaties in de samenwerkende werkmaatschappijen. Indien de relatie in de samenwerkende werkmaatschappij nog geen debiteurnummer heeft zal deze wel worden gevuld, mits het aangeboden debiteurnummer niet reeds voorkomt in deze werkmaatschappij.

    De externe koppeling gegevens zijn terug te vinden in Easyflex bij onderdeel Relatie – webservices (Overzicht koppelingen extern).

    Bij een insert mag het debiteurnummer maximaal uit 7 cijfers bestaan, maar omdat er bij conversies relaties zijn aangemaakt met 8 cijfers is het wel mogelijk debiteurnummer met meer dan 7 cijfers te zoeken en evt. aan te passen.
 xsd:int F Easyflex Identificatienummer (idnr) van de relatie.
  • Opdrachtgever
 F
  • Naam
    Klik hier voor meer info...Om de relatie zoeknaam en naam in Easyflex te vullen worden deze velden aan elkaar geplakt. De eerste 16 tekens komen vervolgens in zoeknaam, en de eerste 40 tekens in naam van de Easyflex relatie. Zoeknaam zal alleen worden gevuld indien het een insert betreft en bij een update niet meer worden aangepast. Het is mogelijk om, in geval van de relatienaam, de velden niet aan elkaar te plakken maar te kiezen voor enkel de opdrachtgevernaam.

    Dit is in te stellen in Easyflex bij ‘beheer’ – ‘Bedrijfsinstellingen’ – ‘inschrijven’ – ‘Plan4Flex relatienaam’.
 xsd:string C Naam van de relatie.
  • Naam
    Klik hier voor meer info...Om de relatie zoeknaam en naam in Easyflex te vullen worden deze velden aan elkaar geplakt. De eerste 16 tekens komen vervolgens in zoeknaam, en de eerste 40 tekens in naam van de Easyflex relatie. Zoeknaam zal alleen worden gevuld indien het een insert betreft en bij een update niet meer worden aangepast. Het is mogelijk om, in geval van de relatienaam, de velden niet aan elkaar te plakken maar te kiezen voor enkel de (vestiging)naam.

    Dit is in te stellen in Easyflex bij ‘beheer’ – ‘Bedrijfsinstellingen’ – ‘inschrijven’ – ‘Plan4Flex relatienaam’.
 xsd:string C Naam van de vestiging van de relatie.
  • Kvknr
 xsd:int(8) F Nummer KvK van de relatie.
  • Debiteurnr
    Klik hier voor meer info...Wanneer de relatie wordt aangeboden wordt gecontroleerd of de relatie reeds aanwezig is in de Easyflex werkmaatschappij. Indien ‘ImportId’ aanwezig is wordt eerst hiermee gezocht en anders eventueel via ‘Debiteurnr’. Indien de relatie niet wordt gevonden betreft het een ‘Insert‘, en anders een ‘Update‘. In beide gevallen wordt vervolgens de waarde van het attribuut Id opgeslagen tezamen met identificerende Easyflex gegevens zodat bij een volgende aanlevering van deze relatie de koppeling bekend is. Het is dus noodzakelijk dat attribuut ‘Id‘ aanwezig is.

    Update van debiteurnummer is alleen mogelijk indien deze niet voorkomt bij een andere relatie. Tevens zal een update van het debiteurnummer en bijbehorende status alleen plaatsvinden bij de relatie van de aangeboden werkmaatschappij en niet bij de relaties in de samenwerkende werkmaatschappijen. Indien de relatie in de samenwerkende werkmaatschappij nog geen debiteurnummer heeft zal deze wel worden gevuld, mits het aangeboden debiteurnummer niet reeds voorkomt in deze werkmaatschappij.

    De externe koppeling gegevens zijn terug te vinden in Easyflex bij onderdeel Relatie – webservices (Overzicht koppelingen extern).

    Bij een insert mag het debiteurnummer maximaal uit 7 cijfers bestaan, maar omdat er bij conversies relaties zijn aangemaakt met 8 cijfers is het wel mogelijk debiteurnummer met meer dan 7 cijfers te zoeken en evt. aan te passen.
 xsd:int(7) F Debiteurnummer van de relatie.
  • Website
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Website van de relatie.
  • Status
    Klik hier voor meer info...Wanneer de relatie wordt aangeboden wordt gecontroleerd of de relatie reeds aanwezig is in de Easyflex werkmaatschappij. Indien ‘ImportId’ aanwezig is wordt eerst hiermee gezocht en anders eventueel via ‘Debiteurnr’. Indien de relatie niet wordt gevonden betreft het een ‘Insert‘, en anders een ‘Update‘. In beide gevallen wordt vervolgens de waarde van het attribuut Id opgeslagen tezamen met identificerende Easyflex gegevens zodat bij een volgende aanlevering van deze relatie de koppeling bekend is. Het is dus noodzakelijk dat attribuut ‘Id‘ aanwezig is.

    Update van debiteurnummer is alleen mogelijk indien deze niet voorkomt bij een andere relatie. Tevens zal een update van het debiteurnummer en bijbehorende status alleen plaatsvinden bij de relatie van de aangeboden werkmaatschappij en niet bij de relaties in de samenwerkende werkmaatschappijen. Indien de relatie in de samenwerkende werkmaatschappij nog geen debiteurnummer heeft zal deze wel worden gevuld, mits het aangeboden debiteurnummer niet reeds voorkomt in deze werkmaatschappij.

    De externe koppeling gegevens zijn terug te vinden in Easyflex bij onderdeel Relatie – webservices (Overzicht koppelingen extern).

    Bij een insert mag het debiteurnummer maximaal uit 7 cijfers bestaan, maar omdat er bij conversies relaties zijn aangemaakt met 8 cijfers is het wel mogelijk debiteurnummer met meer dan 7 cijfers te zoeken en evt. aan te passen.
 F
  • ExportCode
 xsd:string F Status van de relatie.
  • Adres
 V
  • Adres
 xsd:string V Bezoekadres – Straat.
  • Huisnummer
 xsd:int(5) V Bezoekadres – Huisnummer.
  • Toevoeging
 xsd:string F Bezoekadres – Toevoeging.
  • Postcode
 xsd:string F Bezoekadres – Postcode.
  • Woonplaats
 xsd:string V Bezoekadres – Plaats.
  • Land
 F
  • Code
 xsd:string V Bezoekadres – Land.
  • Telefoon
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Telefoonnummer.
  • Fax
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Faxnummer.
  • Mobiel
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Telefoonnummer.
  • Email
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Emailadres.
  • PostAdres
 F Indien PostAdres niet aanwezig of leeg, dan worden de gegevens overgenomen uit Bezoekadres.
  • Adres
 xsd:string V Correspondentieadres – Straat.
  • Huisnummer
 xsd:int(5) V Correspondentieadres – Huisnummer.
  • Toevoeging
 xsd:string F Correspondentieadres – Toevoeging.
  • Postcode
 xsd:string F Correspondentieadres – Postcode.
  • Woonplaats
 xsd:string V Correspondentieadres – Plaats.
  • Land
 F
  • Code
 xsd:string V Correspondentieadres – Land.
  • Telefoon
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Telefoonnummer.
  • Fax
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Faxnummer.
  • Mobiel
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Telefoonnummer.
  • Email
    Klik hier voor meer info...Al deze gegevens worden opgeslagen in Easyflex bij Relatie - algemeen – Communicatie. Voor deze gegevens geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerdere moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden.
 xsd:string F Emailadres.

Fields

Attribuut Type Omschrijving
relatie_registratienummer xsd:string Registratienummer(s) en eventueel werkmaatschappij nummer(s)

Exceptions

Code Detail Omschrijving
39043 Inschrijver, Relatiebeheerder en Locatie dienen bekend te zijn Zelfverklarend.
39043 Inschrijver onbekend Zelfverklarend.
39043 Relatiebeheerder onbekend Zelfverklarend.
39043 Vestiging - Id ontbreekt Zelfverklarend.
39043 Debiteurnr ontbreekt Zelfverklarend.
39043 Status - ExportCode niet correct Zelfverklarend.
39043 Status - ExportCode ontbreekt Zelfverklarend.
39043 Adres - Adres ontbreekt Zelfverklarend.
39043 Adres - Huisnummer ontbreekt Zelfverklarend.
39043 Adres - Woonplaats ontbreekt Zelfverklarend.
39043 Adres - Land - Code ontbreekt Zelfverklarend.
39043 Adres ontbreekt Zelfverklarend.
39043 PostAdres - Niet alle adresgegevens gevuld Zelfverklarend.
39043 Debiteurnr - Status Zelfverklarend.
39043 Opdrachtgever - Naam ontbreekt Zelfverklarend.
39043 Naam ontbreekt Zelfverklarend.
39043 Probleem met registratienummer, deze worden dynamisch teruggegeven in de exception. Het opgegeven registratienummer is onbekend.
39043 Probleem met inschrijver, deze worden dynamisch teruggegeven in de exception. De inschrijver dient bekend te zijn in schema.
39043 Probleem met debiteurnummer, deze worden dynamisch teruggegeven in de exception. Het debiteurnummer is reeds aanwezig in schema.
39043 Adres - Telefoon niet correct Zelfverklarend.
39043 Adres - Fax niet correct Zelfverklarend.
39043 Adres - Mobiel niet correct Zelfverklarend.
39043 Adres - Email niet correct Zelfverklarend.
39043 PostAdres - Telefoon niet correct Zelfverklarend.
39043 PostAdres - Fax niet correct Zelfverklarend.
39043 PostAdres - Mobiel niet correct Zelfverklarend.
39043 PostAdres - Email niet correct Zelfverklarend.
39043 Probleem met postcode, deze worden dynamisch teruggegeven in de exception. Opgegeven postcode is niet correct.
39043 Probleem met landcode, deze worden dynamisch teruggegeven in de exception. Opgegeven landcode is niet correct.
39045 niet geautoriseerd Inschrijver is niet geautoriseerd voor het aanmaken van relaties.
39045 niet geautoriseerd Inschrijver is niet geautoriseerd voor het wijzigen van relaties.
39043 locatie Opgegeven locatie is onbekend of passief.
39043 Het debiteurennummer moet automatisch toegekend worden. Het debiteurennummer moet automatisch toegekend worden.
39043 Wijzigen debiteurennummer is niet toegestaan Wijzigen debiteurennummer is niet toegestaan
39043 Debiteurennummer moet tussen bepaalde waarde vallen, zie exception voor exacte waarde. Debiteurennummer moet tussen bepaalde waarde vallen, zie exception voor exacte waarde.
39043 Debiteurennummer wordt niet automatisch toegekend. Debiteurennummer wordt niet automatisch toegekend.
39043 Debiteurennummer is al toegekend bij een schema, zie exception voor specifiek schema. Debiteurennummer is al toegekend bij een schema, zie exception voor specifiek schema.
39043 Er zijn geen debiteurennummers meer beschikbaar. Er zijn geen debiteurennummers meer beschikbaar.