BillptCreateContact

Descripcion

Crea un contacto/cliente en la plataforma Bill.pt. Los contactos son necesarios para emitir documentos fiscales como facturas y presupuestos.

Configuracion

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Bill.pt con API Token
name	text	Si	Nombre del contacto o empresa
fiscal_id	text	No	NIF / Numero de identificacion fiscal
email	text	No	Email del contacto
phone	text	No	Telefono del contacto
address	text	No	Direccion postal
city	text	No	Ciudad
zip_code	text	No	Codigo postal (ej: 1000-001)
country	text	No	Codigo ISO del pais (default: PT)

Credenciales

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

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

Salida

{
  "success": true,
  "contact": { ... },
  "contact_id": 123,
  "message": "Contacto \"Empresa XYZ\" creado exitosamente"
}

API

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

Ejemplo de Uso

{
  "name": "Empresa XYZ Lda",
  "fiscal_id": "123456789",
  "email": "contacto@empresa.pt",
  "phone": "+351 210 000 000",
  "address": "Rua Principal 100",
  "city": "Lisboa",
  "zip_code": "1000-001",
  "country": "PT"
}

Notas

• El campo name es obligatorio y puede ser el nombre de una persona o empresa
• El fiscal_id (NIF) es importante para documentos fiscales validos en Portugal
• El codigo de pais por defecto es PT (Portugal)
• Si el contacto ya existe con el mismo NIF, puede producirse un error de duplicado

Nodos Relacionados

• BillptGetContacts - Obtener contactos
• BillptCreateDocument - Crear documento fiscal
• BillptCreateReceipt - Crear recibo