BillptCreateDocument

Descripcion

Crea un documento fiscal en Bill.pt. Soporta los tipos: Fatura (FT), Orcamento (ORC), Fatura-Recibo (FR) y Nota de Credito (NC). Permite especificar contacto, items, serie, moneda y observaciones.

Configuracion

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Bill.pt
type	select	Si	Tipo: FT (Factura), FR (Fatura-Recibo), ORC (Presupuesto), NC (Nota de Credito)
contact_id	text	Si	ID del contacto/cliente destinatario
items	textarea	Si	JSON array de lineas del documento
date	text	No	Fecha YYYY-MM-DD (default: hoy)
due_date	text	No	Fecha de vencimiento YYYY-MM-DD
series_id	text	No	ID de serie de documentos
currency	text	No	Moneda ISO (default: EUR)
observations	textarea	No	Notas del documento

Credenciales

Este modulo requiere una credencial de tipo billpt con los siguientes campos:

• API Token: Token de acceso a la API de Bill.pt

Formato de Items

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

Salida

{
  "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

Ejemplo de Uso

{
  "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"
}

Notas

• El campo items debe ser un JSON array serializado como texto
• Cada item requiere al menos item_id, quantity y price
• El tax_id se puede obtener con el modulo BillptGetTaxes
• El contact_id se puede obtener con el modulo BillptGetContacts
• El series_id se puede obtener con el modulo BillptGetSeries
• La moneda por defecto es EUR

Nodos Relacionados

• BillptGetDocuments - Obtener documentos
• BillptCreateReceipt - Crear recibo para factura
• BillptSendDocumentEmail - Enviar documento por email
• BillptVoidDocument - Anular documento
• BillptGetContacts - Obtener contactos
• BillptGetItems - Obtener articulos
• BillptGetTaxes - Obtener tasas de impuesto
• BillptGetSeries - Obtener series