Verbinden Sie Noyax mit Ihrer eigenen Software

Mit der Noyax API spricht Ihr Onlineshop, Ihre Lager- oder Außendienstsoftware direkt mit Noyax: Sie liest Kunden und Artikel, erstellt Rechnungen, Aufträge und Lieferscheine und ruft Bestände und Kundensalden ab.

Seite „Kundenliste“ in der technischen Dokumentation der Noyax API: Endpunkt GET /api/v1/customers, eine curl-Anfrage und der JSON-Inhalt der Antwort 200

Eine Anfrage, eine Antwort

Wählen Sie einen Aufruf: die Anfrage als curl-Befehl, die Antwort als JSON, wie Noyax sie liefert. Die Feldnamen sind die der API, die Werte Beispiele.

GET /api/v1/customers

Kunden kommen seitenweise, höchstens 50 Datensätze je Seite. search sucht im Kundennamen und findet den Kunden, dessen Nummer, Steuernummer oder E-Mail-Adresse genau übereinstimmt.

Anfrage

curl "https://api.noyax.com/api/v1/customers?search=paketleme&pageSize=10" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3"

Antwort 200 OK

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "Page": 1,
    "PageSize": 10,
    "TotalCount": 2,
    "Items": [
      {
        "Id": "8d2f4a61-3c7e-4b19-a5d0-6e1f9b2c7a43",
        "CustomerCode": "C0042",
        "Name": "Kuzey Paketleme A.Ş.",
        "TaxNumber": "6120458731",
        "TaxOffice": "Nilüfer",
        "DueDays": 30,
        "RiskLimit": 250000
      },
      {
        "Id": "e17a0c35-92b4-4d6f-8a1e-3b5c9d0f2a68",
        "CustomerCode": "C0057",
        "Name": "Marmara Paketleme Ltd. Şti.",
        "TaxNumber": "6094127358",
        "TaxOffice": "Gebze",
        "DueDays": 45,
        "RiskLimit": 150000
      }
    ]
  }
}

GET /api/v1/stock/products/status

Die vorhandene Menge mit Aufschlüsselung nach Chargen und Seriennummern. Mit warehouseName zählt nur dieses Lager; abgefragt wird per Artikel-ID, Artikelnummer oder Shop-Artikelnummer.

Anfrage

curl "https://api.noyax.com/api/v1/stock/products/status?productCode=RLM-6205&warehouseName=Merkez%20Depo" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3"

Antwort 200 OK

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "UnitCode": "C62",
    "Quantity": 1620,
    "Lots": [
      {
        "LotNo": "LOT002917",
        "Quantity": 1180
      },
      {
        "LotNo": "LOT002921",
        "Quantity": 440
      }
    ],
    "SerialNumbers": null
  }
}

POST /api/v1/sales-invoices

Rechnung, Positionen und Lagerbewegung werden in einem Schritt geschrieben. Mit „Next“ statt einer Nummer kommt die Nummer aus dem Nummernkreis der Firma; die Kundenbuchung entsteht automatisch.

Anfrage

curl -X POST "https://api.noyax.com/api/v1/sales-invoices" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3" \
  -H "Content-Type: application/json" \
  --data '{
  "InvoiceNumber": "Next",
  "Date": "2026-11-23T10:30:00",
  "CustomerCode": "C0042",
  "Lines": [
    {
      "ProductCode": "CVT-M1040",
      "UnitCode": "C62",
      "Quantity": 200,
      "UnitPrice": 4.5,
      "CurrencyCode": "TRY",
      "ExchangeRate": 1,
      "VatRate": 20,
      "AmountExcludingTax": 900,
      "VatBase": 900,
      "VatAmount": 180,
      "AmountIncludingTax": 1080,
      "WarehouseName": "Merkez Depo"
    }
  ]
}'

Antwort 201 Created

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "Id": "c41e7b20-9a5d-4f83-b6c2-0d8e3a51f794",
    "InvoiceNumber": "NYX2026000000318",
    "Date": "2026-11-23T10:30:00",
    "CustomerCode": "C0042",
    "CustomerName": "Kuzey Paketleme A.Ş.",
    "CurrencyCode": "TRY",
    "SubTotal": 900,
    "VatTotal": 180,
    "GrandTotal": 1080
  }
}

GET /api/v1/finance/customers/balances

Soll, Haben und Saldo je Währung für alle Kunden mit Saldo. Mit asOfDate erhalten Sie den Saldo zu einem früheren Datum.

