v1

latestOpenAPI 3.0.3Proprietaryraw.githubusercontent.com2026-03-067260437.0 KB

Receipts

Create receipt

Create a new receipt with items and client information. Receipts are pre-invoice documents that can be later stamped as CFDI invoices.

Features:

Automatic amount calculations with taxes
Flexible validity periods
Client auto-creation support
Metadata support for tracking
Idempotency support to prevent duplicate receipts

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

post/receipts

Query parameters

teamstring

gigstack Connect: Target team ID for multi-team access.

Requires gigstack Connect enabled on your team and shared billing account.

Example: ?team=team_xyz789

Request body

currencystring required

Currency code (ISO 4217)

exchange_ratenumber nullable

Exchange rate to use for currency conversion

metadataobject nullable

Additional metadata - accepts any custom properties for tracking business data, references, or integration identifiers. All properties are preserved and returned as-is.

periodicity'day' | 'week' | 'two_weeks' | 'month' | 'two_months' nullable

Receipt validity period

payment_formstring nullable

SAT payment form code

idempotency_keystring nullable

Unique key to prevent duplicate receipts. If a receipt with this key already exists, the existing receipt will be returned.

Example request

{
  "client": {
    "id": "client_1234567890",
    "search": {
      "on_key": "tax_id",
      "on_value": "PEGJ800101ABC",
      "auto_create": true
    },
    "address": {
      "country": "MEX",
      "street": "Av. Insurgentes Sur",
      "zip": "03100",
      "city": "Ciudad de México",
      "state": "CDMX",
      "exterior": "123",
      "interior": "4B",
      "municipality": "Benito Juárez",
      "neighborhood": "Del Valle"
    },
    "name": "Juan Pérez García",
    "company": "Empresa SA de CV",
    "phone": "+52 55 1234 5678",
    "email": "juan.perez@ejemplo.com",
    "legal_name": "Juan Pérez García",
    "tax_id": "PEGJ800101ABC"
  },
  "currency": "MXN",
  "exchange_rate": 1,
  "items": [
    {
      "id": "service_1234567890",
      "search": {
        "on_key": "sku",
        "on_value": "CONS-001",
        "auto_create": true
      },
      "quantity": 1,
      "description": "Consulting services",
      "sku": "CONS-001",
      "product_key": "80141503",
      "unit_key": "E48",
      "unit_name": "Servicio",
      "unit_price": 1000,
      "taxes": [
        {
          "factor": "Tasa",
          "rate": 0.16,
          "type": "IVA"
        }
      ],
      "third_party": {
        "legal_name": "Third Party SA",
        "tax_id": "TPR800101ABC",
        "tax_system": "601",
        "zip": "03100"
      }
    }
  ],
  "periodicity": "month",
  "invoice_config": {
    "folio": 123,
    "serie": "A"
  },
  "payment_form": "01",
  "idempotency_key": "receipt-key-12345"
}

Response

Receipt created successfully

messagestring required

dataobject required

Example response

{
  "message": "Operation completed successfully"
}