Dokumentacja API

❓ Wprowadzenie

N24 Labels udostępnia interfejs OData Web Service, który pozwala na integrację z zewnętrznymi aplikacjami, takimi jak PowerApps czy Power Automate. Dzięki temu możesz pobierać listę dostępnych wzorów etykiet i budować własne interfejsy do wyboru szablonów.

Endpoint jest oparty o usługę sieci Web (Codeunit Web Service) i używa protokołu OData v4.

🔗 Format URL

Endpoint ma następujący format:

POST /ODataV4/LabelsWebService_{operacja}?Company={nazwaFirmy}

gdzie:

{operacja} to nazwa wywoływanej procedury
{nazwaFirmy} to nazwa firmy w Business Central

📑 Spis treści

API wzorów etykiet

🧾 API wzorów etykiet

Pobieranie wzorów etykiet (`GetLabelLayouts`)

Zwraca listę dostępnych wzorów etykiet wraz z informacją, który wzór był ostatnio używany przez danego pracownika.

Endpoint: /ODataV4/LabelsWebService_GetLabelLayouts?Company={nazwaFirmy} Metoda: POST

Operacje:

POST - Pobranie wzorów etykiet z oznaczeniem ostatnio użytego

Parametry żądania:

Pole	Typ	Opis
employeeSystemId	Text	SystemId pracownika (Guid jako tekst). Pusty ciąg pomija oznaczanie ostatnio użytego wzoru

Nagłówki:

Nagłówek	Wartość
Content-Type	application/json

Pola odpowiedzi (tablica JSON w polu value):

Pole	Typ	Opis
name	Text	Nazwa wzoru etykiety
description	Text	Opis wzoru etykiety
isLastUsed	Boolean	Czy wzór był ostatnio używany przez wskazanego pracownika

Uwagi:

Pole value w odpowiedzi zawiera tablicę JSON zakodowaną jako tekst
Jeśli employeeSystemId jest pusty lub nieprawidłowy, wszystkie wzory będą miały isLastUsed = false
Zwracane są wyłącznie wzory przypisane do raportu etykiet (N24LBL Label Report)

Przykład żądania:

{
  "employeeSystemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Przykład odpowiedzi:

{
  "value": "[{\"name\":\"StandardLabel\",\"description\":\"Standardowa etykieta produktu\",\"isLastUsed\":true},{\"name\":\"ShippingLabel\",\"description\":\"Etykieta wysyłkowa\",\"isLastUsed\":false}]"
}