Create Invoice from Ticket

Create invoice from receipt image

POST https://api.usatimbre.com/api/timbre/facturar-ticket

cURL

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

201

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

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

201

{
  "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.

Status	Description
pending	Invoice request received
processing	Receipt is being processed
completed	Invoice generated successfully
failed	Invoice generation failed