Fiskaly Create Invoice

Descripcion

Este modulo es el nodo principal para el envio fiscal mediante Fiskaly SIGN ES. Permite crear nuevas facturas o actualizar existentes utilizando la operacion PUT de la API. Soporta multiples tipos de factura segun la normativa fiscal espanola:

• SIMPLIFIED: Factura simplificada
• COMPLETE: Factura completa
• CORRECTING: Factura rectificativa
• ENRICHMENT: Factura complementaria
• REMEDY: Subsanacion
• EXTERNAL: Factura externa
• DRAFT: Borrador (puede eliminarse posteriormente)

El modulo genera automaticamente un UUID para la factura si no se proporciona. Las lineas de factura se pasan como array JSON con descripcion, cantidad, importe y tipo impositivo. Opcionalmente se puede incluir desglose fiscal, firmante y metadatos adicionales.

El modulo es de tipo hidden (oculto en la interfaz principal).

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Fiskaly
taxpayer_id	text	Si	UUID del contribuyente emisor
invoice_id	text	No	UUID de la factura (auto-generado si vacio)
type	select	Si	Tipo de factura: SIMPLIFIED, COMPLETE, CORRECTING, ENRICHMENT, REMEDY, EXTERNAL, DRAFT
number	text	Si	Numero de factura del emisor
issue_date	text	Si	Fecha de emision (YYYY-MM-DD)
client_id	text	No	UUID del cliente receptor
description	text	No	Descripcion general de la factura
lines	textarea	Si	Array JSON de lineas: [{description, quantity, amount, tax_rate}]
tax_breakdown	textarea	No	Desglose de impuestos en JSON (opcional, calculado desde lineas)
currency	text	No	Codigo de moneda ISO (default: EUR)
total_amount	text	No	Importe total de la factura
signer_id	text	No	UUID del certificado firmante
metadata	textarea	No	Metadatos adicionales en JSON

Credenciales

Requiere credenciales de tipo Fiskaly con:

• api_key: API Key de Fiskaly
• api_secret: API Secret de Fiskaly

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "invoice": { "...datos completos de la factura..." },
    "invoice_id": "550e8400-e29b-41d4-a716-446655440000",
    "state": "SIGNED",
    "type": "COMPLETE",
    "message": "Factura FAC-001 creada/actualizada exitosamente"
  }
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi-fiskaly",
  "taxpayer_id": "uuid-contribuyente",
  "type": "COMPLETE",
  "number": "FAC-2026-001",
  "issue_date": "2026-03-23",
  "lines": "[{\"description\": \"Servicio de consultoria\", \"quantity\": 1, \"amount\": 1000.00, \"tax_rate\": 21}]",
  "client_id": "uuid-cliente-receptor"
}

API Utilizada

• Fiskaly SIGN ES API - PUT /taxpayers/{taxpayer_id}/invoices/{invoice_id}

Notas

• Si no se proporciona invoice_id, se genera un UUIDv4 automaticamente
• El campo lines debe ser un array JSON valido
• La moneda por defecto es EUR; solo se envia si es diferente
• El campo tax_breakdown es opcional y puede calcularse desde las lineas
• Se utiliza PUT (upsert): si la factura ya existe, se actualiza
• Las facturas en estado DRAFT pueden eliminarse con el nodo fiskalyDeleteInvoice

Nodos Relacionados

• FiskalyAuth - Autenticacion
• FiskalyGetInvoices - Obtener facturas
• FiskalyDeleteInvoice - Eliminar factura borrador
• FiskalyExportInvoices - Exportar facturas
• FiskalyUpsertTaxpayer - Crear/actualizar contribuyente
• FiskalyUpsertClient - Crear/actualizar dispositivo
• FiskalyUpsertSigner - Crear/actualizar firmante