HubfiscalUpdateDocument

Descripcion

Actualiza uno o mas campos de un documento existente en la base de datos Hub Fiscal. El documento se puede identificar por su ID interno del Hub, el ID de entidad externo (ID de pedido Shopify) o el numero de pedido. Solo los campos con valor se actualizan — los campos vacios se ignoran para no sobreescribir datos existentes.

Casos de uso tipicos:

• Actualizar estado despues de que el proveedor fiscal responda
• Adjuntar el ticket HTML/PDF cuando este disponible
• Registrar mensajes de error cuando la fiscalizacion falla
• Actualizar el numero de documento fiscal despues de que el proveedor lo asigne

Configuracion

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Hub Fiscal SQL Server (MSSQL)
document_id	text	No	ID interno del documento en Hub Fiscal
entity_id	text	No	ID de entidad externo (ID pedido Shopify)
order_number	text	No	Numero de pedido visible (ej: PT14684)
status	select	No	Nuevo estado: pending, processing, completed, failed, voided
fiscal_provider	text	No	Nombre del proveedor fiscal
fiscal_doc_id	text	No	ID del documento en el proveedor fiscal
fiscal_doc_number	text	No	Numero de factura del proveedor fiscal
ticket_html	textarea	No	HTML del ticket. Tambien busca en data.ticket_html, data.html o data.document.html
ticket_pdf	textarea	No	PDF del ticket en base64
contact_name	text	No	Nombre del contacto
contact_nif	text	No	NIF del contacto
contact_email	text	No	Email del contacto
total_net	text	No	Total neto
total_tax	text	No	Total impuestos
total_gross	text	No	Total bruto
error_message	textarea	No	Mensaje de error (para documentos con estado failed)
timeout	text	No	Timeout en milisegundos (default: 30000)

Se requiere al menos un identificador: document_id, entity_id u order_number.

Credenciales

Usa el mismo tipo de credencial que HubfiscalCreateDocument (proveedor hubfiscalCreateDocument).

Salida

{
  "success": true,
  "rows_affected": 1,
  "document": {
    "id": 42,
    "entity_id": "6702987051221",
    "order_number": "PT14684",
    "status": "completed",
    "fiscal_doc_number": "FT 2026/1",
    "total_gross": 19.90
  },
  "fields_updated": ["status", "fiscal_doc_number", "ticket_html"],
  "message": "Documento actualizado (3 campos)"
}

Ejemplo de Uso

Actualizar estado y adjuntar ticket despues de la respuesta de Bill.pt:

{
  "credentials_id": "10",
  "entity_id": "{{id}}",
  "status": "completed",
  "fiscal_doc_number": "{{document_number}}",
  "ticket_html": "{{document.html}}"
}

Marcar un documento como fallido:

{
  "credentials_id": "10",
  "order_number": "PT14684",
  "status": "failed",
  "error_message": "Bill.pt API timeout despues de 30s"
}

Notas

• Solo los campos con valores no vacios se actualizan; los campos vacios se ignoran
• La actualizacion se registra automaticamente en la tabla logs del Hub Fiscal
• Si se proporciona document_id, tiene prioridad sobre entity_id y order_number
• El campo ticket_pdf acepta input en base64 y lo convierte a binario para almacenamiento
• Retorna rows_affected: 0 si el documento no fue encontrado (no lanza error)

Nodos Relacionados

• HubfiscalCreateDocument - Crear/registrar documento
• HubfiscalGetDocuments - Consultar y filtrar documentos
• HubfiscalExportPdf - Exportar tickets PDF/HTML