Journals

Create and retrieve journal entries for a given consent.

List journals

get

Retrieves a paginated list of journals for the specified consent.

System support

System	Status
Fortnox	✅ Supported
Bjorn Lunden	✅ Supported
Spiris	📞 Not supported / contact us
Tripletex	📞 Not supported / contact us
Visma e-conomic	📞 Not supported / contact us
Billy	📞 Not supported / contact us
Visma Dinero	📞 Not supported / contact us
Procountor	✅ Supported
Visma Netvisor	📞 Not supported / contact us
Microsoft Business Central	📞 Not supported / contact us
Exact Online	📞 Not supported / contact us
QuickBooks	📞 Not supported / contact us
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.

StartDatestring · dateOptional

Start date for the journal filter. Format: yyyy-MM-dd.

Example: 2025-01-01

EndDatestring · dateOptional

End date for the journal filter. Format: yyyy-MM-dd.

Example: 2025-12-31

OrderBystring · enumOptional

Sort order for the results.

Possible values:

Header parameters

x-correlation-idstring · uuidRequired

Unique identifier used to correlate and trace this request.

Responses

200

Returns a paginated list of journals 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}/journals

GET /accounting/api/v1/consents/{consentId}/journals 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": "550e8400-e29b-41d4-a716-446655440004",
      "reference": "J-001",
      "transactionDate": "2024-01-01",
      "accountingSeries": {
        "id": "series-1",
        "reference": null,
        "accountingSeriesId": "GJ"
      },
      "description": {
        "text": "January revenue entry",
        "languageId": "ENG"
      },
      "financialDimensions": [
        {
          "id": "97c88337-ef68-46d1-a66d-60276dc31016",
          "reference": "CC-1",
          "type": "costCode",
          "name": null,
          "description": null,
          "isActive": null
        }
      ],
      "accountingEntries": [
        {
          "description": {
            "text": "Sales revenue",
            "languageId": "ENG"
          },
          "accountingAccount": {
            "id": "3001",
            "accountingAccountId": "3001",
            "reference": "3001",
            "standardAccountingAccountId": null,
            "name": "Sales",
            "active": null,
            "postable": null,
            "description": {
              "languageId": "ENG",
              "text": "Sales revenue"
            },
            "descriptions": [],
            "accountingAccountTypeCode": null,
            "financialDimensions": []
          },
          "debitAmount": {
            "amount": 1000,
            "currencyId": "SEK"
          },
          "creditAmount": {
            "amount": 0,
            "currencyId": "SEK"
          },
          "financialDimensions": []
        },
        {
          "description": {
            "text": "Bank",
            "languageId": "ENG"
          },
          "accountingAccount": {
            "id": "1920",
            "accountingAccountId": "1920",
            "reference": "1920",
            "standardAccountingAccountId": null,
            "name": "Bank",
            "active": null,
            "postable": null,
            "description": {
              "languageId": "ENG",
              "text": "Main bank account"
            },
            "descriptions": [],
            "accountingAccountTypeCode": null,
            "financialDimensions": []
          },
          "debitAmount": {
            "amount": 0,
            "currencyId": "SEK"
          },
          "creditAmount": {
            "amount": 1000,
            "currencyId": "SEK"
          },
          "financialDimensions": []
        }
      ]
    }
  ]
}

Create a journal

post

Creates a new journal entry for the specified consent.

System support

System	Status
Fortnox	✅ Supported
Bjorn Lunden	✅ Supported
Spiris	✅ Supported
Tripletex	✅ Supported
Visma e-conomic	✅ Supported
Billy	✅ Supported
Visma Dinero	✅ Supported
Procountor	✅ Supported
Visma Netvisor	📞 Not supported / contact us
Microsoft Business Central	📞 Not supported / contact us
Exact Online	📞 Not supported / contact us
QuickBooks	📞 Not supported / contact us
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.

Header parameters

x-correlation-idstring · uuidRequired

Unique identifier used to correlate and trace this request.

Body

Represents input data for creating a journal entry.

referencestring · nullableOptional

Reference identifier for the journal.

transactionDatestring · nullableOptional

Date of the journal transaction.

bookedJournalIndicatorboolean · nullableOptional

Indicates whether the journal should be booked immediately.

Responses

201

The journal was created. Response includes a Location header with the URL of the created resource.

400

The request body or parameters are invalid.

application/json

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

post/api/v1/consents/{consentId}/journals

POST /accounting/api/v1/consents/{consentId}/journals HTTP/1.1
Host: apione.zwapgrid.com
x-api-key: YOUR_API_KEY
x-correlation-id: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 908

