Recepción de comprobantes

Listar comprobantes recibidos

Consulta los comprobantes del buzón de recepción para Colombia.

get/stamp-documents-received

Request

  • Base URL
    https://api.alegra.com/api/v1
  • URL
    https://api.alegra.com/api/v1/stamp-documents-received
  • Auth
    HTTP basic

Query parameters

startinteger

Posición desde la que deseas consultar. Usa start=0 para comenzar desde el primer resultado.

limitinteger

Cantidad máxima de comprobantes por página. Por defecto 30; los valores superiores a 30 se ajustan a 30.

order_direction'ASC' | 'DESC'

Dirección de ordenamiento de los comprobantes; por defecto DESC.

metadataboolean

Incluye el total de resultados que coinciden con la búsqueda.

fieldsstring[]

Campos adicionales del comprobante separados por comas.

identificationstring

Busca el texto indicado en la identificación del proveedor.

provider_namestring

Busca el texto indicado en el nombre del proveedor o en la dirección de correo del remitente.

totalstring

Busca el texto indicado en el total del comprobante.

responsestring[]

Filtra por pertenencia a las respuestas almacenadas indicadas, separadas por comas. Usa UNANSWERED solo, sin combinarlo con otros valores, para buscar comprobantes sin respuesta (valor nulo).

querystring

Busca el texto indicado en el nombre o la dirección del proveedor, el número, la fecha de expedición o el total del comprobante. Si usas query, se aplica esta búsqueda en lugar de los demás filtros.

numberstring

Busca el texto indicado en el número del comprobante.

date_laterThanOrEqualTostring date
Example:2026-10-21

Fecha de expedición desde la que deseas consultar, incluida. Usa el formato YYYY-MM-DD.

date_earlierThanOrEqualTostring date
Example:2026-10-21

Fecha de expedición hasta la que deseas consultar, incluida. Usa el formato YYYY-MM-DD.

is_registeredboolean

Usa true para consultar comprobantes asociados a un documento registrado en Alegra, como una factura de compra, o false para consultar los que aún no tienen un documento asociado.

Response

Lista de comprobantes recibidos. Con metadata=true devuelve data con la página y metadata.total con el total de coincidencias antes de paginar.

OR

Example response

[
  {
    "id": "123",
    "total": "119.0000",
    "datetime": "2026-09-01 10:00:00",
    "stampReceptionEmail": {
      "datetime": "2026-09-01 10:00:00"
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.