Create egress invoice

POST

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

Create a new egress invoice (expense/credit note) 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/egress?team' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "automation_type": "payment",
    "currency": "MXN",
    "use": "P01",
    "payment_form": "03",
    "client": {
        "id": "client_1234567890"
    },
    "items": [
        {
            "quantity": 1,
            "description": "Purchased materials",
            "sku": "MAT-001",
            "product_key": "80141503",
            "unit_key": "E48",
            "unit_name": "Unidad",
            "unit_price": 500,
            "taxability": "02",
            "taxes": [
                {
                    "type": "IVA",
                    "rate": 0.16,
                    "factor": "Tasa",
                    "withholding": false,
                    "inclusive": false
                }
            ]
        }
    ],
    "send_email": true,
    "emails": [
        "proveedor@empresa.com"
    ],
    "metadata": {
        "purchase_order": "PO-2024-001",
        "department": "procurement"
    }
}'

Response Example

200 - Éxito

{
    "message": "Invoice created successfully",
    "data": {
        "uuid": "invoice_1234567890",
        "client": {
            "id": "client_1234567890",
            "name": "Proveedor ABC SA",
            "email": "proveedor@empresa.com",
            "tax_id": "PABC800101ABC"
        },
        "status": "stamped",
        "currency": "MXN",
        "exchange_rate": 1,
        "total": 580,
        "subtotal": 500,
        "taxes": 80,
        "discount": 0,
        "series": "E",
        "folio_number": 123,
        "invoice_type": "E",
        "items": [
            {
                "id": "item_1234567890",
                "description": "Purchased materials",
                "quantity": 1,
                "unit_price": 500,
                "product_key": "80141503",
                "unit_key": "E48"
            }
        ],
        "created_at": 1677651234,
        "livemode": true,
        "owner": "user_1234567890"
    }
}

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

Get egress invoice

Get invoice files