UgrzejMnie API Developer Portal

Your API Key (X-API-Key) or Bearer Token:

Standard Response Codes and Error Handling (Error Codes)

200 OK – Successful operation execution.

Header: Idempotency-Key – Protection against duplicate requests (24h cache).

400 Bad Request – INVALID_PAYLOAD / INVALID_ID / Missing required field.

401 Unauthorized – Invalid or inactive X-API-Key.

409 Conflict – REQUEST_ALREADY_ACCEPTED / OFFER_NOT_EDITABLE.

410 Gone – REQUEST_EXPIRED / OFFER_NOT_WITHDRAWABLE.

GET /api/v1/integrations/ping

Auth Test

Verifies API key validity and returns details of the associated provider account.

GET /api/v1/integrations/service-requests

Order Funnel with Pagination & Filters

Retrieves paginated orders. Allows tracking requests across all lifecycle stages: status=pending,quoted,accepted,in_transit,completed,cancelled and delta sync via updated_since=...

PII / GDPR Protection: In pending / quoted statuses only general location (city, postal prefix 05-***, fuel/qty) is returned. Full client address & phone are revealed upon quote acceptance (accepted).

GET /api/v1/integrations/service-requests/{id}

Single Source of Truth (Reconciliation / Webhook Fetch)

Returns the complete, authoritative state of a single request including submitted quotes and customer contact info.

POST / PATCH /api/v1/integrations/service-requests/{id}/offers

Quote Submission, Revision & Withdrawal

Submit new quote (POST), modify price/schedule before acceptance (PATCH .../offers/{offerId}) and withdraw quote (POST .../offers/{offerId}/withdraw). Supports SKU breakdown and unloading logistics.

Sample JSON Payload (Supports Idempotency-Key):

{
  "assistance_cost_gross": 3444.00,
  "travel_cost_gross": 0.00,
  "approx_fulfillment_at": "2026-09-02T10:00:00Z",
  "unloading_method": "HDS",
  "estimated_duration_hours": 1.5,
  "items": [
    {
      "sku_code": "PELLET_A1_15KG",
      "name": "Pellet drzewny certyfikowany ENplus A1 worki 15kg",
      "unit": "T",
      "quantity": 2.0,
      "unit_price_net": 1400.00,
      "vat_rate": 0.23,
      "total_gross": 3444.00
    }
  ],
  "description": "Dostawa pelletu certyfikowanego A1 w workach 15kg z rozładunkiem HDS."
}

POST /api/v1/integrations/service-requests/{id}/(en-route | arrive | reschedule | cancel)

Driver & Vehicle TMS Logistics

Real-time logistics status updates:

POST .../en-route – Driver departed (provide driver_name, vehicle_plate, estimated_arrival_minutes).
POST .../arrive – Driver arrived at the delivery location.
POST .../reschedule – Delivery slot update (new_fulfillment_at, reason).
POST .../cancel – Order cancellation (reason_code: out_of_stock, no_transport_capacity, area_out_of_range, client_unreachable, force_majeure, other).

POST /api/v1/integrations/service-requests/manual-delivery

Stream B — Own Yard Order

Creates an own-customer order, returns fulfillment_short_url for the driver QR/link. PESEL/ID is encrypted at rest (AES-GCM). Supports Idempotency-Key.

{
  "customer_name": "Anna Kowalska",
  "customer_phone": "501202303",
  "customer_pesel": "85010112345",
  "delivery_address": "ul. Polna 12, Mrozy",
  "fuel_type": "PELLET",
  "quantity": 2.0,
  "cod_amount_gross": 1450.0,
  "payment_method": "cash"
}

GET /api/v1/integrations/service-requests/{id}/pod.pdf

POD PDF Download

Downloads the generated Proof of Delivery PDF after COMPLETED. Also exposed as pod_pdf_url on GET /service-requests/{id}.

POST /api/v1/integrations/service-requests/{id}/complete

Completion Confirmation & Digital Signature

Marks request as COMPLETED in UgrzejMnie, uploading digital customer signature and execution telemetry.

Fuel Delivery (Tanker meter reading & delivered quantity):

{
  "signature_base64": "data:image/png;base64,iVBORw0KGgoAAA...",
  "signature_name": "Jan Kowalski",
  "delivered_quantity": 2150.0,
  "meter_reading_before": 142050.0,
  "meter_reading_after": 144200.0,
  "completed_notes": "Rozładunek bez uwag."
}

Service / Heat Pump Protocol:

