🧾 Invoice Info (Mexico Only): How to Use It

Clara also supports uploading and accessing electronic invoice XML files, specifically for transactions in Mexico. These invoices can be retrieved through our API to support audit, compliance, or reconciliation processes.

🧾 When a Transaction Has an Invoice

If a transaction has invoice:

  • The hasInvoice field is set to true
  • You’ll receive a link to download them
  • URLs are valid for 12 hours

🔗 Endpoint Format

GET /v3/transactions/{uuid}/invoices

Use this endpoint to retrieve XML invoice details and metadata associated with a specific transaction.


🧪 Example: Getting Invoices for a Transaction

In the following example, we will get the invoice information for the transaction with the UUID "47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1" in Mexico.

📤 cURL Request

curl -X GET
"https://public-api.mx.clara.com/api/v3/transactions/47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1/invoices" \ 
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

📥 Sample JSON Response

{
  "transactionUuid": "47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1",
  "invoices": [
    {
      "invoiceId": "54cd6b23-5146-437f-b133-879c432e6776",
      "invoiceNumber": null,
      "taxRegime": "621",
      "issuer": {
        "rfc": "CLARA123XML",
        "businessName": "CLARA"
      },
      "taxReceipts": {
        "cfdi": "G03",
        "paymentMethod": "Q4"
      },
      "tax": {
        "retained": {
          "isr": 0.75,
          "iva": null,
          "ieps": null
        },
        "transferred": {
          "iva": 0.0,
          "ieps": 0.0
        }
      },
      "amount": {
        "total": 400.00,
        "subTotal": 300.00,
        "currency": "MXN"
      },
      "documentDate": "2024-10-01",
      "xmlStatus": "Vigente",
      "xmlCode": "S – Comprobante obtenido satisfactoriamente."
    }
  ]
}

⚠️ The download URL is temporary and will expire 12 hours after generation. Ensure you download and store the file before it expires.

ℹ️ Note: The example provided contains mock data and does not reflect real tax calculations or financial details.