Integrace objednávek přířezu do vlastního e-shopu nebo ERP

CutOptim Configurator se k vlastnímu e-shopu nebo ERP připojuje dvěma kontrolami na vašem serveru: podepsanou nabídkou a podepsaným webhookem. Obojí je prosté HMAC-SHA256, které ověří jakýkoli jazyk, a referenční příklady v Node a PHP ukazují jak.

Dvě kontroly, obě na vašem serveru

Vlastní platforma nemá zásuvný modul, o který by se opřela, takže důvěra stojí na dvou podpisech. Prohlížeč může zobrazit cenu, ale zda jí uvěří, rozhoduje jen váš server.

Ověřte nabídku před košíkem

Token nabídky je příslib ceny. Váš server se CutOptim zeptá, zda je pravý, nevypršel a ještě nebyl použit, a pak porovná, co tvrdí, s položkou v košíku.

1. Přijměte objednávku

   Stránka předá vašemu skriptu událost cutoptim:order s objednávkou a jejím tokenem nabídky.

2. Zeptejte se CutOptim

   Váš server odešle token na /cfg/v1/quote/verify s vaším tajným klíčem. Odpověď říká, zda je platný, zda ho už některá objednávka použila a jaká tvrzení nese.

3. Porovnejte tvrzení

   Nájemce, měna, platnost a otisk oceněných položek se musí shodovat s položkou, kterou chcete přidat. Cokoli jiného se odmítne.

4. Přidejte, nebo odmítněte

   Do košíku se dostane jen token, který projde. Cena změněná v prohlížeči tady selže.

Přijímejte objednávky webhookem

Když je objednávka odeslána, CutOptim ji pošle na vámi zadanou adresu, podepsanou, abyste poznali, že pochází od nás.

• — Hlavička CutOptim-Signature nese časové razítko t a podpis v1: HMAC-SHA256 z časového razítka, tečky a surového těla.
• — Ověřujte surové bajty přesně tak, jak dorazily; tělo, které bylo zpracováno a znovu zapsáno, už nesedí.
• — Odmítněte časové razítko starší nebo novější než pět minut a podpisy porovnávejte v konstantním čase.
• — Uložte identifikátor události a na už viděný identifikátor odpovězte úspěchem: opakovaný pokus ho zopakuje.

Referenční kód v Node a PHP

Dva malé příklady dělají přesně tohle, bez frameworku a bez závislostí: modul pro Node a jediný soubor PHP. Zkopírujte ten, který se hodí, nahraďte úložiště v paměti tabulkou s jedinečným klíčem na identifikátoru události a tajné údaje držte v prostředí.

import { createWebhookReceiver } from './cutoptim-verify.mjs';

const receive = createWebhookReceiver({
  secrets: [process.env.WEBHOOK_SECRET],          // whsec_... from the admin route, never in the repository
  async onEvent(event) { /* store event.data.order, keyed by event.id */ },
});

// in your HTTP handler - the RAW body, not parsed JSON:
const { status } = await receive({ rawBody, headers: req.headers });
res.writeHead(status).end();

Co zůstává u vás

Konfigurátor stanoví cenu a naplánuje řez; vaše platforma si ponechá všechno, co následuje.

• — Košík, pokladna a platba: CutOptim nevybírá platby.
• — Záznam objednávky a její vyřízení, ve vaší databázi nebo ERP.
• — Vaši zákazníci a stránky vašeho obchodu: žádný hostovaný e-shop neexistuje.

Kam to zapadá

Tyto objednávky může přijímat každý systém, který umí přijmout požadavek HTTPS a spočítat HMAC: vlastnoručně napsaný e-shop, headless storefront, nástroj na nabídky nebo ERP. Pokud potřebujete jen řezný engine a ne objednávkovou obrazovku, slouží k tomu Engine API.

Související kalkulačky, průvodci a obory

• Jak objednat nářez desek, aby se nic nepředělávalo →

Další informace o konfigurátoru

Potřebujete jen řezací engine? Podívejte se na Engine API

Právní informacePodmínky konfigurátoru (EN) ·Smlouva o zpracování údajů (EN) ·Zásady ochrany osobních údajů pro kupující ·Licence třetích stran (EN)