Zum Inhalt springen
aYOUne
← Einkauf API

TradeChannelOrders

Singular: TradeChannelOrder — Base-URL: https://purchase-api.ayoune.app — Zugriff: CRUD — Maschinenlesbare Beschreibung (JSON · YAML)

Jetzt ausprobieren beta

Requests werden über den consumer-app Proxy an *.ayoune.app weitergeleitet. Tokens bleiben im Browser und werden pro Call mitgesendet.

Beispiel-Response (aufgezeichnet) Beispiel

Eine echte, zuvor aufgezeichnete GET /:id-Antwort dieses Endpunkts — nicht der Live-Call oben. Sensible Felder sind maskiert.

{
  "payload": {
    "counterparty": {
      "name": "Beispiel-Händler GmbH"
    },
    "_id": "6abef16d3e4ac8da65834a63",
    "_channel": "6abef16d3e4ac8da65834a62",
    "externalId": "BEISPIEL-302-0000001",
    "createdAt": "2026-10-01T23:49:01.588Z",
    "currency": "EUR",
    "direction": "outbound",
    "events": [
      {
        "at": "2026-10-01T23:49:01.572Z",
        "source": "plugin-scrape",
        "type": "imported",
        "data": {
          "batchSize": 2
        }
      },
      {
        "at": "2026-10-01T23:49:02.292Z",
        "source": "internal",
        "type": "product-matched",
        "data": {
          "matched": 0,
          "autoCreated": 2,
          "unmatched": 0,
          "skipped": 0,
          "needsReview": 0,
          "linkLost": 0,
          "lockSkipped": 0,
          "bundleExpanded": 0,
          "runId": "muq6r2v5-si7m0os6",
          "items": [
            {
              "externalProductId": "B0BEISPIEL1",
              "matchedBy": null,
              "tried": [
                "asin:externalProductId"
              ],
              "outcome": "auto-created"
            },
            {
              "externalProductId": "B0BEISPIEL2",
              "matchedBy": null,
              "tried": [
                "asin:externalProductId"
              ],
              "outcome": "auto-created"
            }
          ]
        }
      },
      {
        "at": "2026-10-01T23:49:03.193Z",
        "source": "internal",
        "type": "counterparty-promoted",
        "data": {
          "consumerId": "6abef16e3e4ac8da65834a6a",
          "isNew": true,
          "dedupKey": "name",
          "provider": "amazon"
        }
      },
      {
        "at": "2026-10-01T23:49:03.233Z",
        "source": "internal",
        "type": "promoted-to-supplier-order",
        "data": {
          "supplierOrderId": "6abef16f3e4ac8da65834a6b",
          "ext_nbr": "amz-BEISPIEL-302-0000001",
          "isNew": true,
          "positionCount": 2,
          "promotedSkus": [
            "B0BEISPIEL1",
            "B0BEISPIEL2"
          ],
          "pendingLines": [],
          "runId": "muq6r2v5-si7m0os6"
        }
      }
    ],
    "externalUrl": "https://www.amazon.de/gp/your-account/order-details?orderID=BEISPIEL-302-0000001",
    "firstSeenAt": "2026-10-01T23:49:01.572Z",
    "firstSeenSource": "plugin-scrape",
    "items": [
      {
        "externalProductId": "B0BEISPIEL1",
        "title": "Beispielartikel: USB-C-Ladekabel 2 m (Prüfer-Testdaten)",
        "qty": 2,
        "unitPrice": 9.95,
        "currency": "EUR",
        "attributes": {
          "seller": {
            "name": "Beispiel-Händler GmbH"
          }
        },
        "_product": "6abef16e3e4ac8da65834a68"
      },
      {
        "externalProductId": "B0BEISPIEL2",
        "title": "Beispielartikel: Etikettendrucker-Rolle (Prüfer-Testdaten)",
        "qty": 3,
        "unitPrice": 10,
        "currency": "EUR",
        "attributes": {
          "seller": {
            "name": "Beispiel-Händler GmbH"
          }
        },
        "_product": "6abef16e3e4ac8da65834a69"
      }
    ],
    "lastSyncedAt": "2026-10-01T23:49:01.572Z",
    "orderDate": "2026-09-20T10:00:00.000Z",
    "provider": "amazon",
    "raw": {
      "source": "pruefer-beispiel"
    },
    "rawStatus": "",
    "shares": [],
    "shipments": [],
    "source": "plugin-scrape",
    "status": "unknown",
    "subtotal": 49.9,
    "total": 59.38,
    "updatedAt": "2026-10-01T23:49:03.234Z",
    "_consumer": "6abef16e3e4ac8da65834a6a",
    "_supplierOrder": "6abef16f3e4ac8da65834a6b",
    "promotedAt": "2026-10-01T23:49:03.229Z"
  },
  "meta": {
    "links": [
      {
        "rel": "self",
        "href": "https://purchase-api.ayoune.app/tradechannelorders/6abef16d3e4ac8da65834a63",
        "method": "get",
        "title": "GET",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      },
      {
        "rel": "TradeChannels",
        "title": "MODEL_TRADECHANNEL",
        "href": "https://api.ayoune.app/purchase/tradechannels/6abef16d3e4ac8da65834a62",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "purchase.tradechannels"
      },
      {
        "rel": "SupplierOrders",
        "title": "MODEL_SUPPLIERORDER",
        "href": "https://api.ayoune.app/purchase/supplierorders/6abef16f3e4ac8da65834a6b",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "purchase.supplierorders"
      }
    ],
    "relations": [
      {
        "rel": "TradeChannels",
        "title": "MODEL_TRADECHANNEL",
        "href": "https://api.ayoune.app/purchase/tradechannels",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "purchase.tradechannels"
      },
      {
        "rel": "SupplierOrders",
        "title": "MODEL_SUPPLIERORDER",
        "href": "https://api.ayoune.app/purchase/supplierorders",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "purchase.supplierorders"
      },
      {
        "rel": "IncomeInvoices",
        "title": "MODEL_INCOMEINVOICE",
        "href": "https://api.ayoune.app/purchase/incomeinvoices",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "purchase.incomeinvoices"
      },
      {
        "rel": "GoodsReceipts",
        "title": "MODEL_GOODSRECEIPT",
        "href": "https://api.ayoune.app/purchase/goodsreceipts",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "purchase.goodsreceipts"
      },
      {
        "rel": "Orders",
        "title": "MODEL_ORDER",
        "href": "https://api.ayoune.app/ecommerce/orders",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "ecommerce.orders"
      },
      {
        "rel": "ProductionOrders",
        "title": "MODEL_PRODUCTIONORDER",
        "href": "https://api.ayoune.app/production/productionorders",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "production.productionorders"
      }
    ],
    "debugId": "6ac9c33057e1a6a13fa5abf9",
    "errors": [],
    "actions": [
      {
        "rel": "self",
        "action": "COPY",
        "title": "MODEL_TRADECHANNELORDER",
        "href": "https://api.ayoune.app/purchase/tradechannelorders/6abef16d3e4ac8da65834a63/copy",
        "method": "post",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      },
      {
        "rel": "self",
        "action": "DELETE",
        "title": "MODEL_TRADECHANNELORDER",
        "href": "https://api.ayoune.app/purchase/tradechannelorders/6abef16d3e4ac8da65834a63",
        "method": "delete",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      }
    ],
    "version": {
      "host": "2026.19.0",
      "core": "2026.365.0"
    },
    "rateLimit": {
      "limit": "10000",
      "remaining": "9885",
      "reset": "1791611150",
      "resetDate": "Sat Oct 10 2026"
    },
    "responseTime": 215.940506,
    "code": 200,
    "status": "success",
    "error": false
  }
}

Endpunkte

MethodePathBeschreibungRight
GET /tradechannelorders Liste mit Filtern/Paginierung purchase.tradechannelorders.view
GET /tradechannelorders/:id Einzelner Datensatz purchase.tradechannelorders.view
POST /tradechannelorders Neuen Datensatz erstellen purchase.tradechannelorders.new
PUT /tradechannelorders Datensatz aktualisieren purchase.tradechannelorders.edit
DELETE /tradechannelorders/:id Datensatz löschen purchase.tradechannelorders.delete

SDK

import { aYOUne } from '@tolinax/ayoune';
const ay = new aYOUne('pat_your_token');

// Alle abrufen
const list = await ay.purchase.tradeChannelOrders.find().limit(10).exec();

// Einzelnen Datensatz
const one = await ay.purchase.tradeChannelOrders.findById('OBJECT_ID').exec();

// Erstellen
const created = await ay.purchase.tradeChannelOrders.create({ name: 'Foo' });

Weiterführend