Skip to main content
Tax retentions represent SAT CFDI withholding and payment-information documents. They include the issuer, receiver, retention code, fiscal period, operation totals, retained tax totals, itemized retained taxes, and CFDI file availability. Use the list endpoint to read tax retentions extracted for an entity. Use the CFDI endpoint when you need the XML or PDF content for a specific tax retention.

​
Extracting Tax Retention Data

Create an extraction with extractor set to tax_retention to retrieve issued and received tax retentions for an entity. 
{
  "entity": "/entities/7b3a25a9-a53a-4846-abe6-f2574c9c2d5d",
  "extractor": "tax_retention",
  "options": {
    "period": {
      "from": "2024-01-01",
      "to": "2024-12-31"
    },
    "issued": true,
    "received": true,
    "xml": true,
    "pdf": true
  }
}
After the extraction reaches finished, read the resulting tax retentions from the entity tax retention list.