Gigstack icon

Gigstack

Interact with Gigstack API for Mexican tax-compliant invoicing and payments

Actions82

Descarga Masiva (SAT) → Create Download Request

AI-generated

Overview

This node operation creates a download request for CFDIs (digital tax receipts) from the Mexican tax authority (SAT) using the Gigstack API. It allows users to specify a date range (maximum one month), the type of CFDIs to download (received or issued), and optionally filter by a specific RFC (tax ID). This is useful for businesses needing to automate the retrieval of their tax documents for accounting or compliance purposes.

Use Case Examples

  1. A business wants to download all CFDIs they received between 2024-01-01 and 2024-01-31 to reconcile their accounts.
  2. An accounting firm automates the download of issued CFDIs for their client for the previous month to prepare tax filings.

Properties

Name Meaning
Date From Start date for the download request in YYYY-MM-DD format, with a maximum range of one month.
Date To End date for the download request in YYYY-MM-DD format, with a maximum range of one month.
CFDI Type Specifies whether to download CFDIs received by the business or issued by the business.
Additional Fields Optional additional fields for the request, including filtering by a specific RFC (counterpart RFC for received, or own RFC for issued).
Team ID Team ID for multi-team access in Gigstack Connect. Leave empty to use the default team.

Output

JSON

  • date_from - Start date of the download request.
  • date_to - End date of the download request.
  • type - Type of CFDIs requested (received or issued).
  • rfc - Optional RFC filter applied to the request.
  • request_id - Identifier of the created download request.
  • status - Status of the download request.

Dependencies

  • Gigstack API
  • An API key credential for authentication

Troubleshooting

  • Ensure the date range does not exceed one month, as the API enforces this limit.
  • Verify that the RFC filter, if used, is correctly formatted and valid.
  • Check that the API key credential is correctly configured and has the necessary permissions.
  • Common error messages may include invalid date format, unauthorized access, or request limit exceeded. Verify input parameters and credentials to resolve these issues.

Links

Discussion