Stamp receipt

curl --request POST \
  --url https://api.gigstack.io/v2/receipts/{id}/stamp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "stamp_to": "client",
  "date": 1767225600000
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({stamp_to: 'client', date: 1767225600000})
};

fetch('https://api.gigstack.io/v2/receipts/{id}/stamp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.gigstack.io/v2/receipts/{id}/stamp"

payload = {
    "stamp_to": "client",
    "date": 1767225600000
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "message": "Receipt stamped successfully",
  "data": {
    "id": "receipt_1234567890",
    "client": {
      "id": "client_1234567890",
      "name": "ESCUELA KEMPER URGATE",
      "legal_name": "ESCUELA KEMPER URGATE",
      "email": "contabilidad@ejemplo.com",
      "bcc": [],
      "phone": "+524421234567",
      "tax_id": "EKU9003173C9",
      "tax_system": "601",
      "use": "G03",
      "address": {
        "street": "Av. Constituyentes",
        "exterior": "1000",
        "neighborhood": "Centro",
        "city": "Querétaro",
        "state": "QRO",
        "zip": "76000",
        "country": "MEX"
      },
      "is_valid": true,
      "efos": {
        "is_valid": true
      },
      "metadata": {},
      "livemode": true,
      "from": "api",
      "owner": "user_1234567890",
      "team": "team_1234567890",
      "created_at": 1767225600000
    },
    "currency": "MXN",
    "exchange_rate": 1,
    "from": "api",
    "url": "https://invoicing.gigstack.pro/autofactura?id=receipt_1234567890",
    "created_at": 1767225600000,
    "invoices": [
      "B0C3E4F2-1A2B-4C5D-9E8F-0123456789AB"
    ],
    "items": [
      {
        "id": "service_1234567890",
        "description": "Servicios de consultoría profesional",
        "quantity": 1,
        "unit_price": 1000,
        "product_key": "80141503",
        "unit_key": "E48",
        "unit_name": "Unidad de servicio",
        "taxes": [
          {
            "type": "IVA",
            "rate": 0.16,
            "factor": "Tasa",
            "withholding": false
          }
        ],
        "team": "team_1234567890",
        "created_at": 1767225600000,
        "from": "api"
      }
    ],
    "livemode": true,
    "metadata": {
      "order_id": "ORD-12345"
    },
    "owner": "user_1234567890",
    "payments": [
      "payment_1234567890"
    ],
    "periodicity": "month",
    "short_url": "https://gigstack.xyz/Rc8vQ2",
    "status": "completed",
    "team": "team_1234567890",
    "valid_until": 1769817600000,
    "automatic_invoice_error": null,
    "payment_form": "03",
    "total": 1160,
    "total_refunded": 0,
    "subtotal": 1000,
    "taxes": 160,
    "discount": 0,
    "withholding_taxes": 0,
    "idempotency_key": "receipt-key-12345"
  }
}

Receipts

Stamp receipt

Convert a receipt into a CFDI invoice by stamping it with SAT.

Only receipts with status: pending can be stamped. A receipt that already has entries in invoices[] is returned as-is with a 200 and no new CFDI; any other non-pending receipt (a cancelled one is stored as completed) is rejected with a 409.

Stamp Options:

client: Stamp to the associated client
general_public_national: Stamp to Mexican general public
general_public_foreign: Stamp to foreign general public

gigstack Connect: Stamp other teams’ receipts using the team parameter.

POST

receipts

{id}

stamp

Stamp receipt

curl --request POST \
  --url https://api.gigstack.io/v2/receipts/{id}/stamp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "stamp_to": "client",
  "date": 1767225600000
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({stamp_to: 'client', date: 1767225600000})
};

