Consultar registro de facturación con Veri*Factu

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

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "record_type": "creation",
    "request_id": "2cc8ef846029ec69613711ad1d85f6dfebf16ffb",
    "sif_id": "0995C42C-6708-44FB-BFBF-B363A5FE873E",
    "fiscal_year": 123,
    "full_invoice_number": "<string>",
    "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>",
    "next_request_waiting_time": 123,
    "next_request_datetime": "1977-04-22T06:00:00Z",
    "qr_value": "<string>",
    "qr_image": "aSDinaTvuI8gbWludGxpZnk=",
    "xml_contents": "aSDinaTvuI8gbWludGxpZnk="
  }
}

GET

api

invoices

{invoiceId}

query

Consultar registro de facturación con Veri*Factu

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

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "record_type": "creation",
    "request_id": "2cc8ef846029ec69613711ad1d85f6dfebf16ffb",
    "sif_id": "0995C42C-6708-44FB-BFBF-B363A5FE873E",
    "fiscal_year": 123,
    "full_invoice_number": "<string>",
    "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>",
    "next_request_waiting_time": 123,
    "next_request_datetime": "1977-04-22T06:00:00Z",
    "qr_value": "<string>",
    "qr_image": "aSDinaTvuI8gbWludGxpZnk=",
    "xml_contents": "aSDinaTvuI8gbWludGxpZnk="
  }
}

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.

Path Parameters

invoiceId

string

required

ID de la factura. Este ID se obtiene en la respuesta a las altas de registros de facturación o puede usarse el identificador único de la factura dentro del sistema del cliente si en la creación del registro de facturación se hizo uso del campo client_invoice_id. El ID también se puede obtener desde el panel web, acediendo a la factura en el campo ID DE KUBIFACTU.

Response

Datos de la factura tras haber sido actualizada con el estado registrado en Veri*Factu.

data

object

Show child attributes

data.id

string<uuid>

Identificador (ID) de la factura en el sistema de KubiFACTU. Se utiliza para hacer referencia al registro de facturación desde otros endpoints como, por ejemplo, el de anulación de facturas.

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.sif_id

string<uuid>

ID del SIF utilizado para la creación del registro.

Example:

"0995C42C-6708-44FB-BFBF-B363A5FE873E"

data.fiscal_year

integer

Año fiscal de la factura.

data.full_invoice_number

string

Número de la factura registrada.

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.

data.next_request_waiting_time

integer

Tiempo que se debe esperar en segundos para que la empresa cliente pueda enviar una nueva petición.

data.next_request_datetime

string<date-time>

Fecha y hora en la que la empresa cliente pueda enviar una nueva petición en formato ISO-8601 (ej.- 1977-04-22T06:00:00Z) con zona horaria UTC.

Example:

"1977-04-22T06:00:00Z"

data.qr_value

string<uri> | null

URL que debe mostrarse en el QR de las facturas procesadas con VeriFactu. Esta URL sirve para que el receptor de la factura pueda validar que esta ha sido correctamente enviada a VeriFactu. Este campo será null cuando Veri*Factu rechace el registro de facturación.

data.qr_image

string<byte> | null

Imagen del QR (PNG) en formato Base64. Este campo será null cuando Veri*Factu rechace el registro de facturación.

data.xml_contents

string<byte> | null

XML del registro de facturación en formato Base64. Cuando la factura sea enviada en diferido este campo será null, ya que la generación del XML se realiza cuando llegue el momento de enviar el registro a VeriFactu. Además, si el registro de facturación forma parte de un envío en diferido, el XML puede contener información sobre otros registros de facturación incluidos en el envío.

Obtener registro de facturación Anular registro de facturación

⌘I

API Reference

Authorizations

Path Parameters

Response