curl --request DELETE \
--url https://api.gigstack.io/v2/invoices/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"motive": "02",
"substitution_uuid": "12345678-1234-1234-1234-123456789012"
}
'const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({motive: '02', substitution_uuid: '12345678-1234-1234-1234-123456789012'})
};
fetch('https://api.gigstack.io/v2/invoices/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/invoices/{id}"
payload = {
"motive": "02",
"substitution_uuid": "12345678-1234-1234-1234-123456789012"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text){
"cancellation_status": "cancelled"
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"error": "El certificado de sello digital (CSD) no está configurado o no es válido.",
"code": "csd_validation_error",
"retryable": false
}{
"message": "Imported invoices stamped by an external PAC cannot be canceled through gigstack. Please cancel through your original PAC provider."
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"error": "El servicio de timbrado no está disponible en este momento. Vuelve a intentarlo en unos minutos.",
"code": "pac_unavailable",
"retryable": true
}Cancel invoice
Integration note: This recipe covers Mexican CFDI cancellation. A provider acknowledgment does not prove final cancellation. Read the invoice and confirm its persisted status; public nested cancellation fields can be absent. Colombian annulment uses different semantics.
Cancel a specific invoice with SAT.
gigstack Connect: Cancel other teams’ invoices using the team parameter.
curl --request DELETE \
--url https://api.gigstack.io/v2/invoices/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"motive": "02",
"substitution_uuid": "12345678-1234-1234-1234-123456789012"
}
'const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({motive: '02', substitution_uuid: '12345678-1234-1234-1234-123456789012'})
};
fetch('https://api.gigstack.io/v2/invoices/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/invoices/{id}"
payload = {
"motive": "02",
"substitution_uuid": "12345678-1234-1234-1234-123456789012"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text){
"cancellation_status": "cancelled"
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"error": "El certificado de sello digital (CSD) no está configurado o no es válido.",
"code": "csd_validation_error",
"retryable": false
}{
"message": "Imported invoices stamped by an external PAC cannot be canceled through gigstack. Please cancel through your original PAC provider."
}{
"message": "Invalid body",
"error": "<string>",
"errors": [
{
"path": "client_id",
"code": "unexpected_key",
"message": "Unexpected field"
}
]
}{
"error": "El servicio de timbrado no está disponible en este momento. Vuelve a intentarlo en unos minutos.",
"code": "pac_unavailable",
"retryable": true
}Authorizations
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
SAT UUID (folio fiscal).
Query Parameters
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
SAT cancellation motive (c_MotivoCancelacion): 01 issued with errors, with a
substitute CFDI (send substitution_uuid); 02 issued with errors, no substitute;
03 the operation did not take place; 04 nominative operation included in a global
invoice. The API only checks that the value is at most two characters; any other value
is rejected by the SAT/PAC at cancellation time.
01, 02, 03, 04 "02"
UUID of the substituting invoice (required for motive 01)
"12345678-1234-1234-1234-123456789012"
Response
Cancellation accepted by the PAC. Raw shape — the PAC's cancellation
response is spread at the top level alongside cancellation_status.
Cancellation state reported by SAT.
"cancelled"