> ## Documentation Index
> Fetch the complete documentation index at: https://developers.novatrade24.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Embed EU VAT-compliant cross-border vehicle transactions into your platform via the Novatrade24 Integration API.

The Novatrade24 Integration API lets marketplaces, dealers, and financial
partners embed EU VAT-compliant cross-border vehicle transactions into their
own systems. Every integration flows through the same end-to-end compliance
workflow — from buyer onboarding to a signed export file ready for the tax
authority.

<Warning>
  **Status: Draft specification.** This documentation describes the Phase 1
  API. No production endpoint exists yet. A hosted mock server is available at
  `https://mock.api.novatrade24.com` for integration design.
</Warning>

## What the API does

* **Upsert a buyer** and carry a KYC workflow to completion (marketplace-led or NT24-led).
* **Register a VIN-based order** linked to that buyer, with invoice, payment, and transport sub-resources.
* **Poll a single compliance rollup** or subscribe to webhooks to know when a transaction is ready for pickup or export.
* **Download the generated Export File** — the signed PDF your customer's tax authority expects.

## Workflow at a glance

<Steps>
  <Step title="Create or sync the buyer">
    `POST /partners/{sellerId}/buyers` upserts by VAT number. Choose `MARKETPLACE_LED`
    (you provide KYC data) or `NT24_LED` (NT24 runs full verification + iDenfy + AML).
  </Step>

  <Step title="Register the order">
    `POST /partners/{sellerId}/orders` with the VIN(s) and buyer reference.
  </Step>

  <Step title="Submit invoice, payment, transport">
    Three sub-resources on the order. Upload required documents as you go.
  </Step>

  <Step title="Poll compliance or wait for webhook">
    `GET /partners/{sellerId}/orders/{uuid}/compliance` or subscribe to
    `compliance.status_changed`.
  </Step>

  <Step title="Download the Export File">
    Auto-generated when compliance reaches `VALID` or `INVALID`. Emitted via
    `export_file.generated` webhook.
  </Step>
</Steps>

## How the API is organized

<CardGroup cols={2}>
  <Card title="Buyer / KYC" icon="user-check" href="/guides/buyer-onboarding">
    Create buyers, upload KYC documents, trigger VIES checks and
    NT24-led verification.
  </Card>

  <Card title="Orders" icon="file-invoice" href="/guides/order-creation">
    Register VIN-based transactions and track their compliance state.
  </Card>

  <Card title="Invoice, Payment, Transport" icon="truck" href="/guides/invoice-payment">
    Submit commercial data and supporting documents.
  </Card>

  <Card title="Compliance & Export File" icon="file-shield" href="/guides/finalization">
    Poll rollup state, download the final export artifact.
  </Card>

  <Card title="Webhooks" icon="bell" href="/webhooks/setup">
    Subscribe to compliance transitions, VIES failures, export file events.
  </Card>

  <Card title="Security & Compliance" icon="lock" href="/security/overview">
    OAuth2 service accounts, DPA, GDPR, EU-only data residency.
  </Card>
</CardGroup>

## Who this is for

* **Marketplaces** (Santander-style) onboarding buyers on behalf of many dealer sellers.
* **Dealer groups** integrating their DMS to NT24 for their own sales pipeline.
* **Dealer Management System (DMS) vendors** offering NT24 compliance as a feature.
* **Direct dealers** automating workflows they already perform manually in the NT24 web app.

## Next steps

<CardGroup cols={3}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Get a token and call `/me` in 5 minutes.
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference">
    Every endpoint, schema, and example.
  </Card>

  <Card title="Contact" icon="envelope" href="https://www.novatrade24.com/contact">
    Request pilot access.
  </Card>
</CardGroup>