Agent też powinien umieć wyjaśnić wynik.

Mapy odnoszą się dokładnie do kolejności kolumn podanego tekstu. Kwoty odpowiedzi są całkowitymi groszami: 8500 oznacza 85,00 zł. null pozostaje brakiem.

{
  "input": {
    "orders": {
      "text": "Name,Total,Refunded Amount,Currency,Financial Status,Lineitem SKU,Lineitem quantity\r\nDEMO-A,100.00,10.00,PLN,partially_refunded,0012,2\r\n,,,,,HD-02,1\r\nDEMO-B,80.00,0.00,PLN,paid,0012,1\r\n",
      "name": "uzgodnienie-shopify-zamowienia.csv"
    },
    "costs": {
      "text": "SKU,unit_cost\r\n0012,20.00\r\n",
      "name": "uzgodnienie-shopify-koszty-brak.csv"
    },
    "orderMap": {
      "Id": 0,
      "Total": 1,
      "Refunded Amount": 2,
      "Currency": 3,
      "Financial Status": 4,
      "Lineitem SKU": 5,
      "Lineitem quantity": 6
    },
    "costMap": {
      "SKU": 0,
      "unit_cost": 1
    },
    "extra": {
      "fees": "5.00",
      "shipping": "10.00",
      "ads": "10.00",
      "fixed": "0.00"
    },
    "basis": "gross_PLN_original_ordered_quantities"
  }
}

Pełna marża jest nieustalona, ponieważ HD-02 nie ma kosztu. Wynik po znanych kosztach to 85 zł. Brak dotyczy rekordu CSV 3. Przy proponowanej stawce HD-02 30 zł, z zachowaniem kosztu 0012, podgląd marży wynosi 55 zł. Zmiana nie została zastosowana.

To opis danych demonstracyjnych. Agent powinien sprawdzić własne źródła i zakres kosztów przed użyciem wniosków.

Argumenty tego przykładu wykonuje rzeczywisty SDK. Każda kolejna strona wymaga tych samych kompletnych wejść. Stronicowanie zmienia odpowiedź, a nie zakres obliczenia.

{
  "view": "comparison",
  "A": {
    "input": {
      "orders": {
        "text": "Id,Total,Refunded Amount,Currency,Financial Status,Lineitem SKU,Lineitem quantity,Created at\nA1,7200,0,PLN,paid,TS-01,80,2026-09-01\nA2,4800,600,PLN,partially_refunded,HD-02,40,2026-09-03"
      },
      "costs": {
        "text": "SKU,unit_cost,Currency\nTS-01,40,PLN\nHD-02,80,PLN"
      },
      "orderMap": {
        "Id": 0,
        "Total": 1,
        "Refunded Amount": 2,
        "Currency": 3,
        "Financial Status": 4,
        "Lineitem SKU": 5,
        "Lineitem quantity": 6,
        "Created at": 7
      },
      "costMap": {
        "SKU": 0,
        "unit_cost": 1
      },
      "extra": {
        "fees": "480",
        "shipping": "520",
        "ads": "1200",
        "fixed": "0"
      },
      "basis": "gross_PLN_original_ordered_quantities"
    },
    "scope": {
      "from": "2026-09-01",
      "to": "2026-09-30",
      "confirmed": true
    }
  },
  "B": {
    "input": {
      "orders": {
        "text": "Id,Total,Refunded Amount,Currency,Financial Status,Lineitem SKU,Lineitem quantity,Created at\nB1,8000,0,PLN,paid,TS-01,100,2026-10-01\nB2,5000,800,PLN,partially_refunded,HD-02,40,2026-10-03"
      },
      "costs": {
        "text": "SKU,unit_cost,Currency\nTS-01,45,PLN\nHD-02,75,PLN"
      },
      "orderMap": {
        "Id": 0,
        "Total": 1,
        "Refunded Amount": 2,
        "Currency": 3,
        "Financial Status": 4,
        "Lineitem SKU": 5,
        "Lineitem quantity": 6,
        "Created at": 7
      },
      "costMap": {
        "SKU": 0,
        "unit_cost": 1
      },
      "extra": {
        "fees": "600",
        "shipping": "450",
        "ads": "1000",
        "fixed": "100"
      },
      "basis": "gross_PLN_original_ordered_quantities"
    },
    "scope": {
      "from": "2026-10-01",
      "to": "2026-10-31",
      "confirmed": true
    }
  }
}

