# KVK Basisprofiel naar FHIR Organization - Netherlands - Generic Functions for data exchange Implementation Guide v0.9.0-ballot

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **KVK Basisprofiel naar FHIR Organization**

## StructureMap: KVK Basisprofiel naar FHIR Organization 

| | |
| :--- | :--- |
| *Official URL*:http://minvws.github.io/generiekefuncties-docs/StructureMap/KvkBasisprofielToOrganization | *Version*:0.9.0-ballot |
| Draft as of 2026-04-02 | *Computable Name*:KvkBasisprofielToOrganization |

 
StructureMap die een KVK Basisprofiel API response transformeert naar een FHIR Organization resource. 



## Resource Content

```json
{
  "resourceType" : "StructureMap",
  "id" : "KvkBasisprofielToOrganization",
  "url" : "http://minvws.github.io/generiekefuncties-docs/StructureMap/KvkBasisprofielToOrganization",
  "version" : "0.9.0-ballot",
  "name" : "KvkBasisprofielToOrganization",
  "title" : "KVK Basisprofiel naar FHIR Organization",
  "status" : "draft",
  "date" : "2026-04-02T11:15:26+00:00",
  "publisher" : "Ministerie van Volksgezondheid, Welzijn en Sport",
  "contact" : [{
    "name" : "Ministerie van Volksgezondheid, Welzijn en Sport",
    "telecom" : [{
      "system" : "url",
      "value" : "https://www.minvws.nl"
    }]
  }],
  "description" : "StructureMap die een KVK Basisprofiel API response transformeert naar een FHIR Organization resource.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "NL",
      "display" : "Netherlands"
    }]
  }],
  "structure" : [{
    "url" : "http://minvws.github.io/generiekefuncties-docs/StructureDefinition/KvkBasisprofiel",
    "mode" : "source",
    "alias" : "KvkBasisprofiel"
  },
  {
    "url" : "http://minvws.github.io/generiekefuncties-docs/StructureDefinition/nl-gf-organization",
    "mode" : "target",
    "alias" : "NlGfOrganization"
  }],
  "group" : [{
    "name" : "KvkBasisprofielToOrganization",
    "typeMode" : "none",
    "input" : [{
      "name" : "src",
      "type" : "KvkBasisprofiel",
      "mode" : "source"
    },
    {
      "name" : "tgt",
      "type" : "Organization",
      "mode" : "target"
    }],
    "rule" : [{
      "name" : "setProfile",
      "source" : [{
        "context" : "src"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "meta",
        "variable" : "meta"
      }],
      "rule" : [{
        "name" : "setProfileUrl",
        "source" : [{
          "context" : "src"
        }],
        "target" : [{
          "context" : "meta",
          "contextType" : "variable",
          "element" : "profile",
          "transform" : "copy",
          "parameter" : [{
            "valueString" : "http://minvws.github.io/generiekefuncties-docs/StructureDefinition/nl-gf-organization"
          }]
        }]
      }]
    },
    {
      "name" : "kvkNummer",
      "source" : [{
        "context" : "src",
        "element" : "kvkNummer",
        "variable" : "kvkNum"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "identifier",
        "variable" : "kvkId"
      }],
      "rule" : [{
        "name" : "kvkUse",
        "source" : [{
          "context" : "kvkNum"
        }],
        "target" : [{
          "context" : "kvkId",
          "contextType" : "variable",
          "element" : "use",
          "transform" : "copy",
          "parameter" : [{
            "valueString" : "official"
          }]
        }]
      },
      {
        "name" : "kvkSystem",
        "source" : [{
          "context" : "kvkNum"
        }],
        "target" : [{
          "context" : "kvkId",
          "contextType" : "variable",
          "element" : "system",
          "transform" : "copy",
          "parameter" : [{
            "valueString" : "http://fhir.nl/fhir/NamingSystem/kvk"
          }]
        }]
      },
      {
        "name" : "kvkValue",
        "source" : [{
          "context" : "kvkNum"
        }],
        "target" : [{
          "context" : "kvkId",
          "contextType" : "variable",
          "element" : "value",
          "transform" : "copy",
          "parameter" : [{
            "valueId" : "kvkNum"
          }]
        }]
      }]
    },
    {
      "name" : "uraNummer",
      "source" : [{
        "context" : "src",
        "element" : "uraNummer",
        "variable" : "uraNum"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "identifier",
        "variable" : "uraId"
      }],
      "rule" : [{
        "name" : "uraUse",
        "source" : [{
          "context" : "uraNum"
        }],
        "target" : [{
          "context" : "uraId",
          "contextType" : "variable",
          "element" : "use",
          "transform" : "copy",
          "parameter" : [{
            "valueString" : "official"
          }]
        }]
      },
      {
        "name" : "uraSystem",
        "source" : [{
          "context" : "uraNum"
        }],
        "target" : [{
          "context" : "uraId",
          "contextType" : "variable",
          "element" : "system",
          "transform" : "copy",
          "parameter" : [{
            "valueString" : "http://fhir.nl/fhir/NamingSystem/ura"
          }]
        }]
      },
      {
        "name" : "uraValue",
        "source" : [{
          "context" : "uraNum"
        }],
        "target" : [{
          "context" : "uraId",
          "contextType" : "variable",
          "element" : "value",
          "transform" : "copy",
          "parameter" : [{
            "valueId" : "uraNum"
          }]
        }]
      },
      {
        "name" : "uraAssigner",
        "source" : [{
          "context" : "uraNum"
        }],
        "target" : [{
          "context" : "uraId",
          "contextType" : "variable",
          "element" : "assigner",
          "variable" : "assignerRef"
        }],
        "rule" : [{
          "name" : "assignerIdentifier",
          "source" : [{
            "context" : "uraNum"
          }],
          "target" : [{
            "context" : "assignerRef",
            "contextType" : "variable",
            "element" : "identifier",
            "variable" : "assignerId"
          }],
          "rule" : [{
            "name" : "assignerIdSystem",
            "source" : [{
              "context" : "uraNum"
            }],
            "target" : [{
              "context" : "assignerId",
              "contextType" : "variable",
              "element" : "system",
              "transform" : "copy",
              "parameter" : [{
                "valueString" : "http://fhir.nl/fhir/NamingSystem/kvk"
              }]
            }]
          },
          {
            "name" : "assignerIdValue",
            "source" : [{
              "context" : "uraNum"
            }],
            "target" : [{
              "context" : "assignerId",
              "contextType" : "variable",
              "element" : "value",
              "transform" : "copy",
              "parameter" : [{
                "valueString" : "50000535"
              }]
            }]
          },
          {
            "name" : "assignerIdType",
            "source" : [{
              "context" : "uraNum"
            }],
            "target" : [{
              "context" : "assignerId",
              "contextType" : "variable",
              "element" : "type",
              "variable" : "assignerIdType"
            }],
            "rule" : [{
              "name" : "assignerIdTypeCoding",
              "source" : [{
                "context" : "uraNum"
              }],
              "target" : [{
                "context" : "assignerIdType",
                "contextType" : "variable",
                "element" : "coding",
                "variable" : "assignerIdTypeCoding"
              }],
              "rule" : [{
                "name" : "assignerIdTypeCodingSystem",
                "source" : [{
                  "context" : "uraNum"
                }],
                "target" : [{
                  "context" : "assignerIdTypeCoding",
                  "contextType" : "variable",
                  "element" : "system",
                  "transform" : "copy",
                  "parameter" : [{
                    "valueString" : "http://terminology.hl7.org/CodeSystem/provenance-participant-type"
                  }]
                }]
              },
              {
                "name" : "assignerIdTypeCodingCode",
                "source" : [{
                  "context" : "uraNum"
                }],
                "target" : [{
                  "context" : "assignerIdTypeCoding",
                  "contextType" : "variable",
                  "element" : "code",
                  "transform" : "copy",
                  "parameter" : [{
                    "valueString" : "custodian"
                  }]
                }]
              }]
            }]
          }]
        }]
      }]
    },
    {
      "name" : "naam",
      "source" : [{
        "context" : "src",
        "element" : "naam",
        "variable" : "naam"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "name",
        "transform" : "copy",
        "parameter" : [{
          "valueId" : "naam"
        }]
      }]
    },
    {
      "name" : "setActive",
      "source" : [{
        "context" : "src"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "active",
        "transform" : "copy",
        "parameter" : [{
          "valueBoolean" : true
        }]
      }]
    },
    {
      "name" : "statutaireNaam",
      "source" : [{
        "context" : "src",
        "element" : "statutaireNaam",
        "variable" : "statNaam"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "alias",
        "transform" : "copy",
        "parameter" : [{
          "valueId" : "statNaam"
        }]
      }]
    },
    {
      "name" : "handelsnamen",
      "source" : [{
        "context" : "src",
        "element" : "handelsnamen",
        "variable" : "hn"
      }],
      "dependent" : [{
        "name" : "KvkHandelsnaamToAlias",
        "variable" : ["hn", "tgt"]
      }]
    },
    {
      "name" : "sbiActiviteiten",
      "source" : [{
        "context" : "src",
        "element" : "sbiActiviteiten",
        "variable" : "sbi"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "type",
        "variable" : "cc"
      }],
      "dependent" : [{
        "name" : "KvkSBIToCodeableConcept",
        "variable" : ["sbi", "cc"]
      }]
    },
    {
      "name" : "embedded",
      "source" : [{
        "context" : "src",
        "element" : "embedded",
        "variable" : "emb"
      }],
      "rule" : [{
        "name" : "eigenaar",
        "source" : [{
          "context" : "emb",
          "element" : "eigenaar",
          "variable" : "eig"
        }],
        "rule" : [{
          "name" : "rsin",
          "source" : [{
            "context" : "eig",
            "element" : "rsin",
            "variable" : "rsin"
          }],
          "target" : [{
            "context" : "tgt",
            "contextType" : "variable",
            "element" : "identifier",
            "variable" : "rsinId"
          }],
          "rule" : [{
            "name" : "rsinSystem",
            "source" : [{
              "context" : "rsin"
            }],
            "target" : [{
              "context" : "rsinId",
              "contextType" : "variable",
              "element" : "system",
              "transform" : "copy",
              "parameter" : [{
                "valueString" : "http://fhir.nl/fhir/NamingSystem/rsin"
              }]
            }]
          },
          {
            "name" : "rsinValue",
            "source" : [{
              "context" : "rsin"
            }],
            "target" : [{
              "context" : "rsinId",
              "contextType" : "variable",
              "element" : "value",
              "transform" : "copy",
              "parameter" : [{
                "valueId" : "rsin"
              }]
            }]
          }]
        }]
      },
      {
        "name" : "hoofdvestiging",
        "source" : [{
          "context" : "emb",
          "element" : "hoofdvestiging",
          "variable" : "hv"
        }],
        "rule" : [{
          "name" : "adressen",
          "source" : [{
            "context" : "hv",
            "element" : "adressen",
            "variable" : "adres"
          }],
          "target" : [{
            "context" : "tgt",
            "contextType" : "variable",
            "element" : "address",
            "variable" : "addr"
          }],
          "dependent" : [{
            "name" : "KvkAdresToAddress",
            "variable" : ["adres", "addr"]
          }]
        },
        {
          "name" : "websites",
          "source" : [{
            "context" : "hv",
            "element" : "websites",
            "variable" : "web"
          }],
          "target" : [{
            "context" : "tgt",
            "contextType" : "variable",
            "element" : "telecom",
            "variable" : "tel"
          }],
          "dependent" : [{
            "name" : "KvkWebsiteToContactPoint",
            "variable" : ["web", "tel"]
          }]
        }]
      }]
    }]
  },
  {
    "name" : "KvkHandelsnaamToAlias",
    "typeMode" : "none",
    "input" : [{
      "name" : "src",
      "mode" : "source"
    },
    {
      "name" : "tgt",
      "type" : "Organization",
      "mode" : "target"
    }],
    "rule" : [{
      "name" : "naam",
      "source" : [{
        "context" : "src",
        "element" : "naam",
        "variable" : "naam"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "alias",
        "transform" : "copy",
        "parameter" : [{
          "valueId" : "naam"
        }]
      }]
    }]
  },
  {
    "name" : "KvkSBIToCodeableConcept",
    "typeMode" : "none",
    "input" : [{
      "name" : "src",
      "mode" : "source"
    },
    {
      "name" : "tgt",
      "type" : "CodeableConcept",
      "mode" : "target"
    }],
    "rule" : [{
      "name" : "sbiCoding",
      "source" : [{
        "context" : "src"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "coding",
        "variable" : "coding"
      }],
      "rule" : [{
        "name" : "sbiSystem",
        "source" : [{
          "context" : "src"
        }],
        "target" : [{
          "context" : "coding",
          "contextType" : "variable",
          "element" : "system",
          "transform" : "copy",
          "parameter" : [{
            "valueString" : "http://minvws.github.io/generiekefuncties-docs/CodeSystem/nl-gf-sbi-cs"
          }]
        }]
      },
      {
        "name" : "sbiCode",
        "source" : [{
          "context" : "src",
          "element" : "sbiCode",
          "variable" : "code"
        }],
        "target" : [{
          "context" : "coding",
          "contextType" : "variable",
          "element" : "code",
          "transform" : "copy",
          "parameter" : [{
            "valueId" : "code"
          }]
        }]
      },
      {
        "name" : "sbiDisplay",
        "source" : [{
          "context" : "src",
          "element" : "sbiOmschrijving",
          "variable" : "omschr"
        }],
        "target" : [{
          "context" : "coding",
          "contextType" : "variable",
          "element" : "display",
          "transform" : "copy",
          "parameter" : [{
            "valueId" : "omschr"
          }]
        }]
      }]
    }]
  },
  {
    "name" : "KvkAdresToAddress",
    "typeMode" : "none",
    "input" : [{
      "name" : "src",
      "mode" : "source"
    },
    {
      "name" : "tgt",
      "type" : "Address",
      "mode" : "target"
    }],
    "rule" : [{
      "name" : "volledigAdres",
      "source" : [{
        "context" : "src",
        "element" : "volledigAdres",
        "variable" : "volledigAdres"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "text",
        "transform" : "copy",
        "parameter" : [{
          "valueId" : "volledigAdres"
        }]
      }]
    },
    {
      "name" : "straatnaam",
      "source" : [{
        "context" : "src",
        "element" : "straatnaam",
        "variable" : "straat"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "line",
        "variable" : "addrLine",
        "transform" : "cast",
        "parameter" : [{
          "valueId" : "straat"
        },
        {
          "valueString" : "string"
        }]
      }],
      "rule" : [{
        "name" : "streetNameExt",
        "source" : [{
          "context" : "straat"
        }],
        "target" : [{
          "context" : "addrLine",
          "contextType" : "variable",
          "element" : "extension",
          "variable" : "ext"
        }],
        "rule" : [{
          "name" : "streetNameExtUrl",
          "source" : [{
            "context" : "straat"
          }],
          "target" : [{
            "context" : "ext",
            "contextType" : "variable",
            "element" : "url",
            "transform" : "copy",
            "parameter" : [{
              "valueString" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName"
            }]
          }]
        },
        {
          "name" : "streetNameExtValue",
          "source" : [{
            "context" : "straat"
          }],
          "target" : [{
            "context" : "ext",
            "contextType" : "variable",
            "element" : "value",
            "transform" : "copy",
            "parameter" : [{
              "valueId" : "straat"
            }]
          }]
        }]
      }]
    },
    {
      "name" : "huisnummer",
      "source" : [{
        "context" : "src",
        "element" : "huisnummer",
        "variable" : "huisnr"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "line",
        "variable" : "addrLine2",
        "transform" : "cast",
        "parameter" : [{
          "valueId" : "huisnr"
        },
        {
          "valueString" : "string"
        }]
      }],
      "rule" : [{
        "name" : "houseNumberExt",
        "source" : [{
          "context" : "huisnr"
        }],
        "target" : [{
          "context" : "addrLine2",
          "contextType" : "variable",
          "element" : "extension",
          "variable" : "ext"
        }],
        "rule" : [{
          "name" : "houseNumberExtUrl",
          "source" : [{
            "context" : "huisnr"
          }],
          "target" : [{
            "context" : "ext",
            "contextType" : "variable",
            "element" : "url",
            "transform" : "copy",
            "parameter" : [{
              "valueString" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber"
            }]
          }]
        },
        {
          "name" : "houseNumberExtValue",
          "source" : [{
            "context" : "huisnr"
          }],
          "target" : [{
            "context" : "ext",
            "contextType" : "variable",
            "element" : "value",
            "transform" : "cast",
            "parameter" : [{
              "valueId" : "huisnr"
            },
            {
              "valueString" : "string"
            }]
          }]
        }]
      }]
    },
    {
      "name" : "huisletter",
      "source" : [{
        "context" : "src",
        "element" : "huisletter",
        "variable" : "huisltr"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "line",
        "variable" : "addrLine3",
        "transform" : "cast",
        "parameter" : [{
          "valueId" : "huisltr"
        },
        {
          "valueString" : "string"
        }]
      }],
      "rule" : [{
        "name" : "houseLetterExt",
        "source" : [{
          "context" : "huisltr"
        }],
        "target" : [{
          "context" : "addrLine3",
          "contextType" : "variable",
          "element" : "extension",
          "variable" : "ext"
        }],
        "rule" : [{
          "name" : "houseLetterExtUrl",
          "source" : [{
            "context" : "huisltr"
          }],
          "target" : [{
            "context" : "ext",
            "contextType" : "variable",
            "element" : "url",
            "transform" : "copy",
            "parameter" : [{
              "valueString" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix"
            }]
          }]
        },
        {
          "name" : "houseLetterExtValue",
          "source" : [{
            "context" : "huisltr"
          }],
          "target" : [{
            "context" : "ext",
            "contextType" : "variable",
            "element" : "value",
            "transform" : "copy",
            "parameter" : [{
              "valueId" : "huisltr"
            }]
          }]
        }]
      }]
    },
    {
      "name" : "huisnummerToevoeging",
      "source" : [{
        "context" : "src",
        "element" : "huisnummerToevoeging",
        "variable" : "huisnrToev"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "line",
        "variable" : "addrLine4",
        "transform" : "cast",
        "parameter" : [{
          "valueId" : "huisnrToev"
        },
        {
          "valueString" : "string"
        }]
      }],
      "rule" : [{
        "name" : "houseNumberAdditionExt",
        "source" : [{
          "context" : "huisnrToev"
        }],
        "target" : [{
          "context" : "addrLine4",
          "contextType" : "variable",
          "element" : "extension",
          "variable" : "ext"
        }],
        "rule" : [{
          "name" : "houseNumberAdditionExtUrl",
          "source" : [{
            "context" : "huisnrToev"
          }],
          "target" : [{
            "context" : "ext",
            "contextType" : "variable",
            "element" : "url",
            "transform" : "copy",
            "parameter" : [{
              "valueString" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator"
            }]
          }]
        },
        {
          "name" : "houseNumberAdditionExtValue",
          "source" : [{
            "context" : "huisnrToev"
          }],
          "target" : [{
            "context" : "ext",
            "contextType" : "variable",
            "element" : "value",
            "transform" : "copy",
            "parameter" : [{
              "valueId" : "huisnrToev"
            }]
          }]
        }]
      }]
    },
    {
      "name" : "postcode",
      "source" : [{
        "context" : "src",
        "element" : "postcode",
        "variable" : "pc"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "postalCode",
        "transform" : "copy",
        "parameter" : [{
          "valueId" : "pc"
        }]
      }]
    },
    {
      "name" : "plaats",
      "source" : [{
        "context" : "src",
        "element" : "plaats",
        "variable" : "plaats"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "city",
        "transform" : "copy",
        "parameter" : [{
          "valueId" : "plaats"
        }]
      }]
    },
    {
      "name" : "land",
      "source" : [{
        "context" : "src",
        "element" : "land",
        "variable" : "land"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "country",
        "transform" : "copy",
        "parameter" : [{
          "valueId" : "land"
        }]
      }]
    },
    {
      "name" : "setUse",
      "source" : [{
        "context" : "src"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "use",
        "transform" : "copy",
        "parameter" : [{
          "valueString" : "work"
        }]
      }]
    }]
  },
  {
    "name" : "KvkWebsiteToContactPoint",
    "typeMode" : "none",
    "input" : [{
      "name" : "src",
      "mode" : "source"
    },
    {
      "name" : "tgt",
      "type" : "ContactPoint",
      "mode" : "target"
    }],
    "rule" : [{
      "name" : "setSystem",
      "source" : [{
        "context" : "src"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "system",
        "transform" : "copy",
        "parameter" : [{
          "valueString" : "url"
        }]
      }]
    },
    {
      "name" : "setValue",
      "source" : [{
        "context" : "src",
        "variable" : "url"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "value",
        "transform" : "copy",
        "parameter" : [{
          "valueId" : "url"
        }]
      }]
    },
    {
      "name" : "setUse",
      "source" : [{
        "context" : "src"
      }],
      "target" : [{
        "context" : "tgt",
        "contextType" : "variable",
        "element" : "use",
        "transform" : "copy",
        "parameter" : [{
          "valueString" : "work"
        }]
      }]
    }]
  }]
}

```
