RegEngine API Documentation

NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
TODAY=$(date -u +%Y-%m-%d)

BODY=$(cat <<EOF
{
  "source": "<your source system id>",
  "events": [
    {
      "cte_type": "receiving",
      "traceability_lot_code": "<the lot code you assigned>",
      "product_description": "<product name>",
      "quantity": "<number greater than 0>",
      "unit_of_measure": "<cases | lbs | kg | pallets | each>",
      "location_name": "<your facility name>",
      "timestamp": "$NOW",
      "kdes": {
        "receive_date": "$TODAY",
        "receiving_location": "<where the lot arrived>",
        "immediate_previous_source": "<who sent it to you>",
        "reference_document": "<your ASN or receipt id>",
        "tlc_source_reference": "<the lot reference your supplier gave you>"
      }
    }
  ]
}
EOF
)

# Sign the exact bytes you send: sha256= plus the HMAC-SHA256 hex digest.
SIGNATURE="sha256=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$REGENGINE_SIGNING_SECRET" -hex | sed 's/^.* //')"

curl -X POST https://regengine.co/api/v1/webhooks/ingest \
  -H "X-RegEngine-API-Key: $REGENGINE_API_KEY" \
  -H "X-Webhook-Signature: $SIGNATURE" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  --data-binary "$BODY"

import hashlib
import hmac
import json
import os
import uuid
from datetime import datetime, timezone

import requests

now = datetime.now(timezone.utc)
payload = {
  "source": "<your source system id>",
  "events": [
    {
      "cte_type": "receiving",
      "traceability_lot_code": "<the lot code you assigned>",
      "product_description": "<product name>",
      "quantity": "<number greater than 0>",
      "unit_of_measure": "<cases | lbs | kg | pallets | each>",
      "location_name": "<your facility name>",
      "timestamp": now.strftime("%Y-%m-%dT%H:%M:%SZ"),
      "kdes": {
        "receive_date": now.strftime("%Y-%m-%d"),
        "receiving_location": "<where the lot arrived>",
        "immediate_previous_source": "<who sent it to you>",
        "reference_document": "<your ASN or receipt id>",
        "tlc_source_reference": "<the lot reference your supplier gave you>"
      }
    }
  ]
}

# Sign the exact bytes you send: sha256= plus the HMAC-SHA256 hex digest.
body = json.dumps(payload).encode()
signature = "sha256=" + hmac.new(
    os.environ["REGENGINE_SIGNING_SECRET"].encode(), body, hashlib.sha256
).hexdigest()

resp = requests.post(
    "https://regengine.co/api/v1/webhooks/ingest",
    headers={
        "X-RegEngine-API-Key": os.environ["REGENGINE_API_KEY"],
        "X-Webhook-Signature": signature,
        "Idempotency-Key": str(uuid.uuid4()),
        "Content-Type": "application/json",
    },
    data=body,
)
print(resp.status_code, resp.json())

import { createHmac, randomUUID } from "node:crypto";

const now = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
const payload = {
  "source": "<your source system id>",
  "events": [
    {
      "cte_type": "receiving",
      "traceability_lot_code": "<the lot code you assigned>",
      "product_description": "<product name>",
      "quantity": "<number greater than 0>",
      "unit_of_measure": "<cases | lbs | kg | pallets | each>",
      "location_name": "<your facility name>",
      "timestamp": now,
      "kdes": {
        "receive_date": now.slice(0, 10),
        "receiving_location": "<where the lot arrived>",
        "immediate_previous_source": "<who sent it to you>",
        "reference_document": "<your ASN or receipt id>",
        "tlc_source_reference": "<the lot reference your supplier gave you>"
      }
    }
  ]
};

// Sign the exact bytes you send: sha256= plus the HMAC-SHA256 hex digest.
const body = JSON.stringify(payload);
const signature =
  "sha256=" + createHmac("sha256", process.env.REGENGINE_SIGNING_SECRET).update(body).digest("hex");

const resp = await fetch("https://regengine.co/api/v1/webhooks/ingest", {
  method: "POST",
  headers: {
    "X-RegEngine-API-Key": process.env.REGENGINE_API_KEY,
    "X-Webhook-Signature": signature,
    "Idempotency-Key": randomUUID(),
    "Content-Type": "application/json",
  },
  body,
});
console.log(resp.status, await resp.json());