Saltar a contenido

List invoices


title: 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).

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

Parámetros

Parámetro Tipo Obligatorio Descripción
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": {
    "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"
  ]
}