{
  "reference": null,
  "transactionDate": null,
  "accountingSeries": {
    "id": null,
    "accountingSeriesId": null
  },
  "description": {
    "text": null,
    "languageId": null
  },
  "bookedJournalIndicator": null,
  "financialDimensions": [
    {
      "id": null,
      "reference": null,
      "type": null,
      "name": null,
      "description": null,
      "isActive": null
    }
  ],
  "accountingEntries": [
    {
      "description": {
        "text": null,
        "languageId": null
      },
      "accountingAccount": {
        "id": null,
        "reference": null,
        "standardAccountingAccountId": null,
        "name": null,
        "active": null,
        "postable": null,
        "descriptions": [
          {
            "text": null,
            "languageId": null
          }
        ],
        "accountingAccountTypeCode": {
          "code": null,
          "listId": null
        },
        "financialDimensions": [
          {
            "id": null,
            "reference": null,
            "type": null,
            "name": null,
            "description": null,
            "isActive": null
          }
        ]
      },
      "debitAmount": {
        "amount": null,
        "currencyId": null
      },
      "creditAmount": {
        "amount": null,
        "currencyId": null
      },
      "financialDimensions": [
        {
          "id": null,
          "reference": null,
          "type": null,
          "name": null,
          "description": null,
          "isActive": null
        }
      ]
    }
  ]
}

No content

Get a journal by ID

get

Retrieves a single journal by its identifier.

System support

System	Status
Fortnox	✅ Supported
Bjorn Lunden	✅ Supported
Spiris	✅ Supported
Tripletex	✅ Supported
Visma e-conomic	📞 Not supported / contact us
Billy	✅ Supported
Visma Dinero	📞 Not supported / contact us
Procountor	✅ Supported
Visma Netvisor	📞 Not supported / contact us
Microsoft Business Central	📞 Not supported / contact us
Exact Online	📞 Not supported / contact us
QuickBooks	📞 Not supported / contact us
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.

journalIdstringRequired

The id of the journal you wish to retrieve.

Header parameters

x-correlation-idstring · uuidRequired

Unique identifier used to correlate and trace this request.

Responses

200

Returns the requested journal.

application/json

Represents a journal entry with its accounting entries.

idstring · nullableOptional

Unique identifier generated by the accounting system.

referencestring · nullableOptional

External reference or number assigned to the journal.

transactionDatestring · nullableOptional

Date when the transaction occurred. Format: yyyy-MM-dd.

401

Missing or invalid authentication credentials.

application/json

403

Not authorized to access this resource.

application/json

404

The requested journal was not found.

application/json

501

This operation is not supported by the connected accounting system.

application/json

get/api/v1/consents/{consentId}/journals/{journalId}

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

{
  "id": "550e8400-e29b-41d4-a716-446655440004",
  "reference": "J-001",
  "transactionDate": "2024-01-01",
  "accountingSeries": {
    "id": "series-1",
    "reference": null,
    "accountingSeriesId": "GJ"
  },
  "description": {
    "text": "January revenue entry",
    "languageId": "ENG"
  },
  "financialDimensions": [
    {
      "id": "97c88337-ef68-46d1-a66d-60276dc31016",
      "reference": "CC-1",
      "type": "costCode",
      "name": null,
      "description": null,
      "isActive": null
    }
  ],
  "accountingEntries": [
    {
      "description": {
        "text": "Sales revenue",
        "languageId": "ENG"
      },
      "accountingAccount": {
        "id": "3001",
        "accountingAccountId": "3001",
        "reference": "3001",
        "standardAccountingAccountId": null,
        "name": "Sales",
        "active": null,
        "postable": null,
        "description": {
          "languageId": "ENG",
          "text": "Sales revenue"
        },
        "descriptions": [],
        "accountingAccountTypeCode": null,
        "financialDimensions": []
      },
      "debitAmount": {
        "amount": 1000,
        "currencyId": "SEK"
      },
      "creditAmount": {
        "amount": 0,
        "currencyId": "SEK"
      },
      "financialDimensions": []
    },
    {
      "description": {
        "text": "Bank",
        "languageId": "ENG"
      },
      "accountingAccount": {
        "id": "1920",
        "accountingAccountId": "1920",
        "reference": "1920",
        "standardAccountingAccountId": null,
        "name": "Bank",
        "active": null,
        "postable": null,
        "description": {
          "languageId": "ENG",
          "text": "Main bank account"
        },
        "descriptions": [],
        "accountingAccountTypeCode": null,
        "financialDimensions": []
      },
      "debitAmount": {
        "amount": 0,
        "currencyId": "SEK"
      },
      "creditAmount": {
        "amount": 1000,
        "currencyId": "SEK"
      },
      "financialDimensions": []
    }
  ]
}