@disruptive-learning/n8n-nodes-gigstack 1.1.8 → 1.2.0

package/dist/nodes/Gigstack/Gigstack.node.js

@@ -10,6 +10,7 @@ const ReceiptDescription_1 = require("./descriptions/ReceiptDescription");
 const TeamDescription_1 = require("./descriptions/TeamDescription");
 const UserDescription_1 = require("./descriptions/UserDescription");
 const WebhookDescription_1 = require("./descriptions/WebhookDescription");
+const DescargarMasivaDescription_1 = require("./descriptions/DescargarMasivaDescription");
 class Gigstack {
     constructor() {
         this.description = {
@@ -70,6 +71,10 @@ class Gigstack {
                             name: 'Webhook',
                             value: 'webhook',
                         },
+                        {
+                            name: 'Descarga Masiva (SAT)',
+                            value: 'descargarMasiva',
+                        },
                     ],
                     default: 'client',
                 },
@@ -90,6 +95,8 @@ class Gigstack {
                 ...UserDescription_1.userFields,
                 ...WebhookDescription_1.webhookOperations,
                 ...WebhookDescription_1.webhookFields,
+                ...DescargarMasivaDescription_1.descargarMasivaOperations,
+                ...DescargarMasivaDescription_1.descargarMasivaFields,
             ],
         };
     }
@@ -233,6 +240,11 @@ class Gigstack {
                         const clientId = this.getNodeParameter('clientId', i);
                         responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', `/clients/${clientId}/stamp-pending-receipts`, {}, qs);
                     }
+                    else if (operation === 'getSupportDocuments') {
+                        const clientId = this.getNodeParameter('clientId', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/clients/${clientId}/support-documents`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
                 }
                 // =====================
                 // SERVICE OPERATIONS
@@ -451,6 +463,144 @@ class Gigstack {
                         responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/invoices/${invoiceId}/files`, {}, qs);
                         responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
                     }
