Express Connect

Dokumentation för API-funktioner

GET Report/Services/{customerId}/Ordered Hämta beställda tjänster per objekt (paginerat) Request Information URI Parameters

Namn	Beskrivning	Typ	Information
customerId	Kund-id	string	Krävs
selectionType	Typ av datumval	SelectionType	Krävs
dateFrom	Från datum	date	Krävs
dateTo	Till datum	date	Krävs
skip	Antal poster att hoppa över (default 0)	integer	Standardvärde 0
take	Antal poster per sida (default 500, max 1000)	integer	Standardvärde 500

Response Information Resource Description Hämta beställda tjänster per objekt (paginerat) EstateOrderReportResult

Namn	Beskrivning	Typ	Information
Rows	Raderna i denna sida	Collection of EstateOrderReportRow
TotalCount	Totalt antal rader (för alla sidor)	integer
HasMore	Finns det fler sidor?	boolean
Page	Aktuell sida (0-baserad)	integer
PageSize	Antal per sida	integer

Kodexempel

CURL kommando
Powershell
.NET c#
PHP


curl "https://connect.maklare.vitec.net/Report/Services/StringValue/Ordered?selectionType=0&dateFrom=2015-01-01T12:00:00&dateTo=2015-01-01T12:00:00&skip=0&take=0" -X GET -H "Authorization: basic {Base64 kodad användarnamn och lösenord}"


$URL = "https://connect.maklare.vitec.net/Report/Services/StringValue/Ordered?selectionType=0&dateFrom=2015-01-01T12:00:00&dateTo=2015-01-01T12:00:00&skip=0&take=0"
Invoke-WebRequest -Uri $URL -Method GET -Headers @{"authorization" = "basic {Base64 kodad användarnamn och lösenord}"}


// HttpClientInstance ska deklareras som en singleton
// public static readonly HttpClient HttpClientInstance = new HttpClient {
//     BaseAddress = new Uri("https://connect.maklare.vitec.net"),
//     DefaultRequestHeaders = {
//         Authorization = new AuthenticationHeaderValue("Basic", "{Base64 kodad användarnamn och lösenord}")
//     }
// }
using (var response = await HttpClientInstance.GetAsync("Report/Services/StringValue/Ordered?selectionType=0&dateFrom=2015-01-01T12:00:00&dateTo=2015-01-01T12:00:00&skip=0&take=0")) {
    if (response.StatusCode == HttpStatusCode.Unauthorized) {
        // Authorization headern är inte korrekt
    }
    if (response.StatusCode == HttpStatusCode.Forbidden) {
        // Begärt data som det saknas åtkomst till
    }
    if (response.StatusCode == HttpStatusCode.InternalServerError) {
        // Oväntat fel, kontakta Vitec
    }
    if (response.StatusCode == HttpStatusCode.BadRequest) {
        var json = await response.Content.ReadAsStringAsync();
        var result = JsonConvert.DeserializeObject<dynamic>(json);
        // Hantera valideringsfel, presenteras i resultatet
    }
    
    var json = await response.Content.ReadAsStringAsync();
    // JsonConvert finns i biblioteket Newtonsoft.Json
    var result = JsonConvert.DeserializeObject<dynamic>(json);
    
    var rows = result.rows.Value;
    // TODO: Gör något med resultatet
}


$URL = "https://connect.maklare.vitec.net/Report/Services/StringValue/Ordered?selectionType=0&dateFrom=2015-01-01T12:00:00&dateTo=2015-01-01T12:00:00&skip=0&take=0";

$ch = curl_init();

