Novatrade24 Integration API

Reference integration

A worked example of the EU VAT compliance flow: OAuth2 service account, a client typed from the published OpenAPI contract, and every call made server-side.

Discovery — GET /me

connected
Target
https://api.dev.novatrade24.com/v1
Auth
client_credentials (api-client-demo)

Novatrade24 API Demo 9fbfb634-0649-4245-a683-801b6a3df585

Authorized sellers

  • Ekstend Unternehmensberatungsgesellschaft mbH · 57fb2dfe-67b6-4bce-b2a5-3bcf96efb2bb · DE

Capabilities

  • rateLimitTier: STANDARD
  • allowMarketplaceLedKyc: true
  • allowMultiVinOrders: true

Compliance workflow

  1. 01

    Discovery

    liveINT-01

    Read the calling organization, the sellers it may act for, and the capability flags that gate everything else.

    • GET /me
    • GET /partners
  2. 02

    Buyer & KYC

    liveINT-02

    Upsert a buyer by (sellerId, vatNumber), run the VIES check, upload KYC documents or hand the buyer to NT24-led verification.

    • POST /partners/{sellerId}/buyers
    • POST /partners/{sellerId}/buyers/{buyerId}/kyc/vies-check
    • POST /partners/{sellerId}/buyers/{buyerId}/kyc/documents
    • GET /partners/{sellerId}/buyers/{buyerId}/kyc
  3. 03

    Order

    liveINT-03

    Register the VIN-based transaction against a verified buyer.

    • POST /partners/{sellerId}/orders
    • GET /partners/{sellerId}/orders/{uuid}
    • POST /partners/{sellerId}/orders/{uuid}/documents
  4. 04

    Invoice & payment

    liveINT-04

    Submit invoice data and PDF, then proof of payment, then flag the vehicle ready for pickup.

    • GET /partners/{sellerId}/orders/{uuid}/invoice
    • POST /partners/{sellerId}/orders/{uuid}/invoice
    • POST /partners/{sellerId}/orders/{uuid}/invoice/documents
    • GET /partners/{sellerId}/orders/{uuid}/payment
    • POST /partners/{sellerId}/orders/{uuid}/payment
    • POST /partners/{sellerId}/orders/{uuid}/payment/documents
    • POST /partners/{sellerId}/orders/{uuid}/payment/ready-for-pickup
  5. 05

    Transport

    liveINT-05

    Confirm pickup and delivery, upload the CMR and the destination declaration.

    • GET /partners/{sellerId}/orders/{uuid}/transport
    • POST /partners/{sellerId}/orders/{uuid}/transport/pickup
    • POST /partners/{sellerId}/orders/{uuid}/transport/delivery
    • POST /partners/{sellerId}/orders/{uuid}/transport/documents
  6. 06

    Compliance rollup

    liveINT-06

    Poll the rollup for what is still missing, or subscribe to a webhook and stop polling.

    • GET /partners/{sellerId}/orders/{uuid}/compliance
    • POST /webhooks
  7. 07

    Finalization

    liveINT-07

    Submit the final invoice where one is required, then download the generated Export File for the tax authority.

    • POST /partners/{sellerId}/orders/{uuid}/finalization/final-invoice
    • GET /partners/{sellerId}/orders/{uuid}/finalization/export-file
    • GET /documents/{id}/download