BillptGetItems

Description

Gets items/products from Bill.pt. Supports getting one by ID or listing with pagination and search by name or code.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	Bill.pt credential
item_id	text	No	Item ID (if empty, lists all)
search	text	No	Text to filter by name or code
per_page	number	No	Results per page (default: 50)
page	number	No	Page number (default: 1)

Credentials

This module requires a billpt type credential with the following fields:

• API Token: Bill.pt API access token

Output

{
  "success": true,
  "items": [ ... ],
  "total": 80,
  "page": 1
}

API

• GET /items/{id} - Individual item
• GET /items - List items

Usage Example

Get item by ID

{
  "item_id": "456"
}

Search items

{
  "search": "Consultoria",
  "per_page": 50
}

Notes

• If item_id is provided, a single item is returned
• The search field filters by name and reference code
• Retrieved items include price, unit and tax rate

Related Nodes

• BillptCreateItem - Create item
• BillptCreateDocument - Create tax document
• BillptGetStock - Check stock
• BillptGetTaxes - Get tax rates