Wanneer gebruik je het?

• het aanmaken of bijwerken van leveranciers;
• het versturen van orders inclusief orderregels;
• het koppelen van orders aan contracten;
• het registreren van facturen en factuurregels.

• ERP stuurt automatisch nieuwe leveranciers naar ISPnext;
• Inkooporders worden realtime overgezet naar ISPnext;
• Contractkoppelingen worden automatisch toegepast bij ontvangst van facturen.

Hoe werkt het?

POST https://XXX.vendorlink.nl/API/auth/login

JSON
{
"u": "username",
"p": "password"
}

{
"userId": 9999999,
"displayName": "Demo User",
"accessToken": "string",
"renewalToken": "string",
"hostname": "XXX.vendorlink.nl"
}

{
"hostname": "ZZZ.vendorlink.nl"
}

POST https://XXX.vendorlink.nl/API/auth/extendtoken

Authorization: Bearer <accessToken>
Content-Type: application/json; charset=utf8

{
"rToken": "string"
}

{
"userId": 9999999,
"displayName": "Demo User",
"accessToken": "string",
"renewalToken": "string"
}

1. Supplier Connector

Endpoint

POST https://XXX.vendorlink.nl/api/Connector/Suppliers

Modelvelden

Voorbeeldrequest

[
  {
    "SupplierName": "Supplier BV",
    "SupplierExternalId": "SUP-EXT-123",
    "SupplierAddressStreet": "Main Street",
    "SupplierAddressNum": "100",
    "SupplierAddressNumAdd": "A",
    "SupplierAddressZipCode": "1234 AB",
    "SupplierAddressTown": "Amsterdam",
    "SupplierAddressCountry": "NL",
    "SupplierVatCode": "NL123456789B01",
    "SupplierKvkCode": "12345678",
    "SupplierDunsNumber": "123456789",
    "SupplierTel": "+31 20 1234567",
    "SupplierOrderEmail": "orders@supplier.com",
    "SupplierBankAccount": "NL91ABNA0417164300",
    "SupplierRatingNorm": "A",
    "SupplierWebsiteUrl": "https://www.supplier.com",
    "SupplierTypeExternalId": "TYPE-001",
    "SupplierCommodityExternalId": "COMM-001",
    "SupplierProductGroupExternalId": "PG-001",
    "SupplierClassificationExternalId": "CLASS-001"
  }
]

2. Order Connector

Endpoint

POST https://XXX.vendorlink.nl/api/Connector/Orders

Modelvelden – Order

Orderregelvelden

Voorbeeldrequest

[
  {
    "OrderId": "ORD-2024001",
    "OrderReference": "REF-001",
    "CreationDate": "2024-05-01T00:00:00",
    "SupplierReference": "SUP-EXT-123",
    "SupplierName": "Supplier BV",
    "UserName": "John Doe",
    "UserMailAddress": "john.doe@example.com",
    "UserId": "USER123",
    "AmountExcl": 1000.00,
    "AmountVat": 210.00,
    "AmountInc": 1210.00,
    "CompanyName": "Company BV",
    "ContractId": "12345",
    "OrderType": "Standard",
    "OrderLines": [
      {
        "OrderId": "ORD-2024001",
        "OrderLineId": "1",
        "ProductReference": "PROD-001",
        "ProductName": "Product A",
        "SupplierReference": "SUP-EXT-123",
        "SupplierName": "Supplier BV",
        "ProductGroup": "Group A",
        "CostCentreReference": "CC-01",
        "CostCentreName": "Cost Centre 1",
        "CostTypeReference": "T1",
        "CostTypeName": "Type 1",
        "Unit": "pieces",
        "ProductPrice": 100.00,
        "Quantity": 10,
        "AmountExclVat": 1000.00,
        "AmountInclVat": 1210.00,
        "DeliveryDate": "2024-05-15T00:00:00",
        "Received": 0,
        "ProductGroupReference": "PG-01"
      }
    ]
  }
]

3. Invoice–Order–Contract Connector

Endpoint

POST https://XXX.vendorlink.nl/api/Connector/InvoiceOrderContracts

Modelvelden

• SupplierExternalId
• InvoiceOrderNumber
• ContractNumber
• ContractNumber2
• ContractNumber3

Voorbeeldrequest

[
 {
   "SupplierExternalId": "SUP-EXT-123",
   "InvoiceOrderNumber": "ORD-001",
   "ContractNumber": "CN-001",
   "ContractNumber2": "CN-002",
   "ContractNumber3": "CN-003"
 }
]

4. Invoice Connector

Endpoint

POST https://XXX.vendorlink.nl/api/Connector/Invoices

Modelvelden – Factuur

Modelvelden – Factuurregel

Voorbeeldrequest

[
  {
    "InvoiceNumber": "INV-2024001",
    "InvoiceNumberSupplier": "SUP-001",
    "InvoiceCreateDate": "2024-05-01T00:00:00",
    "InvoiceDate": "2024-05-01T00:00:00",
    "InvoicePayDate": "2024-05-15T00:00:00",
    "InvoiceWorkFlow": 1,
    "InvoiceSupplierExternalId": "SUP-EXT-123",
    "InvoiceSupplierName": "Supplier BV",
    "InvoiceCompanyReference": "COMP-REF-1",
    "InvoiceCompany": "Company BV",
    "InvoiceOrderLog": "Order log text",
    "InvoiceLines": [
      {
        "InvoiceLineNumber": "1",
        "InvoiceLineDesc": "Product A",
        "InvoiceLineSupplierReference": "SUP-EXT-123",
        "InvoiceLineSupplierName": "Supplier BV",
        "InvoiceDate": "2024-05-01T00:00:00",
        "InvoiceOrderNumber": "ORD-001",
        "InvoiceCostCentreCode": "CC-01",
        "InvoiceCostCentreDesc": "Cost Centre 1",
        "InvoiceCostCentreGroupCode": "G1",
        "InvoiceCostCentreGroupDesc": "Group 1",
        "InvoiceCostTypeCode": "T1",
        "InvoiceCostTypeDesc": "Type 1",
        "InvoiceCostUnitCode": "U1",
        "InvoiceCostUnitDesc": "Unit 1",
        "InvoiceCommodityCode": "C1",
        "InvoiceCommodityDesc": "Commodity 1",
        "InvoiceProjectCode": "P1",
        "InvoiceProjectDesc": "Project 1",
        "InvoiceProductCode": "PR1",
        "InvoiceProductDesc": "Product 1",
        "InvoiceContractCode": "CN1",
        "InvoiceContractDesc": "Contract 1",
        "InvoicePurchaserCode": "PU1",
        "InvoicePurchaserDesc": "Purchaser 1",
        "InvoiceAmountEx": 100.00,
        "InvoiceAmountVat": 21.00,
        "InvoiceAmountIn": 121.00,
        "InvoiceCurrency": "EUR"
      }
    ]
  }
]

Praktische tips

• Controleren dat externe IDs uniek en consistent blijven.
• Factuurregels altijd voorzien van correcte kostenplaats‑ en kostenunits.
• Bij orders: zorg dat OrderId overal exact gelijk blijft, ook in de orderregels.

Veelgemaakte fouten

Veelgestelde vragen