Anfrage

curl "https://api.noyax.com/api/v1/finance/customers/balances?excludeZeroBalance=true&pageSize=2" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3"

Antwort 200 OK

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "Page": 1,
    "PageSize": 2,
    "TotalCount": 84,
    "Items": [
      {
        "CustomerId": "8d2f4a61-3c7e-4b19-a5d0-6e1f9b2c7a43",
        "CustomerCode": "C0042",
        "CustomerName": "Kuzey Paketleme A.Ş.",
        "Balances": [
          {
            "CurrencyCode": "TRY",
            "IsDefault": true,
            "Debit": 184250,
            "Credit": 151900,
            "Balance": 32350
          }
        ]
      },
      {
        "CustomerId": "e17a0c35-92b4-4d6f-8a1e-3b5c9d0f2a68",
        "CustomerCode": "C0057",
        "CustomerName": "Marmara Paketleme Ltd. Şti.",
        "Balances": [
          {
            "CurrencyCode": "TRY",
            "IsDefault": true,
            "Debit": 96400,
            "Credit": 96400,
            "Balance": 0
          },
          {
            "CurrencyCode": "EUR",
            "IsDefault": false,
            "Debit": 12400,
            "Credit": 9800,
            "Balance": 2600
          }
        ]
      }
    ]
  }
}

PATCH /api/v1/products/{productId}

Sie senden nur die geänderten Felder: Nicht gesendete Felder bleiben, wie sie sind; ein mit null gesendetes Feld wird geleert.

Anfrage

curl -X PATCH "https://api.noyax.com/api/v1/products/5b7e2c90-1f4d-4a86-9c3b-e2d0a7f61b58" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-UserID: 12" \
  -H "X-CompanyID: 3" \
  -H "Content-Type: application/json" \
  --data '{
  "ShelfNumber": "B-14",
  "Description": null
}'

Antwort 200 OK

{
  "Success": true,
  "ResultCode": "0000",
  "Message": null,
  "Data": {
    "Id": "5b7e2c90-1f4d-4a86-9c3b-e2d0a7f61b58",
    "Code": "RLM-6205",
    "Name": "Kugellager 6205-2RS",
    "UnitCode": "C62",
    "StockType": 4,
    "VatRate": 20,
    "ShelfNumber": "B-14",
    "Description": null
  }
}

Alle Endpunkte, Felder und Fehlercodes stehen in der technischen Dokumentation (Englisch): https://apidocs.noyax.com/en/v1

Jeder Schlüssel erreicht nur die freigegebenen Module

Ein API-Schlüssel hat je Modul eigene Lese- und Schreibrechte: Lesen erlaubt GET-Anfragen, Schreiben erlaubt POST, PUT, PATCH und DELETE. Anfragen an ein Modul ohne Recht werden abgelehnt.

  • Lesen umfasst nicht Schreiben und Schreiben nicht Lesen; ein Schlüssel kann auch nur lesen.
  • Anfragen laufen im Namen des Benutzers aus X-UserID; in der App sehen Sie, wer einen Datensatz angelegt oder geändert hat.
  • Mit einem Freigabecode verborgene Datensätze erscheinen nicht in der Liste, wenn der Benutzer sie nicht sehen darf.
Module der API
Modul Was Sie tun können
Kunden Kundenkarten mit Adressen, Telefonnummern, Ansprechpartnern und Bankkonten
Artikel Artikelkarten und Mindestbestände
Rechnungen Einkaufs-, Verkaufs-, Einkaufsgutschrifts- und Verkaufsgutschriftsrechnungen
Angebote Einkaufs- und Verkaufsangebote
Aufträge Bestellungen und Kundenaufträge
Lieferscheine Eingangs- und Ausgangslieferscheine
Bestand Bestand eines Artikels mit Aufschlüsselung nach Chargen und Seriennummern (nur lesen)
Finanzen Kundenbewegungen und Salden; Bankkonten, Überweisungs-, Umbuchungs-, Eröffnungs- und Kreditkarten-Einzugsbelege
Stammdaten Kunden- und Artikelgruppen, Parameterdefinitionen, Lager und Lagerbereiche

Eine Rechnung über die API folgt den Regeln der App