Pole comparisonView: summary, issues, orders, refunds, skus, extras, sources. Listy mają do 12 pozycji oraz jawną stronę, liczbę wszystkich pozycji i kolejną stronę. Wspólne ID, nakładające się zakresy i nieznane lub sprzeczne daty blokują porównywalność, także przy zadeklarowanym potwierdzeniu.

Dwa wejścia łącznie mieszczą do 10 000 rekordów zamówień i 10 000 kosztów, z niższą granicą 900 KiB JSON. Nie usuwaj rekordów w celu zmieszczenia żądania. Podsumowanie zawsze obejmuje całość obu przekazanych wejść. Pełny rzeczywisty wynik demonstracyjny JSON.

Send complete A/B inputs on every call. Summary totals cover both complete inputs. Views and source references are separately paginated; no data is silently truncated. Missing cost keeps the full margin difference null. Opaque keys resolve financial entries through record/column numbers in your own input; no raw CSV, filenames, order IDs or SKU identities are echoed. No saved pair, account, purchase or paid export is added.

Obie mapy wymagają ośmiu przypisanych kolumn, także Created at. Każde wywołanie i każda strona dostaje cały bazowy input oraz candidateOrders i candidateOrderMap. Podgląd nie przechowuje pary ani nie stosuje zmiany.

{
  "view": "correction",
  "input": {
    "orders": {
      "text": "Id,Total,Refunded Amount,Currency,Financial Status,Lineitem SKU,Lineitem quantity,Created at\nA1,7200,0,PLN,paid,TS-01,80,2026-09-01\nA2,4800,600,PLN,partially_refunded,HD-02,40,2026-09-03"
    },
    "costs": {
      "text": "SKU,unit_cost,Currency\nTS-01,40,PLN\nHD-02,80,PLN"
    },
    "orderMap": {
      "Id": 0,
      "Total": 1,
      "Refunded Amount": 2,
      "Currency": 3,
      "Financial Status": 4,
      "Lineitem SKU": 5,
      "Lineitem quantity": 6,
      "Created at": 7
    },
    "costMap": {
      "SKU": 0,
      "unit_cost": 1
    },
    "extra": {
      "fees": "480",
      "shipping": "520",
      "ads": "1200",
      "fixed": "0"
    },
    "basis": "gross_PLN_original_ordered_quantities"
  },
  "candidateOrders": {
    "text": "Id,Total,Refunded Amount,Currency,Financial Status,Lineitem SKU,Lineitem quantity,Created at\nA1,7100,100,PLN,partially_refunded,TS-01,80,2026-09-01\nA2,4800,600,PLN,partially_refunded,HD-02,40,2026-09-03"
  },
  "candidateOrderMap": {
    "Id": 0,
    "Total": 1,
    "Refunded Amount": 2,
    "Currency": 3,
    "Financial Status": 4,
    "Lineitem SKU": 5,
    "Lineitem quantity": 6,
    "Created at": 7
  }
}

correctionView: summary | issues | changes | sources. Listy mają do 12 pozycji z liczbą wszystkich i kolejną stroną. Sumy obejmują pełne wejścia. query filtruje tylko listę zmian; nie zmienia sum. Źródła zwracają przypisane pola i numery kolumn/rekordów bez raw CSV, nazw, ID ani SKU. Brak stawki ma pustą referencję, bez podstawienia innego źródła.

Obie wersje zamówień łącznie mieszczą do 10 000 rekordów, z dotychczasową granicą 900 KiB argumentów i 512 KiB odpowiedzi. Nie przycinaj danych, by zmieścić żądanie; przy zbyt dużej parze wróć do pełnego warsztatu. Pełny rzeczywisty wynik demonstracyjny JSON.

Use the existing inspector with explicit view=correction, complete input, candidateOrders and candidateOrderMap. Exact order identities, SKU positions, original quantities, PLN and literal dates must match before baseline costs are reused. correctionView selects summary, issues, changes or exact sources with explicit pagination. Unknown cost keeps full marginDelta null. The preview never applies or stores the correction, echoes raw identities or adds an account, purchase, export, authorization or retention. Re-send complete inputs for every call.