Gigstack icon

Gigstack

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

Actions82

Invoice → Create Egress

AI-generated

Overview

This node operation creates an egress invoice in the Gigstack system, which is used for recording expenses or outgoing payments for a client. It is beneficial for businesses that need to generate tax-compliant expense invoices for their clients in Mexico. For example, a company can use this operation to create an invoice for services or products purchased from a supplier, including detailed line items and tax information.

Use Case Examples

  1. Creating an egress invoice for a client with multiple line items, each specifying description, quantity, unit price, and tax details.
  2. Including additional invoice fields such as currency, payment method, and metadata to customize the invoice.
  3. Automatically sending the generated invoice to the client via email and specifying additional recipients.

Properties

Name Meaning
Client ID The ID of the client for whom the egress invoice is being created.
Items The line items included in the invoice, each with details such as description, quantity, unit price, product and unit keys, service ID, taxability, and whether to include 16% IVA tax.
Additional Fields Optional additional invoice fields such as currency, exchange rate, payment method, payment form, CFDI use, series, email sending options, automation type, and custom metadata.
Team ID Team ID for multi-team access in Gigstack Connect; leave empty to use the default team.

Output

JSON

  • id - The unique identifier of the created egress invoice.
  • client
    • id - The client ID associated with the invoice.
  • items - Array of invoice line items with details such as description, quantity, unit price, product key, unit key, taxability, and taxes.
  • 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.
  • use - CFDI use code.
  • 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 exists and is valid; otherwise, the API will return an error.
  • Verify that all required item fields are correctly filled, especially quantity and unit price, to avoid validation errors.
  • If using non-MXN currency, ensure the exchange rate is provided and accurate.
  • Check that the API key credential is correctly configured and has the necessary permissions to create invoices.
  • Common error messages include authentication failures, missing required fields, and invalid tax codes; resolving these typically involves correcting input data or updating credentials.

Links

Discussion