Invoices

Invoices represent CFDI documents issued or received by an entity. Invoice records include SAT identifiers, issuer and receiver data, monetary totals, payment status, cancellation status, invoice relationships, file availability, and tags. Use the entity invoice list when you need all invoices extracted for one entity. Retrieve an invoice by ID when you need the full invoice resource, including tags and related invoice metadata. Use the CFDI file endpoint when you need the XML or PDF content for a specific invoice, and use the parsed SAT CFDI endpoint when you need structured CFDI data by invoice UUID.

​

How invoice data is collected

Invoice records are collected with the invoice extractor. The extraction can include issued invoices, received invoices, XML files, and PDF files depending on the selected options. Invoice payments, batch payments, line items, relations, and credit notes are also derived from invoice CFDI data. For implementation details, see Extraction request examples.

​

CFDI types included

By default, the invoice extractor includes every CFDI type the SAT exposes for the entity within the requested period. There is no separate extractor for payroll, payment complements, credit notes, or transfer documents. You can remove any type you do not need when configuring an individual extraction or the extraction scheduler, depending on where the extraction will be created. The type field identifies each extracted invoice:

​

Blacklist status

The field issuer.blacklistStatus or receiver.blacklistStatus is set when the invoice issuer or receiver RFC is found in the SAT 69-B list: