Enviar registros de facturación en lote
curl --request POST \
--url https://api.kubifactu.com/api/invoices/batch \
--header 'Content-Type: application/json' \
--header 'X-Qbikode-ClientApiKey: <api-key>' \
--data '
{
"invoices": [
{
"sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7",
"invoice_type_key": "F1",
"sender_data": {
"company_name": "<string>",
"tax_id_number": "<string>"
},
"full_invoice_number": "2025-00001",
"fiscal_year": 2025,
"issue_date": "2025-09-15",
"operation_description": "<string>",
"lines": [
{
"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,
"client_invoice_id": "96f2044008d7iujfd78jspo4",
"callback_url": "https://www.tuempresa.com/kubifactu/callback",
"recipients": [
{
"company_name": "<string>",
"tax_id_number": "<string>",
"other_country_code": "<string>",
"other_tax_id_number": "<string>"
}
],
"representative_company_name": "<string>",
"representative_tax_id_number": "<string>",
"operation_date": "2025-02-26",
"rectified_tax_base": 2500.55,
"rectified_tax_quota": 42.3,
"rectified_equalization_tax_quota": 5.2,
"rectified_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"issue_date": "2025-02-26"
}
],
"substituted_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"issue_date": "2025-02-26"
}
],
"coupon_key": "N",
"invoicing_agreement_registration_number": "<string>",
"sif_agreement_id": "<string>"
}
]
}
'{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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>",
"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=",
"vf_response_body": "aSDinaTvuI8gbWludGxpZnk="
}
}API Reference
Enviar registros de facturación en lote
Generación de nuevos registros de facturación en lote que serán procesados en diferido.
POST
/
api
/
invoices
/
batch
Enviar registros de facturación en lote
curl --request POST \
--url https://api.kubifactu.com/api/invoices/batch \
--header 'Content-Type: application/json' \
--header 'X-Qbikode-ClientApiKey: <api-key>' \
--data '
{
"invoices": [
{
"sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7",
"invoice_type_key": "F1",
"sender_data": {
"company_name": "<string>",
"tax_id_number": "<string>"
},
"full_invoice_number": "2025-00001",
"fiscal_year": 2025,
"issue_date": "2025-09-15",
"operation_description": "<string>",
"lines": [
{
"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,
"client_invoice_id": "96f2044008d7iujfd78jspo4",
"callback_url": "https://www.tuempresa.com/kubifactu/callback",
"recipients": [
{
"company_name": "<string>",
"tax_id_number": "<string>",
"other_country_code": "<string>",
"other_tax_id_number": "<string>"
}
],
"representative_company_name": "<string>",
"representative_tax_id_number": "<string>",
"operation_date": "2025-02-26",
"rectified_tax_base": 2500.55,
"rectified_tax_quota": 42.3,
"rectified_equalization_tax_quota": 5.2,
"rectified_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"issue_date": "2025-02-26"
}
],
"substituted_invoices": [
{
"tax_id_number": "<string>",
"full_invoice_number": "<string>",
"issue_date": "2025-02-26"
}
],
"coupon_key": "N",
"invoicing_agreement_registration_number": "<string>",
"sif_agreement_id": "<string>"
}
]
}
'{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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>",
"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=",
"vf_response_body": "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.
Body
application/json
Array de registros de facturación con la misma estructura que la del endpoint de Enviar registro de facturación.
Show child attributes
Show child attributes
Response
Facturas recibidas con éxito.
Show child attributes
Show child attributes
⌘I