SageCreateDocument

Descripción

Crea un documento fiscal en Sage X3 (Factura o Nota de Crédito) insertando registros en las tres tablas contables de Sage: cabecera (YFACTERCAB), línea (YFACTERLIN) y analitica (YFACTERAN). Usa una conexión SQL Server y ejecuta todos los inserts dentro de una transacción atomica.

El nodo mapea el pais a la configuración correcta de Sage (planta, tercero, regimen fiscal, cuentas) basandose en los procedimientos EQZ_MigracionTP_Sage y EQZ_MigracionEcomm_Sage.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Sage SQL Server (MSSQL)
contato	textarea	No	JSON del contacto: {nome, pais, nif}. Si vacío, usa data.contato del nodo anterior
tipificacao	select	No	Tipo documento: FT (Factura), FR (Factura-Recibo), NC (Nota de Crédito). Default: FT
produtos	textarea	No	Array JSON de productos. Si vacío, usa data.produtos del nodo anterior
invoice_date	text	No	Fecha YYYY-MM-DD. Si vacío, usa fecha actual
sage_schema	text	No	Schema de base de datos Sage (default: LIVE)
currency	text	No	Divisa ISO (default: EUR)
canal	text	No	Eje analitico CAN (default: E-COMMERCE)
delegación	text	No	Eje analitico DEL (default: 06)
descripción	text	No	Descripción del documento. Soporta variables {{}}. Auto-generada si vacía
sage_user	text	No	Valor del campo CREUSR (default: ADMIN)
timeout	text	No	Timeout de la consulta en milisegundos (default: 30000)

Credenciales

Este modulo requiere una credencial tipo sageCreateDocument (SQL Server) con:

• host: Hostname o IP del SQL Server
• user: Usuario de base de datos
• password: Contrasena
• database: Nombre de la base de datos
• port: Puerto (default: 1433)
• sage_schema: Nombre del schema (default: LIVE)

Mapeo por Pais

Pais	Planta	Tipo	Tercero	Regimen IVA	Cuenta	Código IVA
PT	22_PT	TPE03	CT-000028	PORT	700050	PT023
ES	22_ES	TPE01	CT-000001	ESPA	700000	ES021

Salida

{
  "success": true,
  "idRegistro": 1234,
  "schema": "LIVE",
  "tercero": "CT-000028",
  "planta": "22_PT",
  "total": 19.90,
  "descripcion": "Ventas Ecomm 05/04/2026",
  "pais": "PT",
  "tipificacao": "FT",
  "fecha": "2026-04-05",
  "message": "Documento Sage creado (ID: 1234) en LIVE.YFACTERCAB"
}

Ejemplo de Uso

Flujo tipico: Webhook Shopify → Decision (pais) → EditFields (mapeo) → SageCreateDocument

{
  "credentials_id": "5",
  "tipificacao": "FT",
  "invoice_date": "{{created_at}}",
  "sage_schema": "LIVE",
  "canal": "E-COMMERCE",
  "delegacion": "06"
}

El nodo lee automáticamente contato y produtos de la salida del nodo anterior.

Notas

• Los tres inserts (YFACTERCAB, YFACTERLIN, YFACTERAN) se ejecutan en una sola transacción con rollback si falla
• El nodo calcula el total desde el array de productos (suma de preco_unitario * quantidade)
• Las Notas de Crédito (NC) usan INVTYP_0 = 2 en vez de 1
• Los ejes analiticos son: PAI (pais), CAN (canal), DEL (delegación), CLI (cliente)
• Si el pais no esta en el mapeo, usa la configuración de Portugal por defecto

Nodos Relacionados

• BillptCreateDocument - Crear documento en Bill.pt
• HubfiscalCreateDocument - Registrar documento en Hub Fiscal
• SqlQueryMSSQL - Ejecutar queries SQL Server directas