Stamp pending receipts

POST

https://api.gigstack.io/v2/clients/{id}/stamp-pending-receipts

Stamp the client's pending receipts into CFDI invoices.

Batch cap: at most 100 receipts are stamped per call. Receipts are processed
five at a time. If the client has more than 100 pending receipts, call the endpoint
repeatedly until data.remaining reaches 0.

data.remaining is re-counted from Firestore after stamping, so it includes both
receipts beyond the 100-item cap and receipts that failed in this run (they stay
pending).

Fiscal prerequisites. Before stamping anything the handler checks that the client
has an RFC (rfc, falling back to tax_id), a legal name (legal_name, falling back
to name), address.zip, and tax_system. If any is missing it returns 400 with
error.code: client_fiscal_data_incomplete and stamps nothing. email and
address.country are not checked (country defaults to MEX).

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

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

Batch processed. A 200 does not mean every receipt was stamped — inspect
data.failed and data.results. When the client has no pending receipts the
response is still 200, with all counters at 0 and the message
No pending receipts found.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/clients/client_1234567890/stamp-pending-receipts?team=undefined' \
--header 'Authorization: <api-key>'

Response Example

200 - Success Example

{
    "success": true,
    "message": "Stamped 2 receipt(s), 1 failed",
    "timestamp": 1767225600000,
    "data": {
        "stamped": 2,
        "failed": 1,
        "remaining": 0,
        "results": [
            {
                "id": "receipt_1234567890",
                "status": "stamped"
            },
            {
                "id": "receipt_2345678901",
                "status": "stamped"
            },
            {
                "id": "receipt_3456789012",
                "status": "failed",
                "error": "CFDI40147 - El campo UsoCFDI no es válido"
            }
        ]
    }
}

Modified at 2026-08-14 03:51:35

Get client customer portal access token

Delete client