+                    else if (operation === 'createDraft') {
+                        const clientId = this.getNodeParameter('clientId', i);
+                        const itemsData = this.getNodeParameter('items', i);
+                        const additionalFields = this.getNodeParameter('additionalFields', i);
+                        const draftItems = itemsData.itemValues || [];
+                        const processedDraftItems = draftItems.map((item) => {
+                            const p = {};
+                            if (item.id)
+                                p.id = item.id;
+                            if (item.description)
+                                p.description = item.description;
+                            if (item.quantity)
+                                p.quantity = item.quantity;
+                            if (item.unit_price)
+                                p.unit_price = item.unit_price;
+                            if (item.product_key)
+                                p.product_key = item.product_key;
+                            if (item.unit_key)
+                                p.unit_key = item.unit_key;
+                            if (item.includeIva) {
+                                p.taxes = [{ type: 'IVA', rate: 0.16, factor: 'Tasa', withholding: false }];
+                            }
+                            return p;
+                        });
+                        const body = {
+                            client: { id: clientId },
+                            items: processedDraftItems,
+                        };
+                        if (additionalFields.currency)
+                            body.currency = additionalFields.currency;
+                        if (additionalFields.exchange_rate)
+                            body.exchange_rate = additionalFields.exchange_rate;
+                        if (additionalFields.payment_method)
+                            body.payment_method = additionalFields.payment_method;
+                        if (additionalFields.payment_form)
+                            body.payment_form = additionalFields.payment_form;
+                        if (additionalFields.use)
+                            body.use = additionalFields.use;
+                        if (additionalFields.series)
+                            body.series = additionalFields.series;
+                        if (additionalFields.metadata) {
+                            body.metadata = JSON.parse(additionalFields.metadata);
+                        }
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', '/invoices/draft', body, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'getDraft') {
+                        const draftId = this.getNodeParameter('draftId', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/invoices/draft/${draftId}`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'getAllDrafts') {
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (returnAll) {
+                            responseData = await GenericFunctions_1.gigstackApiRequestAllItems.call(this, 'GET', '/invoices/draft', {}, qs);
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            qs.limit = limit;
+                            const response = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', '/invoices/draft', {}, qs);
+                            responseData = response.data || [];
+                        }
+                    }
+                    else if (operation === 'updateDraft') {
+                        const draftId = this.getNodeParameter('draftId', i);
+                        const updateFields = this.getNodeParameter('updateFields', i);
+                        const body = {};
+                        if (updateFields.currency)
+                            body.currency = updateFields.currency;
+                        if (updateFields.exchange_rate)
+                            body.exchange_rate = updateFields.exchange_rate;
+                        if (updateFields.payment_method)
+                            body.payment_method = updateFields.payment_method;
+                        if (updateFields.payment_form)
+                            body.payment_form = updateFields.payment_form;
+                        if (updateFields.use)
+                            body.use = updateFields.use;
+                        if (updateFields.series)
+                            body.series = updateFields.series;
+                        if (updateFields.metadata) {
+                            body.metadata = JSON.parse(updateFields.metadata);
+                        }
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'PUT', `/invoices/draft/${draftId}`, body, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'deleteDraft') {
+                        const draftId = this.getNodeParameter('draftId', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'DELETE', `/invoices/draft/${draftId}`, {}, qs);
+                    }
+                    else if (operation === 'stampDraft') {
+                        const draftId = this.getNodeParameter('draftId', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', `/invoices/draft/${draftId}/stamp`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'previewDraft') {
+                        const draftId = this.getNodeParameter('draftId', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', `/invoices/draft/${draftId}/preview`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'getAllSat') {
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        const filters = this.getNodeParameter('filters', i);
+                        if (filters.type)
+                            qs.type = filters.type;
+                        if (filters.status)
+                            qs.status = filters.status;
+                        if (filters.rfc)
+                            qs.rfc = filters.rfc;
+                        if (returnAll) {
+                            responseData = await GenericFunctions_1.gigstackApiRequestAllItems.call(this, 'GET', '/invoices/sat', {}, qs);
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            qs.limit = limit;
+                            const response = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', '/invoices/sat', {}, qs);
+                            responseData = response.data || [];
+                        }
+                    }
+                    else if (operation === 'getSat') {
+                        const satUuid = this.getNodeParameter('satUuid', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/invoices/sat/${satUuid}`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'retryXmlSat') {
+                        const satUuid = this.getNodeParameter('satUuid', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', `/invoices/sat/${satUuid}/retry-xml`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'generatePdfSat') {
+                        const satUuid = this.getNodeParameter('satUuid', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', `/invoices/sat/${satUuid}/pdf`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'getSupportDocuments') {
+                        const invoiceId = this.getNodeParameter('invoiceId', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/invoices/${invoiceId}/support-documents`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
                 }
                 // =====================
                 // PAYMENT OPERATIONS
@@ -575,6 +725,11 @@ class Gigstack {
                         responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', `/payments/${paymentId}/refund`, body, qs);
                         responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
                     }
+                    else if (operation === 'getSupportDocuments') {
+                        const paymentId = this.getNodeParameter('paymentId', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/payments/${paymentId}/support-documents`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
                 }
                 // =====================
                 // RECEIPT OPERATIONS
@@ -595,13 +750,29 @@ class Gigstack {
                         };
                         if (additionalFields.currency)
                             body.currency = additionalFields.currency;
+                        if (additionalFields.exchange_rate)
+                            body.exchange_rate = additionalFields.exchange_rate;
                         if (additionalFields.periodicity)
                             body.periodicity = additionalFields.periodicity;
                         if (additionalFields.payment_form)
                             body.payment_form = additionalFields.payment_form;
+                        if (additionalFields.idempotency_key)
+                            body.idempotency_key = additionalFields.idempotency_key;
                         if (additionalFields.metadata) {
                             body.metadata = JSON.parse(additionalFields.metadata);
                         }
+                        // Handle invoice_config
+                        const invoiceConfig = this.getNodeParameter('invoiceConfig', i, {});
+                        if (invoiceConfig && Object.keys(invoiceConfig).length > 0) {
+                            const config = {};
+                            if (invoiceConfig.serie)
+                                config.serie = invoiceConfig.serie;
+                            if (invoiceConfig.folio && invoiceConfig.folio !== 0)
+                                config.folio = invoiceConfig.folio;
+                            if (Object.keys(config).length > 0) {
+                                body.invoice_config = config;
+                            }
+                        }
                         responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', '/receipts', body, qs);
                         responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
                     }
@@ -942,6 +1113,73 @@ class Gigstack {
                         responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'DELETE', `/webhooks/${webhookId}`, {}, qs);
                     }
                 }
+                // =====================
+                // DESCARGA MASIVA OPERATIONS
+                // =====================
+                else if (resource === 'descargarMasiva') {
+                    if (operation === 'getActivationStatus') {
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', '/invoices/download/activate/status', {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'activate') {
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', '/invoices/download/activate', {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'deactivate') {
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', '/invoices/download/deactivate', {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'createRequest') {
+                        const date_from = this.getNodeParameter('date_from', i);
+                        const date_to = this.getNodeParameter('date_to', i);
+                        const type = this.getNodeParameter('type', i);
+                        const additionalFields = this.getNodeParameter('additionalFields', i);
+                        const body = { date_from, date_to, type };
+                        if (additionalFields.rfc)
+                            body.rfc = additionalFields.rfc;
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', '/invoices/download/request', body, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'getRequestStatus') {
+                        const request_id = this.getNodeParameter('request_id', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/invoices/download/status/${request_id}`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'downloadPackage') {
+                        const package_id = this.getNodeParameter('package_id', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/invoices/download/package/${package_id}`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'getSchedule') {
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', '/invoices/download/schedule', {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'updateSchedule') {
+                        const enabled = this.getNodeParameter('enabled', i);
+                        const hour = this.getNodeParameter('hour', i);
+                        const types = this.getNodeParameter('types', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'PUT', '/invoices/download/schedule', { enabled, hour, types }, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'getScheduleHistory') {
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', '/invoices/download/schedule/history', {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'getInvoiceByUuid') {
+                        const uuid = this.getNodeParameter('uuid', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'GET', `/invoices/download/invoice/${uuid}`, {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'enableSync') {
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'POST', '/invoices/download/enable-sync', {}, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                    else if (operation === 'updateSyncPeriod') {
+                        const sync_from = this.getNodeParameter('sync_from', i);
+                        responseData = await GenericFunctions_1.gigstackApiRequest.call(this, 'PUT', '/invoices/download/sync-period', { sync_from }, qs);
+                        responseData = (0, GenericFunctions_1.simplifyResponse)(responseData);
+                    }
+                }
                 // Return data
                 if (Array.isArray(responseData)) {
                     returnData.push(...responseData.map((item) => ({ json: item })));

package/dist/nodes/Gigstack/descriptions/ClientDescription.js

@@ -49,6 +49,12 @@ exports.clientOperations = [
                 description: 'Stamp all pending receipts for a client',
                 action: 'Stamp pending receipts',
             },
+            {
+                name: 'Get Support Documents',
+                value: 'getSupportDocuments',
+                description: 'List support documents attached to a client',
+                action: 'Get client support documents',
+            },
             {
                 name: 'Update',
                 value: 'update',
@@ -326,7 +332,7 @@ exports.clientFields = [
         displayOptions: {
             show: {
                 resource: ['client'],
-                operation: ['get', 'update', 'delete', 'validate', 'stampPendingReceipts'],
+                operation: ['get', 'update', 'delete', 'validate', 'stampPendingReceipts', 'getSupportDocuments'],
             },
         },
         description: 'The ID of the client',

package/dist/nodes/Gigstack/descriptions/DescargarMasivaDescription.d.ts

@@ -0,0 +1,3 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const descargarMasivaOperations: INodeProperties[];
+export declare const descargarMasivaFields: INodeProperties[];

package/dist/nodes/Gigstack/descriptions/DescargarMasivaDescription.js

@@ -0,0 +1,301 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.descargarMasivaFields = exports.descargarMasivaOperations = void 0;
+exports.descargarMasivaOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+            },
+        },
+        options: [
+            {
+                name: 'Activate',
+                value: 'activate',
+                description: 'Activate Descarga Masiva (enables SAT bulk download billing)',
+                action: 'Activate descarga masiva',
+            },
+            {
+                name: 'Create Download Request',
+                value: 'createRequest',
+                description: 'Create a SAT bulk download request (max 1 month range per request)',
+                action: 'Create a download request',
+            },
+            {
+                name: 'Deactivate',
+                value: 'deactivate',
+                description: 'Deactivate Descarga Masiva',
+                action: 'Deactivate descarga masiva',
+            },
+            {
+                name: 'Enable Auto Sync',
+                value: 'enableSync',
+                description: 'Enable automatic SAT synchronization',
+                action: 'Enable auto sync',
+            },
+            {
+                name: 'Get Activation Status',
+                value: 'getActivationStatus',
+                description: 'Check activation status and billing info for Descarga Masiva',
+                action: 'Get activation status',
+            },
+            {
+                name: 'Get Invoice By UUID',
+                value: 'getInvoiceByUuid',
+                description: 'Fetch a single CFDI from SAT by UUID',
+                action: 'Get invoice by UUID',
+            },
+            {
+                name: 'Get Package',
+                value: 'downloadPackage',
+                description: 'Download a ZIP package of XML files by package ID',
+                action: 'Get a download package',
+            },
+            {
+                name: 'Get Request Status',
+                value: 'getRequestStatus',
+                description: 'Check the status of a download request',
+                action: 'Get request status',
+            },
+            {
+                name: 'Get Schedule',
+                value: 'getSchedule',
+                description: 'Get current download schedule config and FIEL/registration status',
+                action: 'Get download schedule',
+            },
+            {
+                name: 'Get Schedule History',
+                value: 'getScheduleHistory',
+                description: 'Get the last 20 scheduled download requests with live SAT status',
+                action: 'Get schedule history',
+            },
+            {
+                name: 'Update Schedule',
+                value: 'updateSchedule',
+                description: 'Save or update the daily download schedule',
+                action: 'Update download schedule',
+            },
+            {
+                name: 'Update Sync Period',
+                value: 'updateSyncPeriod',
+                description: 'Update the sync start date (defaults to 71 months ago)',
+                action: 'Update sync period',
+            },
+        ],
+        default: 'getActivationStatus',
+    },
+];
+exports.descargarMasivaFields = [
+    // ----------------------------------
+    //   descargarMasiva: createRequest
+    // ----------------------------------
+    {
+        displayName: 'Date From',
+        name: 'date_from',
+        type: 'string',
+        required: true,
+        default: '',
+        placeholder: 'YYYY-MM-DD',
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['createRequest'],
+            },
+        },
+        description: 'Start date for the download request (YYYY-MM-DD format). Max range is 1 month.',
+    },
+    {
+        displayName: 'Date To',
+        name: 'date_to',
+        type: 'string',
+        required: true,
+        default: '',
+        placeholder: 'YYYY-MM-DD',
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['createRequest'],
+            },
+        },
+        description: 'End date for the download request (YYYY-MM-DD format). Max range is 1 month.',
+    },
+    {
+        displayName: 'CFDI Type',
+        name: 'type',
+        type: 'options',
+        required: true,
+        options: [
+            { name: 'Received - CFDIs received by the business', value: 'received' },
+            { name: 'Issued - CFDIs issued by the business', value: 'issued' },
+        ],
+        default: 'received',
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['createRequest'],
+            },
+        },
+        description: 'Whether to download CFDIs received or issued by the business',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['createRequest'],
+            },
+        },
+        options: [
+            {
+                displayName: 'RFC Filter',
+                name: 'rfc',
+                type: 'string',
+                default: '',
+                description: 'Filter by a specific RFC (counterpart RFC for received, or your own for issued)',
+            },
+        ],
+    },
+    // ----------------------------------
+    //   descargarMasiva: getRequestStatus
+    // ----------------------------------
+    {
+        displayName: 'Request ID',
+        name: 'request_id',
+        type: 'string',
+        required: true,
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['getRequestStatus'],
+            },
+        },
+        description: 'The ID of the download request to check',
+    },
+    // ----------------------------------
+    //   descargarMasiva: downloadPackage
+    // ----------------------------------
+    {
+        displayName: 'Package ID',
+        name: 'package_id',
+        type: 'string',
+        required: true,
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['downloadPackage'],
+            },
+        },
+        description: 'The package ID to download (obtained from a completed download request)',
+    },
+    // ----------------------------------
+    //   descargarMasiva: getInvoiceByUuid
+    // ----------------------------------
+    {
+        displayName: 'UUID',
+        name: 'uuid',
+        type: 'string',
+        required: true,
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['getInvoiceByUuid'],
+            },
+        },
+        description: 'The UUID of the CFDI to fetch from SAT',
+    },
+    // ----------------------------------
+    //   descargarMasiva: updateSchedule
+    // ----------------------------------
+    {
+        displayName: 'Enabled',
+        name: 'enabled',
+        type: 'boolean',
+        required: true,
+        default: true,
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['updateSchedule'],
+            },
+        },
+        description: 'Whether to enable the daily download schedule',
+    },
+    {
+        displayName: 'Download Hour (UTC)',
+        name: 'hour',
+        type: 'number',
+        default: 3,
+        typeOptions: {
+            minValue: 0,
+            maxValue: 23,
+        },
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['updateSchedule'],
+            },
+        },
+        description: 'Hour of day (UTC, 0-23) to run the scheduled download',
+    },
+    {
+        displayName: 'CFDI Types to Download',
+        name: 'types',
+        type: 'multiOptions',
+        options: [
+            { name: 'Received', value: 'received' },
+            { name: 'Issued', value: 'issued' },
+        ],
+        default: ['received', 'issued'],
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['updateSchedule'],
+            },
+        },
+        description: 'Which CFDI types to include in scheduled downloads',
+    },
+    // ----------------------------------
+    //   descargarMasiva: updateSyncPeriod
+    // ----------------------------------
+    {
+        displayName: 'Sync Start Date',
+        name: 'sync_from',
+        type: 'string',
+        required: true,
+        default: '',
+        placeholder: 'YYYY-MM-DD',
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+                operation: ['updateSyncPeriod'],
+            },
+        },
+        description: 'The date from which to start syncing CFDIs (YYYY-MM-DD). SAT allows up to 71 months back.',
+    },
+    // ----------------------------------
+    //   descargarMasiva: Common - Team
+    // ----------------------------------
+    {
+        displayName: 'Team ID',
+        name: 'team',
+        type: 'string',
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['descargarMasiva'],
+            },
+        },
+        description: 'Team ID for Gigstack Connect (multi-team access). Leave empty to use default team.',
+    },
+];