{
  "signature_base64": "data:image/png;base64,iVBORw0KGgoAAA...",
  "signature_name": "Anna Nowak",
  "work_performed": "Wymiana zaworu trójdrożnego i odpowietrzenie układu",
  "parts_replaced": ["Zawór trójdrożny DN25", "Uszczelka EPDM"],
  "labor_hours": 2.5,
  "completed_notes": "Kocioł uruchomiony i przetestowany."
}

GET /api/v1/integrations/events?after_id={last_event_id}

Event Journal (Zero-loss Replay & Polling)

Sequential ledger of all events tied to your orders (e.g. offer.accepted, order.cancelled). Enables 100% loss-free synchronization after network drops or ERP server restarts.

POST / GET /api/v1/integrations/service-requests/{id}/attachments

Attachments (POD, Waybills, Photos, Invoices)

Attaching scanned POD waybills, signed acceptance certificates, meter photos or VAT invoices to the order.

Sample JSON Payload:

{
  "attachment_type": "POD_SCAN",
  "file_name": "WZ_2026_09_01_podpisany.pdf",
  "file_url": "https://your-s3-server.com/doc/wz_123.pdf",
  "mime_type": "application/pdf",
  "file_size_bytes": 1048576
}

POST /api/v1/integrations/service-requests/{id}/decline

Decline Request (Hide from pending feed)

Allows providers to explicitly decline quoting on an order (e.g. no vehicles/stock available), hiding it from their pending feed.

Sample JSON Payload:

{
  "reason_code": "out_of_stock",
  "reason_description": "Temporary lack of pellet in central warehouse."
}

Real-time Webhook Notifications

UgrzejMnie sends lightweight HTTP POST notifications to your Webhook URL immediately upon state changes. Your system should receive the event and query GET /service-requests/{request_id} for full details.

Thin Webhook Payload Format:

{
  "event_id": 145920,
  "event": "offer.accepted",
  "request_id": 123,
  "occurred_at": "2026-09-01T21:45:00Z"
}

HMAC-SHA256 Signature Verification:

Every delivery includes an X-WMU-Signature header computed using your Webhook Secret (whsec_...).

API Key & Webhook Management

wmu_live_... keys are issued by admins. Here you can rotate your active key, issue isolated wmu_test_... sandbox keys, set Webhook URL and rotate whsec_... secrets.

verify_webhook_signature — SDK Snippets

import hmac, hashlib

