Handwerker

Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.

Handwerker abrufen

Version 1.0

---

get

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

companyCodeIdinteger · int32Optional

managementIdinteger · int32Optional

creditorIdinteger · int32Optional

creditorNumberstringOptional

craftsmanIdinteger · int32Optional

personIdinteger · int32Optional

includeMainCommunicationbooleanOptionalDefault: false

includePersonAddressesbooleanOptionalDefault: false

includePersonCommunicationsbooleanOptionalDefault: false

includePersonBankAccountsbooleanOptionalDefault: false

includeCraftsmanAccessibilitybooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

CreditorIdinteger · int32Optional

CreditorNumberstring · nullfähigOptional

CraftsmanPortalIdstring · nullfähigOptional

PersonIdinteger · int32Optional

AccessibilityIdinteger · int32 · nullfähigOptional

BankAccountIdinteger · int32 · nullfähigOptional

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.1/Commissioning/Craftsman

HTTPcURLJavaScriptPython

GET /openwowi/v1.1/Commissioning/Craftsman HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "Id": 1,
    "CreditorId": 1,
    "CreditorNumber": "text",
    "CraftsmanPortalId": "text",
    "PersonId": 1,
    "Person": {
      "Id": 1,
      "IdNum": "text",
      "Shortname": "text",
      "Name": "text",
      "NodeId": 1,
      "TaxNumber": "text",
      "TaxIdentificationNumber": "text",
      "ValidFrom": "2026-03-28",
      "ValidTo": "2026-03-28",
      "IsNaturalPerson": true,
      "NaturalPerson": {
        "Title": "text",
        "FirstName": "text",
        "LastName": "text",
        "BirthName": "text",
        "CareOf": "text",
        "BirthDate": "2026-03-28",
        "DeathDate": "2026-03-28T02:17:38.480Z",
        "Gender": {
          "Id": 1,
          "Name": "text"
        },
        "MaritalType": {
          "Id": 1,
          "Name": "text"
        },
        "Nationality": {
          "Id": 1,
          "Name": "text",
          "Code": "text"
        },
        "PersonInCare": {
          "Id": 1,
          "IdNum": "text"
        },
        "ContactFor": [
          {
            "Id": 1,
            "IdNum": "text",
            "LongName1": "text",
            "LongName2": "text"
          }
        ]
      },
      "LegalPerson": {
        "LongName1": "text",
        "LongName2": "text",
        "VatId": "text",
        "CommercialRegisterNumber": "text",
        "CommercialRegisterTown": "text",
        "ContractPersons": [
          {
            "Id": 1,
            "IdNum": "text",
            "FirstName": "text",
            "LastName": "text"
          }
        ]
      },
      "Addresses": [
        {
          "Id": 1,
          "Zip": "text",
          "Town": "text",
          "Street": "text",
          "HouseNumber": "text",
          "HouseNumberAddition": "text",
          "ValidFrom": "2026-03-28",
          "ValidTo": "2026-03-28",
          "StreetComplete": "text",
          "HouseNumberComplete": "text",
          "MainAddress": true,
          "AddressType": {
            "Id": 1,
            "Name": "text"
          },
          "Country": {
            "Id": 1,
            "Name": "text",
            "Code": "text"
          }
        }
      ],
      "Communications": [
        {
          "Id": 1,
          "RelatedAddressId": 1,
          "Content": "text",
          "Explanation": "text",
          "RelatedAddress": "text",
          "CommunicationType": {
            "Id": 1,
            "Name": "text"
          }
        }
      ],
      "BankAccounts": [
        {
          "Id": 1,
          "Iban": "text",
          "Bic": "text",
          "AccountHolder": "text",
          "ValidFrom": "2026-03-28",
          "ValidTo": "2026-03-28",
          "BankAccountType": {
            "Id": 1,
            "Code": "text"
          },
          "BankAccountId": 1,
          "BankAccountUsageType": {
            "Id": 1,
            "Code": "text"
          }
        }
      ],
      "FirstEmailCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      },
      "FirstLandlinePhoneCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      },
      "FirstMobilePhoneCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      }
    },
    "DefaultAddress": {
      "Id": 1,
      "Zip": "text",
      "Town": "text",
      "Street": "text",
      "HouseNumber": "text",
      "HouseNumberAddition": "text",
      "ValidFrom": "2026-03-28",
      "ValidTo": "2026-03-28",
      "StreetComplete": "text",
      "HouseNumberComplete": "text",
      "MainAddress": true,
      "AddressType": {
        "Id": 1,
        "Name": "text"
      },
      "Country": {
        "Id": 1,
        "Name": "text",
        "Code": "text"
      }
    },
    "DefaultBankaccount": {
      "Id": 1,
      "Iban": "text",
      "Bic": "text",
      "AccountHolder": "text",
      "ValidFrom": "2026-03-28",
      "ValidTo": "2026-03-28",
      "BankAccountType": {
        "Id": 1,
        "Code": "text"
      },
      "BankAccountId": 1,
      "BankAccountUsageType": {
        "Id": 1,
        "Code": "text"
      }
    },
    "AccessibilityId": 1,
    "BankAccountId": 1,
    "CraftsmanAccessibilityList": [
      {
        "Id": 1,
        "AddressId": 1,
        "IsStandardCommissionNotificationMethod": true,
        "EconomicUnit": {
          "Id": 1,
          "IdNum": "text",
          "Name": "text",
          "Location": "text"
        },
        "Department": {
          "Id": 1,
          "Name": "text",
          "DepartmentType": {
            "Id": 1,
            "Name": "text"
          }
        },
        "Management": {
          "Id": 1,
          "IdNum": "text",
          "Name": "text",
          "PersonId": 1
        },
        "Owner": {
          "Id": 1,
          "OwnerNumber": "text"
        },
        "Communication": {
          "Id": 1,
          "Value": "text",
          "CommunicationType": "text"
        },
        "CommissionNotificationMethod": {
          "Id": 1,
          "Code": "text"
        },
        "CraftActivity": {
          "Id": 1,
          "Code": "text"
        }
      }
    ]
  }
]

