Skip to main content
POST
/
api
/
timbre
/
facturar-ticket
curl -X POST "https://api.usatimbre.com/api/timbre/facturar-ticket" \
  -H "Authorization: Bearer tmb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "receipt_image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
    "cfdi_usage": "G03",
    "expense_description": "Comida de negocios"
  }'

{
  "id": "inv_abc123",
  "status": "processing",
  "amount": null,
  "currency": "MXN",
  "vendor": null,
  "created_at": "2024-01-21T10:30:00Z",
  "pdf_url": null,
  "xml_url": null
}

​
Overview

Create an invoice (factura) from a receipt image. The system will process the image, extract the relevant information, and generate a CFDI-compliant invoice.
This operation requires 1 credit. Make sure you have sufficient credits before calling this endpoint.

​
Request Body

​
receipt_image
string
required
Imagen del ticket codificada en Base64. Formatos soportados: JPEG, PNG.
​
cfdi_usage
string
required
Código de uso CFDI. Valores comunes:
  • G01 - Adquisición de mercancías
  • G02 - Devoluciones, descuentos o bonificaciones
  • G03 - Gastos en general
  • P01 - Por definir
​
expense_description
string
Descripción opcional del gasto. Ejemplo: Comida de negocios

​
Response

​
id
string
Unique invoice identifier
​
status
string
Invoice status. Values: pending, processing, completed, failed
​
amount
number
Invoice total amount (extracted from receipt)
​
currency
string
Currency code (e.g., MXN)
​
vendor
string
Vendor name (extracted from receipt)
​
created_at
string
ISO 8601 timestamp of creation
​
pdf_url
string
URL to download the invoice PDF (available when status is completed)
​
xml_url
string
URL to download the invoice XML/CFDI (available when status is completed)
curl -X POST "https://api.usatimbre.com/api/timbre/facturar-ticket" \
  -H "Authorization: Bearer tmb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "receipt_image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
    "cfdi_usage": "G03",
    "expense_description": "Comida de negocios"
  }'

{
  "id": "inv_abc123",
  "status": "processing",
  "amount": null,
  "currency": "MXN",
  "vendor": null,
  "created_at": "2024-01-21T10:30:00Z",
  "pdf_url": null,
  "xml_url": null
}

​
Processing Status

After creating an invoice, the status will be processing. You can poll the Get Invoice Details endpoint to check when processing is complete.
StatusDescription
pendingInvoice request received
processingReceipt is being processed
completedInvoice generated successfully
failedInvoice generation failed