Overview
Bokio
This CDK catalogue package is pinned to @activepieces/piece-bokio@0.1.0 and declares 11 declared actions and no declared triggers. Its definition is derived from the exact reviewed Activepieces source.
Provider runtime verification is recorded separately when an approved test connection is exercised; this catalogue entry does not claim that verification.
Technical guide
Technical reference
- Package:
@activepieces/piece-bokio@0.1.0 - Exact artifact digest:
sha256:9dae787678773948c589d6d51b918ebc616ed65827b1071fd00549a522b25a96 - Source: the exact reviewed Activepieces source
- Authentication, action and trigger schemas are taken from the exact pinned package.
Capability summary
Authentication
Authentication method: custom
Authentication profiles
connection · custom
- Company ID Required
- API Key Required · protected credential
Supported objects
| Object | Read | Write | Notes |
|---|---|---|---|
| Create Customer | Yes | No | |
| Create Invoice | Yes | No | |
| Add line item to invoice | Yes | No | |
| Create an item | Yes | No | |
| Create a journal entry | Yes | No | |
| Update an invoice | Yes | No | |
| Find Customer | Yes | No | |
| Get Draft Invoice by Customer Name | Yes | No | |
| Get an invoice | Yes | No | |
| Get a journal entry | Yes | No | |
| Custom API Call | Yes | No |
Supported actions
Create Customer · Read
Creates a new customer in Bokio
create_customer · Risk: low · Retry: safe
Inputs
customerName· string · Required, Name of the customertype· string · Required, Type of the customervatNumber· string · Optional, Customer VAT numberorgNumber· string · Optional, Customer organization numberpaymentTerms· string · Optional, Payment terms for the customer. Payment terms for the invoices. Payment terms can both take free text or days, in digits, until the payment is due.customerNumber· string · Optional, Customer number (optional)email· string · Optional, Customer email addressphone· string · Optional, Customer phone numberlin1· string · Optional, Customer address line 1line2· string · Optional, Customer address line 2zipCode· string · Optional, Customer zip codecity· string · Optional, Customer citycountry· string · Optional, Customer country (ISO 3166-1 alpha-2 country code)
Create Invoice · Read
Creates a new draft invoice in Bokio
create_invoice · Risk: low · Retry: safe
Inputs
invoiceType· string · Optional, Type of invoicecustomerRef· string · Optional, UUID of the customerinvoiceDate· string · Required, Invoice date (YYYY-MM-DD)dueDate· string · Required, Due date (YYYY-MM-DD)orderNumberReference· string · Optional, The order number associated with the invoicecurrency· string · Optional, ISO 4217 currency code (e.g., SEK, EUR, USD)currencyRate· number · Optional, Currency rate (defaults to 1)itemType· string · Required, Type of the line itemdynamicProps· object · Optional, Configure item details based on item type
Add line item to invoice · Read
Adds a line item to an existing draft invoice
add_line_item_to_invoice · Risk: low · Retry: safe
Inputs
invoiceId· string · Required, Select the invoiceitemType· string · Required, Type of the itemdynamicProps· object · Optional, Configure item details based on item type
Create an item · Read
Creates a new item in Bokio
create_an_item · Risk: low · Retry: safe
Inputs
itemType· string · Required, Type of the itemdynamicProps· object · Optional, Configure item details based on item type
Create a journal entry · Read
Creates a new journal entry in Bokio
create_ajournal_entry · Risk: low · Retry: safe
Inputs
title· string · Optional, Title of the journal entrydate· string · Required, Journal entry date (YYYY-MM-DD)items· array · Optional, Journal entry items as JSON array. Each item should have: account (account number), debit (optional), credit (optional)
Update an invoice · Read
Updates an existing draft invoice in Bokio
update_an_invoice · Risk: low · Retry: safe
Inputs
invoiceId· string · Required, Select the invoiceinvoiceType· string · Optional, Type of invoicecustomerRef· string · Optional, UUID of the customerinvoiceDate· string · Required, Invoice date (YYYY-MM-DD)dueDate· string · Required, Due date (YYYY-MM-DD)orderNumberReference· string · Optional, The order number associated with the invoicecurrency· string · Optional, ISO 4217 currency code (e.g., SEK, EUR, USD)currencyRate· number · Optional, Currency ratelineItemsJson· string · Optional, Line items as JSON array. Each item should have: itemRef (object with id), description, quantity, unitPrice, unit, itemType (PRODUCT or SERVICE), vat
Find Customer · Read
Find customers in Bokio by filtering and pagination
find_customer · Risk: low · Retry: safe
Inputs
filterType· string · Optional, Type of filter to usefilterValue· string · Optional, Value to filter bypage· number · Optional, Page number (defaults to 1)pageSize· number · Optional, Number of items per page (max 100, defaults to 25)
Get Draft Invoice by Customer Name · Read
Get all draft invoices for a customer by customer name
get_draft_invoice_by_customer_name · Risk: low · Retry: safe
Inputs
customerName· string · Required, Name of the customer to find draft invoices forpage· number · Optional, Page number (defaults to 1)pageSize· number · Optional, Number of items per page (max 100, defaults to 25)
Get an invoice · Read
Retrieve a specific invoice by its ID
get_an_invoice · Risk: low · Retry: safe
Inputs
invoiceId· string · Required, The ID of the invoice to retrieve
Get a journal entry · Read
Retrieve a specific journal entry by its ID
get_ajournal_entry · Risk: low · Retry: safe
Inputs
journalEntryId· string · Required, UUID of the journal entry
Custom API Call · Read
Make a custom API call to a specific endpoint
custom_api_call · Risk: low · Retry: safe
Inputs
url· object · Requiredmethod· string · Requiredheaders· object · Optional, Authorization headers are injected automatically from your connection.queryParams· object · Optional, Appended to the URL as ?key=value.body_type· string · Optionalbody· object · Optionalresponse_is_binary· boolean · Optional, Enable for files like PDFs, images, etc.failsafe· boolean · Optional, On a failed request, output the error instead of failing the step.timeout· number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).followRedirects· boolean · Optional, Follow 3xx redirects instead of returning them as the response.
Setup
Setup
Create a tenant connection only in the consuming Studio instance when this connector is made available there. Credentials remain in that tenant's Vault-backed connection and are not stored in CDK package metadata.
Limitations
The package has passed deterministic offline package-load and contract validation. No provider credentials, provider API call or live webhook delivery is represented by this release state.