BillptCreateDocument

Description

Creates a tax document in Bill.pt. Supports the following types: Fatura (FT), Orcamento (ORC), Fatura-Recibo (FR) and Nota de Credito (NC). Allows specifying contact, items, series, currency and observations.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	Bill.pt credential
type	select	Yes	Type: FT (Invoice), FR (Invoice-Receipt), ORC (Quote), NC (Credit Note)
contact_id	text	Yes	Recipient contact/customer ID
items	textarea	Yes	JSON array of document lines
date	text	No	Date YYYY-MM-DD (default: today)
due_date	text	No	Due date YYYY-MM-DD
series_id	text	No	Document series ID
currency	text	No	ISO currency (default: EUR)
observations	textarea	No	Document notes

Credentials

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

• API Token: Bill.pt API access token

Items Format

[
  {
    "item_id": 1,
    "quantity": 2,
    "price": 10.00,
    "discount": 0,
    "tax_id": 1,
    "description": "Descripcion opcional"
  }
]

Output

{
  "success": true,
  "document": { ... },
  "document_id": 789,
  "document_number": "FT 2025/1",
  "type": "FT",
  "total": 24.60,
  "message": "Fatura creada exitosamente"
}

API

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

Usage Example

{
  "type": "FT",
  "contact_id": "123",
  "items": "[{\"item_id\": 1, \"quantity\": 2, \"price\": 10.00, \"tax_id\": 1}]",
  "date": "2025-01-15",
  "due_date": "2025-02-15",
  "observations": "Factura mensual de servicios"
}

Notes

• The items field must be a JSON array serialized as text
• Each item requires at least item_id, quantity and price
• The tax_id can be obtained with the BillptGetTaxes module
• The contact_id can be obtained with the BillptGetContacts module
• The series_id can be obtained with the BillptGetSeries module
• The default currency is EUR

Related Nodes

• BillptGetDocuments - Get documents
• BillptCreateReceipt - Create receipt for invoice
• BillptSendDocumentEmail - Send document by email
• BillptVoidDocument - Void document
• BillptGetContacts - Get contacts
• BillptGetItems - Get items
• BillptGetTaxes - Get tax rates
• BillptGetSeries - Get series