curl_setopt($ch, CURLOPT_USERNAME, "{Användarnamn}");
curl_setopt($ch, CURLOPT_PASSWORD, "{Lösenord}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $URL);

$result = curl_exec($ch);

if (curl_errno($ch)) {
    die(curl_getinfo($ch));
}

$info = curl_getinfo($ch);
curl_close($ch);

$http_code = $info["http_code"];
if ($http_code == 401) {
    // Användarnamnet eller lösenordet är felaktigt
}
if ($http_code == 403) {
    // Begärt data som det saknas åtkomst till
}
if ($http_code == 500) {
    // Oväntat fel, kontakta Vitec
}
if ($http_code == 400) {
    $json = json_decode($result, true);
    // Hantera valideringsfel, presenteras i $json
}

$field_on_result = $result["rows"];
// TODO: Gör något med resultatet

Testformulär Text input

Username

Password

customerId

selectionType

dateFrom

dateTo

skip

take

Response Formats

application/json, text/json
application/xml, text/xml

{
  "rows": [
    {
      "estateId": "sample string 1",
      "customerId": "sample string 2",
      "dates": {
        "possessionDate": "2026-04-06T21:57:08.066709+02:00",
        "dateChanged": "2026-04-06T21:57:08.066709+02:00",
        "contractDate": "2026-04-06T21:57:08.066709+02:00",
        "assignmentDate": "2026-04-06T21:57:08.066709+02:00"
      },
      "orders": [
        {
          "id": "sample string 1",
          "createdAt": "2026-04-06T21:57:08.066709+02:00",
          "lastUpdatedAt": "2026-04-06T21:57:08.066709+02:00",
          "status": {
            "status": "Error",
            "updatedAt": "2026-04-06T21:57:08.066709+02:00"
          },
          "userId": "sample string 3",
          "serviceId": 1,
          "serviceName": "sample string 4"
        },
        {
          "id": "sample string 1",
          "createdAt": "2026-04-06T21:57:08.066709+02:00",
          "lastUpdatedAt": "2026-04-06T21:57:08.066709+02:00",
          "status": {
            "status": "Error",
            "updatedAt": "2026-04-06T21:57:08.066709+02:00"
          },
          "userId": "sample string 3",
          "serviceId": 1,
          "serviceName": "sample string 4"
        }
      ]
    },
    {
      "estateId": "sample string 1",
      "customerId": "sample string 2",
      "dates": {
        "possessionDate": "2026-04-06T21:57:08.066709+02:00",
        "dateChanged": "2026-04-06T21:57:08.066709+02:00",
        "contractDate": "2026-04-06T21:57:08.066709+02:00",
        "assignmentDate": "2026-04-06T21:57:08.066709+02:00"
      },
      "orders": [
        {
          "id": "sample string 1",
          "createdAt": "2026-04-06T21:57:08.066709+02:00",
          "lastUpdatedAt": "2026-04-06T21:57:08.066709+02:00",
          "status": {
            "status": "Error",
            "updatedAt": "2026-04-06T21:57:08.066709+02:00"
          },
          "userId": "sample string 3",
          "serviceId": 1,
          "serviceName": "sample string 4"
        },
        {
          "id": "sample string 1",
          "createdAt": "2026-04-06T21:57:08.066709+02:00",
          "lastUpdatedAt": "2026-04-06T21:57:08.066709+02:00",
          "status": {
            "status": "Error",
            "updatedAt": "2026-04-06T21:57:08.066709+02:00"
          },
          "userId": "sample string 3",
          "serviceId": 1,
          "serviceName": "sample string 4"
        }
      ]
    }
  ],
  "totalCount": 1,
  "hasMore": true,
  "page": 3,
  "pageSize": 4
}

<EstateOrderReportResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Express.Business.Reports.Service">
  <HasMore>true</HasMore>
  <Page>3</Page>
  <PageSize>4</PageSize>
  <Rows>
    <EstateOrderReportRow>
      <CustomerId>sample string 2</CustomerId>
      <Dates>
        <AssignmentDate>2026-04-06T21:57:08.066709+02:00</AssignmentDate>
        <ContractDate>2026-04-06T21:57:08.066709+02:00</ContractDate>
        <DateChanged>2026-04-06T21:57:08.066709+02:00</DateChanged>
        <PossessionDate>2026-04-06T21:57:08.066709+02:00</PossessionDate>
      </Dates>
      <EstateId>sample string 1</EstateId>
      <Orders>
        <OrderEntry>
          <CreatedAt>2026-04-06T21:57:08.066709+02:00</CreatedAt>
          <Id>sample string 1</Id>
          <LastUpdatedAt>2026-04-06T21:57:08.066709+02:00</LastUpdatedAt>
          <ServiceId>1</ServiceId>
          <ServiceName>sample string 4</ServiceName>
          <Status>
            <Status>Error</Status>
            <UpdatedAt>2026-04-06T21:57:08.066709+02:00</UpdatedAt>
          </Status>
          <UserId>sample string 3</UserId>
        </OrderEntry>
        <OrderEntry>
          <CreatedAt>2026-04-06T21:57:08.066709+02:00</CreatedAt>
          <Id>sample string 1</Id>
          <LastUpdatedAt>2026-04-06T21:57:08.066709+02:00</LastUpdatedAt>
          <ServiceId>1</ServiceId>
          <ServiceName>sample string 4</ServiceName>
          <Status>
            <Status>Error</Status>
            <UpdatedAt>2026-04-06T21:57:08.066709+02:00</UpdatedAt>
          </Status>
          <UserId>sample string 3</UserId>
        </OrderEntry>
      </Orders>
    </EstateOrderReportRow>
    <EstateOrderReportRow>
      <CustomerId>sample string 2</CustomerId>
      <Dates>
        <AssignmentDate>2026-04-06T21:57:08.066709+02:00</AssignmentDate>
        <ContractDate>2026-04-06T21:57:08.066709+02:00</ContractDate>
        <DateChanged>2026-04-06T21:57:08.066709+02:00</DateChanged>
        <PossessionDate>2026-04-06T21:57:08.066709+02:00</PossessionDate>
      </Dates>
      <EstateId>sample string 1</EstateId>
      <Orders>
        <OrderEntry>
          <CreatedAt>2026-04-06T21:57:08.066709+02:00</CreatedAt>
          <Id>sample string 1</Id>
          <LastUpdatedAt>2026-04-06T21:57:08.066709+02:00</LastUpdatedAt>
          <ServiceId>1</ServiceId>
          <ServiceName>sample string 4</ServiceName>
          <Status>
            <Status>Error</Status>
            <UpdatedAt>2026-04-06T21:57:08.066709+02:00</UpdatedAt>
          </Status>
          <UserId>sample string 3</UserId>
        </OrderEntry>
        <OrderEntry>
          <CreatedAt>2026-04-06T21:57:08.066709+02:00</CreatedAt>
          <Id>sample string 1</Id>
          <LastUpdatedAt>2026-04-06T21:57:08.066709+02:00</LastUpdatedAt>
          <ServiceId>1</ServiceId>
          <ServiceName>sample string 4</ServiceName>
          <Status>
            <Status>Error</Status>
            <UpdatedAt>2026-04-06T21:57:08.066709+02:00</UpdatedAt>
          </Status>
          <UserId>sample string 3</UserId>
        </OrderEntry>
      </Orders>
    </EstateOrderReportRow>
  </Rows>
  <TotalCount>1</TotalCount>
</EstateOrderReportResult>