Listar registros de facturación con filtros

curl --request GET \
  --url https://api.kubifactu.com/api/invoices \
  --header 'X-Qbikode-ClientApiKey: <api-key>'

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "client_invoice_id": "<string>",
      "record_type": "creation",
      "request_id": "2cc8ef846029ec69613711ad1d85f6dfebf16ffb",
      "fiscal_year": 2025,
      "full_invoice_number": "F23-0000123",
      "issue_date": "2025-09-15",
      "created_at": "2025-09-15T07:35:24.992854Z",
      "fingerprint": "<string>",
      "csv": "<string>",
      "vf_post_status": "success",
      "vf_record_registration_status": "success",
      "has_warnings": false,
      "vf_error_descriptions": "<string>"
    }
  ],
  "meta": {
    "per_page": 50,
    "next_page_cursor": "eyJpZCI6IjE5NzctMDQtMjJUMDY6MDA6MDBaIn0",
    "prev_page_cursor": "ffN6eRJ0i2YPRA7C51eYNkLt8HIubpW9RDrFk77",
    "has_more": true
  }
}

API Reference

Listar registros de facturación con filtros

Por el momento, este endpoint sólo esta disponible en el entorno de pruebas.

Obtiene un listado paginado de registros de facturación pertenecientes a la empresa autenticada. La información de cada registro de facturación en una versión reducida de la que se obtiene en consultas individuales o cuando se crean nuevos registros de facturación.

Además se devuelve una sección meta para la gestión de la paginación.

El valor devuelto en meta.next_page_cursor sirve para solicitar la siguiente página y meta.prev_page_cursor para retroceder. Si meta.has_more es false, no hay más elementos.

GET

api

invoices

Listar registros de facturación con filtros

curl --request GET \
  --url https://api.kubifactu.com/api/invoices \
  --header 'X-Qbikode-ClientApiKey: <api-key>'

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "client_invoice_id": "<string>",
      "record_type": "creation",
      "request_id": "2cc8ef846029ec69613711ad1d85f6dfebf16ffb",
      "fiscal_year": 2025,
      "full_invoice_number": "F23-0000123",
      "issue_date": "2025-09-15",
      "created_at": "2025-09-15T07:35:24.992854Z",
      "fingerprint": "<string>",
      "csv": "<string>",
      "vf_post_status": "success",
      "vf_record_registration_status": "success",
      "has_warnings": false,
      "vf_error_descriptions": "<string>"
    }
  ],
  "meta": {
    "per_page": 50,
    "next_page_cursor": "eyJpZCI6IjE5NzctMDQtMjJUMDY6MDA6MDBaIn0",
    "prev_page_cursor": "ffN6eRJ0i2YPRA7C51eYNkLt8HIubpW9RDrFk77",
    "has_more": true
  }
}

Authorizations

X-Qbikode-ClientApiKey

string

header

required

API-KEY de la empresa que hace la petición. Este dato se puede consultar en el panel web, accediendo a la sección Empresas y accediendo a la ficha de la empresa en.

Query Parameters

date_from

string<date>

required

Fecha de inicio del rango de creación de las facturas (incluida). Formato YYYY-MM-DD.

Example:

"2025-01-01"

date_to

string<date>

required

Fecha de fin del rango de creación de las facturas (incluida). Debe ser igual o posterior a date_from.

Example:

"2025-01-31"

sif_id

string

ID del SIF emisor sobre el que se quieren buscar registros de facturación.

Example:

"A3DEAECE-8698-4E3D-A0A3-A17B523B9703"

vf_post_status

string

Filtrar registros de facturación por el estado de envío a Veri*Factu.

Ver valores posibles para vf_post_status en la respuesta de envío de registros de facturación.

Example:

"failure"

vf_record_registration_status

string

Filtrar registros de facturación por el estado del registro reportado por Veri*Factu.

Ver valores posibles para vf_record_registration_status en la respuesta de envío de registros de facturación.

Example:

"accepted_with_errors"

per_page

integer

Número de elementos por página (máximo 50). Valor por defecto 50.

Required range: 1 <= x <= 50

Example:

25

cursor

string

Cursor para la paginación basada en cursor. Use el valor devuelto en meta.next_page_cursor.

Example:

"eyJpZCI6IjE5NzctMDQtMjJUMDY6MDA6MDBaIn0"

Response

Listado paginado de registros de facturación.

data

object[]

Show child attributes

data.id

string<uuid>

Identificador (ID) de la factura en el sistema de KubiFACTU.

data.client_invoice_id

string | null

Identificador único de la factura dentro del sistema del cliente.

data.record_type

enum<string>

Tipo de registro de facturación:

creation: Se trata de un registro de alta.
cancellation: Se trata de un registro de anulación.

Available options:

creation,

cancellation

data.request_id

string

Identificador de la petición como referencia para el soporte técnico.

Example:

"2cc8ef846029ec69613711ad1d85f6dfebf16ffb"

data.fiscal_year

integer

Año fiscal de la factura.

Example:

2025

data.full_invoice_number

string

Número de la factura registrada.

Example:

"F23-0000123"

data.issue_date

string<date>

Fecha de expedición del registro de facturación.

Example:

"2025-09-15"

data.created_at

string<date-time>

Fecha y hora de creación de la factura en nuestro sistema.

Example:

"2025-09-15T07:35:24.992854Z"

data.fingerprint

string | null

Huella SHA-256 del registro de facturación registrado.

data.csv

string | null

Código Seguro de Verificación del registro de facturación.

data.vf_post_status

enum<string> | null

Este campo indica si la factura ha sido enviada a Veri*Factu, pero no indica si el registro ha sido aceptado. Los valores posibles son:

success: Se ha realizado el envío a Veri*Factu.
failure: No se ha podido hacer el envío a Veri*Factu.

Available options:

success,

failure

data.vf_record_registration_status

enum<string> | null

Valores posibles para el campo vf_record_registration_status, que indican el estado del registro en Veri*Factu.

success: El registro ha sido correctamente registrado en Veri*Factu.
accepted_with_errors: El registro ha sido registrado en Veri*Factu, pero tiene errores que deben ser subsanados.
failed: El registro tiene errores no aceptables y ha sido rechazado por Veri*Factu.
not_registered: No se ha encontrado el registro en Veri*Factu.
cancelled: El registro está anulado.
unknown: Se desconoce el estado del registro.

Available options:

success,

accepted_with_errors,

failed,

not_registered,

cancelled,

unknown

data.has_warnings

boolean

Indica si el registro contiene errores que deban ser subsanados.

Example:

false

data.vf_error_descriptions

string | null

Cadena con la descripción de los errores devueltos por Veri*Factu.