Domain Overview

The big picture

The ConformaESG API exposes your sustainability data as a handful of connected resources. At the center of the model is the supplier: every material flow, certification and purchase is ultimately anchored to the supplier that provides it.

1                    ┌──────────────┐
2                    │   Supplier   │
3                    └──────┬───────┘
4           ┌───────────────┼────────────────┐
5           ▼               ▼                ▼
6   ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
7   │ Certifications│ │   Products   │ │   Purchases  │
8   └──────────────┘ └──────┬───────┘ └──────┬───────┘
9                           │                │
10                    ┌──────┴─────┐     ┌────┴─────┐
11                    ▼            ▼     ▼          ▼
12               Textile       Chemicals  Status   Audit log
13             (fiber/yarn/                        of changes
14              fabric)
15
16              ┌─────────────────────────────────────┐
17              │ Product Traceability (with stages)  │
18              └─────────────────────────────────────┘

The resources you'll use

How the resources fit together

1. You start by registering your suppliers and attaching their certifications.
2. You add the items each supplier sells to you as supplier products (or fabrics / yarns / fibers for textile-specific detail).
3. You maintain your own company products catalog — the SKUs you sell.
4. Every time you buy from a supplier you create a purchase order, then move it through the status lifecycle as it progresses.
5. For any company product you can build a product traceability journey composed of ordered processing stages — each stage captures the transport mode, distance and CO₂ emissions between steps.
6. When a specific batch ships, you record it as a traceability record (batch-level, lightweight alternative to the full journey).

Multi-tenant isolation

All records are scoped to the tenant identified by your credentials. You cannot see or modify data belonging to other tenants, and no tenant identifier is required in any request. Your subscription also defines which modules are enabled — see Configuration and the /me/entitlements endpoint.