BillptCreateItem

Description

Creates an item (product or service) in Bill.pt. Items are used as lines in tax documents such as invoices and quotes.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	Bill.pt credential
name	text	Yes	Item name
code	text	No	Code / internal reference
description	text	No	Detailed description
unit_price	number	No	Unit price without taxes
unit	select	No	Unit: UN, KG, M, L, H (default: UN)
tax_id	text	No	Tax rate ID
type	select	No	product or service (default: product)

Credentials

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

• API Token: Bill.pt API access token

Output

{
  "success": true,
  "item": { ... },
  "item_id": 456,
  "message": "Articulo \"Producto XYZ\" creado exitosamente"
}

API

POST /items - https://api.bill.pt

Usage Example

{
  "name": "Servicio de Consultoria",
  "code": "SRV-001",
  "description": "Hora de consultoria tecnica",
  "unit_price": 75.00,
  "unit": "H",
  "tax_id": "1",
  "type": "service"
}

Notes

• The name field is required
• Available units are: UN (unit), KG (kilogram), M (meter), L (liter), H (hour)
• The tax_id can be obtained with the BillptGetTaxes module
• The default type is product

Related Nodes

• BillptGetItems - Get items
• BillptCreateDocument - Create tax document
• BillptGetTaxes - Get tax rates
• BillptGetStock - Check stock