fetch('https://api.gigstack.io/v2/receipts/{id}/stamp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.gigstack.io/v2/receipts/{id}/stamp"

payload = {
    "stamp_to": "client",
    "date": 1767225600000
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "message": "Receipt stamped successfully",
  "data": {
    "id": "receipt_1234567890",
    "client": {
      "id": "client_1234567890",
      "name": "ESCUELA KEMPER URGATE",
      "legal_name": "ESCUELA KEMPER URGATE",
      "email": "contabilidad@ejemplo.com",
      "bcc": [],
      "phone": "+524421234567",
      "tax_id": "EKU9003173C9",
      "tax_system": "601",
      "use": "G03",
      "address": {
        "street": "Av. Constituyentes",
        "exterior": "1000",
        "neighborhood": "Centro",
        "city": "Querétaro",
        "state": "QRO",
        "zip": "76000",
        "country": "MEX"
      },
      "is_valid": true,
      "efos": {
        "is_valid": true
      },
      "metadata": {},
      "livemode": true,
      "from": "api",
      "owner": "user_1234567890",
      "team": "team_1234567890",
      "created_at": 1767225600000
    },
    "currency": "MXN",
    "exchange_rate": 1,
    "from": "api",
    "url": "https://invoicing.gigstack.pro/autofactura?id=receipt_1234567890",
    "created_at": 1767225600000,
    "invoices": [
      "B0C3E4F2-1A2B-4C5D-9E8F-0123456789AB"
    ],
    "items": [
      {
        "id": "service_1234567890",
        "description": "Servicios de consultoría profesional",
        "quantity": 1,
        "unit_price": 1000,
        "product_key": "80141503",
        "unit_key": "E48",
        "unit_name": "Unidad de servicio",
        "taxes": [
          {
            "type": "IVA",
            "rate": 0.16,
            "factor": "Tasa",
            "withholding": false
          }
        ],
        "team": "team_1234567890",
        "created_at": 1767225600000,
        "from": "api"
      }
    ],
    "livemode": true,
    "metadata": {
      "order_id": "ORD-12345"
    },
    "owner": "user_1234567890",
    "payments": [
      "payment_1234567890"
    ],
    "periodicity": "month",
    "short_url": "https://gigstack.xyz/Rc8vQ2",
    "status": "completed",
    "team": "team_1234567890",
    "valid_until": 1769817600000,
    "automatic_invoice_error": null,
    "payment_form": "03",
    "total": 1160,
    "total_refunded": 0,
    "subtotal": 1000,
    "taxes": 160,
    "discount": 0,
    "withholding_taxes": 0,
    "idempotency_key": "receipt-key-12345"
  }
}

Authorizations

Authorization

string

header

required

Authentication Method: HTTP Bearer token.

The runtime requires the literal Bearer prefix — a bare token in the Authorization header is rejected with 401 unauthorized.

Header Format: Authorization: Bearer YOUR_API_KEY

Your API key is a JWT. Live keys operate on live data (livemode: true); test keys operate on isolated test data (livemode: false).

Get your key at: app.gigstack.pro/settings?tab=api

Errors: credential failures are answered by the authentication layer with a raw { "message": … } body, not the standardized envelope — 401 for a missing, malformed or expired token, 403 for a revoked key or a plan without API access. See the Unauthorized and AuthForbidden responses.

Path Parameters

string

required

Receipt ID

Query Parameters

team

string

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

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

Also requires the multipleIssuerAccounts feature on your plan. Requests targeting a team other than the one your API key belongs to return 403 without it.

Only API keys can use it: an OAuth access token sent with another team's id is rejected with 403 Team mismatch with OAuth token.

Optional — omit it entirely unless you are acting on another team. It deliberately carries no example value so generated snippets do not emit ?team=undefined; when the parameter is absent, the team is derived from your API key.

Example: ?team=team_xyz789

Body

application/json

stamp_to

enum<string>

required

Who to stamp the receipt to

Available options:

client,

general_public_national,

general_public_foreign

Example:

"client"

idempotency_key

string | null

Optional. A retry that reuses the key returns 409 with the receipt id instead of attempting a second stamp.

Example:

"stamp-receipt-2026-09-11-001"

fiscal_information

object | null

Custom fiscal information (overrides client data)

Show child attributes

date

number | null

Custom invoice date (timestamp in milliseconds)

Example:

1677651234000

Response

Receipt stamped successfully. This handler predates the standardized envelope — it returns the raw shape { "message": …, "data": … } with no success or timestamp keys.

message

string

required

Example:

"Receipt stamped successfully"

data

object

required

The stamped receipt.

Clients

Services

Descarga Masiva SAT

Invoices

Payments

Receipts

Retentions

Teams

Users

Webhooks

Catalogs

Auth

SAT Lists

Documents

Platform Payouts

Stamp receipt

Authorizations

Path Parameters

Query Parameters

Body

Response