Clients

Use client to sync customer records from an external platform.

Create or Update

curl https://api.factulit.es/api/v1/client \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: factulit_test_key" \
  -d '{
    "id_external": "customer-1001",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "email": "ada@example.test",
    "country": "ES",
    "active": true
  }'

id_external is the stable customer identifier from your platform. Factulit scopes it to the authenticated integration and business.

Fiscal Fields

When available, include vat_number, tax_id_type, vat_status, and customer_type. These fields help Factulit choose the correct invoice flow when the client is attached to an order.