Rechnung, Positionen und die Chargen- und Seriennummern der Positionen mit Lagerbewegung werden in einem Schritt geschrieben. Ist etwas davon ungültig, wird nichts gespeichert; alle Fehler kommen in einer Antwort zurück, mit Positionsnummer.

  • Senden Sie „Next“ statt einer Nummer, kommt die Nummer aus dem Nummernkreis der Firma – bei E-Rechnung aus dem Nummernkreis für e-Fatura oder e-Arşiv.
  • Der Kunde wird über seine Nummer gefunden oder, wenn Sie nur diese haben, über die Steuernummer; Adresse, Name und Finanzamt kommen von der Kundenkarte.
  • Die API berechnet keine Positionsbeträge, prüft aber, ob sie zusammenpassen; die Rechnungssummen werden aus den Positionen gefüllt.
Seite „Verkaufsrechnung erstellen“ in der technischen Dokumentation: POST /api/v1/sales-invoices, eine curl-Anfrage und die Antwort 201 Bild vergrößern

Fehlermeldungen sagen, was passiert ist

Jede Antwort kommt im gleichen Rahmen: Success, ResultCode und Message. Eine erfolgreiche Anfrage hat den Code 0000; bei Fehlern kommen HTTP-Status, ein vierstelliger Code und die Beschreibung zusammen, mehrere Fehler stehen einzeln in Errors.

  • Token abgelaufen · 401

    Token has expired. Obtain a new token using the refresh token.

  • Kein Recht für das Modul · 403

    You do not have permission for this operation.

  • Pflicht-Header fehlt · 400

    X-UserID header is required.

  • Tageskontingent aufgebraucht · 429

    Daily request limit (10000) exceeded.

Ihr Restkontingent steht in jeder Antwort

Jeder Schlüssel hat ein Limit pro Sekunde und pro Tag, das sich alle Server mit diesem Schlüssel teilen. Das Restkontingent kommt in den Headern jeder Antwort zurück; der Tageszähler wird um Mitternacht (türkische Zeit) zurückgesetzt.

  • Eine am Sekundenlimit gescheiterte Anfrage zählt nicht zum Tageslimit.
  • Ihr Tageslimit richtet sich nach der gebuchten Staffel des API-Moduls.
Header einer Beispielantwort
Header Bedeutung Wert
X-RateLimit-Limit Anfragen pro Sekunde 50
X-RateLimit-Remaining Rest in dieser Sekunde 37
X-Daily-Limit Anfragen pro Tag 10000
X-Daily-Remaining Rest heute 9874

Weitere Funktionen der API

Seiten und Suche
Listen kommen seitenweise, höchstens 50 Datensätze je Seite. search sucht im Kundennamen und findet den Kunden, dessen Nummer, Steuernummer oder E-Mail-Adresse genau übereinstimmt.
Vollständige und teilweise Änderung
PUT ersetzt alle Felder eines Datensatzes; mit PATCH senden Sie nur die geänderten Felder (JSON Merge Patch).
Firma und Periode
Jede Anfrage arbeitet in der Firma aus X-CompanyID; mit X-PeriodID landen neue Datensätze in dieser Buchungsperiode.
Vorhandene Datensätze
Legen Sie einen Kunden oder Artikel mit einer schon vergebenen Nummer an, liefert die Antwort die ID des vorhandenen Datensatzes.
Versionen
Die Version steht in der Adresse (/api/v1). Eine als veraltet markierte Version läuft noch mindestens 6 Monate.
Postman-Sammlung
Alle Endpunkte samt Anmeldung liegen mit fertigen Variablen in einer Postman-Sammlung; importieren und sofort testen.

Senden Sie Ihre erste Anfrage in wenigen Minuten.

Die Noyax API ist eine REST-API für die Kommunikation zwischen Servern; Anfragen und Antworten sind JSON. Die technische Dokumentation beschreibt jeden Endpunkt mit Feldern, Beispielen und Fehlercodes, und mit der Postman-Sammlung testen Sie alle Endpunkte mit Ihrem eigenen Schlüssel.

  1. Schlüssel

    Noyax gibt Ihnen Ihren Organisationsnamen und Ihren API-Schlüssel; am Schlüssel ist festgelegt, welche Module er lesen und schreiben darf.

  2. Token

    Mit dem Schlüssel holen Sie ein Token. Es gilt 20 Minuten; danach holen Sie mit dem Refresh-Token ein neues.

  3. Erste Anfrage

    Sie setzen das Token in den Authorization-Header, Benutzer und Firma in die Header X-UserID und X-CompanyID und senden die Anfrage.

Verbinden Sie Ihre Software mit Noyax.

14 Tage kostenlos testen. Keine Kreditkarte nötig.