def verify_webhook_signature(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

function verify_webhook_signature(string $payload, string $signature, string $secret): bool {
    $expected = hash_hmac('sha256', $payload, $secret);
    return hash_equals($expected, $signature);
}

const crypto = require('crypto');

function verifyWebhookSignature(payloadBuffer, signature, secret) {
    const expected = crypto.createHmac('sha256', secret).update(payloadBuffer).digest('hex');
    return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}

import (
    "crypto/hmac"
    "crypto/sha256"
    "encoding/hex"
)

func VerifyWebhookSignature(payload []byte, signature, secret string) bool {
    mac := hmac.New(sha256.New, []byte(secret))
    mac.Write(payload)
    expected := hex.EncodeToString(mac.Sum(nil))
    return hmac.Equal([]byte(expected), []byte(signature))
}

error_code	HTTP	Meaning & Resolution
TOTAL_GROSS_MISMATCH	422	The sum of items[].total_gross differs from assistance_cost_gross by more than 1 PLN.
DECLINE_NOT_ALLOWED_FOR_ACCEPTED	422	/decline is only allowed for PENDING/QUOTED. Use /cancel with reason_code after acceptance.
ATTACHMENT_NOT_ALLOWED_ON_PENDING	422	POD/Waybills/Invoices can only be uploaded to accepted or in-progress orders.
FILE_TOO_LARGE	422	Declared file_size_bytes exceeds the 20 MB limit.
NO_PROVIDER_ID	400	Global key without provider association. TMS endpoints require a key with ProviderID.
FORBIDDEN	403	The service request belongs to another winning provider.
WEBHOOK_URL_NOT_SET	422	Set a Webhook URL before triggering test webhooks.
NOT_SANDBOX_REQUEST	422	Simulation endpoints only work on sandbox orders.

PUESC — SENT / e-DD — Integracja fiskalna

Platforma UgrzejMnie integruje się z bramką PUESC (Ministerstwo Finansów) w zakresie zgłoszeń SENT (System Elektronicznej Navigacji Transportu) oraz e-DD (Elektroniczny Dokument Dowodowy / EMCS PL2).

SENT — System Elektronicznej Navigacji Transportu

Zgłoszenia SENT-100 (nadawca) i SENT-300 (przewoźnik) wysyłane automatycznie po utworzeniu trasy. XML zawiera dane transportu, pojazdu i naczepy.

SENT-100 — zgłoszenie nadawcy (dostawca paliwa/ciepła)
SENT-300 — zgłoszenie przewoźnika (transport)
Automatyczna wysyłka po utworzeniu RouteRun
Status urzędowy per trasa: nieobjęta / wysłany / błąd / odrzucony
Ponowienie (retry) nieudanych zgłoszeń jednym kliknięciem

e-DD — Elektroniczny Dokument Dowodowy (EMCS PL2)

Dokumenty e-DD (DD815C — projekt, DD818 — raport przyjęcia) podpisywane certyfikatem XAdES i wysyłane do EMCS PL2 po zakończeniu dostawy.

DD815C — e-DD draft (generowany przed wysyłką)
DD818 — raport przyjęcia (po zakończeniu dostawy)
Podpis XAdES (XMLDSig) przez stateless signer sidecar
Certyfikat .pem lub .pfx/.p12 (konwersja automatyczna)
Walidacja wygasania certyfikatu (alert < 30 dni)

Złota zasada SENT — pojazdy i lokalizacja

GPS/lokalizacja pochodzi z ciągnika (e-TOLL/ZSL), ale zgłoszenie SENT zawiera zarówno rejestrację ciągnika, jak i naczepy.

Ciągnik — rejestracja + numer lokalizatora e-TOLL/ZSL
Naczepa/przyczepa — rejestracja (jednostka bierna, bez e-TOLL)
System automatycznie dobiera naczepę do zgłoszenia SENT-300
XML zawiera obie rejestracje, ale tylko lokalizator ciągnika

Procedura awaryjna — Dokument zastępczy

Gdy bramka PUESC jest niedostępna, system generuje urzędowy dokument zastępczy (PDF) zgodnie z przepisami awaryjnymi — kierowca może ruszyć w trasę, a zgłoszenie zostanie wysłane po przywróceniu systemu.

Generowanie PDF jednym kliknięciem (desktop + mobile)
Dane dostawcy (NIP, nazwa), trasy, pojazdu, kierowcy
Pola podpisów kierowcy i dyspozytora
Numer sekwencyjny per dostawca per dzień
Wpis audytowy w historii zgłoszeń

Konfiguracja per-provider

Każdy dostawca konfiguruje PUESC niezależnie (ustawienia w aplikacji desktop/mobile). Integracja jest opcjonalna — dostawcy którzy nie chcą SENT/e-DD mogą ją wyłączyć.

Środowisko: test (sandbox) lub produkcja
Login i hasło PUESC (AES-256-GCM encrypted)
Certyfikat XAdES (.pem lub .pfx/.p12)
Toggle SENT on/off, e-DD on/off
Status na pulpicie: środowisko, cert, wygasanie

Historia zgłoszeń i audyt

Każda wysyłka SENT/e-DD jest zapisywana z pełnym XML, odpowiedzią PUESC, statusem i kodem błędu. Widoczna dla dostawcy i admina.

Podgląd XML i surowej odpowiedzi PUESC
Filtrowanie po typie (SENT/e-DD) i statusie
Panel admina: lista providerów + statystyki
Retry nieudanych zgłoszeń

Integration Examples in Your Technology

Select your programming language or tool to inspect ready-to-run code snippets:

A. Pobranie listy oczekujących zapytań klienta:

curl -X GET "https://ugrzejmnie.pl/api/v1/integrations/service-requests?status=PENDING&limit=20" \
     -H "X-API-Key: wmu_live_YOUR_KEY"

B. Złożenie wyceny / oferty z pozycjami SKU (obsługuje Idempotency-Key):

curl -X POST "https://ugrzejmnie.pl/api/v1/integrations/service-requests/123/offers" \
     -H "X-API-Key: wmu_live_YOUR_KEY" \
     -H "Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d" \
     -H "Content-Type: application/json" \
     -d '{
       "assistance_cost_gross": 3444.00,
       "travel_cost_gross": 0.00,
       "approx_fulfillment_at": "2026-09-02T10:00:00Z",
       "unloading_method": "HDS",
       "items": [
         {
           "sku_code": "PELLET_A1_15KG",
           "name": "Pellet drzewny certyfikowany ENplus A1 worki 15kg",
           "unit": "T",
           "quantity": 2.0,
           "unit_price_net": 1400.00,
           "vat_rate": 0.23,
           "total_gross": 3444.00
         }
       ],
       "description": "Dostawa pelletu certyfikowanego A1 w workach 15kg z rozładunkiem HDS."
     }'

