Timbrar una factura

POST

/invoices/{id}/stamp

curl --request POST \
  --url 'https://api.dev.lade.com.mx/invoices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/stamp?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'Authorization: Bearer <token>'

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

Timbra (envía al SAT vía Facturapi) una factura en estado DRAFT o ERROR. Usa un lock atómico condicional para que solo un intento de timbrado esté en curso a la vez (409 si ya hay uno). Rechaza timbrar si la factura sigue en $0 (no editada aún). Descarga el PDF/XML resultantes y los sube a S3. Si Facturapi falla, marca la factura como ERROR y notifica por email a los OWNER/ADMIN del equipo (best-effort).

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)

Responses

200

Factura timbrada exitosamente

Media typeapplication/json

object

message

string

invoice

object

id

string format: uuid

status

string

Allowed values: VALID

uuid

UUID fiscal del SAT

string

folio

string

series

string

Example

{
  "message": "Invoice stamped successfully",
  "invoice": {
    "id": "990e8400-e29b-41d4-a716-446655440004",
    "status": "VALID",
    "uuid": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
    "folio": "142",
    "series": "A"
  }
}

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"
}

409

Conflicto con recurso existente

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Conflict",
  "message": "Resource already exists"
}

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"
}