---

Version 1.2

---

get

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

companyCodeIdinteger · int32Optional

managementIdinteger · int32Optional

creditorIdinteger · int32Optional

creditorNumberstringOptional

craftsmanIdinteger · int32Optional

personIdinteger · int32Optional

includeMainCommunicationbooleanOptionalDefault: false

includePersonAddressesbooleanOptionalDefault: false

includePersonCommunicationsbooleanOptionalDefault: false

includePersonBankAccountsbooleanOptionalDefault: false

includeCraftsmanAccessibilitybooleanOptionalDefault: false

showNullValuesbooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

CreditorIdinteger · int32Optional

CreditorNumberstring · nullfähigOptional

CraftsmanPortalIdstring · nullfähigOptional

PersonIdinteger · int32Optional

AccessibilityIdinteger · int32 · nullfähigOptional

BankAccountIdinteger · int32 · nullfähigOptional

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.2/CommissioningRead/Craftsman

HTTPcURLJavaScriptPython

GET /openwowi/v1.2/CommissioningRead/Craftsman HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "Id": 1,
    "CreditorId": 1,
    "CreditorNumber": "text",
    "CraftsmanPortalId": "text",
    "PersonId": 1,
    "Person": {
      "Id": 1,
      "IdNum": "text",
      "Shortname": "text",
      "Name": "text",
      "NodeId": 1,
      "TaxNumber": "text",
      "TaxIdentificationNumber": "text",
      "ValidFrom": "2026-03-28",
      "ValidTo": "2026-03-28",
      "IsNaturalPerson": true,
      "NaturalPerson": {
        "Title": "text",
        "FirstName": "text",
        "LastName": "text",
        "BirthName": "text",
        "CareOf": "text",
        "BirthDate": "2026-03-28",
        "DeathDate": "2026-03-28T02:17:38.480Z",
        "Gender": {
          "Id": 1,
          "Name": "text"
        },
        "MaritalType": {
          "Id": 1,
          "Name": "text"
        },
        "Nationality": {
          "Id": 1,
          "Name": "text",
          "Code": "text"
        },
        "PersonInCare": {
          "Id": 1,
          "IdNum": "text"
        },
        "ContactFor": [
          {
            "Id": 1,
            "IdNum": "text",
            "LongName1": "text",
            "LongName2": "text"
          }
        ]
      },
      "LegalPerson": {
        "LongName1": "text",
        "LongName2": "text",
        "VatId": "text",
        "CommercialRegisterNumber": "text",
        "CommercialRegisterTown": "text",
        "ContractPersons": [
          {
            "Id": 1,
            "IdNum": "text",
            "FirstName": "text",
            "LastName": "text"
          }
        ]
      },
      "Addresses": [
        {
          "Id": 1,
          "Zip": "text",
          "Town": "text",
          "Street": "text",
          "HouseNumber": "text",
          "HouseNumberAddition": "text",
          "ValidFrom": "2026-03-28",
          "ValidTo": "2026-03-28",
          "StreetComplete": "text",
          "HouseNumberComplete": "text",
          "MainAddress": true,
          "AddressType": {
            "Id": 1,
            "Name": "text"
          },
          "Country": {
            "Id": 1,
            "Name": "text",
            "Code": "text"
          }
        }
      ],
      "Communications": [
        {
          "Id": 1,
          "RelatedAddressId": 1,
          "Content": "text",
          "Explanation": "text",
          "RelatedAddress": "text",
          "CommunicationType": {
            "Id": 1,
            "Name": "text"
          }
        }
      ],
      "BankAccounts": [
        {
          "Id": 1,
          "Iban": "text",
          "Bic": "text",
          "AccountHolder": "text",
          "ValidFrom": "2026-03-28",
          "ValidTo": "2026-03-28",
          "BankAccountType": {
            "Id": 1,
            "Code": "text"
          },
          "BankAccountId": 1,
          "BankAccountUsageType": {
            "Id": 1,
            "Code": "text"
          }
        }
      ],
      "FirstEmailCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      },
      "FirstLandlinePhoneCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      },
      "FirstMobilePhoneCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      }
    },
    "DefaultAddress": {
      "Id": 1,
      "Zip": "text",
      "Town": "text",
      "Street": "text",
      "HouseNumber": "text",
      "HouseNumberAddition": "text",
      "ValidFrom": "2026-03-28",
      "ValidTo": "2026-03-28",
      "StreetComplete": "text",
      "HouseNumberComplete": "text",
      "MainAddress": true,
      "AddressType": {
        "Id": 1,
        "Name": "text"
      },
      "Country": {
        "Id": 1,
        "Name": "text",
        "Code": "text"
      }
    },
    "DefaultBankaccount": {
      "Id": 1,
      "Iban": "text",
      "Bic": "text",
      "AccountHolder": "text",
      "ValidFrom": "2026-03-28",
      "ValidTo": "2026-03-28",
      "BankAccountType": {
        "Id": 1,
        "Code": "text"
      },
      "BankAccountId": 1,
      "BankAccountUsageType": {
        "Id": 1,
        "Code": "text"
      }
    },
    "AccessibilityId": 1,
    "BankAccountId": 1,
    "CraftsmanAccessibilityList": [
      {
        "Id": 1,
        "AddressId": 1,
        "IsStandardCommissionNotificationMethod": true,
        "EconomicUnit": {
          "Id": 1,
          "IdNum": "text",
          "Name": "text",
          "Location": "text"
        },
        "Department": {
          "Id": 1,
          "Name": "text",
          "DepartmentType": {
            "Id": 1,
            "Name": "text"
          }
        },
        "Management": {
          "Id": 1,
          "IdNum": "text",
          "Name": "text",
          "PersonId": 1
        },
        "Owner": {
          "Id": 1,
          "OwnerNumber": "text"
        },
        "Communication": {
          "Id": 1,
          "Value": "text",
          "CommunicationType": "text"
        },
        "CommissionNotificationMethod": {
          "Id": 1,
          "Code": "text"
        },
        "CraftActivity": {
          "Id": 1,
          "Code": "text"
        }
      }
    ]
  }
]

---