API Reference
curl --request GET \
--url https://api.kubifactu.com/api/invoicing/invoices/{invoiceId} \
--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>",
"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="
}
}Obtener registro de facturación
Obtener información sobre un registro de facturación.
Este endpoint no hace consulta a Veri*Factu; los datos se devuelven directamente desde nuestra base de datos.
curl --request GET \
--url https://api.kubifactu.com/api/invoicing/invoices/{invoiceId} \
--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>",
"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
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 cuestión.
Path Parameters
ID de la factura. Este ID se obtiene en la respuesta a las altas de registros de facturación. También se peude obtener desde el panel web, acediendo a la factura en el campo ID DE KUBIFACTU.
Response
Datos de la factura.
Show child attributes
Show child attributes
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.
Tipo de registro de facturación:
creation: Se trata de un registro de alta.cancellation: Se trata de un registro de anulación.
creation, cancellation Identificador de la petición como referencia para el soporte técnico.
"2cc8ef846029ec69613711ad1d85f6dfebf16ffb"
ID del SIF utilizado para la creación del registro.
"0995C42C-6708-44FB-BFBF-B363A5FE873E"
Año fiscal de la factura.
Número de la factura registrada.
Fecha y hora de creación de la factura en nuestro sistema.
"2025-09-15T07:35:24.992854Z"
Huella SHA-256 del registro de facturación registrado.
Código Seguro de Verificación del registro de facturación.
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.
success, failure 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.
success, accepted_with_errors, failed, not_registered, cancelled, unknown Indica si el registro contiene errores que deban ser subsanados.
false
Cadena con la descripción de los errores devueltos por Veri*Factu.
Tiempo que se debe esperar en segundos para que la empresa cliente pueda enviar una nueva petición.
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.
"1977-04-22T06:00:00Z"
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.
Imagen del QR (PNG) en formato Base64. Este campo será null cuando Veri*Factu rechace el registro de facturación.
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.