Skip to content
N'entropy EUDR API

Quick Start

Quick Start

Section titled “Quick Start”

This guide walks you through pushing supplier, product, and batch data from an external system.

Prerequisites

Section titled “Prerequisites”
  • An N’entropy platform account
  • An API token with write scopes (see Authentication)

Step 1: Push Suppliers

Section titled “Step 1: Push Suppliers”
Terminal window
curl -X POST https://backend.joinnentropy.com/api/v1/integration/suppliers \
  -H "Authorization: Bearer eudr_live_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "suppliers": [
      {
        "externalId": "VENDOR-001",
        "name": "Amazon Timber Co.",
        "country": "BR",
        "address": "Rua Example 123, São Paulo",
        "email": "timber@example.com",
        "contactPerson": "João Silva"
      },
      {
        "externalId": "VENDOR-002",
        "name": "Nordic Wood AB",
        "country": "SE",
        "address": "Storgatan 1, Stockholm",
        "email": "info@nordicwood.se"
      }
    ]
  }'

Response:

{
  "success": true,
  "created": 2,
  "updated": 0,
  "errors": [],
  "records": [
    { "externalId": "VENDOR-001", "internalId": "clx...", "status": "CREATED" },
    { "externalId": "VENDOR-002", "internalId": "clx...", "status": "CREATED" }
  ]
}

Step 2: Push Products

Section titled “Step 2: Push Products”

Products can optionally reference suppliers by their externalId:

Terminal window
curl -X POST https://backend.joinnentropy.com/api/v1/integration/products \
  -H "Authorization: Bearer eudr_live_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "externalId": "ITEM-001",
        "name": "Brazilian Hardwood Planks",
        "category": "Wood",
        "country": "BR",
        "hsCode": "4407.29",
        "supplierExternalId": "VENDOR-001"
      }
    ]
  }'

Step 3: Push Batches

Section titled “Step 3: Push Batches”

Batches reference products by their externalId:

Terminal window
curl -X POST https://backend.joinnentropy.com/api/v1/integration/batches \
  -H "Authorization: Bearer eudr_live_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "batches": [
      {
        "externalId": "BATCH-2024-001",
        "productExternalId": "ITEM-001",
        "batchNumber": "BN-2024-001",
        "quantity": 5000,
        "unit": "kg",
        "receivedDate": "2024-01-15"
      }
    ]
  }'

Step 4: Check DDS Status

Section titled “Step 4: Check DDS Status”

After batches are synced, you can check their DDS status:

Terminal window
curl -X GET https://backend.joinnentropy.com/api/v1/integration/dds/BATCH-2024-001 \
  -H "Authorization: Bearer eudr_live_your_token"

Idempotent Upserts

Section titled “Idempotent Upserts”

All push operations are idempotent. If you push data with the same externalId, the existing record is updated rather than duplicated. This means you can safely re-sync data without creating duplicates.

What’s Next?

Section titled “What’s Next?”