C. Potwierdzenie realizacji z podpisem cyfrowym i licznikiem:

curl -X POST "https://ugrzejmnie.pl/api/v1/integrations/service-requests/123/complete" \
     -H "X-API-Key: wmu_live_YOUR_KEY" \
     -H "Idempotency-Key: e4eaaaf2-d142-11e1-b3e4-080027620cdd" \
     -H "Content-Type: application/json" \
     -d '{
       "signature_base64": "data:image/png;base64,iVBORw0KGgoAAA...",
       "signature_name": "Jan Kowalski",
       "delivered_quantity": 2150.0,
       "meter_reading_before": 142050.0,
       "meter_reading_after": 144200.0,
       "completed_notes": "Dostarczono i rozładowano bez uwag."
     }'

A. Pobranie listy oczekujących zapytań klienta:

import requests

API_KEY = "wmu_live_YOUR_KEY"
headers = {"X-API-Key": API_KEY}

response = requests.get(
    "https://ugrzejmnie.pl/api/v1/integrations/service-requests",
    params={"status": "PENDING", "limit": 20},
    headers=headers
)
data = response.json()
print(f"Otwarte zapytania: {data.get('total', len(data.get('items', [])))}")

B. Złożenie wyceny / oferty z pozycjami SKU:

import requests
import uuid

API_KEY = "wmu_live_YOUR_KEY"
headers = {
    "X-API-Key": API_KEY,
    "Idempotency-Key": str(uuid.uuid4()),
    "Content-Type": "application/json"
}

payload = {
    "assistance_cost_gross": 3444.00,
    "travel_cost_gross": 0.00,
    "approx_fulfillment_at": "2026-09-02T10:00:00Z",
    "unloading_method": "HDS",
    "items": [
        {
            "sku_code": "PELLET_A1_15KG",
            "name": "Pellet drzewny certyfikowany ENplus A1 worki 15kg",
            "unit": "T",
            "quantity": 2.0,
            "unit_price_net": 1400.00,
            "vat_rate": 0.23,
            "total_gross": 3444.00
        }
    ],
    "description": "Dostawa pelletu certyfikowanego A1 w workach 15kg z rozładunkiem HDS."
}

response = requests.post(
    "https://ugrzejmnie.pl/api/v1/integrations/service-requests/123/offers",
    json=payload,
    headers=headers
)
print("Odpowiedź:", response.json())

C. Potwierdzenie realizacji z podpisem cyfrowym:

import requests
import uuid

API_KEY = "wmu_live_YOUR_KEY"
headers = {
    "X-API-Key": API_KEY,
    "Idempotency-Key": str(uuid.uuid4()),
    "Content-Type": "application/json"
}

payload = {
    "signature_base64": "data:image/png;base64,iVBORw0KGgoAAA...",
    "signature_name": "Jan Kowalski",
    "delivered_quantity": 2150.0,
    "meter_reading_before": 142050.0,
    "meter_reading_after": 144200.0,
    "completed_notes": "Dostarczono i rozładowano bez uwag."
}

response = requests.post(
    "https://ugrzejmnie.pl/api/v1/integrations/service-requests/123/complete",
    json=payload,
    headers=headers
)
print("Zlecenie zakończone:", response.json())

D. Klient API: Exponential Backoff, Idempotency-Key, kursor GET /events:

import time, uuid, requests

class UgrzejMnieClient:
    def __init__(self, api_key, base="https://ugrzejmnie.pl/api/v1/integrations"):
        self.api_key, self.base = api_key, base

    def request(self, method, path, json=None, retries=4):
        headers = {"X-API-Key": self.api_key, "Idempotency-Key": str(uuid.uuid4())}
        delay = 0.5
        for attempt in range(retries):
            r = requests.request(method, self.base + path, json=json, headers=headers, timeout=15)
            if r.status_code < 500:
                return r.json()
            time.sleep(delay)
            delay *= 2
        raise RuntimeError("API niedostępne")

    def poll_events(self, after_id=0):
        data = self.request("GET", f"/events?after_id={after_id}&limit=100")
        return data.get("last_id", after_id), data.get("events", [])

