Enviar registro de facturación en diferido
curl --request POST \
--url https://api.kubifactu.com/api/invoicing/invoices/deferred \
--header 'Content-Type: application/json' \
--header 'X-Qbikode-ClientApiKey: <api-key>' \
--data '
{
"sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7",
"sender_data": {
"sender_full_name": "<string>",
"sender_id_card_number": "<string>"
},
"invoice_data": {
"invoice_type_key": "F1",
"fiscal_year": 2026,
"series_code": "2026",
"invoice_number": "00021",
"invoice_datetime": "2026-02-26 12:35:44",
"description": "<string>",
"tax_breakdown": [
{
"tax_type_key": "01",
"tax_base": 200,
"tax_base_at_cost": 123,
"tax_rate": 21,
"tax_quota": 42,
"equalization_tax_rate": 5.2,
"equalization_tax_quota": 10.4
}
],
"total_quota": 123,
"total_amount": 123,
"operation_date": "2026-02-26",
"representative_company_name": "<string>",
"representative_tax_id_number": "<string>",
"is_simplified": false,
"coupon_key": "N",
"invoicing_agreement_registration_number": "<string>",
"sif_agreement_id": "<string>",
"rectified_base_amount": 2500.55,
"rectified_quota": 42.3,
"rectified_equalization_tax_quota": 5.2,
"replaced_rectified_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"invoice_date": "2026-02-26"
}
],
"substituted_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"invoice_date": "2026-02-26"
}
]
},
"callback_url": "https://www.tuempresa.com/kubifactu/callback",
"recipients": [
{
"full_name": "<string>",
"tax_id_number": "<string>",
"other_id_country_code": "<string>",
"other_id_card_id": "<string>"
}
]
}
'import requests
url = "https://api.kubifactu.com/api/invoicing/invoices/deferred"
payload = {
"sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7",
"sender_data": {
"sender_full_name": "<string>",
"sender_id_card_number": "<string>"
},
"invoice_data": {
"invoice_type_key": "F1",
"fiscal_year": 2026,
"series_code": "2026",
"invoice_number": "00021",
"invoice_datetime": "2026-02-26 12:35:44",
"description": "<string>",
"tax_breakdown": [
{
"tax_type_key": "01",
"tax_base": 200,
"tax_base_at_cost": 123,
"tax_rate": 21,
"tax_quota": 42,
"equalization_tax_rate": 5.2,
"equalization_tax_quota": 10.4
}
],
"total_quota": 123,
"total_amount": 123,
"operation_date": "2026-02-26",
"representative_company_name": "<string>",
"representative_tax_id_number": "<string>",
"is_simplified": False,
"coupon_key": "N",
"invoicing_agreement_registration_number": "<string>",
"sif_agreement_id": "<string>",
"rectified_base_amount": 2500.55,
"rectified_quota": 42.3,
"rectified_equalization_tax_quota": 5.2,
"replaced_rectified_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"invoice_date": "2026-02-26"
}
],
"substituted_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"invoice_date": "2026-02-26"
}
]
},
"callback_url": "https://www.tuempresa.com/kubifactu/callback",
"recipients": [
{
"full_name": "<string>",
"tax_id_number": "<string>",
"other_id_country_code": "<string>",
"other_id_card_id": "<string>"
}
]
}
headers = {
"X-Qbikode-ClientApiKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Qbikode-ClientApiKey': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sif_id: '9db0bca1-187e-4cf4-b87c-96f2044008d7',
sender_data: {sender_full_name: '<string>', sender_id_card_number: '<string>'},
invoice_data: {
invoice_type_key: 'F1',
fiscal_year: 2026,
series_code: '2026',
invoice_number: '00021',
invoice_datetime: '2026-02-26 12:35:44',
description: '<string>',
tax_breakdown: [
{
tax_type_key: '01',
tax_base: 200,
tax_base_at_cost: 123,
tax_rate: 21,
tax_quota: 42,
equalization_tax_rate: 5.2,
equalization_tax_quota: 10.4
}
],
total_quota: 123,
total_amount: 123,
operation_date: '2026-02-26',
representative_company_name: '<string>',
representative_tax_id_number: '<string>',
is_simplified: false,
coupon_key: 'N',
invoicing_agreement_registration_number: '<string>',
sif_agreement_id: '<string>',
rectified_base_amount: 2500.55,
rectified_quota: 42.3,
rectified_equalization_tax_quota: 5.2,
replaced_rectified_invoices: [
{
tax_id_number: '<string>',
full_invoice_number: '<string>',
invoice_date: '2026-02-26'
}
],
substituted_invoices: [
{
tax_id_number: '<string>',
full_invoice_number: '<string>',
invoice_date: '2026-02-26'
}
]
},
callback_url: 'https://www.tuempresa.com/kubifactu/callback',
recipients: [
{
full_name: '<string>',
tax_id_number: '<string>',
other_id_country_code: '<string>',
other_id_card_id: '<string>'
}
]
})
};
fetch('https://api.kubifactu.com/api/invoicing/invoices/deferred', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.kubifactu.com/api/invoicing/invoices/deferred",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'sif_id' => '9db0bca1-187e-4cf4-b87c-96f2044008d7',
'sender_data' => [
'sender_full_name' => '<string>',
'sender_id_card_number' => '<string>'
],
'invoice_data' => [
'invoice_type_key' => 'F1',
'fiscal_year' => 2026,
'series_code' => '2026',
'invoice_number' => '00021',
'invoice_datetime' => '2026-02-26 12:35:44',
'description' => '<string>',
'tax_breakdown' => [
[
'tax_type_key' => '01',
'tax_base' => 200,
'tax_base_at_cost' => 123,
'tax_rate' => 21,
'tax_quota' => 42,
'equalization_tax_rate' => 5.2,
'equalization_tax_quota' => 10.4
]
],
'total_quota' => 123,
'total_amount' => 123,
'operation_date' => '2026-02-26',
'representative_company_name' => '<string>',
'representative_tax_id_number' => '<string>',
'is_simplified' => false,
'coupon_key' => 'N',
'invoicing_agreement_registration_number' => '<string>',
'sif_agreement_id' => '<string>',
'rectified_base_amount' => 2500.55,
'rectified_quota' => 42.3,
'rectified_equalization_tax_quota' => 5.2,
'replaced_rectified_invoices' => [
[
'tax_id_number' => '<string>',
'full_invoice_number' => '<string>',
'invoice_date' => '2026-02-26'
]
],
'substituted_invoices' => [
[
'tax_id_number' => '<string>',
'full_invoice_number' => '<string>',
'invoice_date' => '2026-02-26'
]
]
],
'callback_url' => 'https://www.tuempresa.com/kubifactu/callback',
'recipients' => [
[
'full_name' => '<string>',
'tax_id_number' => '<string>',
'other_id_country_code' => '<string>',
'other_id_card_id' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Qbikode-ClientApiKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.kubifactu.com/api/invoicing/invoices/deferred"
payload := strings.NewReader("{\n \"sif_id\": \"9db0bca1-187e-4cf4-b87c-96f2044008d7\",\n \"sender_data\": {\n \"sender_full_name\": \"<string>\",\n \"sender_id_card_number\": \"<string>\"\n },\n \"invoice_data\": {\n \"invoice_type_key\": \"F1\",\n \"fiscal_year\": 2026,\n \"series_code\": \"2026\",\n \"invoice_number\": \"00021\",\n \"invoice_datetime\": \"2026-02-26 12:35:44\",\n \"description\": \"<string>\",\n \"tax_breakdown\": [\n {\n \"tax_type_key\": \"01\",\n \"tax_base\": 200,\n \"tax_base_at_cost\": 123,\n \"tax_rate\": 21,\n \"tax_quota\": 42,\n \"equalization_tax_rate\": 5.2,\n \"equalization_tax_quota\": 10.4\n }\n ],\n \"total_quota\": 123,\n \"total_amount\": 123,\n \"operation_date\": \"2026-02-26\",\n \"representative_company_name\": \"<string>\",\n \"representative_tax_id_number\": \"<string>\",\n \"is_simplified\": false,\n \"coupon_key\": \"N\",\n \"invoicing_agreement_registration_number\": \"<string>\",\n \"sif_agreement_id\": \"<string>\",\n \"rectified_base_amount\": 2500.55,\n \"rectified_quota\": 42.3,\n \"rectified_equalization_tax_quota\": 5.2,\n \"replaced_rectified_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ],\n \"substituted_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ]\n },\n \"callback_url\": \"https://www.tuempresa.com/kubifactu/callback\",\n \"recipients\": [\n {\n \"full_name\": \"<string>\",\n \"tax_id_number\": \"<string>\",\n \"other_id_country_code\": \"<string>\",\n \"other_id_card_id\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Qbikode-ClientApiKey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.kubifactu.com/api/invoicing/invoices/deferred")
.header("X-Qbikode-ClientApiKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"sif_id\": \"9db0bca1-187e-4cf4-b87c-96f2044008d7\",\n \"sender_data\": {\n \"sender_full_name\": \"<string>\",\n \"sender_id_card_number\": \"<string>\"\n },\n \"invoice_data\": {\n \"invoice_type_key\": \"F1\",\n \"fiscal_year\": 2026,\n \"series_code\": \"2026\",\n \"invoice_number\": \"00021\",\n \"invoice_datetime\": \"2026-02-26 12:35:44\",\n \"description\": \"<string>\",\n \"tax_breakdown\": [\n {\n \"tax_type_key\": \"01\",\n \"tax_base\": 200,\n \"tax_base_at_cost\": 123,\n \"tax_rate\": 21,\n \"tax_quota\": 42,\n \"equalization_tax_rate\": 5.2,\n \"equalization_tax_quota\": 10.4\n }\n ],\n \"total_quota\": 123,\n \"total_amount\": 123,\n \"operation_date\": \"2026-02-26\",\n \"representative_company_name\": \"<string>\",\n \"representative_tax_id_number\": \"<string>\",\n \"is_simplified\": false,\n \"coupon_key\": \"N\",\n \"invoicing_agreement_registration_number\": \"<string>\",\n \"sif_agreement_id\": \"<string>\",\n \"rectified_base_amount\": 2500.55,\n \"rectified_quota\": 42.3,\n \"rectified_equalization_tax_quota\": 5.2,\n \"replaced_rectified_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ],\n \"substituted_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ]\n },\n \"callback_url\": \"https://www.tuempresa.com/kubifactu/callback\",\n \"recipients\": [\n {\n \"full_name\": \"<string>\",\n \"tax_id_number\": \"<string>\",\n \"other_id_country_code\": \"<string>\",\n \"other_id_card_id\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kubifactu.com/api/invoicing/invoices/deferred")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Qbikode-ClientApiKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sif_id\": \"9db0bca1-187e-4cf4-b87c-96f2044008d7\",\n \"sender_data\": {\n \"sender_full_name\": \"<string>\",\n \"sender_id_card_number\": \"<string>\"\n },\n \"invoice_data\": {\n \"invoice_type_key\": \"F1\",\n \"fiscal_year\": 2026,\n \"series_code\": \"2026\",\n \"invoice_number\": \"00021\",\n \"invoice_datetime\": \"2026-02-26 12:35:44\",\n \"description\": \"<string>\",\n \"tax_breakdown\": [\n {\n \"tax_type_key\": \"01\",\n \"tax_base\": 200,\n \"tax_base_at_cost\": 123,\n \"tax_rate\": 21,\n \"tax_quota\": 42,\n \"equalization_tax_rate\": 5.2,\n \"equalization_tax_quota\": 10.4\n }\n ],\n \"total_quota\": 123,\n \"total_amount\": 123,\n \"operation_date\": \"2026-02-26\",\n \"representative_company_name\": \"<string>\",\n \"representative_tax_id_number\": \"<string>\",\n \"is_simplified\": false,\n \"coupon_key\": \"N\",\n \"invoicing_agreement_registration_number\": \"<string>\",\n \"sif_agreement_id\": \"<string>\",\n \"rectified_base_amount\": 2500.55,\n \"rectified_quota\": 42.3,\n \"rectified_equalization_tax_quota\": 5.2,\n \"replaced_rectified_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ],\n \"substituted_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ]\n },\n \"callback_url\": \"https://www.tuempresa.com/kubifactu/callback\",\n \"recipients\": [\n {\n \"full_name\": \"<string>\",\n \"tax_id_number\": \"<string>\",\n \"other_id_country_code\": \"<string>\",\n \"other_id_card_id\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"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": "2026-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_url": "<string>",
"xml_url": "<string>",
"vf_response_body": "aSDinaTvuI8gbWludGxpZnk=",
"recovery": {
"status": "retry",
"reason_code": "temporary_service_error",
"message": "A temporary service or communication error prevented submission. KubiFactu will retry automatically.",
"attempts": 1,
"next_attempt_at": "2026-10-22T08:30:24+00:00"
}
}
}API Reference
Enviar registro de facturación en diferido
Generación de un nuevo registro de facturación en diferido.
POST
/
api
/
invoicing
/
invoices
/
deferred
Enviar registro de facturación en diferido
curl --request POST \
--url https://api.kubifactu.com/api/invoicing/invoices/deferred \
--header 'Content-Type: application/json' \
--header 'X-Qbikode-ClientApiKey: <api-key>' \
--data '
{
"sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7",
"sender_data": {
"sender_full_name": "<string>",
"sender_id_card_number": "<string>"
},
"invoice_data": {
"invoice_type_key": "F1",
"fiscal_year": 2026,
"series_code": "2026",
"invoice_number": "00021",
"invoice_datetime": "2026-02-26 12:35:44",
"description": "<string>",
"tax_breakdown": [
{
"tax_type_key": "01",
"tax_base": 200,
"tax_base_at_cost": 123,
"tax_rate": 21,
"tax_quota": 42,
"equalization_tax_rate": 5.2,
"equalization_tax_quota": 10.4
}
],
"total_quota": 123,
"total_amount": 123,
"operation_date": "2026-02-26",
"representative_company_name": "<string>",
"representative_tax_id_number": "<string>",
"is_simplified": false,
"coupon_key": "N",
"invoicing_agreement_registration_number": "<string>",
"sif_agreement_id": "<string>",
"rectified_base_amount": 2500.55,
"rectified_quota": 42.3,
"rectified_equalization_tax_quota": 5.2,
"replaced_rectified_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"invoice_date": "2026-02-26"
}
],
"substituted_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"invoice_date": "2026-02-26"
}
]
},
"callback_url": "https://www.tuempresa.com/kubifactu/callback",
"recipients": [
{
"full_name": "<string>",
"tax_id_number": "<string>",
"other_id_country_code": "<string>",
"other_id_card_id": "<string>"
}
]
}
'import requests
url = "https://api.kubifactu.com/api/invoicing/invoices/deferred"
payload = {
"sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7",
"sender_data": {
"sender_full_name": "<string>",
"sender_id_card_number": "<string>"
},
"invoice_data": {
"invoice_type_key": "F1",
"fiscal_year": 2026,
"series_code": "2026",
"invoice_number": "00021",
"invoice_datetime": "2026-02-26 12:35:44",
"description": "<string>",
"tax_breakdown": [
{
"tax_type_key": "01",
"tax_base": 200,
"tax_base_at_cost": 123,
"tax_rate": 21,
"tax_quota": 42,
"equalization_tax_rate": 5.2,
"equalization_tax_quota": 10.4
}
],
"total_quota": 123,
"total_amount": 123,
"operation_date": "2026-02-26",
"representative_company_name": "<string>",
"representative_tax_id_number": "<string>",
"is_simplified": False,
"coupon_key": "N",
"invoicing_agreement_registration_number": "<string>",
"sif_agreement_id": "<string>",
"rectified_base_amount": 2500.55,
"rectified_quota": 42.3,
"rectified_equalization_tax_quota": 5.2,
"replaced_rectified_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"invoice_date": "2026-02-26"
}
],
"substituted_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"invoice_date": "2026-02-26"
}
]
},
"callback_url": "https://www.tuempresa.com/kubifactu/callback",
"recipients": [
{
"full_name": "<string>",
"tax_id_number": "<string>",
"other_id_country_code": "<string>",
"other_id_card_id": "<string>"
}
]
}
headers = {
"X-Qbikode-ClientApiKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Qbikode-ClientApiKey': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sif_id: '9db0bca1-187e-4cf4-b87c-96f2044008d7',
sender_data: {sender_full_name: '<string>', sender_id_card_number: '<string>'},
invoice_data: {
invoice_type_key: 'F1',
fiscal_year: 2026,
series_code: '2026',
invoice_number: '00021',
invoice_datetime: '2026-02-26 12:35:44',
description: '<string>',
tax_breakdown: [
{
tax_type_key: '01',
tax_base: 200,
tax_base_at_cost: 123,
tax_rate: 21,
tax_quota: 42,
equalization_tax_rate: 5.2,
equalization_tax_quota: 10.4
}
],
total_quota: 123,
total_amount: 123,
operation_date: '2026-02-26',
representative_company_name: '<string>',
representative_tax_id_number: '<string>',
is_simplified: false,
coupon_key: 'N',
invoicing_agreement_registration_number: '<string>',
sif_agreement_id: '<string>',
rectified_base_amount: 2500.55,
rectified_quota: 42.3,
rectified_equalization_tax_quota: 5.2,
replaced_rectified_invoices: [
{
tax_id_number: '<string>',
full_invoice_number: '<string>',
invoice_date: '2026-02-26'
}
],
substituted_invoices: [
{
tax_id_number: '<string>',
full_invoice_number: '<string>',
invoice_date: '2026-02-26'
}
]
},
callback_url: 'https://www.tuempresa.com/kubifactu/callback',
recipients: [
{
full_name: '<string>',
tax_id_number: '<string>',
other_id_country_code: '<string>',
other_id_card_id: '<string>'
}
]
})
};
fetch('https://api.kubifactu.com/api/invoicing/invoices/deferred', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.kubifactu.com/api/invoicing/invoices/deferred",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'sif_id' => '9db0bca1-187e-4cf4-b87c-96f2044008d7',
'sender_data' => [
'sender_full_name' => '<string>',
'sender_id_card_number' => '<string>'
],
'invoice_data' => [
'invoice_type_key' => 'F1',
'fiscal_year' => 2026,
'series_code' => '2026',
'invoice_number' => '00021',
'invoice_datetime' => '2026-02-26 12:35:44',
'description' => '<string>',
'tax_breakdown' => [
[
'tax_type_key' => '01',
'tax_base' => 200,
'tax_base_at_cost' => 123,
'tax_rate' => 21,
'tax_quota' => 42,
'equalization_tax_rate' => 5.2,
'equalization_tax_quota' => 10.4
]
],
'total_quota' => 123,
'total_amount' => 123,
'operation_date' => '2026-02-26',
'representative_company_name' => '<string>',
'representative_tax_id_number' => '<string>',
'is_simplified' => false,
'coupon_key' => 'N',
'invoicing_agreement_registration_number' => '<string>',
'sif_agreement_id' => '<string>',
'rectified_base_amount' => 2500.55,
'rectified_quota' => 42.3,
'rectified_equalization_tax_quota' => 5.2,
'replaced_rectified_invoices' => [
[
'tax_id_number' => '<string>',
'full_invoice_number' => '<string>',
'invoice_date' => '2026-02-26'
]
],
'substituted_invoices' => [
[
'tax_id_number' => '<string>',
'full_invoice_number' => '<string>',
'invoice_date' => '2026-02-26'
]
]
],
'callback_url' => 'https://www.tuempresa.com/kubifactu/callback',
'recipients' => [
[
'full_name' => '<string>',
'tax_id_number' => '<string>',
'other_id_country_code' => '<string>',
'other_id_card_id' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Qbikode-ClientApiKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.kubifactu.com/api/invoicing/invoices/deferred"
payload := strings.NewReader("{\n \"sif_id\": \"9db0bca1-187e-4cf4-b87c-96f2044008d7\",\n \"sender_data\": {\n \"sender_full_name\": \"<string>\",\n \"sender_id_card_number\": \"<string>\"\n },\n \"invoice_data\": {\n \"invoice_type_key\": \"F1\",\n \"fiscal_year\": 2026,\n \"series_code\": \"2026\",\n \"invoice_number\": \"00021\",\n \"invoice_datetime\": \"2026-02-26 12:35:44\",\n \"description\": \"<string>\",\n \"tax_breakdown\": [\n {\n \"tax_type_key\": \"01\",\n \"tax_base\": 200,\n \"tax_base_at_cost\": 123,\n \"tax_rate\": 21,\n \"tax_quota\": 42,\n \"equalization_tax_rate\": 5.2,\n \"equalization_tax_quota\": 10.4\n }\n ],\n \"total_quota\": 123,\n \"total_amount\": 123,\n \"operation_date\": \"2026-02-26\",\n \"representative_company_name\": \"<string>\",\n \"representative_tax_id_number\": \"<string>\",\n \"is_simplified\": false,\n \"coupon_key\": \"N\",\n \"invoicing_agreement_registration_number\": \"<string>\",\n \"sif_agreement_id\": \"<string>\",\n \"rectified_base_amount\": 2500.55,\n \"rectified_quota\": 42.3,\n \"rectified_equalization_tax_quota\": 5.2,\n \"replaced_rectified_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ],\n \"substituted_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ]\n },\n \"callback_url\": \"https://www.tuempresa.com/kubifactu/callback\",\n \"recipients\": [\n {\n \"full_name\": \"<string>\",\n \"tax_id_number\": \"<string>\",\n \"other_id_country_code\": \"<string>\",\n \"other_id_card_id\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Qbikode-ClientApiKey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.kubifactu.com/api/invoicing/invoices/deferred")
.header("X-Qbikode-ClientApiKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"sif_id\": \"9db0bca1-187e-4cf4-b87c-96f2044008d7\",\n \"sender_data\": {\n \"sender_full_name\": \"<string>\",\n \"sender_id_card_number\": \"<string>\"\n },\n \"invoice_data\": {\n \"invoice_type_key\": \"F1\",\n \"fiscal_year\": 2026,\n \"series_code\": \"2026\",\n \"invoice_number\": \"00021\",\n \"invoice_datetime\": \"2026-02-26 12:35:44\",\n \"description\": \"<string>\",\n \"tax_breakdown\": [\n {\n \"tax_type_key\": \"01\",\n \"tax_base\": 200,\n \"tax_base_at_cost\": 123,\n \"tax_rate\": 21,\n \"tax_quota\": 42,\n \"equalization_tax_rate\": 5.2,\n \"equalization_tax_quota\": 10.4\n }\n ],\n \"total_quota\": 123,\n \"total_amount\": 123,\n \"operation_date\": \"2026-02-26\",\n \"representative_company_name\": \"<string>\",\n \"representative_tax_id_number\": \"<string>\",\n \"is_simplified\": false,\n \"coupon_key\": \"N\",\n \"invoicing_agreement_registration_number\": \"<string>\",\n \"sif_agreement_id\": \"<string>\",\n \"rectified_base_amount\": 2500.55,\n \"rectified_quota\": 42.3,\n \"rectified_equalization_tax_quota\": 5.2,\n \"replaced_rectified_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ],\n \"substituted_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ]\n },\n \"callback_url\": \"https://www.tuempresa.com/kubifactu/callback\",\n \"recipients\": [\n {\n \"full_name\": \"<string>\",\n \"tax_id_number\": \"<string>\",\n \"other_id_country_code\": \"<string>\",\n \"other_id_card_id\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kubifactu.com/api/invoicing/invoices/deferred")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Qbikode-ClientApiKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sif_id\": \"9db0bca1-187e-4cf4-b87c-96f2044008d7\",\n \"sender_data\": {\n \"sender_full_name\": \"<string>\",\n \"sender_id_card_number\": \"<string>\"\n },\n \"invoice_data\": {\n \"invoice_type_key\": \"F1\",\n \"fiscal_year\": 2026,\n \"series_code\": \"2026\",\n \"invoice_number\": \"00021\",\n \"invoice_datetime\": \"2026-02-26 12:35:44\",\n \"description\": \"<string>\",\n \"tax_breakdown\": [\n {\n \"tax_type_key\": \"01\",\n \"tax_base\": 200,\n \"tax_base_at_cost\": 123,\n \"tax_rate\": 21,\n \"tax_quota\": 42,\n \"equalization_tax_rate\": 5.2,\n \"equalization_tax_quota\": 10.4\n }\n ],\n \"total_quota\": 123,\n \"total_amount\": 123,\n \"operation_date\": \"2026-02-26\",\n \"representative_company_name\": \"<string>\",\n \"representative_tax_id_number\": \"<string>\",\n \"is_simplified\": false,\n \"coupon_key\": \"N\",\n \"invoicing_agreement_registration_number\": \"<string>\",\n \"sif_agreement_id\": \"<string>\",\n \"rectified_base_amount\": 2500.55,\n \"rectified_quota\": 42.3,\n \"rectified_equalization_tax_quota\": 5.2,\n \"replaced_rectified_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ],\n \"substituted_invoices\": [\n {\n \"tax_id_number\": \"<string>\",\n \"full_invoice_number\": \"<string>\",\n \"invoice_date\": \"2026-02-26\"\n }\n ]\n },\n \"callback_url\": \"https://www.tuempresa.com/kubifactu/callback\",\n \"recipients\": [\n {\n \"full_name\": \"<string>\",\n \"tax_id_number\": \"<string>\",\n \"other_id_country_code\": \"<string>\",\n \"other_id_card_id\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"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": "2026-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_url": "<string>",
"xml_url": "<string>",
"vf_response_body": "aSDinaTvuI8gbWludGxpZnk=",
"recovery": {
"status": "retry",
"reason_code": "temporary_service_error",
"message": "A temporary service or communication error prevented submission. KubiFactu will retry automatically.",
"attempts": 1,
"next_attempt_at": "2026-10-22T08:30:24+00:00"
}
}
}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.
Body
application/json
ID del SIF que se quiere utilizar para el envío de la factura. Los SIFs se pueden registrar en el panel web de KubiFACTU.
Un SIF puede procesar registros de facturación de diferentes empresas.
Una empresa puede tener uno o varios SIFs. Por ejemplo, una empresa con varias tiendas puede operar con un SIF por cada establecimiento, de forma que el encadenamiento/trazabilidad de las facturas se trate por separado.
Example:
"9db0bca1-187e-4cf4-b87c-96f2044008d7"
Información referente al emisor de la factura.
Show child attributes
Show child attributes
Datos del registro de facturación.
Show child attributes
Show child attributes
URL a la que KubiFACTU llama con el resultado de la AEAT cuando procesa el registro de facturación: el envío de un registro de facturación en diferido, un reenvío o una consulta. No se llama por el resultado que ya devuelve la respuesta de un envío inmediato.
Un mismo registro puede generar varios callbacks. Correlaciona cada elemento por id y procésalo de forma idempotente.
Los reintentos automáticos también llaman a esta URL, incluidos los de un envío inmediato que falló: cada nuevo retry, el paso a attention y el final de la recuperación (resolved). Por eso callback_url también sirve en los envíos inmediatos.
Se hará una petición POST a esta URL y se enviarán un array en formato JSON con los datos de las facturas procesadas cuyos ítems contendrán los siguientes campos:
id:string. Identificador de KubiFACTU para el registro de facturación.record_type:string (creation|cancellation). Tipo de registro de facturación.sif_id:string. ID del SIF utilizado para la creación del registro.sender_company_name:string. Nombre de la empresa emisira.sender_tax_id_number:string. CIF/NIF de la empresa emisora.full_invoice_number:string. Número de factura.fingerprint:string. Huella del registro de facturación.vf_post_status:string. Ver valores posibles en la documentación del campovf_post_statusde la respuesta de envío de registros de facturación.vf_record_registration_status:string. Ver valores posibles en la documentación del campovf_record_registration_statusde la respuesta de envío de registros de facturación.has_warnings:bool. Indica si el registro contiene errores que deban ser subsanados.vf_error_descriptions:string|null. Cadena con la descripción de los errores devueltos por Veri*Factu.vf_response_body:string|null. Cuerpo de la respuesta de Veri*Factu en formato Base64. Contiene el XML completo devuelto por la AEAT tras el envío del registro de facturación.xml_url:string|null. URL para descargar el XML del registro de facturación enviado a Veri*Factu mediante el endpoint Descargar XML del registro de facturación. Seránullsi el XML aún no está disponible.qr_value:string|null. URL del código QR para validación de la factura en Veri*Factu. Seránullsi el registro fue rechazado o no aplica mostrar QR.qr_image_url:string|null. URL para descargar la imagen PNG del código QR generado por KubiFACTU mediante el endpoint Descargar imagen QR del registro de facturación. Seránullsi el registro fue rechazado o no aplica mostrar QR.recovery:objectonull. Siempre presente. Valenullsi la recuperación automática no sigue el registro; en ese caso puedes ignorarlo. Mismo formato que el camporecoveryde la respuesta de envío de registros de facturación.
Example:
"https://www.tuempresa.com/kubifactu/callback"
Información de los receptores de la factura. Obligatorio para facturas ordinarias.
Show child attributes
Show child attributes
Response
Factura enviada con éxito.
Show child attributes
Show child attributes