package/dist/nodes/Gigstack/descriptions/InvoiceDescription.js

@@ -61,6 +61,78 @@ exports.invoiceOperations = [
                 description: 'Get many payment complement invoices (CFDI type P)',
                 action: 'Get many payment invoices',
             },
+            {
+                name: 'Create Draft',
+                value: 'createDraft',
+                description: 'Create a draft invoice (not stamped yet)',
+                action: 'Create a draft invoice',
+            },
+            {
+                name: 'Delete Draft',
+                value: 'deleteDraft',
+                description: 'Delete a draft invoice',
+                action: 'Delete a draft invoice',
+            },
+            {
+                name: 'Get Draft',
+                value: 'getDraft',
+                description: 'Get a draft invoice by ID',
+                action: 'Get a draft invoice',
+            },
+            {
+                name: 'Get Many Drafts',
+                value: 'getAllDrafts',
+                description: 'Get many draft invoices',
+                action: 'Get many draft invoices',
+            },
+            {
+                name: 'Preview Draft',
+                value: 'previewDraft',
+                description: 'Generate a preview PDF for a draft invoice',
+                action: 'Preview a draft invoice',
+            },
+            {
+                name: 'Stamp Draft',
+                value: 'stampDraft',
+                description: 'Stamp (finalize) a draft into a real CFDI invoice',
+                action: 'Stamp a draft invoice',
+            },
+            {
+                name: 'Update Draft',
+                value: 'updateDraft',
+                description: 'Update a draft invoice',
+                action: 'Update a draft invoice',
+            },
+            {
+                name: 'Get Many SAT Invoices',
+                value: 'getAllSat',
+                description: 'Get many SAT invoices downloaded via Descarga Masiva',
+                action: 'Get many SAT invoices',
+            },
+            {
+                name: 'Get SAT Invoice',
+                value: 'getSat',
+                description: 'Get a single SAT invoice by UUID',
+                action: 'Get a SAT invoice',
+            },
+            {
+                name: 'Generate SAT Invoice PDF',
+                value: 'generatePdfSat',
+                description: 'Generate a PDF for a received SAT invoice',
+                action: 'Generate SAT invoice PDF',
+            },
+            {
+                name: 'Retry SAT Invoice XML',
+                value: 'retryXmlSat',
+                description: 'Retry XML download for a stuck or errored SAT invoice',
+                action: 'Retry SAT invoice XML',
+            },
+            {
+                name: 'Get Support Documents',
+                value: 'getSupportDocuments',
+                description: 'List support documents attached to an invoice',
+                action: 'Get invoice support documents',
+            },
         ],
         default: 'getAllIncome',
     },
