Gniazda rozszerzeń

W module - Gniazda rozszerzeń Administracja  Integracje zewnętrzne, dostępne będą funkcjonalności pozwalające na przekazywanie danych z serwisów zewnętrznych i ich wykorzystywanie do rozszerzenia funkcjonalności naszego Systemu. Obecnie umożliwiono pobieranie Kosztów dostawy.

image30 b2b
Rysunek 1. Widok modułu Gniazda rozszerzeń w Panelu Administracyjnym

W celu skonfigurowania należy dodać Gniazdo rozszerzeń, podając jego Nazwę, Adres URL serwisu zewnętrznego oraz Metodę HTTP (GET lub POST). Można również dodać maksymalnie dziesięć Nagłówków składających się z Klucza i Wartości.

Do podanego serwisu przesyłane będą dane Zamówienia w formacie json. Przykładowy komunikat:

 {
  "additionalData": {},
  "clientExternalId": "XSmart",
  "contractorExternalId": "XSmart",
  "createDate": "2024-10-15T12:35:36.373Z",
  "currencyRate": 1,
  "deliveryAddress": null,
  "deliveryDate": "2024-10-21T10:42:23.227Z",
  "deliveryType": "ADDRESS_DELIVERY",
  "id": 63,
  "invoiceAddress": null,
  "number": null,
  "orderCurrency": "PLN",
  "orderPositions": [
    {
      "id": 559,
      "offerPositionId": 21010,
      "ordinalNo": 1,
      "positionHash": "1",
      "product": {
        "externalId": "XYZ12345/G",
        "productId": null
      },
      "quantity": 5,
      "saleUnitPrice": {
        "currency": "PLN",
        "gross": 2.56,
        "net": 2.08,
        "vat": 23
      },
      "saleUnitsInfo": [
        {
          "baseUnit": true,
          "baseUnitRate": 1,
          "clientUnit": true,
          "externalId": "szt",
          "qty": 5,
          "shortcut": "szt",
          "unitId": 1061
        }
      ]
    }
  ],
  "pickupAddress": null,
  "storeDTO": {
    "externalId": "T1H",
    "id": 1002,
    "name": "T1H"
  },
  "voucherCode": ""
}
Daty przekazywane są w formacie: yyyy-MM-dd’T’HH:mm:ss.SSSXXX

W celu prawidłowego działania konieczne jest odesłanie wartości kosztów dostawy:

  • net - wartość netto;

  • vat - informacja liczbowa o zastosowanej stawce VAT;

  • gross - wartość brutto;

  • currency - trzyliterowy skrót określający walutę, w której podano wartości.

Przykładowy fragment komunikatu zwrotnego, który jest konieczny do prawidłowego działania funkcjonalności:

{
    "net": 17.8,
    "vat": 23,
    "gross": 21.89,
    "currency": "PLN"
  }

Po skonfigurowaniu Gniazda rozszerzeń należy połączyć je z wybraną Metodą dostawy Administracja  Konifiguracja. W tym celu dla wybranej własnej Metody dostawy należy w zakładce Koszty dostawy zmienić Typ kosztów dostawy na Zewnętrzny oraz wybrać odpowiednie Gniazdo rozszerzeń w polu Źródło danych.

Opcja nie jest dostępna dla systemowych Metody dostawy.
image31 b2b
Rysunek 2. Połączenie Metody dostawy z Gniazdem rozszerzeń - konfiguracja w Panelu Administracyjnym

W celu śledzenia poprawności działania połączenia z Gniazdem rozszerzeń w module Audyt udostępniono zakładkę Audyt komunikacji przez gniazda rozszerzeń z informacjami o statusach poszczególnych zapytań.

Usługa Gniazd rozszerzeń jest dostępna w katalogu usług dodatkowych (płatnych). By umożliwić zapoznanie się z funkcjonalnością, czasowo udostępniona została bezpłatnie, w trybie testowym. Docelowe korzystanie z funkcjonalności Gniazd rozszerzeń wymagać będzie jej wykupienia.