Cancelar una factura

POST

/invoices/{id}/cancel

curl --request POST \
  --url 'https://api.dev.lade.com.mx/invoices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cancel?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "reason": "02" }'

• Development environment (dominio custom)
• QA environment
• Production environment
• Development environment (legacy — execute-api URL directo)

Cancela una factura VALID o DRAFT. Un DRAFT se cancela localmente sin llamar al SAT. Una factura VALID requiere cancelación ante el SAT vía Facturapi con un motivo (01=Errores con relación, 02=Errores sin relación, 03=No se llevó a cabo, 04=Operación nominativa relacionada), que puede quedar CANCELLED (inmediata) o CANCELLED_PENDING (el receptor debe aceptar). Requiere rol OWNER o ADMIN.

Authorizations

• cognitoAuth

Parameters

Path Parameters

id

required

string format: uuid

ID de la factura (UUID)

Query Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Request Body

Media typeapplication/json

object

reason

Motivo de cancelación SAT (solo aplica si la factura está VALID)

string

default: 02

Allowed values: 01 02 03 04

Example

{
  "reason": "02"
}

Responses

200

Cancelación procesada

Media typeapplication/json

object

message

string

invoice

object

id

string format: uuid

status

string

Allowed values: CANCELLED CANCELLED_PENDING

cancelledAt

string format: date-time

cancelReason

string

Example

{
  "message": "Invoice cancellation processed",
  "invoice": {
    "id": "990e8400-e29b-41d4-a716-446655440004",
    "status": "CANCELLED",
    "cancelledAt": "2026-07-26T10:00:00Z",
    "cancelReason": "02"
  }
}

400

Solicitud inválida

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

403

Sin permisos

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}

404

Recurso no encontrado

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}

502

Error al comunicarse con el proveedor externo (Facturapi/Stripe)

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Facturapi error: the CSD certificate is invalid"
}