@@ -539,6 +611,372 @@ exports.invoiceFields = [
         ],
     },
     // ----------------------------------
+    //         invoice: Draft operations
+    // ----------------------------------
+    {
+        displayName: 'Client ID',
+        name: 'clientId',
+        type: 'string',
+        required: true,
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['createDraft'],
+            },
+        },
+        description: 'The ID of the client for this draft invoice',
+    },
+    {
+        displayName: 'Items',
+        name: 'items',
+        type: 'fixedCollection',
+        typeOptions: {
+            multipleValues: true,
+            minValue: 1,
+        },
+        required: true,
+        default: { itemValues: [{}] },
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['createDraft'],
+            },
+        },
+        placeholder: 'Add Item',
+        options: [
+            {
+                name: 'itemValues',
+                displayName: 'Item',
+                values: [
+                    {
+                        displayName: 'Description',
+                        name: 'description',
+                        type: 'string',
+                        default: '',
+                    },
+                    {
+                        displayName: 'Quantity',
+                        name: 'quantity',
+                        type: 'number',
+                        default: 1,
+                    },
+                    {
+                        displayName: 'Unit Price',
+                        name: 'unit_price',
+                        type: 'number',
+                        default: 0,
+                        typeOptions: { numberPrecision: 2 },
+                    },
+                    {
+                        displayName: 'Product Key (SAT)',
+                        name: 'product_key',
+                        type: 'string',
+                        default: '80141503',
+                    },
+                    {
+                        displayName: 'Unit Key (SAT)',
+                        name: 'unit_key',
+                        type: 'string',
+                        default: 'E48',
+                    },
+                    {
+                        displayName: 'Service ID',
+                        name: 'id',
+                        type: 'string',
+                        default: '',
+                        description: 'Service ID to use (inherits service properties)',
+                    },
+                    {
+                        displayName: 'Include IVA 16%',
+                        name: 'includeIva',
+                        type: 'boolean',
+                        default: true,
+                    },
+                ],
+            },
+        ],
+        description: 'Draft invoice line items',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['createDraft'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Currency',
+                name: 'currency',
+                type: 'options',
+                options: [
+                    { name: 'MXN - Mexican Peso', value: 'MXN' },
+                    { name: 'USD - US Dollar', value: 'USD' },
+                    { name: 'EUR - Euro', value: 'EUR' },
+                ],
+                default: 'MXN',
+            },
+            {
+                displayName: 'Exchange Rate',
+                name: 'exchange_rate',
+                type: 'number',
+                default: 1,
+                typeOptions: { numberPrecision: 4 },
+            },
+            {
+                displayName: 'Payment Method',
+                name: 'payment_method',
+                type: 'options',
+                options: [
+                    { name: 'PUE - Pago en Una Exhibicion', value: 'PUE' },
+                    { name: 'PPD - Pago en Parcialidades o Diferido', value: 'PPD' },
+                ],
+                default: 'PUE',
+            },
+            {
+                displayName: 'Payment Form',
+                name: 'payment_form',
+                type: 'string',
+                default: '03',
+                description: 'SAT payment form code (e.g. 03 for transfer)',
+            },
+            {
+                displayName: 'CFDI Use',
+                name: 'use',
+                type: 'string',
+                default: 'G03',
+                description: 'CFDI use code (e.g. G03)',
+            },
+            {
+                displayName: 'Series',
+                name: 'series',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'Metadata',
+                name: 'metadata',
+                type: 'json',
+                default: '{}',
+            },
+        ],
+    },
+    // Draft ID field (get, update, delete, stamp, preview)
+    {
+        displayName: 'Draft ID',
+        name: 'draftId',
+        type: 'string',
+        required: true,
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['getDraft', 'updateDraft', 'deleteDraft', 'stampDraft', 'previewDraft'],
+            },
+        },
+        description: 'The ID of the draft invoice',
+    },
+    // updateDraft fields
+    {
+        displayName: 'Update Fields',
+        name: 'updateFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['updateDraft'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Currency',
+                name: 'currency',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'Exchange Rate',
+                name: 'exchange_rate',
+                type: 'number',
+                default: 1,
+                typeOptions: { numberPrecision: 4 },
+            },
+            {
+                displayName: 'Payment Method',
+                name: 'payment_method',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'Payment Form',
+                name: 'payment_form',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'CFDI Use',
+                name: 'use',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'Series',
+                name: 'series',
+                type: 'string',
+                default: '',
+            },
+            {
+                displayName: 'Metadata',
+                name: 'metadata',
+                type: 'json',
+                default: '{}',
+            },
+        ],
+    },
+    // getAllDrafts
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        default: false,
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['getAllDrafts'],
+            },
+        },
+        description: 'Whether to return all results or only up to a given limit',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        typeOptions: { minValue: 1, maxValue: 100 },
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['getAllDrafts'],
+                returnAll: [false],
+            },
+        },
+        description: 'Max number of results to return',
+    },
+    // ----------------------------------
+    //         invoice: SAT Invoices
+    // ----------------------------------
+    {
+        displayName: 'UUID',
+        name: 'satUuid',
+        type: 'string',
+        required: true,
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['getSat', 'retryXmlSat', 'generatePdfSat'],
+            },
+        },
+        description: 'The UUID of the SAT invoice',
+    },
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        default: false,
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['getAllSat'],
+            },
+        },
+        description: 'Whether to return all results or only up to a given limit',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        typeOptions: { minValue: 1, maxValue: 100 },
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['getAllSat'],
+                returnAll: [false],
+            },
+        },
+        description: 'Max number of results to return',
+    },
+    {
+        displayName: 'Filters',
+        name: 'filters',
+        type: 'collection',
+        placeholder: 'Add Filter',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['getAllSat'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Type',
+                name: 'type',
+                type: 'options',
+                options: [
+                    { name: 'Received', value: 'received' },
+                    { name: 'Issued', value: 'issued' },
+                ],
+                default: '',
+                description: 'Filter by CFDI direction',
+            },
+            {
+                displayName: 'Status',
+                name: 'status',
+                type: 'options',
+                options: [
+                    { name: 'Valid', value: 'valid' },
+                    { name: 'Canceled', value: 'canceled' },
+                    { name: 'Error', value: 'error' },
+                ],
+                default: '',
+            },
+            {
+                displayName: 'RFC',
+                name: 'rfc',
+                type: 'string',
+                default: '',
+                description: 'Filter by counterpart RFC',
+            },
+        ],
+    },
+    // ----------------------------------
+    //         invoice: Support Documents
+    // ----------------------------------
+    {
+        displayName: 'Invoice ID',
+        name: 'invoiceId',
+        type: 'string',
+        required: true,
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['invoice'],
+                operation: ['getSupportDocuments'],
+            },
+        },
+        description: 'The ID of the invoice',
+    },
+    // ----------------------------------
     //         invoice: Common - Team
     // ----------------------------------
     {

package/dist/nodes/Gigstack/descriptions/PaymentDescription.js

@@ -43,6 +43,12 @@ exports.paymentOperations = [
                 description: 'Refund a payment',
                 action: 'Refund a payment',
             },
+            {
+                name: 'Get Support Documents',
+                value: 'getSupportDocuments',
+                description: 'List support documents attached to a payment',
+                action: 'Get payment support documents',
+            },
             {
                 name: 'Register',
                 value: 'register',
@@ -292,7 +298,7 @@ exports.paymentFields = [
         displayOptions: {
             show: {
                 resource: ['payment'],
-                operation: ['get', 'cancel', 'markAsPaid', 'refund'],
+                operation: ['get', 'cancel', 'markAsPaid', 'refund', 'getSupportDocuments'],
             },
         },
         description: 'The ID of the payment',

package/dist/nodes/Gigstack/descriptions/ReceiptDescription.js

@@ -140,6 +140,23 @@ exports.receiptFields = [
                 default: 'MXN',
                 description: 'Receipt currency',
             },
+            {
+                displayName: 'Exchange Rate',
+                name: 'exchange_rate',
+                type: 'number',
+                default: 1,
+                typeOptions: {
+                    numberPrecision: 4,
+                },
+                description: 'Exchange rate to MXN',
+            },
+            {
+                displayName: 'Idempotency Key',
+                name: 'idempotency_key',
+                type: 'string',
+                default: '',
+                description: 'Unique key to prevent duplicate receipts. If a receipt with this key already exists, the existing receipt will be returned.',
+            },
             {
                 displayName: 'Periodicity',
                 name: 'periodicity',
@@ -147,9 +164,9 @@ exports.receiptFields = [
                 options: [
                     { name: 'Day', value: 'day' },
                     { name: 'Week', value: 'week' },
-                    { name: 'Two Weeks', value: 'fortnight' },
+                    { name: 'Two Weeks', value: 'two_weeks' },
                     { name: 'Month', value: 'month' },
-                    { name: 'Two Months', value: 'bimonth' },
+                    { name: 'Two Months', value: 'two_months' },
                 ],
                 default: 'month',
                 description: 'Validity period for stamping the receipt',
@@ -177,6 +194,36 @@ exports.receiptFields = [
             },
         ],
     },
+    {
+        displayName: 'Invoice Config',
+        name: 'invoiceConfig',
+        type: 'collection',
+        placeholder: 'Add Invoice Config',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['receipt'],
+                operation: ['create'],
+            },
+        },
+        description: 'Configure invoice serie and folio for future stamping',
+        options: [
+            {
+                displayName: 'Serie',
+                name: 'serie',
+                type: 'string',
+                default: '',
+                description: 'Invoice serie (e.g., "A", "B"). Leave empty for default.',
+            },
+            {
+                displayName: 'Folio',
+                name: 'folio',
+                type: 'number',
+                default: 0,
+                description: 'Invoice folio number. Leave 0 for automatic increment.',
+            },
+        ],
+    },
     // ----------------------------------
     //         receipt: get, cancel, stamp
     // ----------------------------------
@@ -368,6 +415,40 @@ exports.receiptFields = [
                 default: '',
                 description: 'Filter receipts created before this date',
             },
+            {
+                displayName: 'Metadata Filters',
+                name: 'metadataFilters',
+                type: 'fixedCollection',
+                typeOptions: {
+                    multipleValues: true,
+                },
+                default: {},
+                description: 'Filter by metadata fields using key-value pairs',
+                options: [
+                    {
+                        name: 'filters',
+                        displayName: 'Metadata Filter',
+                        values: [
+                            {
+                                displayName: 'Key',
+                                name: 'key',
+                                type: 'string',
+                                default: '',
+                                placeholder: 'e.g., order_id',
+                                description: 'The metadata field key to filter on',
+                            },
+                            {
+                                displayName: 'Value',
+                                name: 'value',
+                                type: 'string',
+                                default: '',
+                                placeholder: 'e.g., ORD-123',
+                                description: 'The value to match',
+                            },
+                        ],
+                    },
+                ],
+            },
         ],
     },
     // ----------------------------------

package/dist/nodes/Gigstack/descriptions/index.d.ts

@@ -6,3 +6,4 @@ export * from './ReceiptDescription';
 export * from './TeamDescription';
 export * from './UserDescription';
 export * from './WebhookDescription';
+export * from './DescargarMasivaDescription';

package/dist/nodes/Gigstack/descriptions/index.js

@@ -22,3 +22,4 @@ __exportStar(require("./ReceiptDescription"), exports);
 __exportStar(require("./TeamDescription"), exports);
 __exportStar(require("./UserDescription"), exports);
 __exportStar(require("./WebhookDescription"), exports);
+__exportStar(require("./DescargarMasivaDescription"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@disruptive-learning/n8n-nodes-gigstack",
-  "version": "1.1.8",
+  "version": "1.2.0",
   "description": "n8n community node for Gigstack API - Mexican tax compliance, invoicing, and payment processing",
   "keywords": [
     "n8n-community-node-package",