Leverantörer

Leverantörsresursen speglar Fortnox /3/suppliers. Leverantören adresseras på sitt leverantörsnummer (SupplierNumber), och numret kan inte ändras när det väl är satt.

Scope: supplier · Kräver AI Pro

EndpointsCopy Anchor Link

Bas-URL: https://app.klirr.ai/api/v1. Skrivningar kuverteras i Supplier.

ListparametrarCopy Anchor Link

Utöver paginering (page, limit, offset) och sortorder (asc/desc):

Det finns inget filter: listan innehåller både aktiva och inaktiva leverantörer, med Active satt. Skickar du filter eller lastmodified, eller fler än en av fritextsökningarna (name, organisationnumber, email, phone, zipcode, city), svarar API:t 400 i stället för att tyst returnera ett ofiltrerat svar.

FältCopy Anchor Link

Fullständig form (GET /3/suppliers/{SupplierNumber}, och svaret på POST/PUT).

Fält som Klirr inte modellerar (till exempel IBAN, BIC, BankAccountNumber, ClearingNumber, Phone2, OurReference) sparas och returneras oförändrade. Vid PUT slås de ihop med de redan sparade, så en smal uppdatering raderar inte IBAN.

ListformCopy Anchor Link

GET /3/suppliers returnerar en reducerad rad med exakt dessa fält: @url, Active, Address1, Address2, BankAccountNumber, BG, BIC, City, CostCenter, CountryCode, Currency, DisablePaymentFile, Email, IBAN, Name, OrganisationNumber, PG, Phone, PreDefinedAccount, Project, SupplierNumber, TermsOfPayment, ZipCode. Telefon heter Phone i listan men Phone1 i den fullständiga formen, och listan har landskoden (CountryCode) men inte landsnamnet.

Skapa en leverantörCopy Anchor Link

curl -X POST https://app.klirr.ai/api/v1/3/suppliers \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"Supplier":{"Name":"Lindqvist Grossist AB","OrganisationNumber":"556000-0001","BG":"000-0000","TermsOfPayment":"30"}}'

Svar (201):

{
  "Supplier": {
    "@url": "https://app.klirr.ai/api/v1/3/suppliers/1",
    "SupplierNumber": "1",
    "Name": "Lindqvist Grossist AB",
    "OrganisationNumber": "556000-0001",
    "VATNumber": "",
    "Email": "",
    "Phone1": "",
    "Address1": "",
    "ZipCode": "",
    "City": "",
    "Country": "Sverige",
    "CountryCode": "SE",
    "Currency": "SEK",
    "BG": "000-0000",
    "PG": "",
    "Active": true,
    "Comments": "",
    "VATType": "25",
    "TermsOfPayment": "30",
    "PreDefinedAccount": ""
  }
}

Lista leverantörerCopy Anchor Link

curl "https://app.klirr.ai/api/v1/3/suppliers?name=Lindqvist&sortby=name" \
  -H "Authorization: Bearer <access_token>"

{
  "Suppliers": [
    {
      "@url": "https://app.klirr.ai/api/v1/3/suppliers/1",
      "Active": true,
      "Address1": "",
      "Address2": "",
      "BankAccountNumber": "",
      "BG": "000-0000",
      "BIC": "",
      "City": "",
      "CostCenter": "",
      "CountryCode": "SE",
      "Currency": "SEK",
      "DisablePaymentFile": false,
      "Email": "",
      "IBAN": "",
      "Name": "Lindqvist Grossist AB",
      "OrganisationNumber": "556000-0001",
      "PG": "",
      "Phone": "",
      "PreDefinedAccount": "",
      "Project": "",
      "SupplierNumber": "1",
      "TermsOfPayment": "30",
      "ZipCode": ""
    }
  ],
  "MetaInformation": { "@TotalResources": 1, "@TotalPages": 1, "@CurrentPage": 1 }
}

Uppdatera en leverantörCopy Anchor Link

PUT ändrar bara de fält du skickar. Använd "API_BLANK" för att tömma ett textfält (inte Name eller Active, som ger 400). Se Fortnox-kompatibilitet.

curl -X PUT https://app.klirr.ai/api/v1/3/suppliers/1 \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"Supplier":{"Email":"[email protected]"}}'

Inaktivera en leverantörCopy Anchor Link

DELETE raderar inte leverantören. Den inaktiveras (Active: false), eftersom artiklar och inlärd konteringshistorik refererar till den. Svaret är 204, och leverantören finns kvar på sin URL.

FelCopy Anchor Link

Allmänna fel (401, 403, 429) beskrivs under Felkoder.