Gigstack icon

Gigstack

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

Actions82

Invoice → Create Income

AI-generated

Overview

This node operation creates an income invoice for a specified client using the Gigstack API. It allows users to define invoice line items with details such as description, quantity, unit price, product and unit keys, taxability, and whether to include IVA tax. Additional invoice fields like currency, exchange rate, payment method, payment form, CFDI use, series, email sending options, automation type, and custom metadata can also be specified. This operation is useful for businesses needing to generate tax-compliant income invoices for clients in Mexico, automating invoicing workflows and ensuring proper tax handling.

Use Case Examples

  1. Create an income invoice for a client with multiple line items, specifying quantities, unit prices, and tax details.
  2. Generate an invoice in USD with a custom exchange rate and send it automatically to the client and additional email recipients.
  3. Create an invoice with metadata for integration with other systems or custom processing.

Properties

Name Meaning
Client ID The ID of the client for whom the income invoice is being created.
Items The line items to include in the invoice, each with description, quantity, unit price, product key, unit key, service ID, taxability, and option to include IVA tax.
Additional Fields Optional additional invoice settings such as currency, exchange rate, payment method, payment form, CFDI use, series, email sending preferences, automation type, and custom metadata.
Team ID Optional team ID for multi-team access; defaults to the default team if empty.

Output

JSON

  • id - The unique identifier of the created income invoice.
  • client
    • id - The client ID associated with the invoice.
  • items - Array of invoice line items with their details.
  • currency - Currency used for the invoice.
  • exchange_rate - Exchange rate applied if currency is not MXN.
  • payment_method - CFDI payment method used.
  • payment_form - SAT payment form code used.
  • use - CFDI use code indicating invoice purpose.
  • series - Invoice series identifier.
  • send_email - Indicates if the invoice was sent via email.
  • automation_type - Type of invoice automation applied.
  • emails - List of additional email recipients.
  • metadata - Custom metadata associated with the invoice.

Dependencies

  • Gigstack API key credential

Troubleshooting

  • Ensure the client ID provided is valid and exists in the Gigstack system to avoid errors.
  • Verify that the items array contains at least one item with valid fields such as description and unit price.
  • If using a currency other than MXN, make sure to provide a valid exchange rate.
  • Check that the JSON metadata is correctly formatted to prevent parsing errors.
  • If the API request fails, check the API key credential and network connectivity.

Links

Discussion