List invoices

List the calling issuer's invoice summaries, newest first. Optionally filter by status and by tipo_de_comprobante (I invoices, E credit notes, P payment complements), by direction (issued by default; received lists the CFDIs other parties issued to the issuer, downloaded from the SAT; all lists both) and by origin (cefidia or sat). Every invoice carries its direction and origin.

Alcance (scope): invoices:read · Características: Solo lectura, Idempotente

Parámetros¶

Parámetro	Tipo	Obligatorio	Descripción
`direction`	string	No	issued (default): the issuer's own CFDIs; received: CFDIs issued to it by others; all: both.
`origin`	string	No	cefidia: created here; sat: downloaded from the SAT. Every origin when omitted.
`status`	string	No	Filter by invoice status; every status when omitted.
`tipo_de_comprobante`	string	No	Filter by document type: I invoices, E credit notes, P payment complements.
`limit`	integer	No	Maximum number of invoices to return (default 50, max 100).
`issuer`	string	Sí	Id of the issuer the call acts for, from list_issuers.

Esquema de entrada (JSON Schema)¶

{
  "type": "object",
  "properties": {
    "direction": {
      "type": "string",
      "enum": [
        "issued",
        "received",
        "all"
      ],
      "description": "issued (default): the issuer's own CFDIs; received: CFDIs issued to it by others; all: both."
    },
    "origin": {
      "type": "string",
      "enum": [
        "cefidia",
        "sat"
      ],
      "description": "cefidia: created here; sat: downloaded from the SAT. Every origin when omitted."
    },
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "signed",
        "canceled"
      ],
      "description": "Filter by invoice status; every status when omitted."
    },
    "tipo_de_comprobante": {
      "type": "string",
      "enum": [
        "I",
        "E",
        "P"
      ],
      "description": "Filter by document type: I invoices, E credit notes, P payment complements."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of invoices to return (default 50, max 100)."
    },
    "issuer": {
      "type": "string",
      "format": "uuid",
      "description": "Id of the issuer the call acts for, from list_issuers."
    }
  },
  "required": [
    "issuer"
  ]
}