A. Pobranie listy oczekujących zapytań klienta:

<?php

$apiKey = 'wmu_live_YOUR_KEY';

$ch = curl_init('https://ugrzejmnie.pl/api/v1/integrations/service-requests?status=PENDING&limit=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: $apiKey",
    "Accept: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$pendingRequests = json_decode($response, true);
curl_close($ch);

print_r($pendingRequests);

B. Złożenie wyceny / oferty z pozycjami SKU:

<?php

$apiKey = 'wmu_live_YOUR_KEY';
$requestId = 123;

$payload = [
    'assistance_cost_gross' => 3444.00,
    'travel_cost_gross'     => 0.00,
    'approx_fulfillment_at' => '2026-09-02T10:00:00Z',
    'unloading_method'      => 'HDS',
    'items' => [
        [
            'sku_code'       => 'PELLET_A1_15KG',
            'name'           => 'Pellet drzewny certyfikowany ENplus A1 worki 15kg',
            'unit'           => 'T',
            'quantity'       => 2.0,
            'unit_price_net' => 1400.00,
            'vat_rate'       => 0.23,
            'total_gross'    => 3444.00
        ]
    ],
    'description'           => 'Dostawa pelletu certyfikowanego A1 w workach 15kg.'
];

$ch = curl_init("https://ugrzejmnie.pl/api/v1/integrations/service-requests/$requestId/offers");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: $apiKey",
    "Idempotency-Key: " . bin2hex(random_bytes(16)),
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

C. Potwierdzenie realizacji z podpisem cyfrowym:

<?php

$apiKey = 'wmu_live_YOUR_KEY';
$requestId = 123;

$payload = [
    'signature_base64'     => 'data:image/png;base64,iVBORw0KGgoAAA...',
    'signature_name'       => 'Jan Kowalski',
    'delivered_quantity'   => 2150.0,
    'meter_reading_before' => 142050.0,
    'meter_reading_after'  => 144200.0,
    'completed_notes'      => 'Dostarczono i rozładowano bez uwag.'
];

$ch = curl_init("https://ugrzejmnie.pl/api/v1/integrations/service-requests/$requestId/complete");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: $apiKey",
    "Idempotency-Key: " . bin2hex(random_bytes(16)),
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

A. Pobranie listy oczekujących zapytań klienta:

const API_KEY = "wmu_live_YOUR_KEY";

const res = await fetch("https://ugrzejmnie.pl/api/v1/integrations/service-requests?status=PENDING&limit=20", {
  headers: { "X-API-Key": API_KEY }
});
const data = await res.json();
console.log("Otwarte zapytania:", data.items);

B. Złożenie wyceny / oferty z pozycjami SKU:

const API_KEY = "wmu_live_YOUR_KEY";
const requestId = 123;

const res = await fetch("https://ugrzejmnie.pl/api/v1/integrations/service-requests/" + requestId + "/offers", {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    assistance_cost_gross: 3444.00,
    travel_cost_gross: 0.00,
    approx_fulfillment_at: "2026-09-02T10:00:00Z",
    unloading_method: "HDS",
    items: [
      {
        sku_code: "PELLET_A1_15KG",
        name: "Pellet drzewny certyfikowany ENplus A1 worki 15kg",
        unit: "T",
        quantity: 2.0,
        unit_price_net: 1400.00,
        vat_rate: 0.23,
        total_gross: 3444.00
      }
    ],
    description: "Dostawa pelletu certyfikowanego A1 w workach 15kg z rozładunkiem HDS."
  })
});
const result = await res.json();
console.log("Wysłano ofertę:", result);

C. Potwierdzenie realizacji z podpisem cyfrowym:

const API_KEY = "wmu_live_YOUR_KEY";
const requestId = 123;

const res = await fetch("https://ugrzejmnie.pl/api/v1/integrations/service-requests/" + requestId + "/complete", {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    signature_base64: "data:image/png;base64,iVBORw0KGgoAAA...",
    signature_name: "Jan Kowalski",
    delivered_quantity: 2150.0,
    meter_reading_before: 142050.0,
    meter_reading_after: 144200.0,
    completed_notes: "Dostarczono i rozładowano bez uwag."
  })
});
const result = await res.json();
console.log("Zlecenie zakończone:", result);

A. Pobranie listy oczekujących zapytań klienta:

