Suppliers

Retrieve supplier records for a given consent.

List suppliers

get

Retrieves a paginated list of suppliers for the specified consent.

System support

System	Status
Fortnox	✅ Supported
Bjorn Lunden	📞 Not supported / contact us
Spiris	📞 Not supported / contact us
Tripletex	📞 Not supported / contact us
Visma e-conomic	📞 Not supported / contact us
Billy	✅ Supported
Visma Dinero	✅ Supported
Procountor	✅ Supported
Visma Netvisor	📞 Not supported / contact us
Microsoft Business Central	✅ Supported
Exact Online	✅ Supported
QuickBooks	✅ Supported
Xero	✅ Supported
Bokio	📞 Not supported / contact us
Kleer	📞 Not supported / contact us

Authorizations

x-api-keystringRequired

Use the API key to access all API endpoints.

Path parameters

consentIdstring · uuidRequired

Identifier of the consent representing the connection to the accounting system.

Query parameters

Countinteger · int32 · min: 1 · max: 100Optional

Number of records to return per page. Range: 1-100.

CurrentPageinteger · int32 · min: 1 · max: 2147483647Optional

Page number to return. Must be 1 or greater.

Header parameters

x-correlation-idstring · uuidRequired

Unique identifier used to correlate and trace this request.

Responses

200

Returns a paginated list of suppliers for the specified consent.

application/json

Represents a paginated result containing metadata and a collection of items.

401

Missing or invalid authentication credentials.

application/json

403

Not authorized to access this resource.

application/json

501

This operation is not supported by the connected accounting system.

application/json

get/api/v1/consents/{consentId}/suppliers

GET /accounting/api/v1/consents/{consentId}/suppliers HTTP/1.1
Host: apione.zwapgrid.com
x-api-key: YOUR_API_KEY
x-correlation-id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

{
  "meta": {
    "totalResources": 10,
    "totalPages": 1,
    "currentPage": 1
  },
  "data": [
    {
      "id": "SUP-001",
      "customerAssignedAccountId": {
        "id": "SUP-001",
        "schemeId": "supplierId"
      },
      "party": {
        "partyIdentification": [],
        "partyName": {
          "name": "Acme Supplies",
          "languageId": "ENG"
        },
        "postalAddress": null,
        "partyLegalEntity": null,
        "contact": null,
        "endpointId": null
      },
      "deliveryAddresses": [],
      "description": null,
      "financialDimensions": [],
      "active": true,
      "currency": "SEK",
      "paymentMeans": [
        {
          "paymentChannelCode": "IBAN",
          "payeeFinancialAccounts": [
            {
              "id": "SE3550000000054910000003",
              "financialInstitution": "Swedbank"
            }
          ],
          "payeeFinancialAccount": "SE3550000000054910000003",
          "financialAccount": {
            "id": "SE3550000000054910000003",
            "financialInstitution": "Swedbank"
          }
        }
      ]
    }
  ]
}

Get a supplier by ID

get

Retrieves a single supplier by its identifier.

System support

System	Status
Fortnox	📞 Not supported / contact us
Bjorn Lunden	📞 Not supported / contact us
Spiris	📞 Not supported / contact us
Tripletex	📞 Not supported / contact us
Visma e-conomic	📞 Not supported / contact us
Billy	✅ Supported
Visma Dinero	✅ Supported
Procountor	📞 Not supported / contact us
Visma Netvisor	📞 Not supported / contact us
Microsoft Business Central	📞 Not supported / contact us
Exact Online	✅ Supported
QuickBooks	✅ Supported
Xero	✅ Supported
Bokio	📞 Not supported / contact us
Kleer	📞 Not supported / contact us

Authorizations

x-api-keystringRequired

Use the API key to access all API endpoints.

Path parameters

consentIdstring · uuidRequired

Identifier of the consent representing the connection to the accounting system.

supplierIdstringRequired

Identifier of the supplier.

Header parameters

x-correlation-idstring · uuidRequired

Unique identifier used to correlate and trace this request.

Responses

200

Returns the requested supplier.

application/json

Represents a supplier entity in the accounting system.

idstring · nullableOptional

Unique identifier for the supplier.

activeboolean · nullableOptional

Indicates whether the supplier is active.

currencystring · nullableOptional

Currency code associated with the supplier.

401

Missing or invalid authentication credentials.

application/json

403

Not authorized to access this resource.

application/json

404

The requested supplier was not found.

application/json

501

This operation is not supported by the connected accounting system.

application/json

get/api/v1/consents/{consentId}/suppliers/{supplierId}

GET /accounting/api/v1/consents/{consentId}/suppliers/{supplierId} HTTP/1.1
Host: apione.zwapgrid.com
x-api-key: YOUR_API_KEY
x-correlation-id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

{
  "id": "SUP-001",
  "customerAssignedAccountId": {
    "id": "SUP-001",
    "schemeId": "supplierId"
  },
  "party": {
    "partyIdentification": [],
    "partyName": {
      "name": "Acme Supplies",
      "languageId": "ENG"
    },
    "postalAddress": null,
    "partyLegalEntity": null,
    "contact": null,
    "endpointId": null
  },
  "deliveryAddresses": [],
  "description": null,
  "financialDimensions": [],
  "active": true,
  "currency": "SEK",
  "paymentMeans": [
    {
      "paymentChannelCode": "IBAN",
      "payeeFinancialAccounts": [
        {
          "id": "SE3550000000054910000003",
          "financialInstitution": "Swedbank"
        }
      ],
      "payeeFinancialAccount": "SE3550000000054910000003",
      "financialAccount": {
        "id": "SE3550000000054910000003",
        "financialInstitution": "Swedbank"
      }
    }
  ]
}