Create income invoice

POST

https://api.gigstack.io/v2/invoices/income

Create a new income invoice with CFDI 4.0 compliance.

gigstack Connect: Create invoices for other teams using the team parameter.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200Correcto

application/json

Invoice created successfully

Body

🟠400Solicitud incorrecta

🟠401No autenticado

🟠403Permiso insuficiente

🔴500Error interno del servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/invoices/income?team' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "automation_type": "pue_invoice",
    "currency": "MXN",
    "use": "P01",
    "payment_form": "03",
    "payment_method": "PUE",
    "client": {
        "id": "client_1234567890"
    },
    "items": [
        {
            "quantity": 1,
            "description": "Professional consulting services",
            "sku": "CONS-001",
            "product_key": "80141503",
            "unit_key": "ACT",
            "unit_name": "Actividad",
            "unit_price": 1500,
            "taxability": "02",
            "taxes": [
                {
                    "type": "IVA",
                    "rate": 0.16,
                    "factor": "Tasa",
                    "withholding": false,
                    "inclusive": false
                }
            ]
        }
    ],
    "send_email": true,
    "emails": [
        "cliente@empresa.com"
    ],
    "metadata": {
        "project_id": "PROJ-2024-001",
        "department": "consulting"
    }
}'

Response Example

200 - Éxito

{
    "message": "Invoice created successfully",
    "data": {
        "uuid": "invoice_1234567890",
        "client": {
            "id": "client_1234567890",
            "name": "Juan Pérez García",
            "email": "juan.perez@ejemplo.com",
            "tax_id": "PEGJ800101ABC"
        },
        "status": "stamped",
        "currency": "MXN",
        "exchange_rate": 1,
        "total": 1160,
        "subtotal": 1000,
        "taxes": 160,
        "discount": 0,
        "series": "A",
        "folio_number": 123,
        "invoice_type": "I",
        "payment_method": "PUE",
        "items": [
            {
                "id": "item_1234567890",
                "description": "Professional consulting services",
                "quantity": 1,
                "unit_price": 1000,
                "product_key": "80141503",
                "unit_key": "E48"
            }
        ],
        "created_at": 1677651234,
        "livemode": true,
        "owner": "user_1234567890"
    }
}

Modified at 2025-10-09 23:51:05

Get income invoice

List egress invoices