req, _ := http.NewRequest("GET", "https://ugrzejmnie.pl/api/v1/integrations/service-requests?status=PENDING&limit=20", nil)
req.Header.Set("X-API-Key", "wmu_live_YOUR_KEY")

resp, err := http.DefaultClient.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Printf("Pobrano zleceń: %v\n", result["count"])

B. Złożenie wyceny / oferty z pozycjami SKU:

payload := map[string]interface{}{
    "assistance_cost_gross": 3444.00,
    "travel_cost_gross":     0.00,
    "approx_fulfillment_at": "2026-09-02T10:00:00Z",
    "unloading_method":      "HDS",
    "items": []map[string]interface{}{
        {
            "sku_code":       "PELLET_A1_15KG",
            "name":           "Pellet drzewny certyfikowany ENplus A1 worki 15kg",
            "unit":           "T",
            "quantity":       2.0,
            "unit_price_net": 1400.00,
            "vat_rate":       0.23,
            "total_gross":    3444.00,
        },
    },
    "description": "Dostawa pelletu certyfikowanego A1 w workach 15kg z rozładunkiem HDS.",
}
body, _ := json.Marshal(payload)

req, _ := http.NewRequest("POST", "https://ugrzejmnie.pl/api/v1/integrations/service-requests/123/offers", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "wmu_live_YOUR_KEY")
req.Header.Set("Idempotency-Key", "custom-unique-uuid-12345")
req.Header.Set("Content-Type", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()
fmt.Println("Status:", resp.Status)

C. Potwierdzenie realizacji z podpisem cyfrowym:

payload := map[string]interface{}{
    "signature_base64":     "data:image/png;base64,iVBORw0KGgoAAA...",
    "signature_name":       "Jan Kowalski",
    "delivered_quantity":   2150.0,
    "meter_reading_before": 142050.0,
    "meter_reading_after":  144200.0,
    "completed_notes":      "Dostarczono i rozładowano bez uwag.",
}
body, _ := json.Marshal(payload)

req, _ := http.NewRequest("POST", "https://ugrzejmnie.pl/api/v1/integrations/service-requests/123/complete", bytes.NewBuffer(body))
req.Header.Set("X-API-Key", "wmu_live_YOUR_KEY")
req.Header.Set("Idempotency-Key", "custom-complete-uuid-67890")
req.Header.Set("Content-Type", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()
fmt.Println("Zakończono zlecenie, status:", resp.Status)

UgrzejMnie — Developer Portal

Standard Response Codes and Error Handling (Error Codes)

Sample JSON Payload (Supports Idempotency-Key):

Fuel Delivery (Tanker meter reading & delivered quantity):

Service / Heat Pump Protocol:

Sample JSON Payload:

Sample JSON Payload:

Real-time Webhook Notifications

Thin Webhook Payload Format:

HMAC-SHA256 Signature Verification:

API Key & Webhook Management

verify_webhook_signature — SDK Snippets

Sandbox & Order Lifecycle Simulator

Sent Request (HTTP Request):

Server Response (HTTP Response):

Error Directory

PUESC — SENT / e-DD — Integracja fiskalna

SENT — System Elektronicznej Navigacji Transportu

e-DD — Elektroniczny Dokument Dowodowy (EMCS PL2)

Złota zasada SENT — pojazdy i lokalizacja

Procedura awaryjna — Dokument zastępczy

Konfiguracja per-provider

Historia zgłoszeń i audyt

Integration Examples in Your Technology

A. Pobranie listy oczekujących zapytań klienta:

B. Złożenie wyceny / oferty z pozycjami SKU (obsługuje Idempotency-Key):

C. Potwierdzenie realizacji z podpisem cyfrowym i licznikiem:

A. Pobranie listy oczekujących zapytań klienta:

B. Złożenie wyceny / oferty z pozycjami SKU:

C. Potwierdzenie realizacji z podpisem cyfrowym:

D. Klient API: Exponential Backoff, Idempotency-Key, kursor GET /events:

A. Pobranie listy oczekujących zapytań klienta:

B. Złożenie wyceny / oferty z pozycjami SKU:

C. Potwierdzenie realizacji z podpisem cyfrowym:

A. Pobranie listy oczekujących zapytań klienta:

B. Złożenie wyceny / oferty z pozycjami SKU:

C. Potwierdzenie realizacji z podpisem cyfrowym:

A. Pobranie listy oczekujących zapytań klienta:

B. Złożenie wyceny / oferty z pozycjami SKU:

C. Potwierdzenie realizacji z podpisem cyfrowym: