Contribuyentes

Crear contribuyente

POST /api/v1/taxpayers

Campo	Tipo	Requerido	Descripción
nif	string	✅	NIF/CIF del contribuyente
name	string	✅	Razón social
certificate_path	string	❌	Ruta al certificado PKCS#12
certificate_password	string	❌	Contraseña del certificado
is_production	boolean	❌	false = sandbox AEAT (por defecto)

Sin certificado

Si activas el modo Colaborador Social, no necesitas subir tu certificado. La plataforma firmará en tu nombre.

Listar contribuyentes

GET /api/v1/taxpayers

Consultar contribuyente

GET /api/v1/taxpayers/{id}

Actualizar contribuyente

PUT /api/v1/taxpayers/{id}

Eliminar contribuyente

DELETE /api/v1/taxpayers/{id}

Restricción

No puedes eliminar un contribuyente que tenga facturas registradas.